38 lines
2.7 KiB
Markdown
38 lines
2.7 KiB
Markdown
# Multi-agent V2 与 cc-web 兼容性审计
|
||
|
||
## 目标
|
||
|
||
完成 cc-web 对 Codex 0.145.0 Multi-agent V2 的兼容适配，验证后在无其他运行对话时重启服务并验收。
|
||
|
||
## 实施计划
|
||
|
||
- [x] 补充 Multi-agent V2 失败回归用例
|
||
- [x] 实现 Ultra 推理强度全链路支持
|
||
- [x] 替换过时的 V1 子代理指导
|
||
- [x] 实现 subAgentActivity 子代理路由与嵌套状态同步
|
||
- [x] 更新 V2 mock 与关闭/路径展示语义
|
||
- [x] 运行回归和静态检查
|
||
- [x] 检查运行会话并重启 cc-web
|
||
- [x] 执行重启后版本与服务验收
|
||
|
||
## 约束
|
||
|
||
- 上游事实优先采用 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` 显式用户前缀安装。
|