# qcode

**Repository Path**: jinxinyang/qcode

## Basic Information

- **Project Name**: qcode
- **Description**: 简单的编程
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🚀 QCode - 安卓远程编码控制系统

一个强大的远程编码控制系统，允许通过安卓手机远程控制电脑端的AI编码操作、任务管理和系统监控。

## 📁 项目结构

```
qcode/
├── 📱 android-remote-control/   # 安卓应用
│   ├── app/                    # 应用主体
│   │   ├── src/main/
│   │   │   ├── java/com/example/remotecontrol/
│   │   │   ├── res/            # 资源文件
│   │   │   └── AndroidManifest.xml
│   │   └── build.gradle
│   ├── build.gradle
│   ├── gradlew                 # Gradle包装器
│   └── settings.gradle
│
├── 💻 pc-backend/              # PC端服务器
│   ├── src/                    # 源代码
│   │   ├── main.js            # 主入口文件
│   │   ├── core/              # 核心功能
│   │   ├── handlers/          # 请求处理器
│   │   ├── server/            # 服务器配置
│   │   ├── services/          # 业务服务
│   │   └── utils/             # 工具函数
│   ├── python/                # Python脚本
│   │   ├── core/              # 核心Python模块
│   │   └── utils/             # Python工具
│   ├── assets/                # 静态资源
│   ├── natapp.exe             # 内网穿透工具
│   ├── natapp_authtoken.txt   # natapp认证令牌
│   ├── package.json
│   └── requirements.txt       # Python依赖
│
├── 📚 setup/                   # 环境搭建
│   ├── README.md              # 详细环境搭建指南
│   └── check-environment.js   # 环境检查脚本
│
├── 🚀 启动脚本
│   ├── start_server.bat       # Windows一键启动脚本
│   └── build-android.bat      # 安卓构建脚本
│
├── 📱 app-debug.apk           # 预编译的安卓应用
├── 📖 README.md               # 项目说明（本文件）
└── ⚙️ package.json            # 根项目配置
```

## 🎯 系统功能

✅ **已完成的核心功能：**
- 🌐 WebSocket实时通信服务器
- 📱 安卓远程控制应用
- 🤖 Augment AI聊天监控
- 📋 任务管理系统
- 🖥️ 屏幕截图和控制
- 🔗 内网穿透支持（natapp）
- 🐍 Python脚本集成
- 📊 实时状态监控

## 🚀 快速开始

### 📋 环境要求

在开始之前，请确保你的系统满足以下要求：

- **Windows 10/11** (推荐)
- **Node.js 18+**
- **Python 3.8+**
- **Android Studio** (用于开发) 或 **ADB** (用于安装APK)

### 🛠️ 环境搭建

#### 1. 检查环境
```bash
# 运行环境检查脚本
node setup/check-environment.js
```

#### 2. 安装依赖
```bash
# 安装Node.js依赖
npm install

# 安装Python依赖
pip install -r pc-backend/requirements.txt
```

### 🖥️ 启动PC端服务器

#### 方法一：一键启动（推荐）
```cmd
# Windows用户直接双击运行
start_server.bat
```

这个脚本会自动：
- ✅ 启动Node.js服务器（端口8080）
- ✅ 检查natapp认证令牌
- ✅ 启动内网穿透服务
- ✅ 显示访问地址

#### 方法二：手动启动
```bash
cd pc-backend
npm install
node src/main.js
```

### 📱 安装安卓应用

#### 方法一：使用预编译APK（推荐）
```bash
# 安装到连接的安卓设备
adb install app-debug.apk
```

#### 方法二：从源码编译
```bash
cd android-remote-control

# Windows
gradlew.bat assembleDebug
gradlew.bat installDebug

# macOS/Linux
./gradlew assembleDebug
./gradlew installDebug
```

### 🔗 连接配置

#### 本地网络连接
- **本机测试**: `ws://localhost:8080`
- **局域网设备**: `ws://你的PC的IP:8080`
- **安卓模拟器**: `ws://10.0.2.2:8080`

#### 外网访问（natapp）
当启动脚本运行后，会显示类似：
```
🌐 Natapp Tunnel: tcp://sb98d778.natappfree.cc:40377
```
在安卓应用中使用：`ws://sb98d778.natappfree.cc:40377`

### 📱 使用安卓应用

1. **打开应用**：在安卓设备上启动"Remote Control"应用

2. **配置连接**：
   - 输入服务器地址（如：`ws://192.168.1.100:8080`）
   - 点击"连接"按钮

3. **功能使用**：
   - 📋 **任务管理**：查看和管理编码任务
   - 🖥️ **屏幕控制**：远程查看和控制PC屏幕
   - 💬 **AI聊天监控**：监控Augment AI对话
   - 📊 **系统状态**：查看PC端运行状态

## 🔧 高级配置

### natapp内网穿透配置

1. **获取authtoken**：
   - 访问 [natapp.cn](https://natapp.cn)
   - 注册账号并获取免费隧道的authtoken

2. **配置令牌**：
   - 首次运行`start_server.bat`时会提示输入authtoken
   - 令牌会自动保存到`pc-backend/natapp_authtoken.txt`
   - 后续启动会自动使用保存的令牌

### Python脚本配置

系统集成了Python脚本用于：
- 🤖 Augment AI聊天监控
- 📊 系统状态收集
- 🔄 任务自动化处理

Python依赖会在首次启动时自动安装。

## 🧪 测试和调试

### 连接测试
1. 启动PC端服务器
2. 在安卓应用中连接
3. 发送测试消息
4. 观察PC端控制台输出

### 常见问题排查

**连接失败**：
- ✅ 检查PC和手机是否在同一网络
- ✅ 确认防火墙设置允许8080端口
- ✅ 验证IP地址是否正确

**natapp连接问题**：
- ✅ 检查authtoken是否正确
- ✅ 确认网络连接正常
- ✅ 查看natapp控制台输出

**Python脚本错误**：
- ✅ 确认Python环境正确安装
- ✅ 检查requirements.txt中的依赖
- ✅ 查看PC端控制台的Python错误信息

## 🔮 功能特性

### 当前功能
- ✅ **实时通信**：WebSocket双向通信
- ✅ **任务管理**：远程任务创建和监控
- ✅ **屏幕控制**：截图和远程操作
- ✅ **AI集成**：Augment聊天监控
- ✅ **内网穿透**：支持外网访问
- ✅ **跨平台**：Windows/Android支持

### 计划功能
- 🔄 **文件传输**：手机与PC间文件同步
- 🔄 **语音控制**：语音指令执行
- 🔄 **多设备支持**：同时连接多个设备
- 🔄 **安全认证**：用户身份验证
- 🔄 **插件系统**：自定义功能扩展

## 📞 技术支持

遇到问题？按以下步骤排查：

1. **运行环境检查**：
   ```bash
   node setup/check-environment.js
   ```

2. **查看日志**：
   - PC端：控制台输出
   - 安卓端：应用内消息显示

3. **网络诊断**：
   - 检查防火墙设置
   - 验证端口是否被占用
   - 测试网络连通性

4. **重启服务**：
   - 关闭所有相关窗口
   - 重新运行`start_server.bat`

## 🤝 贡献指南

欢迎参与项目开发！

1. **Fork项目**
2. **创建功能分支**
3. **提交更改**
4. **发起Pull Request**

## 📄 许可证

MIT License - 详见LICENSE文件

---

**🎉 开始你的远程编码之旅！**

> 💡 提示：首次使用建议先在本地网络测试，确认功能正常后再配置外网访问。