feat: complete Codex App capabilities and rebuild release

This commit is contained in:
shiyue
2026-08-20 13:37:23 +08:00
parent d7dc32e924
commit 19c1601351
8 changed files with 756 additions and 54 deletions

View File

@@ -0,0 +1,37 @@
# 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 交叉验证 |