cc-web/.planning/multi-agent-v2-audit/task_plan.md

Multi-agent V2 与 cc-web 兼容性审计

目标

完成 cc-web 对 Codex 0.145.0 Multi-agent V2 的兼容适配，验证后在无其他运行对话时重启服务并验收。

实施计划

• 补充 Multi-agent V2 失败回归用例
• 实现 Ultra 推理强度全链路支持
• 替换过时的 V1 子代理指导
• 实现 subAgentActivity 子代理路由与嵌套状态同步
• 更新 V2 mock 与关闭/路径展示语义
• 运行回归和静态检查
• 检查运行会话并重启 cc-web
• 执行重启后版本与服务验收

约束

• 上游事实优先采用 OpenAI 官方文档或本机安装包的可验证行为。
• 代码理解优先使用 codebase-memory-mcp，rg 仅做文本与行号校验。
• 保留工作区既有未提交文件，只修改本任务涉及的产品代码和回归。
• 用户已明确授权用户级全局 Codex 包升级；仅使用单次代理注册表，不改写 npm 持久配置。
• 重启前必须确认除当前对话外没有其他 running 对话；不启用 multi_agent_v2 feature flag。

错误记录

• 官方 Codex 手册 helper 对 HEAD https://developers.openai.com/codex/codex-manual.md 返回 HTTP 403；后续改用已缓存手册、官方 GET 或本机安装包证据降级。
• 一次过宽的 /home/hdzx 文件系统扫描超过 60 秒无输出，已中止；后续收窄到已知安装路径与有限目录。
• 浅克隆官方源码目录只留下无提交的 .git，未形成可检出的 HEAD；后续改为查询精确标签后定点 fetch，避免重复同一失败路径。
• 一次工具脚本因 JavaScript 对象引号拼写错误未执行；已立即修正，同类命令后续采用更短参数块。
• 一次 GitHub release JSON 的 jq 表达式把数组结果继续索引 .body，导致解析报错；已改为分别输出元组和正文，确认最新稳定版为 0.145.0。
• 一次计划文件补丁把“错误记录”误定位到 findings 文件，校验未通过且未写入；已按文件职责拆分后成功更新。
• 一次读取 0.145.0 child completion 源码的工具脚本重复出现 JavaScript 对象引号拼写错误；命令未执行，随即修正并成功获取证据。
• 一次补写 child completion 发现时再次把 task_plan 的错误记录定位到 findings，补丁校验未通过；已拆分为正确文件更新。
• 一次补写驻留 app-server 发现时误带了空的 skill 文件 hunk，补丁整体校验失败且未写入；已移除无关 hunk 后成功更新。
• 首次 npm install -g 使用 npm 默认系统前缀 /usr/local，因 EACCES 在 rename 阶段失败；未使用 sudo，改为对当前实际 Codex 路径对应的 ~/.local 显式用户前缀安装。