# Codex Pilot 外部用户部署包

版本：2.60-external

这套部署包用于把外部版手机 App 连接到用户自己的 Mac 或 Windows 电脑，并通过手机使用电脑端 Codex 的工作包、对话、任务、引导、语音、附件和多电脑切换功能。

## 建议阅读顺序

1. `docs/FULL-GUIDE-zh-CN.md`
2. Mac 用户双击 `install-mac.command`
3. Windows 用户双击 `install-windows.cmd`，安装器会申请管理员权限
4. 安装 `app/` 目录里的外部版 APK
5. 用 `verify-mac.command` 或 `verify-windows.ps1` 验证电脑端服务

## 包内文件

- `app/`：外部版 Android APK
- `server/mac/`：Mac 电脑端服务
- `server/windows/`：Windows 电脑端服务
- `cloud-relay/`：可选的 Docker 云端中转服务
- `install-*`：安装并配置开机自启
- `verify-*`：检查电脑服务和连接信息
- `uninstall-*`：停止并移除开机自启，默认保留数据
- `docs/`：完整部署、使用和故障排查教程

## 默认目录

- Mac 服务：`~/.codex-pilot/mobile-control`
- Windows 服务：`%USERPROFILE%\.codex-pilot\mobile-control`
- 默认工作包：`~/CodexWorkspaces` 或 `%USERPROFILE%\CodexWorkspaces`
- 默认端口：`8787`

外部版不包含内部电脑地址、内部节点列表或内部访问口令。每台电脑首次安装时会在本机生成独立 token。

安装成功后会自动打开本机扫码配对页面。二维码使用 10 分钟有效的一次性配对码，不包含长期 token；手机配对成功后，配对码立即失效。
