host
cf9d17f035
仿 websearch MCP 播种，默认关： - cloud/skill_seed.py：cloud/skills/ 的 SKILL.md 拷进租户 codex-home/.agents/skills/（个人级技能路径，见模块 文档的路径依据与诚实边界）；幂等，租户改过的文件 绝不覆盖（上报 differs），缺包不阻塞任务。 - cloud/worker.py：新增 --seed-skills，_tenant_dirs 里 调用播种；老租户下一次任务自动合并；播种失败只记 日志、不阻塞任务（技能是可选流程说明）。 - cloud/tests/test_skill_seed_worker.py：播种助手 + worker 开关，仿 test_websearch_worker.py 的结构。 - docs/chatgpt-codex-alignment.md：补第二批说明与实测 待办（真实 Docker 任务 skills/list + $live-info 调用， 通过前不宣称生产任务已能用这些技能）。 验证：skill_seed + chatgpt skills + websearch worker 共 14 项全过。本批不改生产配置、不部署，autoscaler 加 --seed-skills 是部署时另行的主机步骤。
86 lines
6.5 KiB
Markdown
86 lines
6.5 KiB
Markdown
# codex-app-server 对齐 ChatGPT Codex：工具目录对照
|
||
|
||
来源：用户 2026-10-30 提供的 ChatGPT Codex 工具目录（ChatGPT Codex
|
||
在其自有 app 里的工具清单），对照对象是 codex-app-server 现生产
|
||
（main d4a517f，2026-10-29）与本分支第一批。
|
||
|
||
方向先说清：用户 2026-10-29 已定，往自动化编程任务平台方向
|
||
做生产级提升，不是个人 agent OS 方向。所以本对照只对齐
|
||
“编程任务平台”相关的能力，ChatGPT 托管专属能力不照搬，
|
||
见文末“不照搬”一节。
|
||
|
||
## 对照表
|
||
|
||
| ChatGPT Codex 能力 | codex-app-server 现状 | 结论 |
|
||
|---|---|---|
|
||
| 终端与文件：shell、读写工作区、看图片、apply_patch、看终端输出 | codex-core 工具 + worktree + 沙箱，host/cloud 已有 | 对齐 |
|
||
| 联网查询：网页搜索、打开网页、找页面内容 | websearch MCP（SearXNG / DuckDuckGo / Brave），生产 worker 带 `--websearch-mcp` 才播种 | 对齐（搜索本体） |
|
||
| 联网查询：天气、时区、股票、体育赛程 | 无专用垂类工具；本分支新增 `live-info` 技能，教 agent 用 web_search 查一级来源、带来源和快照时间，绝不编数字 | 第一批：技能对齐，工具未新增 |
|
||
| 图片生成：按描述生成、按已有图片编辑 | 无图片生成模型工具；查看/裁剪/缩放靠 PIL / ImageMagick（若装了）。本分支新增 `image-workflow` 技能，未配置生成工具时必须明说无法生成，绝不拿占位图顶替 | 第一批：流程对齐，生成能力仍缺工具 |
|
||
| 浏览器与界面操作（CUA）：读界面、开网页、操作标签页、桌面应用 | 无。README 已写：Computer Use 是另一条管线，不在 host / CLI 中间层 | 不照搬，见下 |
|
||
| 协作代理：启动代理、发任务、看进度、等结果 | host delegate、模型内子代理、云端协调员/子任务 | 对齐 |
|
||
| Codex 任务与工作区：列项目/任务、读任务记录、建/切 worktree、开文件或终端面板、管理标题、归档、附件 | projects / tasks / fork / archive / uploads 已有；任务文件读取在 PR #146（未合） | 对齐，文件端点待 #146 |
|
||
| 自动化：创建/查看/更新定时任务和提醒 | automations --add + run-due、云端自动化 | 对齐 |
|
||
| 文档工具：LaTeX 编译、Word / PDF / 表格 / 演示文稿 | 无一等工具，只能靠 shell 调系统里装好的工具。本分支新增 `document-tools` 技能：先核查 pandoc / latexmk / python-docx 等，缺了明说，产出后必须重读验证 | 第一批：技能对齐，工具未新增 |
|
||
| 连接的应用与服务：GitHub、文档会话、Sites 等，须安装/授权 | GitHub PR 链路、MCP / skills / 插件已有；ChatGPT 的 Docs / Sites 连接器目录没有 | 部分，不照搬连接器目录 |
|
||
| 专项能力：管理插件、技能 | skills/list、`.agents/skills`、MCP 已有；本分支在 `cloud/skills/` 新增 3 个技能包 | 部分，第一批补技能包 |
|
||
| 专项能力：ChatGPT 宠物 | 无，ChatGPT app 专属 | 不照搬 |
|
||
| 专项能力：AIMemory Runner 远程运维 | 2026-10-28 已停用全部 7 个 aimemory 容器，数据未删但不在活跃能力里 | 不照搬，现不活跃 |
|
||
|
||
## 第一批做了什么（本分支）
|
||
|
||
- `cloud/skills/live-info/SKILL.md`：天气/时区/股票/体育，
|
||
查一级来源、带来源和快照时间、不编数字。
|
||
- `cloud/skills/document-tools/SKILL.md`：LaTeX / Word / PDF /
|
||
表格 / 演示文稿，先核查工具、缺了明说、产出后重读验证。
|
||
- `cloud/skills/image-workflow/SKILL.md`：已有图片处理 +
|
||
生成工具已配置时才生成，未配置时明说、绝不顶替。
|
||
- `cloud/tests/test_chatgpt_codex_skills.py`：校验每个技能
|
||
都有 name + description、名字与目录一致、无密钥占位、
|
||
正文非空。技能本身不改 worker 行为，生产行为不变。
|
||
- 本分支不改 worker 播种、不改生产配置、不部署。把技能
|
||
播种进租户 codex-home（仿 websearch MCP 的播种方式）
|
||
是下一批，需要单独评审 worker 改动。
|
||
|
||
## 第二批：技能播种进租户（本分支新增）
|
||
|
||
- `cloud/skill_seed.py`：仿 websearch MCP 播种，把
|
||
`cloud/skills/` 的 SKILL.md 拷进租户
|
||
`codex-home/.agents/skills/<名>/SKILL.md`。路径依据：
|
||
Codex 个人技能在 `$HOME/.agents/skills`，项目技能在
|
||
`.agents/skills`（从工作目录向上扫到仓库根）；租户任务
|
||
绝不能往任务 worktree 里播种（会污染任务 diff），所以
|
||
用租户 codex-home 这个个人级类比位置——这也是
|
||
websearch MCP 播种用的通道。
|
||
- `cloud/worker.py`：新增 `--seed-skills`（默认关，仿
|
||
`--websearch-mcp`），只在 `_tenant_dirs` 里调用播种；
|
||
老租户下一次任务自动合并；租户改过的技能文件绝不
|
||
覆盖（只上报 differs）；播种失败只记日志、不阻塞任务
|
||
（技能是可选流程说明，不是已宣传就必须有的工具）。
|
||
- `cloud/tests/test_skill_seed_worker.py`：播种助手
|
||
（拷、幂等、缺包、租户改动不覆盖）+ worker 开关
|
||
（关 = 老行为、开 = 播真实包、老租户合并 + 改动存活）。
|
||
- 诚实边界：播种只保证文件落进租户 home、幂等、不覆盖
|
||
租户改动。某个 Codex 版本在 Docker 租户任务里是否真
|
||
从这个位置发现技能，仍需一次真实任务实测
|
||
（skills/list + 显式 `$live-info` 调用，仿 websearch
|
||
e2e 探针的做法），实测通过前不要宣称“生产任务已能用
|
||
这些技能”。本批不改生产配置、不部署，autoscaler 的
|
||
worker 参数里加 `--seed-skills` 是部署时另行应用的
|
||
主机步骤（unit 文件不在 deploy tar 里，仿 websearch）。
|
||
|
||
## 不照搬（诚实边界）
|
||
|
||
- CUA / 桌面操作：需要浏览器自动化 + 桌面操作基础设施，
|
||
不是加一个技能就能对齐的，且与“自动化编程任务平台”
|
||
方向不符；若用户另行立项，再单独评估 Playwright /
|
||
浏览器 MCP 路线。
|
||
- 图片生成模型：需要图片生成模型或 API 配置，codex-app-server
|
||
现用中转 chat 模型，没有图片生成工具；技能只能管“有工具
|
||
时怎么用、没工具时怎么明说”，不能凭空变出生成能力。
|
||
- ChatGPT 连接器目录（Docs / Sites 等）与宠物：ChatGPT
|
||
托管服务专属，需要 OAuth 与托管后端，不在开源宿主编排层
|
||
的范围里。
|
||
- AIMemory Runner：已停用，不为对齐而恢复；恢复需用户
|
||
另行定是否启用 docker 自启与数据清理。
|