Files
codex-app-server/docs/chatgpt-codex-alignment.md
T
host cf9d17f035 align: 第二批:把技能包播种进租户 codex-home
仿 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 是部署时另行的主机步骤。
2026-10-30 01:16:49 +08:00

6.5 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/.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 自启与数据清理。