# touchlight

**Repository Path**: BigQuill/touchlight

## Basic Information

- **Project Name**: touchlight
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-31
- **Last Updated**: 2025-07-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TouchLight - 可编程运动训练平台

## 🎯 项目简介

TouchLight 是一个革命性的智能运动训练系统，采用**混合架构设计**，支持在线全功能和离线基础模式。通过8颗环形LED和毫秒级触控检测，将枯燥的运动训练转化为有趣的互动游戏。无论是否有手机连接，都能提供优质的训练体验。

## 📖 文档阅读指南

项目文档已按照从宏观到微观、从概念到实现的顺序编号：

1. **快速了解项目**：阅读 `01_TouchLight_Project_Overview.md`
2. **深入技术细节**：按照 `00_TouchLight_Documentation_Index.md` 中的顺序阅读
3. **开始开发**：重点阅读 `08_TouchLight_App_Development_Plan.md`

## 🏗️ 混合架构设计

### 在线模式 (全功能)
```
┌─────────────┐     BLE      ┌─────────────┐   ESP-NOW   ┌─────────────┐
│   手机App   │◄────────────►│   Gateway   │◄──────────►│  Client×N   │
│ (游戏引擎)  │              │ (智能中继)  │            │ (执行单元)  │
└─────────────┘              └─────────────┘            └─────────────┘
       │                                                        
       │ WiFi/4G                                               
       ▼                                                        
┌─────────────┐                                                
│  云端服务器  │                                                
│ (数据分析)  │                                                
└─────────────┘
```

### 离线模式 (独立运行)
```
                    ┌─────────────┐   ESP-NOW   ┌─────────────┐
                    │   Gateway   │◄──────────►│  Client×N   │
                    │ (简单引擎)  │            │ (执行单元)  │
                    └─────────────┘            └─────────────┘
```

## 🚀 核心特性

- **混合架构**：在线全功能 + 离线基础模式，保证任何情况都能使用
- **8颗环形LED**：丰富的视觉反馈和游戏指示
- **极低延迟**：手机→设备总延迟 < 50ms
- **高并发**：最多10个设备同时激活训练
- **可靠传输**：ACK确认机制，防丢包
- **可视化编程**：像搭积木一样创建运动游戏
- **离线训练**：8个内置程序，无需手机独立运行
- **智能切换**：自动检测手机连接，无缝模式切换

## 💻 技术栈

- **硬件**：ESP32 + 自定义PCB
- **通信**：BLE 5.0 + ESP-NOW
- **移动端**：iOS原生(Core Bluetooth) + React Native
- **后端**：Node.js + MySQL + Redis
- **协议**：自定义二进制协议 + JSON

## 📱 开发计划

### Phase 1 (MVP - 12周)
- ✅ 硬件原型完成
- 🚧 iOS App开发中
- 📅 基础游戏功能
- 📅 简化版可视化编程

### Phase 2 (扩展 - 6个月)
- 📅 Android版本
- 📅 完整可视化编程
- 📅 社区功能
- 📅 AI训练助手

## 🛠️ 快速开始

```bash
# 克隆项目
git clone https://github.com/touchlight/touchlight-app.git

# 安装依赖
cd touchlight-app
npm install
cd ios && pod install

# 运行开发版本
npx react-native run-ios
```

## 📚 项目文档

查看 `00_TouchLight_Documentation_Index.md` 获取完整的文档列表和阅读建议。

## 🤝 贡献指南

我们欢迎所有形式的贡献，包括但不限于：
- 报告问题
- 提交代码
- 改进文档
- 分享创意

## 📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

---

**让运动训练变得有趣，让每个人都成为游戏创造者！** 🎮✨