外部版完整使用教程
掌握工作包同步、上下文、引导、语音、附件、任务恢复和多电脑联动。
1. 开始使用
选电脑
确认顶部显示正确节点且在线。
确认顶部显示正确节点且在线。
选工作包
进入项目并选择小对话。
进入项目并选择小对话。
发任务
确认发送目标后输入文字、语音或附件。
确认发送目标后输入文字、语音或附件。
聊天页顶部会显示当前电脑和发送模式。输入框上方可以展开查看具体工作包与小对话目标。
2. 工作包同步
- 手机新建工作包会创建到当前电脑的默认工作包目录，并登记到 Codex。
- 电脑新建或打开过的项目，手机刷新后可以读取。
- 删除工作包默认只删除登记和桌面入口，不删除真实文件。
- 批量管理支持全选、反选、单选、取消和删除确认。
要彻底删除真实文件，请在电脑文件管理器中操作并先确认备份。手机删除功能默认保护文件。
3. 小对话与上下文
小对话对应电脑端 Codex 线程。手机发电脑、电脑发手机的上下文都写在同一线程中。
| 操作 | 用途 |
|---|---|
| 切换小对话 | 继续已有上下文 |
| 新建小对话 | 为同一工作包开启新上下文 |
| 重命名 | 让对话更容易识别 |
| 置顶 | 放到最近位置 |
| 删除 | 归档电脑端对应线程 |
4. 三种发送模式
桌面线程
默认模式，写入电脑小对话，适合项目、代码修改和持续任务。
引导执行
用于正在运行的任务，补充要求、纠正方向或打断。
API 问答
用于快问快答，不写入电脑线程。需要电脑端配置有效 API Key。
5. 引导和纠错
任务执行中可以使用“补充”“打断”“继续”“先解释”“不要改这个”等操作。引导消息会发送到当前正在执行的任务，不需要等任务结束。
发现方向错误时优先点“打断”，再说明正确方向；只是补充条件时点“补充”。
6. 语音、附件和链接
- 点麦克风开始实时转文字，小话筒进入动态状态。
- 点停止结束识别；直接发送也会自动停止。
- 引导输入框同样支持语音转文字。
- 点“+”上传图片、视频或文件。
- 聊天里的网址可以点击打开。
- 长按消息复制全文；进入文本选择后可只复制部分文字。
7. 任务中心和失败恢复
| 状态 | 处理建议 |
|---|---|
| 排队 | 等待同一工作包前一任务完成 |
| 执行中 | 可补充、打断或查看详情 |
| 正在重连 | 等待短暂恢复，持续异常再诊断 |
| 疑似卡住 | 诊断电脑、取消或重发 |
| 失败 | 查看简明原因，使用纠正或重发 |
任务卡片和详情页提供详情、补充、打断、取消、重发、文件和日志入口。
离线队列、云端中转和后台通知
- 直连失败时，任务先进入手机本地离线队列，电脑恢复后自动续传。
- 配置云端中转后，任务可先由 Relay 暂存，目标电脑上线后领取。
- App 的前台联动服务会监测任务开始、确认、失败和完成并发送系统通知。
- 开机和覆盖升级后会自动恢复后台联动。
8. 多电脑切换
发送前确认顶部电脑名称。每台电脑的工作包、token 和任务队列独立。切换电脑后 App 会刷新该节点的工作包和小对话。
- 节点离线时先诊断，不要连续重复发送。
- 重命名电脑只影响手机显示，不改变地址和 token。
- 重要任务优先发送到当前空闲、Codex 登录正常的电脑。
9. 推荐日常流程
- 打开 App，确认电脑在线。
- 进入工作包并选对小对话。
- 展开发送目标确认电脑、工作包和模式。
- 发出任务，观察任务状态。
- 方向偏差时立即补充或打断。
- 完成后查看结果文件和电脑端变化。
- 长任务结束后可使用“压缩上下文”整理后续重点。