在电脑上新建会话
- 进入概览
确认后台服务在线，在 Codex、Kimi、Qwen 中选择一个 Agent。
- 点击新建并打开
按钮会显示当前 Agent 名称，例如 “新建并打开 Codex”。
- 选择项目文件夹
使用 Windows 系统文件夹选择器选中代码项目，再确认在此文件夹启动。
- 等待终端打开
客户端会创建受管 tmux 会话，并打开 Ubuntu/Windows Terminal。手机会话列表随后出现同一个会话。
继续以前的工作
电脑端概览点击 “继续历史工作”。
| Agent | 恢复方式 | 说明 |
|---|---|---|
| Codex | 选择结构化历史，或使用 codex resume | 列表可以使用原工作目录继续，不创建新对话 |
| Kimi | kimi --continue 或 kimi --session | 由 Kimi 官方恢复命令处理 |
| Qwen | qwen --continue 或 qwen --resume | 由 Qwen 官方恢复命令处理 |
为了防止桌面客户端变成任意命令执行器，恢复入口不接受其他程序、管道、分号、重定向或额外的任意参数。
对话历史可以完整向上滚动
手机控制台默认打开对话时间线。向上滚到顶部时，会按游标继续加载更早记录，并尽量保持当前阅读位置；不再只保留固定数量的消息或终端行。
- Codex：优先通过本机
codex app-server读取 Thread、Turn 和 Item，把用户消息、回复、命令、文件修改和工具状态显示为结构化记录。 - Kimi / Qwen：从本机受管终端持续记录时间线，因此可以查看此前输出，但不会凭空得到 Codex 那种结构化工具语义。
- 兼容回退：Codex 结构化历史暂时无法匹配时，会自动退回 tmux 增量记录，当前会话仍可操作。
发送消息和停止当前操作
- 输入区固定在底部，会随文字自动增高。
- 发送后，自己的消息会立即进入时间线，Agent 输出随后持续更新。
- Agent 正在工作时可以点击停止按钮。它相当于中断当前操作，会话本身仍保留。
- 常用 Slash 命令会按当前 Agent 显示；需要选择的命令会打开终端交互提示。
对话视图与终端视图
顶部的 “终端”/“对话”按钮可以切换视图。
对话视图
适合阅读历史、发送普通消息、查看命令、文件修改和工具状态。日常使用优先停留在这里。
终端视图
显示原始 CLI 屏幕，用于交互菜单、异常界面和高级操作。提供 Ctrl+C、Esc、Tab 和方向键。
原始终端更接近当前屏幕状态，不是长期历史浏览器。需要找较早内容时先回到对话时间线向上滚动。
发送照片和文档
输入框左侧点击 “＋”，可以选择照片、截图或常用文档。
- 每条消息最多 4 个附件。
- 每个附件最多 12 MB。
- 支持 PNG、JPG、PDF、TXT、Markdown、CSV、JSON、LOG、DOCX、XLSX 和 PPTX。
- 附件不能和 Slash 命令放在同一条消息里。
- 可执行文件、扩展名与内容不一致的文件会被拒绝。
附件先上传到这台电脑的私有暂存目录，并绑定当前手机和会话；图片作为图像输入交给 Agent，文档通过本机路径读取。旧暂存文件会自动清理。
会话设置里有什么
点击手机页面顶部菜单，可以打开 “会话设置”：
- 切换当前受管会话。
- 启动新会话、刷新状态或结束当前会话。
- 查看当前 Agent、历史模式和完整 Slash 操作。
- 查看受管进程状态。
- 查看手机 App 与电脑端各自的版本号。
断线后会发生什么
短时网络波动时，页面会尝试恢复实时连接。恢复后会用服务端当前状态修正断线期间可能遗漏的事件；已经加载的历史仍可以继续阅读。
如果长时间无法恢复：
- 确认电脑没有睡眠，Woodox 后台服务仍在线。
- 回到 Android 首页重新连接保存的电脑。
- 仍失败时，在电脑端打开 “诊断”，按异常项的建议处理。