Files
codex-app-server/docs/chatgpt-codex-alignment.md
T
host 378cddfb1e align: 修正技能播种路径:codex-home/skills/ 才是用户技能目录
2026-10-30 主机实测(临时 codex-home,生产未动)纠正:
先播 .agents/skills/ 时 skills/list 只返回 5 个系统技能,
3 个自有技能一个没出现;改播 skills/ 后返回 8 个,
3 个自有技能以 scope=user 出现。系统技能本身就在
skills/.system/ 下。
- skill_seed DEST_SUBDIR 由 .agents/skills 改为 skills,
  模块文档与 worker 注释同步修正。
- 测试期望路径同步改为 skills/。
- 对照表补实测结论与附带发现:Codex 自带系统技能
  imagegen,图片生成在 Codex 本体里不是无技能。

验证:skill_seed + chatgpt skills + websearch worker
共 14 项全过。主机探针文件已全部清理,生产未动。
2026-10-30 01:16:49 +08:00

6.8 KiB
Raw Blame History

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/skills/<名>/SKILL.md。路径是实测纠正过的: 2026-10-30 主机实测,临时 codex-home(生产未动)先播 .agents/skills/,skills/list 只返回 5 个系统技能、3 个 自有技能一个没出现;改播 skills/ 后返回 8 个,3 个自有 技能以 scope=user 出现。系统技能本身就在 skills/.system/ 下,这就是用户技能目录的证据。租户 任务绝不能往任务 worktree 里播种(会污染任务 diff), 所以用租户 codex-home——这也是 websearch MCP 播种用的 通道。附带发现:Codex 自带系统技能里已有 imagegen (生成/编辑位图),所以图片生成在 Codex 本体里不是 “无技能”,只是中转模型是否支持图片工具另待实测。
  • cloud/worker.py:新增 --seed-skills(默认关,仿 --websearch-mcp),只在 _tenant_dirs 里调用播种; 老租户下一次任务自动合并;租户改过的技能文件绝不 覆盖(只上报 differs);播种失败只记日志、不阻塞任务 (技能是可选流程说明,不是已宣传就必须有的工具)。
  • cloud/tests/test_skill_seed_worker.py:播种助手 (拷、幂等、缺包、租户改动不覆盖)+ worker 开关 (关 = 老行为、开 = 播真实包、老租户合并 + 改动存活)。
  • 诚实边界:发现已实测(skills/list,scope=user), 模型在真实 Docker 租户任务里是否真调用 $live-info 并返回结果仍未实测——那需要带 --seed-skills 的 worker(部署或临时 worker,另等用户定),不是本批 能宣称的。本批不改生产配置、不部署,autoscaler 的 worker 参数里加 --seed-skills 是部署时另行应用的 主机步骤(unit 文件不在 deploy tar 里,仿 websearch)。

不照搬(诚实边界)

  • CUA / 桌面操作:需要浏览器自动化 + 桌面操作基础设施, 不是加一个技能就能对齐的,且与“自动化编程任务平台” 方向不符;若用户另行立项,再单独评估 Playwright / 浏览器 MCP 路线。
  • 图片生成模型:需要图片生成模型或 API 配置,codex-app-server 现用中转 chat 模型,没有图片生成工具;技能只能管“有工具 时怎么用、没工具时怎么明说”,不能凭空变出生成能力。
  • ChatGPT 连接器目录(Docs / Sites 等)与宠物:ChatGPT 托管服务专属,需要 OAuth 与托管后端,不在开源宿主编排层 的范围里。
  • AIMemory Runner:已停用,不为对齐而恢复;恢复需用户 另行定是否启用 docker 自启与数据清理。