适用场景：AI 文档、网站重构或批量内容任务因响应流中断而停止，需要从可验证的断点继续。
1. 先判断是不是“半完成” #
看到 stream disconnected before completion 后，先不要重跑整批。记录错误原文和时间，检查本地聊天记录、工作区差异、远端 CMS、数据库发布记录和媒体上传记录。只有确认上一次没有外部写入，才可以安全地重新提交相同批次。
2. 使用 codex fork 创建恢复线程 #
Codex CLI 的 codex fork 子命令可以分叉已保存的交互会话，用来尝试新的执行路径。当前本地版本支持传入会话 ID，或用 codex fork --last 选择最近会话。某些客户端可能提供 /fork 交互入口；以本地菜单与 codex fork --help 为准。新分支的第一条任务说明应包含：
- 最后一个成功检查点和批次编号；
- 已完成、待复审和待发布的文件范围；
- 不可重复发布或覆盖的对象 ID；
- 下一批的大小、验收条件和回滚方式。
不同 Codex CLI 版本对分支、工作树和上下文继承的行为可能不同。运行 codex fork --help 查看本地说明；不要假设分叉会恢复服务端流、自动创建 Git 工作树或保存尚未写入的文件。
3. 为批处理建立 manifest #
每个源文件至少记录稳定 ID、源 URL、内容哈希、处理状态、目标 URL、远端对象 ID、最近截图时间和复核结果。状态变更要幂等：同一个源重复执行时，应更新同一对象或明确跳过，而不是无条件创建新页面。
4. 视觉与语义验收 #
- 用 Edge 无头模式打开每个目标页面并截图。
- 检查桌面和移动视口的空行、标题层级、列表、表格和链接。
- 对照技术资料核对型号、数字、日期、范围和限定条件。
- 把视觉缺陷和语义缺陷分别记录，修复后重新截图。
5. 何时使用临时侧问 #
如果当前客户端提供侧边对话，可用它临时核对一个小问题，例如解释一条日志。不要假设所有 Codex 客户端都支持名为 /side 的命令；也不要让临时侧问承载主任务的发布、迁移或批处理状态。这些内容应回到主线程或正式分叉的会话。
6. 发布前安全边界 #
公开 Docs 不应包含 NDA 原文、合同附件、工厂名称、联系人、内部路径、原始请求 ID 或未公开的交付清单。对断流根因使用“未证实”或“可能原因”等表述，除非服务端证据足以支持确定结论。
快速检查表 #
- □ 最后成功检查点已保存
- □ 远端 CMS 状态已核对
- □ 批次有稳定 ID 和内容哈希
- □ 新分支说明了下一批范围
- □ 桌面、移动截图已复核
- □ NDA 与内部标识已移除
想了解这套流程为何形成，可阅读案例：《长会话断流后，如何用 Codex fork 继续 AI 文档项目》。
本页是通用操作指南。具体命令和分支能力以当前 Codex CLI 的 codex fork --help 输出和客户端菜单为准。
