73 lines
2.7 KiB
Markdown
73 lines
2.7 KiB
Markdown
# iTuoke
|
||
|
||
手机操控桌面应用：**Wails + Vue3 + TypeScript**（UI） / **Go**（ADB 设备核心） / **Python**（Agent 独立进程）。
|
||
|
||
## 架构
|
||
|
||
```text
|
||
frontend/ UI：左画面 | 右对话 | 设置 | 日志
|
||
main.go 桌面壳入口（窗口 + 注册服务）
|
||
internal/device/ ADB 连接 / 视频预览 / 实时触摸控制（Go）
|
||
internal/agent/ 对接 Python Agent 的桥
|
||
internal/protocol/ 版本化 JSON-RPC 契约
|
||
agent/ Python Agent 进程（可后接云端模型）
|
||
```
|
||
|
||
关键改代码位置已在源文件顶部用 `[关键]` / `[入口]` / `[UI · …]` 备注标出。
|
||
|
||
## 开发
|
||
|
||
需要 Go 1.26、Node.js 22.18+（测试直接运行 TypeScript）、npm 和 Wails v3。macOS 实时预览还需安装 `scrcpy 5.0.1` 与 `ffmpeg`（当前控制协议对应 scrcpy 5.0.1）。首次运行先安装前端依赖，并同步内置 ADB：
|
||
|
||
```bash
|
||
npm --prefix frontend install
|
||
./scripts/sync-platform-tools.sh
|
||
```
|
||
|
||
|
||
```bash
|
||
# 1) 生成前端绑定（改 Go 导出方法后重跑）
|
||
wails3 generate bindings -ts -i ./...
|
||
|
||
# 2) 跑桌面应用（热重载）
|
||
wails3 dev
|
||
|
||
# 3) 可选：单独起 Python Agent
|
||
cd agent && python3 main.py
|
||
```
|
||
|
||
macOS 开发运行会把应用包同步到 `~/Applications/iTuoke.app` 后启动，避免从外置磁盘运行时反复触发「可移除宗卷」文件授权。ADB 使用应用专用的本地后台服务，不复用其他工具的默认服务；配对记录继续保留。
|
||
|
||
## 内置 ADB（客户无需安装）
|
||
|
||
```bash
|
||
./scripts/sync-platform-tools.sh # 同步 platform-tools 到 third_party/
|
||
wails3 build # macOS 打包时自动拷进 .app/Contents/Resources/
|
||
```
|
||
|
||
运行时优先使用应用内置 `adb`，不依赖客户电脑是否安装过 Android SDK。
|
||
|
||
## 当前能力
|
||
|
||
- USB / 无线 ADB 设备发现、配对、连接与离线重连。
|
||
- scrcpy 视频预览，支持适应窗口及 50%–200% 缩放。
|
||
- 预览中点按、长按及连续拖动：按下、移动、松开实时发送到 scrcpy 控制通道。
|
||
- 深色、浅色和跟随系统主题，连接配置与缩放偏好持久化。
|
||
- 设置与日志页面；Go/Python Agent 对话目前仍为 stub，尚未接入模型。
|
||
|
||
`frontend/bindings/`、依赖目录、构建产物、录屏和本机配置不提交；前端绑定由上述生成命令或 Wails 构建任务重建。图标、原始图标素材及各平台打包模板保留在仓库。
|
||
|
||
## 验证
|
||
|
||
```bash
|
||
node --test frontend/tests/*.test.mjs
|
||
npm --prefix frontend run build
|
||
go test -race ./internal/...
|
||
```
|
||
|
||
可选实机预览检查（设备需已连接到 iTuoke 的专用 ADB 服务）：
|
||
|
||
```bash
|
||
ITUOKE_TEST_DEVICE='手机IP:连接端口' go test -race ./internal/device -run TestLocalPhonePreview -v -count=1
|
||
```
|