cc-web/.planning/codex-app-web-search/task_plan.md

Codex App Web Search 接入计划

目标

让设置中的 enableSearch 驱动 Codex App/app-server 原生 Web Search，保持旧 codex exec 路径禁用搜索，并用协议回归证明参数形状、关闭语义和事件展示均正确。

验收标准

• 开启 Web Search 后，Codex App 的官方协议字段收到明确启用值。
• 关闭 Web Search 后，协议字段为禁用值或按官方语义省略，不影响普通 turn。
• 设置保存与读取不再把 Codex App 搜索能力硬编码为不可用。
• webSearch item 继续按 web_search 工具事件展示。
• 不新增“上下文超限后客户端 compact + 重放”逻辑；文档结论明确区分上游原生自动压缩与 cc-web 额外失败兜底。
• 回归、语法检查和差异检查通过，且不覆盖 Goal 生命周期的并行改动。

阶段

1. [完成] 确认 Codex App Web Search 官方协议与现有链路
2. [完成] 编写 Web Search 配置与协议回归断言
3. [完成] 接入 Codex App 原生 Web Search 参数
4. [完成] 更新设置界面与配置保存语义
5. [完成] 验证 Web Search 事件展示与自动 compact 现状
6. [完成] 运行回归、语法与差异检查
7. [完成] 汇总兼容性结论并清理跟踪文件

决策

• 以本机 Codex app-server 生成 schema 为参数形状的直接证据，并用 hapi 实现交叉核对。
• Web Search 只接 Codex App 原生协议，不重新启用旧 codex exec --search 路径。
• 原生自动 compact 已存在；客户端“最终超限后 compact 并重放”不是本轮实现目标。

错误记录

错误	尝试	处理
developers.openai.com 返回 Forbidden	1	改查同为官方域名的 platform.openai.com
platform.openai.com 被 Cloudflare 拦截	2	按 openai-docs 降级，读取官方文档参考并转用本机协议 schema 交叉验证