Codex 的输入 Token 都花在哪了？
utils
本文字数：24.4k 字 | 阅读时长 ≈ 131 min
原创

Codex 的输入 Token 都花在哪了？

utils
本文字数：24.4k 字 | 阅读时长 ≈ 131 min

原创

用户在输入框里写下的内容，只是 Codex 发给模型的请求的一部分。为了让模型知道该遵守什么规则、能使用哪些工具、正在什么环境里工作，Codex 还会附带相应的说明。这些内容也会占用输入 Token。

所以，即使只输入一句 hello，请求也可能很长。要理解这些 Token 花在哪里，需要拆开模型实际收到的内容。

一次请求里有什么

以首轮请求为例，可以把输入理解为下面几部分：

用户输入 hello
  + 工作规范：应该怎样完成任务
  + Skill 目录：有哪些可用的工作流程
  + 工具定义：能调用什么、需要传哪些参数
  + 环境与运行说明：在哪里工作、有哪些权限
          ↓
Codex 装配请求，交给模型

本文把首次请求前装配的这些额外内容称为“预加载”。它们承担不同的作用，不能只根据用户输入的长度来估计整次请求的大小。

1. 工作规范 AGENTS.md：告诉模型怎样做事

这部分包括客户端提供的基础指令，以及用户和项目提供的 AGENTS.md 等规范。例如，回答使用什么语言、修改代码后运行哪些检查、哪些文件不能改，都可能写在这里。AGENTS.md 会按全局与项目范围加载，具体机制见 OpenAI 官方 AGENTS.md 文档。

2. Skill 目录：告诉模型有哪些工作流程

Skill 可以理解为工作流手册。Codex 先看到 Skill 的名称、描述和路径，选中某个 Skill 后再读取完整的 SKILL.md。例如，写博客时可能读取写作 Skill 的正文，其他 Skill 仍只出现在目录里。这种按需加载方式见 OpenAI 官方 Skill 文档。

例如，假设项目里有一个最简单的笔记总结 Skill，文件位于 .agents/skills/summarize-note/SKILL.md：

---
name: summarize-note
description: 将笔记整理成三条要点，适用于用户要求总结笔记时。
---

阅读用户提供的笔记，提取三条主要观点。
每条用一句话表达，不补充笔记中没有的信息。

当这个 Skill 被列入初始目录时，模型先看到的是下面这些信息。这里用简化格式展示：

名称：summarize-note
描述：将笔记整理成三条要点，适用于用户要求总结笔记时。
路径：.agents/skills/summarize-note/SKILL.md

此时，文件正文里的“提取三条主要观点”等执行步骤还没有被读取。如果用户说“用 summarize-note 帮我总结这段笔记”，Codex 选中该 Skill 后才读取完整文件，正文也随之进入上下文。也就是说，目录信息先占用 Token，手册内容在使用时再增加输入。

3. 工具定义：告诉模型如何调用工具

模型要调用工具，就需要知道工具的名称、用途和参数。以一个虚构的文档读取工具为例，至少要说明：

工具名称：read_document
用途：根据文档 ID 读取正文
参数：document_id，字符串，必填

工具既可能来自 Codex 的 Shell、文件操作等运行能力，也可能来自 Apps、连接器或 MCP 服务。一个插件还可以同时提供 Skill 和工具连接，所以它既可能增加 Skill 目录，也可能增加工具定义。

4. 环境与运行说明：告诉模型在哪里工作

工作目录、Shell、日期、时区、文件访问范围和审批规则等信息，也会出现在请求中。比如，模型需要知道文件路径相对于哪个目录，以及哪些操作需要额外权限。

一个请求样本中的来源分布

下面用一份保存的 hello 请求快照说明各部分的体积。样本包含 90 个 Apps 工具接口和 182 项 Skill 目录；具体采集条件放在附录 E。这里的数值只用于展示来源分布，不代表每位用户的启动开销。

分项使用 o200k_base 分词器，对文字和紧凑序列化后的工具 JSON 做本地计数。估算合计 59,931 Token，下表的占比都以它为分母。

内容块 估算 Token 占估算总量 来源
Apps 工具定义 32,317 53.92% Apps／连接器提供，由 Codex 装配的接口名称、说明和参数结构
Skill 目录块 16,499 27.53% 本地、内置及插件 Skill 的名称、描述、路径，以及目录配套说明
本地／运行时工具定义 4,330 7.22% Codex 的 Shell、文件操作、子代理、Goal 等接口
AGENTS.md 3,413 5.69% 用户提供的长期工作规范
权限与审批说明 2,596 4.33% Codex 根据运行权限与审批配置生成的文字
环境上下文 336 0.56% 工作目录、Shell、日期、时区及文件系统环境
协作模式说明 250 0.42% Codex 当前协作方式的说明
Apps 使用说明 146 0.24% 宿主提供的连接器使用说明
基础指令字段 42 0.07% 这个样本中捕获到的基础指令字段
用户输入 1 <0.01% 用户实际输入的 hello
工具数组编码边界差 1 <0.01% 分块编码与整个工具数组编码的连接处差额
合计 59,931 100.00% 同一离线估算口径

这个样本中，用户的 hello 只有 1 个估算 Token，而 Apps 工具定义和 Skill 目录合计占 81.45%。输入较大的原因，是请求中装配了较多的接口说明和工作流程目录。

182 项 Skill 中，114 项来自用户安装的本地 Skill，4 项来自系统内置 Skill，64 项来自插件包。

为什么工具定义会这么长

一个应用通常会提供多个接口。例如，文档应用可能分别提供查找、读取、创建和修改接口，每个接口都需要自己的说明和参数结构。所以，插件数量、接口数量和 Token 数是三个不同的指标。

下面拆分样本中的 90 个 Apps 接口。“占 Apps”以 32,317 为分母，“占总量”以 59,931 为分母。

工具组 接口数 估算 Token 占 Apps 占总量
Pages 38 15,989 49.48% 26.68%
Sites 25 8,265 25.57% 13.79%
Search Service 1 2,571 7.96% 4.29%
Plugin Management 6 2,089 6.46% 3.49%
Pets 11 1,637 5.07% 2.73%
Codex Document Control 3 867 2.68% 1.45%
Safety Settings 5 761 2.35% 1.27%
Hotline 1 138 0.43% 0.23%

Pages 在这里指 ChatGPT 云端页面和空间相关接口。它与 Sites 共提供 63 个接口，定义合计 24,254 个估算 Token，占 Apps 定义的 75.05%。接口的描述越长、参数结构越复杂，定义本身就越大；接口数量相同，Token 数也未必相同。

继续执行任务时，还会增加哪些输入

首轮装配的内容之外，后续请求还可能包含保留的对话历史、读取到的文件、工具返回的日志和搜索结果等。模型先前生成的回复，在后续调用中也可能作为历史上下文成为输入。OpenAI 会话状态文档

例如，让 Codex 修改一篇博客，它可能先读取文章，再根据文章修改，最后查看检查结果。用户只发出了一条任务消息，但这些步骤会带来多次模型调用，读取到的文章和检查结果也会进入后续请求。理解用量时，需要区分“某一次请求的输入量”和“整个任务多次调用累计的输入量”。

长会话还可能对历史做截断或压缩，所以不能简单把所有历次文字相加。当输入 Token 较多时，可以沿着这些来源检查：是规则和目录较长、工具定义较多，还是任务过程中积累了大量文件和工具结果。

附录：分项与原始材料

下面保留分项统计、Skill 索引、接口结构和计数示例，较长的内容可按需展开。hello 和用户 AGENTS.md 保留原文；环境信息、Skill 路径经过脱敏；工具定义只保留结构；其他启动指令只提供功能摘要。这些材料主要帮助理解计数方法。

A：完整分项统计

下面列出 8 个文字块和 22 个工具定义块，编码边界差另计 1 Token。表中的“结构摘录”统一指保留接口名和参数结构，省略描述、示例和内部使用说明。

统计块 类别 原块估算 Token 可公开内容及其范围
基础指令 文字 42 摘要：编码助手角色和基本行为；不逐字导出内部指令
Skill 发现目录 文字 16,499 结构摘录：含 182 项名称与路径；未导出描述及内部使用说明
权限与审批说明 文字 2,596 摘要：运行边界、权限配置及审批机制；不逐字导出内部指令
协作模式说明 文字 250 摘要：协作行为和交互方式；不逐字导出内部指令
Apps 使用说明 文字 146 摘要：连接器使用方式；不逐字导出内部指令
AGENTS.md 文字 3,413 原文：与被统计的历史消息逐字一致；不是当前 AGENTS.md 文件的重新读取
环境上下文 文字 336 路径脱敏原文：保留其余环境字段；私人目录改为通用目录，原 Token 数不适用于替换后文本
用户消息 文字 1 原文：内容恰好为 hello，无额外换行
exec_command 本地／运行时工具定义 342 结构摘录
write_stdin 本地／运行时工具定义 167 结构摘录
list_mcp_resources 本地／运行时工具定义 122 结构摘录
list_mcp_resource_templates 本地／运行时工具定义 133 结构摘录
read_mcp_resource 本地／运行时工具定义 114 结构摘录
request_user_input 本地／运行时工具定义 287 结构摘录
request_plugin_install 本地／运行时工具定义 222 结构摘录
apply_patch 本地／运行时工具定义 252 结构摘录
view_image 本地／运行时工具定义 108 结构摘录
multi_agent_v1 本地／运行时工具定义 1,926 结构摘录
mcp__codex_apps__chatgpt_space Apps 工具定义 15,989 结构摘录
mcp__codex_apps__codex_document_control Apps 工具定义 867 结构摘录
mcp__codex_apps__hotline Apps 工具定义 138 结构摘录
mcp__codex_apps__pets Apps 工具定义 1,637 结构摘录
mcp__codex_apps__plugin_management Apps 工具定义 2,089 结构摘录
mcp__codex_apps__safety_settings Apps 工具定义 761 结构摘录
mcp__codex_apps__search_service Apps 工具定义 2,571 结构摘录
mcp__codex_apps__sites Apps 工具定义 8,265 结构摘录
get_goal 本地／运行时工具定义 58 结构摘录
create_goal 本地／运行时工具定义 149 结构摘录
update_goal 本地／运行时工具定义 438 结构摘录
web_search 本地／运行时工具定义 12 客户端捕获到的原生工具声明；被计入离线估算不代表它一定会在模型服务端执行

B：用户文字与环境内容

B.1 hello 原文

被计数的字符串只有 5 个字符 hello，不含代码围栏和展示换行，对应 1 个估算 Token。

hello

B.2 用户 AGENTS.md 原文

下面保留该样本的用户规范及包装标签。原字符串为 5,661 个字符、13,595 个 UTF-8 字节，本地估算 3,413 Token。

展开用户 AGENTS.md 原文 
# AGENTS.md instructions

<INSTRUCTIONS>
# 智能体工作规范

本文件统一维护智能体执行任务时的工作规范，按任务类型分节。目前包含回答、实验与模型迭代总结、Skill 编写与维护、Worker 使用规范。

## 适用范围与规范导航

- 执行任务时，只应用与当前任务相关的规范；同一任务涉及多个类型时，组合应用对应规范。
- Skill 规范仅用于新增、修改或整理 Skill；单纯调用已有 Skill 或处理其他项目时，不要求采用 Skill 目录结构。
- 本文件作为全局默认规范使用；项目或子目录有更具体的 `AGENTS.md` 时，按其适用范围执行，冲突处以更具体的项目规范为准。所有规范均须遵守系统、开发者和当前用户指令。

| 规范 | 适用任务 |
| --- | --- |
| 回答规范 | 所有任务的理解、执行和结果汇报 |
| 实验与模型迭代总结规范 | 训练、评测、方案实验或迭代优化目标的记录与总结 |
| Skill 编写与维护规范 | 新增、修改、整理可复用 Skill 及其资源 |
| Worker 使用规范 | Worker 选择、任务运行、资源使用与结果回收 |

## 回答规范

### 核心目标

让我用尽量少的阅读，获得足以理解和行动的完整答案。
先保证准确、回应完整，再压缩表达。以下为默认偏好，我当次明确的任务范围、格式和详略要求优先。

### 理解任务

- 结合可见上下文，弄清我最终要判断什么、已经知道什么、提出了哪些子问题，以及有哪些约束。自行核对，不必输出一份计划。
- 完整汇报时，覆盖当前任务中仍有效的全部问题，逐项给出答案或明确缺口；单点追问时，只补当前缺口，必要时更新原结论，不重复已讲清的内容。
- 把分散在前文的信息联系起来，补上理解结论所必需的环节。补充内容应直接影响当前判断，避免扩展无关背景和新任务。
- 信息不足时，先利用已有上下文和可用工具补齐；只有无法自行确定、且需要我决定的目标、授权范围或显著成本取舍才询问。其余采用合理假设继续推进，必要时简短说明。

### 执行实验与修改

- 围绕当前问题、对照和已有成功标准开展实验；没有明确标准时，报告实际差异，不自行设定达标门槛。比较结果时核对数据、指标和测试条件是否可比。
- 在已有授权范围内完成必要验证。以原问题获得有证据的回答为完成标准；证据不足时给出有边界的结论，并指出最关键的缺口。
- 当前任务要求的交付和必要验证均完成后停止。额外实验只用于解决影响当前判断的具体疑问，避免扩大任务。

### 汇报结果

- 开头用 1–3 句直接回答原问题：得到了什么结论，对当前判断或选择意味着什么。无法判断时，也要直接说清。
- 补足理解结论所必需的证据与限制；有依据且有助理解时解释原因，需要作出选择时给出建议。不为填满固定栏目增加内容。
- 数字要解释含义：必要时给出基线、当前值和变化；比例说清分母，区分百分比与百分点。多个方案用同一口径的小表格比较。
- 实验设置只保留影响结论可信度和适用范围的条件。详细配置、完整日志和中间过程需要保留时放入文件，正文仍应独立回答问题。
- 区分实际测得的结果、原因推测和未验证事项。没有验证原因时不能写成定论；样本通过不能扩大成所有情况成立。
- 给建议时说明当前最值得采取的做法及依据。若关键证据不足，指出什么证据会改变判断，不罗列一长串可能方向。

### 按任务调整表达

- 技术解释：针对我的卡点，用最小输入输出例子、简单公式或几行代码讲清楚；图确实有帮助时放在对应解释旁。追问时承接已有认识。
- 代码或方案修改：说明实际行为如何变化、原问题是否解决、有什么验证依据，以及影响使用的遗留问题。交付内容应能直接使用。
- 默认中文，用短段落和具体词语。简单问题通常 1–3 句，复杂问题写到必要判断完整，不为凑字数删掉关键条件。
- 省略客套、题目复述、重复总结、执行流水账和不影响判断的术语；不机械套模板，不在结尾习惯性追加“如果需要，我还可以……”。

### 发出前检查

我关心的每块“知识拼图”，是否都有答案或明确缺口？
我看完后，能否知道结果说明了什么、依据是什么，以及它如何影响当前判断？
删除不服务于这些问题的内容。

## 实验与模型迭代总结规范

### 适用范围与完成标准

- 执行训练、评测、方案实验或迭代优化时，随过程保留必要记录；一个明确目标完成、阶段结束或决定停止时，主动生成或更新总结。普通问答、局部排错和中间运行不单独生成报告；我有明确要求时按要求交付。
- 总结应让我独立判断：原问题得到什么回答、哪些改动有效、证据和限制是什么、当前该采用什么方案或补什么关键证据。明确目标已达成、部分达成、未达成或受阻；训练结束、程序运行成功或文档写完均不能代替目标达成。没有约定达标条件时，只报告观察到的变化。
- 同一目标维护一份主文档，持续更新当前结论，保留影响决策的关键迭代和未解决问题。新证据推翻旧判断时说明变化及依据，避免多份报告各说各话。沿用项目已有的文档形式和位置；未指定时使用项目内的 Markdown 文档。

### 记录与比较

- 实验前从已有上下文确定待回答的问题、基线、关键改动和判断依据；用足以区分方案的简短记录保存。已有验收条件时沿用，不自行增加指标门槛或扩大实验范围。
- 为需要比较的实验使用稳定标识，按需关联代码版本、模型或 checkpoint、数据版本及划分、关键配置、随机种子、运行命令和结果位置。过程中记录，详细复现信息放附录或配置文件；缺失信息如实标明。
- 训练和调参沿用约定的数据划分，在训练集或验证集上完成相应优化；已有独立测试集时留作最终评价，缺少时说明限制，不为补齐文档自行重划数据或追加评测。测试集若已参与模型、阈值或提示词选择，明确说明其不再提供独立终评证据。记录最终模型或 checkpoint 的选择依据。
- 比较时使用一致的评测口径；数据、计算预算或其他条件不同且影响判断时说明差异，不直接归因于某一改动。已有多次运行时报告次数和波动，不只挑最好一次；只有单次时如实标明，不为补齐报告形式而追加运行。

### 按判断组织正文

- 开头先给当前结论、目标状态及对选择的影响，再展开关键证据。按问题和决策组织内容，执行时间线只保留能解释方案演变的节点；无需固定章节或填充空栏目。
- 多轮或多方案实验优先用一张总览表，按需列出基线与改动、关键结果及变化、相关代价、当前取舍和证据入口。共同设置集中说明，每轮只补差异；避免逐项复制完整实验配置。
- 每个关键实验讲清楚：为什么做、实际改了什么、结果怎样、据此能判断什么。结果表之后立即解释对原问题的意义。保留影响判断的失败和退化结果；有样本级结果时，必要地拆开新增收益与原有退化，解释净变化。
- 指标、术语或公式在首次需要时就地解释其在本实验中的含义。复杂关系尽量沿用同一组具体输入与输出，把例子、数字和解释接起来；公式和代码仅在帮助理解关键差异时加入。
- 区分实测结果、人工核实、模型评审和原因推测。模型评审注明样本范围与判定方式；抽样观察不直接外推整体。多个因素同时变化时，不把总体收益归因给其中某一个因素。

### 图、案例与 HTML

- 图放在对应判断附近，并说明读者应看哪里、它支持什么结论。结构关系用简图，数值差异用数据图，输出质量用真实案例；根据需要选择，不要求每份报告都齐全。用于飞书的结构图优先保持可编辑，并保留图源。
- 案例尽量对齐同一输入的基线结果与新结果，标注方案、样本标识和关键差异；按问题呈现有解释价值的成功、失败或退化案例，并交代选取方式。截图保留必要上下文；示意数据与实测数据明确区分。
- 多轮实验、多方案或较多样例需要导航与比较时，按需提供 HTML 总览。与主文档共用同一份结果数据，展示当前结论、方案比较及详情入口；根据实际需要提供跳转、筛选或图片放大。正文仍须独立回答问题，不把结论只放在交互页面里。

### 交付前检查

- 核对结论、表格、图注和产物版本一致，主文档入口明确，关键链接和图片可用；有 HTML 时实际检查其主要交互。复现入口应能定位关键配置、命令和产物，无法验证的部分明确标注。
- 最终回复给出当前结论、关键依据、文档和必要产物入口，以及影响当前决策的剩余问题。文档长短以判断完整为准。

## Skill 编写与维护规范

### 目录结构

以下 `<skills-root>` 表示当前环境实际加载的 Skill 根目录。按本规范统一维护 `SKILL.md` 和 `agents/openai.yaml`；只有真正需要时才添加 `scripts/`、`references/`、`assets/`。

```text
<skills-root>/<skill-name>/
├── SKILL.md
└── agents/
    └── openai.yaml
```

### 写 Skill 的原则

1. 一个 skill 只解决一个明确任务或完整工作流。多个步骤服务于同一目标时可以放在一起，否则拆分。例如，下载模型和生成图片通常应拆成两个 skill；如果目标是完成“生成图片并发布预览页”的固定流程，生成、上传和发布可以写在同一个 skill 中。

2. `SKILL.md` 写成简短、可执行的操作手册，只保留作用、核心步骤、常用命令和完成检查。例如，能用“输入是什么、执行什么命令、如何确认完成”三步讲清楚时，不要再补充大段背景说明。

3. skill 应自包含、通用、可迁移。所需脚本放入 `scripts/`；路径和参数优先使用占位符或环境变量，不写机器专属路径和单次任务配置。例如，不要直接引用当前服务器上的 `/mnt/.../tool.py`；应把可复用脚本放进当前 skill 的 `scripts/`，在调用前将 `SKILL_DIR` 设置为当前 Skill 的实际根目录，再通过 `"$SKILL_DIR/scripts/tool.py"` 调用。单次任务参数在调用时传入。默认不要写入真实密钥；如果 skill 仅供用户本人使用且用户明确要求，可以把必需的密钥写入 skill，但不要公开或共享。

4. `description` 应说明 skill 的能力、触发场景和边界，不写单次任务信息；在 `SKILL.md` 中写明完成检查。例如，写“下载 Hugging Face 模型或数据集，用户要求下载或校验仓库时使用”，不要写“下载本次任务指定的 Qwen 模型到某个服务器目录”。

### 新增 Skill 流程

1. 确认 Skill 根目录并创建基础目录；先替换占位值再执行：

   ```bash
   SKILLS_ROOT="<skills-root>"
   SKILL_NAME="<skill-name>"
   SKILL_DIR="$SKILLS_ROOT/$SKILL_NAME"
   mkdir -p "$SKILL_DIR/agents"
   ```

2. 编写 `SKILL.md`：

   ```markdown
   ---
   name: <skill-name>
   description: "<能力 + 触发场景 + 边界>"
   ---

   # <Skill Title>

   <按需写核心步骤、常用命令和完成检查>
   ```

   不要为了套模板强制添加“参数”“快速命令”等无实际内容的章节。

3. 写 `agents/openai.yaml`：

   ```yaml
   interface:
     display_name: "<Readable Name>"
     short_description: "<25-64 chars>"
     default_prompt: "Use $<skill-name> to <do the task>."
   ```

   添加资源文件时，可复用脚本放入 `scripts/`，并用最小有效输入实际运行验证；需要执行权限时使用：

   ```bash
   chmod +x "$SKILL_DIR/scripts/<script>"
   ```

   `agents/openai.yaml` 必须与 `SKILL.md` 保持一致。

4. 完成检查：确认当前环境能发现该 Skill、目录名与 `name` 一致、命令和脚本可执行、`agents/openai.yaml` 与 `SKILL.md` 一致，并清理占位文件、缓存和其他无关产物。

## Worker 使用规范

- 仅在任务需要 GPU 或大量 CPU/内存资源时，运行 `mlx worker list` 查询可用 worker；普通问答、文档编辑和轻量代码检查在当前环境完成。
- 选择资源和运行环境满足任务要求的可用 worker，使用 `mlx worker login <id>` 登录，并在该 worker 内执行重型工作。
- 仅在任务可独立拆分、输出确定且结果可合并时，按需使用多个 worker 并行执行，优先缩短完成时间；有前后依赖的步骤顺序执行。
- 没有合适 worker 时，先评估本地 devbox 的 CPU/内存是否足以完成任务，资源足够才回退到本地；资源不足时，保留已完成结果并说明具体缺口，不直接启动预计会 OOM 的任务。
- 任务完成前，确认运行状态、关键结果和产物位置，并回收后续使用所需的结果。
</INSTRUCTIONS>

B.3 环境信息：仅路径脱敏

原环境字符串为 1,042 个字符，本地估算 336 Token。下面将私人工作目录替换为 /workspace/project，其余字段保留；替换后的文本不再对应原来的计数。

<environment_context>
  <cwd>/workspace/project</cwd>
  <shell>bash</shell>
  <current_date>2026-10-24</current_date>
  <timezone>Etc/UTC</timezone>
  <filesystem><workspace_roots><root>/workspace/project</root></workspace_roots><permission_profile type="managed"><file_system type="restricted"><entry access="read"><special>:root</special></entry><entry access="write"><path>/workspace/project</path></entry><entry access="write"><special>:slash_tmp</special></entry><entry access="write"><special>:tmpdir</special></entry><entry access="read"><path>/workspace/project/.git</path></entry><entry access="read"><path>/workspace/project/.agents</path></entry><entry access="read"><path>/workspace/project/.codex</path></entry><entry access="read"><path>/workspace/project/.aws</path></entry></file_system></permission_profile></filesystem>
</environment_context>

B.4 内部启动说明的功能摘要

下面概括各类启动说明的作用。

原块 估算 Token 功能摘要
基础指令字段 42 说明编码助手的角色与基本行为
权限与审批说明 2,596 说明运行权限、文件访问边界和审批机制
协作模式说明 250 说明当前协作方式和交互规则
Apps 使用说明 146 说明连接器的使用方式

C：182 项 Skill 索引

这份索引来自样本中的首轮文字，共有 182 项 Skill。下表仅列出名称和脱敏路径，原目录块中的描述及配套说明未展开。

路径使用以下通用根目录：USER_SKILLS 表示用户 Skill 根目录，SYSTEM_SKILLS 表示系统内置根目录，PLUGIN_CACHE 表示插件缓存根目录。原来以不透明 app ID 标识的一个包统一替换为 plugin-a；保留相对路径结构，便于看出来源。

展开 182 项 Skill 索引
序号 Skill 名称 来源路径（已脱敏）
1 imagegen SYSTEM_SKILLS/imagegen/SKILL.md
2 openai-docs SYSTEM_SKILLS/openai-docs/SKILL.md
3 skill-creator SYSTEM_SKILLS/skill-creator/SKILL.md
4 skill-installer SYSTEM_SKILLS/skill-installer/SKILL.md
5 academic-plotting USER_SKILLS/academic-plotting/SKILL.md
6 plugin-a:agent-simplification PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/agent-simplification/SKILL.md
7 plugin-a:agents PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/agents/SKILL.md
8 plugin-a:agents-platform PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/agents-platform/SKILL.md
9 plugin-a:architect-agent-memory PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-agent-memory/SKILL.md
10 plugin-a:architect-branches-versions-merge PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-branches-versions-merge/SKILL.md
11 plugin-a:architect-create-client-tool PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-create-client-tool/SKILL.md
12 plugin-a:architect-create-llm-test PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-create-llm-test/SKILL.md
13 plugin-a:architect-create-simulation-test PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-create-simulation-test/SKILL.md
14 plugin-a:architect-create-tool-test PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-create-tool-test/SKILL.md
15 plugin-a:architect-create-webhook-tool PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-create-webhook-tool/SKILL.md
16 plugin-a:architect-edit-existing-tool PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-edit-existing-tool/SKILL.md
17 plugin-a:architect-edit-string-fields PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-edit-string-fields/SKILL.md
18 plugin-a:architect-edit-workflows PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-edit-workflows/SKILL.md
19 plugin-a:architect-explain-test-runs PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-explain-test-runs/SKILL.md
20 plugin-a:architect-explore-agent PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-explore-agent/SKILL.md
21 plugin-a:architect-generate-agent PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-generate-agent/SKILL.md
22 plugin-a:architect-get-agent-ci-green PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-get-agent-ci-green/SKILL.md
23 plugin-a:architect-llm-selection PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-llm-selection/SKILL.md
24 plugin-a:architect-manage-procedures PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-manage-procedures/SKILL.md
25 plugin-a:architect-migrate-from-competitor PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-migrate-from-competitor/SKILL.md
26 plugin-a:architect-migrate-to-procedures PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-migrate-to-procedures/SKILL.md
27 plugin-a:architect-mock-all-tools PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-mock-all-tools/SKILL.md
28 plugin-a:architect-post-call-data PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-post-call-data/SKILL.md
29 plugin-a:architect-review-live-calls PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-review-live-calls/SKILL.md
30 plugin-a:architect-schedule-launch PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-schedule-launch/SKILL.md
31 plugin-a:architect-secure-for-production PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-secure-for-production/SKILL.md
32 plugin-a:architect-structured-procedures PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-structured-procedures/SKILL.md
33 plugin-a:architect-troubleshoot-tool-errors PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-troubleshoot-tool-errors/SKILL.md
34 plugin-a:architect-turn-taking-latency PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-turn-taking-latency/SKILL.md
35 plugin-a:architect-update-config-safely PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/architect-update-config-safely/SKILL.md
36 plugin-a:code-tools PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/code-tools/SKILL.md
37 plugin-a:creative-studio PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/creative-studio/SKILL.md
38 plugin-a:dubbing PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/dubbing/SKILL.md
39 plugin-a:fix-agent-qa-ticket PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/fix-agent-qa-ticket/SKILL.md
40 plugin-a:music PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/music/SKILL.md
41 plugin-a:setup-api-key PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/setup-api-key/SKILL.md
42 plugin-a:sound-effects PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/sound-effects/SKILL.md
43 plugin-a:speech-engine PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/speech-engine/SKILL.md
44 plugin-a:speech-to-text PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/speech-to-text/SKILL.md
45 plugin-a:text-to-speech PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/text-to-speech/SKILL.md
46 plugin-a:voice-changer PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/voice-changer/SKILL.md
47 plugin-a:voice-isolator PLUGIN_CACHE/openai-curated-remote/plugin-a/1.0.0/skills/voice-isolator/SKILL.md
48 ark-vlm-call USER_SKILLS/ark-vlm-call/SKILL.md
49 audiocraft-audio-generation USER_SKILLS/audiocraft/SKILL.md
50 autogpt-agents USER_SKILLS/autogpt/SKILL.md
51 autoresearch USER_SKILLS/0-autoresearch-skill/SKILL.md
52 awq-quantization USER_SKILLS/awq/SKILL.md
53 axolotl USER_SKILLS/axolotl/SKILL.md
54 blip-2-vision-language USER_SKILLS/blip-2/SKILL.md
55 brainstorming-research-ideas USER_SKILLS/brainstorming-research-ideas/SKILL.md
56 chroma USER_SKILLS/chroma/SKILL.md
57 clip USER_SKILLS/clip/SKILL.md
58 constitutional-ai USER_SKILLS/constitutional-ai/SKILL.md
59 creative-thinking-for-research USER_SKILLS/creative-thinking-for-research/SKILL.md
60 crewai-multi-agent USER_SKILLS/crewai/SKILL.md
61 cv-method-grid-search USER_SKILLS/cv-method-grid-search/SKILL.md
62 deepspeed USER_SKILLS/deepspeed/SKILL.md
63 devbox-tool-setup USER_SKILLS/devbox-tool-setup/SKILL.md
64 devbox-trouble-runbook USER_SKILLS/devbox-trouble-runbook/SKILL.md
65 distributed-llm-pretraining-torchtitan USER_SKILLS/torchtitan/SKILL.md
66 douyin-down-huggingface USER_SKILLS/douyin-down-huggingface/SKILL.md
67 douyin-face-process USER_SKILLS/douyin-face-process/SKILL.md
68 douyin-frame-vlm-judge USER_SKILLS/douyin-frame-vlm-judge/SKILL.md
69 douyin-guldan-frame USER_SKILLS/douyin-guldan-frame/SKILL.md
70 douyin-hive-table USER_SKILLS/douyin-hive-table/SKILL.md
71 douyin-ip-hive-mining USER_SKILLS/douyin-ip-hive-mining/SKILL.md
72 douyin-ppl-ai USER_SKILLS/douyin-ppl-ai/SKILL.md
73 douyin-seedream-gen USER_SKILLS/douyin-seedream-gen/SKILL.md
74 douyin-tos-gallery USER_SKILLS/douyin-tos-gallery/SKILL.md
75 douyin-tosutil USER_SKILLS/douyin-tosutil/SKILL.md
76 dspy USER_SKILLS/dspy/SKILL.md
77 evaluating-code-models USER_SKILLS/bigcode-evaluation-harness/SKILL.md
78 evaluating-cosmos-policy USER_SKILLS/cosmos-policy/SKILL.md
79 evaluating-llms-harness USER_SKILLS/lm-evaluation-harness/SKILL.md
80 evolving-ai-agents USER_SKILLS/a-evolve/SKILL.md
81 experiment-tracking-swanlab USER_SKILLS/swanlab/SKILL.md
82 faiss USER_SKILLS/faiss/SKILL.md
83 feishu-doc-io USER_SKILLS/feishu-doc-io/SKILL.md
84 fine-tuning-openvla-oft USER_SKILLS/openvla-oft/SKILL.md
85 fine-tuning-serving-openpi USER_SKILLS/openpi/SKILL.md
86 fine-tuning-with-trl USER_SKILLS/trl-fine-tuning/SKILL.md
87 gguf-quantization USER_SKILLS/gguf/SKILL.md
88 google-drive:google-docs PLUGIN_CACHE/openai-curated-remote/google-drive/0.1.22/skills/google-docs/SKILL.md
89 google-drive:google-drive PLUGIN_CACHE/openai-curated-remote/google-drive/0.1.22/skills/google-drive/SKILL.md
90 google-drive:google-drive-comments PLUGIN_CACHE/openai-curated-remote/google-drive/0.1.22/skills/google-drive-comments/SKILL.md
91 google-drive:google-sheets PLUGIN_CACHE/openai-curated-remote/google-drive/0.1.22/skills/google-sheets/SKILL.md
92 google-drive:google-slides PLUGIN_CACHE/openai-curated-remote/google-drive/0.1.22/skills/google-slides/SKILL.md
93 gptq USER_SKILLS/gptq/SKILL.md
94 grpo-rl-training USER_SKILLS/grpo-rl-training/SKILL.md
95 guidance USER_SKILLS/guidance/SKILL.md
96 hqq-quantization USER_SKILLS/hqq/SKILL.md
97 huggingface-accelerate USER_SKILLS/accelerate/SKILL.md
98 huggingface-tokenizers USER_SKILLS/huggingface-tokenizers/SKILL.md
99 implementing-llms-litgpt USER_SKILLS/litgpt/SKILL.md
100 instructor USER_SKILLS/instructor/SKILL.md
101 ip-binary-train USER_SKILLS/ip-binary-train/SKILL.md
102 knowledge-distillation USER_SKILLS/knowledge-distillation/SKILL.md
103 lambda-labs-gpu-cloud USER_SKILLS/lambda-labs/SKILL.md
104 langchain USER_SKILLS/langchain/SKILL.md
105 langsmith-observability USER_SKILLS/langsmith/SKILL.md
106 llama-cpp USER_SKILLS/llama-cpp/SKILL.md
107 llama-factory USER_SKILLS/llama-factory/SKILL.md
108 llamaguard USER_SKILLS/llamaguard/SKILL.md
109 llamaindex USER_SKILLS/llamaindex/SKILL.md
110 llava USER_SKILLS/llava/SKILL.md
111 long-context USER_SKILLS/long-context/SKILL.md
112 mamba-architecture USER_SKILLS/mamba/SKILL.md
113 miles-rl-training USER_SKILLS/miles/SKILL.md
114 ml-paper-writing USER_SKILLS/ml-paper-writing/SKILL.md
115 ml-training-recipes USER_SKILLS/ml-training-recipes/SKILL.md
116 mlflow USER_SKILLS/mlflow/SKILL.md
117 modal-serverless-gpu USER_SKILLS/modal/SKILL.md
118 model-merging USER_SKILLS/model-merging/SKILL.md
119 model-pruning USER_SKILLS/model-pruning/SKILL.md
120 moe-training USER_SKILLS/moe-training/SKILL.md
121 nanogpt USER_SKILLS/nanogpt/SKILL.md
122 nemo-curator USER_SKILLS/nemo-curator/SKILL.md
123 nemo-evaluator-sdk USER_SKILLS/nemo-evaluator/SKILL.md
124 nemo-guardrails USER_SKILLS/nemo-guardrails/SKILL.md
125 nnsight-remote-interpretability USER_SKILLS/nnsight/SKILL.md
126 notion:notion-database-designer PLUGIN_CACHE/openai-curated-remote/notion/3.0.2/skills/notion-database-designer/SKILL.md
127 notion:notion-meeting-intelligence PLUGIN_CACHE/openai-curated-remote/notion/3.0.2/skills/notion-meeting-intelligence/SKILL.md
128 notion:notion-research-documentation PLUGIN_CACHE/openai-curated-remote/notion/3.0.2/skills/notion-research-documentation/SKILL.md
129 notion:notion-setup PLUGIN_CACHE/openai-curated-remote/notion/3.0.2/skills/setup/SKILL.md
130 notion:notion-spec-to-implementation PLUGIN_CACHE/openai-curated-remote/notion/3.0.2/skills/notion-spec-to-implementation/SKILL.md
131 notion:notion-weekly-project-digest PLUGIN_CACHE/openai-curated-remote/notion/3.0.2/skills/notion-weekly-project-digest/SKILL.md
132 openrlhf-training USER_SKILLS/openrlhf/SKILL.md
133 optimizing-attention-flash USER_SKILLS/flash-attention/SKILL.md
134 outlines USER_SKILLS/outlines/SKILL.md
135 pages:maintain-space PLUGIN_CACHE/openai-curated-remote/pages/0.1.25/skills/maintain-space/SKILL.md
136 pages:manage-schedules PLUGIN_CACHE/openai-curated-remote/pages/0.1.25/skills/manage-schedules/SKILL.md
137 pages:organize-space PLUGIN_CACHE/openai-curated-remote/pages/0.1.25/skills/organize-space/SKILL.md
138 pages:write-page PLUGIN_CACHE/openai-curated-remote/pages/0.1.25/skills/write-page/SKILL.md
139 peft-fine-tuning USER_SKILLS/peft/SKILL.md
140 phoenix-observability USER_SKILLS/phoenix/SKILL.md
141 pinecone USER_SKILLS/pinecone/SKILL.md
142 plugin-management:plugin-management PLUGIN_CACHE/openai-curated-remote/plugin-management/0.1.0/skills/plugin-management/SKILL.md
143 presenting-conference-talks USER_SKILLS/presenting-conference-talks/SKILL.md
144 prompt-guard USER_SKILLS/prompt-guard/SKILL.md
145 pytorch-fsdp2 USER_SKILLS/pytorch-fsdp2/SKILL.md
146 pytorch-lightning USER_SKILLS/pytorch-lightning/SKILL.md
147 pyvene-interventions USER_SKILLS/pyvene/SKILL.md
148 qdrant-vector-search USER_SKILLS/qdrant/SKILL.md
149 quantizing-models-bitsandbytes USER_SKILLS/bitsandbytes/SKILL.md
150 ray-data USER_SKILLS/ray-data/SKILL.md
151 ray-train USER_SKILLS/ray-train/SKILL.md
152 rwkv-architecture USER_SKILLS/rwkv/SKILL.md
153 segment-anything-model USER_SKILLS/segment-anything/SKILL.md
154 sentence-transformers USER_SKILLS/sentence-transformers/SKILL.md
155 sentencepiece USER_SKILLS/sentencepiece/SKILL.md
156 serving-llms-vllm USER_SKILLS/vllm/SKILL.md
157 sglang USER_SKILLS/sglang/SKILL.md
158 simpo-training USER_SKILLS/simpo/SKILL.md
159 sites:sites PLUGIN_CACHE/openai-curated-remote/sites/1.1.2/skills/sites/SKILL.md
160 sites:sites-remix PLUGIN_CACHE/openai-curated-remote/sites/1.1.2/skills/sites-remix/SKILL.md
161 skypilot-multi-cloud-orchestration USER_SKILLS/skypilot/SKILL.md
162 slime-rl-training USER_SKILLS/slime/SKILL.md
163 sparse-autoencoder-training USER_SKILLS/saelens/SKILL.md
164 speculative-decoding USER_SKILLS/speculative-decoding/SKILL.md
165 stable-diffusion-image-generation USER_SKILLS/stable-diffusion/SKILL.md
166 systems-paper-writing USER_SKILLS/systems-paper-writing/SKILL.md
167 tensorboard USER_SKILLS/tensorboard/SKILL.md
168 tensorrt-llm USER_SKILLS/tensorrt-llm/SKILL.md
169 torchforge-rl-training USER_SKILLS/torchforge/SKILL.md
170 training-llms-megatron USER_SKILLS/megatron-core/SKILL.md
171 transformer-lens-interpretability USER_SKILLS/transformer-lens/SKILL.md
172 ue-embedding-get USER_SKILLS/ue-embedding-get/SKILL.md
173 unsloth USER_SKILLS/unsloth/SKILL.md
174 verl-rl-training USER_SKILLS/verl/SKILL.md
175 viking-release USER_SKILLS/viking-release/SKILL.md
176 visualize:visualize PLUGIN_CACHE/openai-bundled/visualize/1.0.55/skills/visualize/SKILL.md
177 weights-and-biases USER_SKILLS/weights-and-biases/SKILL.md
178 whisper USER_SKILLS/whisper/SKILL.md
179 work-pets:create-pet PLUGIN_CACHE/openai-curated-remote/work-pets/0.1.6/skills/create-pet/SKILL.md
180 work-pets:pets PLUGIN_CACHE/openai-curated-remote/work-pets/0.1.6/skills/pets/SKILL.md
181 work-pets:update-pet PLUGIN_CACHE/openai-curated-remote/work-pets/0.1.6/skills/update-pet/SKILL.md
182 yarn-queue-ops USER_SKILLS/yarn-queue-ops/SKILL.md

D：工具接口结构

下面保留 22 个顶层定义的结构，其中 Apps 部分包含 90 个接口。tools 数组列出工具组中的接口，parameters 描述可传入的参数。

JSON 已省略描述、示例、内部使用说明和自定义语法正文，不能直接当作完整工具注册配置。展示时添加了缩进，原计数使用紧凑序列化；每个小节标注的 Token 数对应删减前的完整定义。

D.1 exec_command（原完整定义约 342 Token） 
{
  "type": "function",
  "name": "exec_command",
  "strict": false,
  "parameters": {
    "type": "object",
    "properties": {
      "cmd": {
        "type": "string"
      },
      "justification": {
        "type": "string"
      },
      "login": {
        "type": "boolean"
      },
      "max_output_tokens": {
        "type": "number"
      },
      "prefix_rule": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "sandbox_permissions": {
        "type": "string",
        "enum": [
          "use_default",
          "require_escalated"
        ]
      },
      "shell": {
        "type": "string"
      },
      "tty": {
        "type": "boolean"
      },
      "workdir": {
        "type": "string"
      },
      "yield_time_ms": {
        "type": "number"
      }
    },
    "required": [
      "cmd"
    ],
    "additionalProperties": false
  }
}
D.2 write_stdin（原完整定义约 167 Token） 
{
  "type": "function",
  "name": "write_stdin",
  "strict": false,
  "parameters": {
    "type": "object",
    "properties": {
      "chars": {
        "type": "string"
      },
      "max_output_tokens": {
        "type": "number"
      },
      "session_id": {
        "type": "number"
      },
      "yield_time_ms": {
        "type": "number"
      }
    },
    "required": [
      "session_id"
    ],
    "additionalProperties": false
  }
}
D.3 list_mcp_resources（原完整定义约 122 Token） 
{
  "type": "function",
  "name": "list_mcp_resources",
  "strict": false,
  "parameters": {
    "type": "object",
    "properties": {
      "cursor": {
        "type": "string"
      },
      "server": {
        "type": "string"
      }
    },
    "additionalProperties": false
  }
}
D.4 list_mcp_resource_templates（原完整定义约 133 Token） 
{
  "type": "function",
  "name": "list_mcp_resource_templates",
  "strict": false,
  "parameters": {
    "type": "object",
    "properties": {
      "cursor": {
        "type": "string"
      },
      "server": {
        "type": "string"
      }
    },
    "additionalProperties": false
  }
}
D.5 read_mcp_resource（原完整定义约 114 Token） 
{
  "type": "function",
  "name": "read_mcp_resource",
  "strict": false,
  "parameters": {
    "type": "object",
    "properties": {
      "server": {
        "type": "string"
      },
      "uri": {
        "type": "string"
      }
    },
    "required": [
      "server",
      "uri"
    ],
    "additionalProperties": false
  }
}
D.6 request_user_input（原完整定义约 287 Token） 
{
  "type": "function",
  "name": "request_user_input",
  "strict": false,
  "parameters": {
    "type": "object",
    "properties": {
      "questions": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "header": {
              "type": "string"
            },
            "id": {
              "type": "string"
            },
            "options": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "description": {
                    "type": "string"
                  },
                  "label": {
                    "type": "string"
                  }
                },
                "required": [
                  "label",
                  "description"
                ],
                "additionalProperties": false
              }
            },
            "question": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "header",
            "question",
            "options"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "questions"
    ],
    "additionalProperties": false
  }
}
D.7 request_plugin_install（原完整定义约 222 Token） 
{
  "type": "function",
  "name": "request_plugin_install",
  "strict": false,
  "parameters": {
    "type": "object",
    "properties": {
      "plugin_id": {
        "type": "string"
      },
      "suggest_reason": {
        "type": "string"
      }
    },
    "required": [
      "plugin_id",
      "suggest_reason"
    ],
    "additionalProperties": false
  }
}
D.8 apply_patch（原完整定义约 252 Token） 
{
  "type": "custom",
  "name": "apply_patch",
  "format_note": "Custom input format; original instruction and grammar text omitted."
}
D.9 view_image（原完整定义约 108 Token） 
{
  "type": "function",
  "name": "view_image",
  "strict": false,
  "parameters": {
    "type": "object",
    "properties": {
      "detail": {
        "type": "string",
        "enum": [
          "high",
          "original"
        ]
      },
      "path": {
        "type": "string"
      }
    },
    "required": [
      "path"
    ],
    "additionalProperties": false
  }
}
D.10 multi_agent_v1（原完整定义约 1,926 Token） 
{
  "type": "namespace",
  "name": "multi_agent_v1",
  "tools": [
    {
      "type": "function",
      "name": "close_agent",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "target": {
            "type": "string"
          }
        },
        "required": [
          "target"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "resume_agent",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "send_input",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "interrupt": {
            "type": "boolean"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "audio_url": {
                  "type": "string"
                },
                "image_url": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "path": {
                  "type": "string"
                },
                "text": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            }
          },
          "message": {
            "type": "string"
          },
          "target": {
            "type": "string"
          }
        },
        "required": [
          "target"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "spawn_agent",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "fork_context": {
            "type": "boolean"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "audio_url": {
                  "type": "string"
                },
                "image_url": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "path": {
                  "type": "string"
                },
                "text": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            }
          },
          "message": {
            "type": "string"
          },
          "model": {
            "type": "string"
          },
          "reasoning_effort": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "wait_agent",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "targets": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "timeout_ms": {
            "type": "number"
          }
        },
        "required": [
          "targets"
        ],
        "additionalProperties": false
      }
    }
  ]
}
D.11 mcp__codex_apps__chatgpt_space（原完整定义约 15,989 Token） 
{
  "type": "namespace",
  "name": "mcp__codex_apps__chatgpt_space",
  "tools": [
    {
      "type": "function",
      "name": "_attach_automation_to_page",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "automation_id": {
            "type": "string"
          },
          "automation_role": {
            "type": "string",
            "enum": [
              "controller",
              "task"
            ]
          },
          "controller_automation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "page_id": {
            "type": "string"
          }
        },
        "required": [
          "page_id",
          "automation_id"
        ]
      }
    },
    {
      "type": "function",
      "name": "_create_controller_automation",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "controller_automation_id": {
            "type": "string"
          },
          "default_timezone": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "dtstart_offset_json": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "page_id": {
            "type": "string"
          },
          "prompt": {
            "type": "string"
          },
          "schedule": {
            "type": "string"
          },
          "timing_mode": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "exact_schedule",
                  "flexible_schedule",
                  "condition_watch"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "title": {
            "type": "string"
          },
          "triggers": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {},
                  "additionalProperties": {
                    "$ref": "#/$defs/JsonValue"
                  }
                }
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "page_id",
          "controller_automation_id",
          "prompt",
          "title"
        ],
        "$defs": {
          "JsonValue": {}
        }
      }
    },
    {
      "type": "function",
      "name": "_create_page",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "idempotency_key": {
            "anyOf": [
              {
                "$ref": "#/$defs/PageCreationIdempotencyKey"
              },
              {
                "type": "null"
              }
            ]
          },
          "initial_blocks": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "namespace": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "meeting_notes",
                  "data_reports"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "parent_page_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "position": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "site_project_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "space_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "title"
        ],
        "additionalProperties": false,
        "$defs": {
          "PageCreationIdempotencyKey": {
            "type": "string"
          }
        }
      }
    },
    {
      "type": "function",
      "name": "_create_page_visualization",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "after_block_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "base_sequence": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "html": {
            "type": "string"
          },
          "page_id": {
            "type": "string"
          },
          "replace_block": {
            "anyOf": [
              {
                "$ref": "#/$defs/_ReplaceBlock"
              },
              {
                "type": "null"
              }
            ]
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "page_id",
          "html",
          "title"
        ],
        "additionalProperties": false,
        "$defs": {
          "_ReplaceBlock": {
            "type": "object",
            "properties": {
              "block_id": {
                "type": "string"
              },
              "expected_hash": {
                "type": "string"
              }
            },
            "required": [
              "block_id",
              "expected_hash"
            ],
            "additionalProperties": false
          }
        }
      }
    },
    {
      "type": "function",
      "name": "_create_presentation",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "idempotency_key": {
            "$ref": "#/$defs/PageCreationIdempotencyKey"
          },
          "namespace": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "meeting_notes",
                  "data_reports"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "parent_page_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "position": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "space_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "title",
          "idempotency_key"
        ],
        "additionalProperties": false,
        "$defs": {
          "PageCreationIdempotencyKey": {
            "type": "string"
          }
        }
      }
    },
    {
      "type": "function",
      "name": "_create_space",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_edit_page",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "base_sequence": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "operations": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "$ref": "#/$defs/t"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "block_id": {
                          "type": "string"
                        },
                        "expected_hash": {
                          "type": "string"
                        },
                        "op": {
                          "type": "string",
                          "enum": [
                            "patch_block_markdown"
                          ]
                        },
                        "replacements": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "new": {
                                "type": "string"
                              },
                              "old": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "old",
                              "new"
                            ],
                            "additionalProperties": false
                          },
                          "minItems": 1
                        }
                      },
                      "required": [
                        "op",
                        "block_id",
                        "expected_hash",
                        "replacements"
                      ],
                      "additionalProperties": false
                    }
                  ]
                },
                "minItems": 1
              },
              {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "$ref": "#/$defs/t"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "at": {
                          "$ref": "#/$defs/l"
                        },
                        "block_kind": {
                          "$ref": "#/$defs/k"
                        },
                        "block_units": {
                          "$ref": "#/$defs/u"
                        },
                        "markdown": {
                          "type": "string"
                        },
                        "op": {
                          "type": "string",
                          "enum": [
                            "insert_markdown"
                          ]
                        }
                      },
                      "required": [
                        "at",
                        "op"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "block_id": {
                          "type": "string"
                        },
                        "block_kind": {
                          "anyOf": [
                            {
                              "$ref": "#/$defs/k"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "block_units": {
                          "$ref": "#/$defs/u"
                        },
                        "expected_hash": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "markdown": {
                          "type": "string"
                        },
                        "op": {
                          "type": "string",
                          "enum": [
                            "replace_block_markdown"
                          ]
                        }
                      },
                      "required": [
                        "block_id",
                        "op"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "block_id": {
                          "type": "string"
                        },
                        "expected_hash": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "op": {
                          "type": "string",
                          "enum": [
                            "delete_block"
                          ]
                        }
                      },
                      "required": [
                        "block_id",
                        "op"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "after_block_id": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "block_id": {
                          "type": "string"
                        },
                        "op": {
                          "type": "string",
                          "enum": [
                            "move_block"
                          ]
                        }
                      },
                      "required": [
                        "block_id",
                        "after_block_id",
                        "op"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "block_id": {
                          "type": "string"
                        },
                        "expected_hash": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "metadata": {
                          "type": "object",
                          "properties": {},
                          "additionalProperties": true
                        },
                        "op": {
                          "type": "string",
                          "enum": [
                            "set_block_metadata"
                          ]
                        }
                      },
                      "required": [
                        "block_id",
                        "metadata",
                        "op"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "at": {
                          "$ref": "#/$defs/l"
                        },
                        "label": {
                          "type": "string"
                        },
                        "op": {
                          "type": "string",
                          "enum": [
                            "insert_page_link"
                          ]
                        },
                        "target_page_id": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "at",
                        "target_page_id",
                        "op"
                      ],
                      "additionalProperties": false
                    }
                  ]
                },
                "minItems": 1
              }
            ]
          },
          "page_id": {
            "type": "string"
          },
          "stream_kind": {
            "type": "string",
            "enum": [
              "content",
              "scratch"
            ]
          }
        },
        "required": [
          "page_id",
          "operations"
        ],
        "additionalProperties": false,
        "$defs": {
          "k": {
            "type": "string",
            "enum": [
              "markdown",
              "agent_instructions"
            ]
          },
          "l": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "following_block_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "between_blocks"
                    ]
                  },
                  "preceding_block_id": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "preceding_block_id",
                  "following_block_id",
                  "kind"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "anchor": {
                    "oneOf": [
                      {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "enum": [
                              "yjs_relative"
                            ]
                          },
                          "relative_position_base64": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "relative_position_base64",
                          "kind"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "type": "object",
                        "properties": {
                          "expected_block_hash": {
                            "type": "string"
                          },
                          "kind": {
                            "type": "string",
                            "enum": [
                              "snapshot_offset"
                            ]
                          },
                          "offset_utf16": {
                            "type": "integer"
                          }
                        },
                        "required": [
                          "offset_utf16",
                          "expected_block_hash",
                          "kind"
                        ],
                        "additionalProperties": false
                      }
                    ]
                  },
                  "block_id": {
                    "type": "string"
                  },
                  "kind": {
                    "type": "string",
                    "enum": [
                      "in_block"
                    ]
                  }
                },
                "required": [
                  "block_id",
                  "anchor",
                  "kind"
                ],
                "additionalProperties": false
              }
            ]
          },
          "t": {
            "type": "object",
            "properties": {
              "expected_title_hash": {
                "type": "string"
              },
              "op": {
                "type": "string",
                "enum": [
                  "set_title"
                ]
              },
              "title": {
                "type": "string"
              }
            },
            "required": [
              "title",
              "expected_title_hash",
              "op"
            ],
            "additionalProperties": false
          },
          "u": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "markdown",
                            "agent_instructions"
                          ]
                        },
                        "markdown": {
                          "type": "string"
                        },
                        "metadata": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {},
                              "additionalProperties": true
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "required": [
                        "kind",
                        "markdown"
                      ],
                      "additionalProperties": false
                    }
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          }
        }
      }
    },
    {
      "type": "function",
      "name": "_execute_artifact_code",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "font_files_to_load": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "hydrate_images": {
            "type": "boolean"
          },
          "idempotency_key": {
            "$ref": "#/$defs/PageCreationIdempotencyKey"
          },
          "image_references": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "page_id": {
            "type": "string"
          },
          "wait_for_persistence": {
            "type": "boolean"
          }
        },
        "required": [
          "page_id",
          "idempotency_key",
          "code"
        ],
        "additionalProperties": false,
        "$defs": {
          "PageCreationIdempotencyKey": {
            "type": "string"
          }
        }
      }
    },
    {
      "type": "function",
      "name": "_find_pages",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "query": {
            "type": "string"
          },
          "space_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "query"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_get_artifact_execution_status",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "idempotency_key": {
            "$ref": "#/$defs/PageCreationIdempotencyKey"
          },
          "page_id": {
            "type": "string"
          }
        },
        "required": [
          "page_id",
          "idempotency_key"
        ],
        "additionalProperties": false,
        "$defs": {
          "PageCreationIdempotencyKey": {
            "type": "string"
          }
        }
      }
    },
    {
      "type": "function",
      "name": "_get_page_auto_update",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "page_id": {
            "type": "string"
          }
        },
        "required": [
          "page_id"
        ]
      }
    },
    {
      "type": "function",
      "name": "_get_page_sharing",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "page_id": {
            "type": "string"
          }
        },
        "required": [
          "page_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_get_sharing_availability",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_get_space",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "space_id": {
            "type": "string"
          }
        },
        "required": [
          "space_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_get_space_sharing",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "space_id": {
            "type": "string"
          }
        },
        "required": [
          "space_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_inspect_artifact",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "font_files_to_load": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "hydrate_images": {
            "type": "boolean"
          },
          "image_references": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "page_id": {
            "type": "string"
          }
        },
        "required": [
          "page_id",
          "code"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_inspect_page_reference",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "page_id": {
            "type": "string"
          },
          "reference": {
            "type": "string"
          }
        },
        "required": [
          "page_id",
          "reference"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_list_page_automations",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "page_id": {
            "type": "string"
          }
        },
        "required": [
          "page_id"
        ]
      }
    },
    {
      "type": "function",
      "name": "_list_page_comments",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "block_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "limit": {
            "type": "integer"
          },
          "page_id": {
            "type": "string"
          },
          "state": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "open",
                  "resolved"
                ]
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "page_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_list_pages",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "include_has_children": {
            "type": "boolean"
          },
          "limit": {
            "type": "integer"
          },
          "namespace": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "meeting_notes",
                  "data_reports"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "parent_page_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "space_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "top_level_only": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_list_spaces",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "limit": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_manage_page_comment",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "add",
              "reply",
              "react",
              "resolve",
              "reopen",
              "edit",
              "delete_message",
              "delete_thread"
            ]
          },
          "active": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "block_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "body": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "emoji": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "message_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "occurrence": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "page_id": {
            "type": "string"
          },
          "selected_text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "thread_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "page_id",
          "action"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_move_page",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "action": {
            "type": "string",
            "enum": [
              "move",
              "confirm",
              "status",
              "resume"
            ]
          },
          "operation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "page_id": {
            "type": "string"
          },
          "parent_page_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "preview_token": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "source_space_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "space_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "page_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_patch_page",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "changes": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "block_id": {
                      "type": "string"
                    },
                    "block_index": {
                      "type": "null"
                    },
                    "expected_hash": {
                      "type": "string"
                    },
                    "replacements": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "new": {
                            "type": "string"
                          },
                          "old": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "old",
                          "new"
                        ],
                        "additionalProperties": false
                      },
                      "minItems": 1
                    }
                  },
                  "required": [
                    "replacements",
                    "block_id",
                    "expected_hash"
                  ],
                  "additionalProperties": false
                },
                "minItems": 1
              },
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "block_id": {
                      "type": "null"
                    },
                    "block_index": {
                      "type": "integer"
                    },
                    "expected_hash": {
                      "type": "null"
                    },
                    "replacements": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "new": {
                            "type": "string"
                          },
                          "old": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "old",
                          "new"
                        ],
                        "additionalProperties": false
                      },
                      "minItems": 1
                    }
                  },
                  "required": [
                    "replacements",
                    "block_index"
                  ],
                  "additionalProperties": false
                },
                "minItems": 1
              }
            ]
          },
          "observed_sequence": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "page_id": {
            "type": "string"
          },
          "stream_kind": {
            "type": "string",
            "enum": [
              "content",
              "scratch"
            ]
          }
        },
        "required": [
          "page_id",
          "changes"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_progress_update",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "block_ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "message": {
            "type": "string"
          },
          "page_id": {
            "type": "string"
          },
          "text_ranges": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "$ref": "#/$defs/_ProgressTextRange"
                }
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "page_id",
          "block_ids",
          "message"
        ],
        "additionalProperties": false,
        "$defs": {
          "_ProgressTextRange": {
            "type": "object",
            "properties": {
              "block_id": {
                "type": "string"
              },
              "end_utf16": {
                "type": "integer"
              },
              "start_utf16": {
                "type": "integer"
              }
            },
            "required": [
              "block_id",
              "start_utf16",
              "end_utf16"
            ],
            "additionalProperties": false
          }
        }
      }
    },
    {
      "type": "function",
      "name": "_read_page",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "block_ids": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "minItems": 1
              },
              {
                "type": "null"
              }
            ]
          },
          "context_blocks": {
            "type": "integer"
          },
          "context_lines": {
            "type": "integer"
          },
          "include_content": {
            "type": "boolean"
          },
          "page_id": {
            "type": "string"
          },
          "search": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "minItems": 1
              },
              {
                "type": "null"
              }
            ]
          },
          "stream_kind": {
            "type": "string",
            "enum": [
              "content",
              "scratch"
            ]
          },
          "view": {
            "type": "string",
            "enum": [
              "editing",
              "full",
              "excerpts"
            ]
          }
        },
        "required": [
          "page_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_read_page_changes",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "after_sequence": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "include_comments": {
            "type": "boolean"
          },
          "max_chars": {
            "type": "integer"
          },
          "page_id": {
            "type": "string"
          },
          "stream_kind": {
            "type": "string",
            "enum": [
              "content",
              "scratch"
            ]
          }
        },
        "required": [
          "page_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_read_page_reference",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "page_id": {
            "type": "string"
          },
          "reference": {
            "type": "string"
          }
        },
        "required": [
          "page_id",
          "reference"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_read_page_transcript",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "page_id": {
            "type": "string"
          }
        },
        "required": [
          "page_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_reply_page_comment",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "body": {
            "type": "string"
          },
          "page_id": {
            "type": "string"
          },
          "thread_id": {
            "type": "string"
          }
        },
        "required": [
          "page_id",
          "thread_id",
          "body"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_run_page_auto_update",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "expected_controller_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "idempotency_key": {
            "type": "string"
          },
          "page_id": {
            "type": "string"
          }
        },
        "required": [
          "page_id",
          "idempotency_key"
        ]
      }
    },
    {
      "type": "function",
      "name": "_search_sharing_recipients",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "limit": {
            "type": "integer"
          },
          "page_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "queries": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "minItems": 1
              },
              {
                "type": "null"
              }
            ]
          },
          "query": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "space_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_set_page_auto_update",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "idempotency_key": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "is_enabled": {
            "type": "boolean"
          },
          "page_id": {
            "type": "string"
          }
        },
        "required": [
          "page_id",
          "is_enabled"
        ]
      }
    },
    {
      "type": "function",
      "name": "_trash_page",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "page_id": {
            "type": "string"
          }
        },
        "required": [
          "page_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_update_page_sharing",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "add_or_replace": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "$ref": "#/$defs/_UserOrGroupSharingGrant"
                },
                {
                  "$ref": "#/$defs/_WorkspaceSharingGrant"
                }
              ]
            }
          },
          "page_id": {
            "type": "string"
          },
          "remove": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/_SharingRecipient"
            }
          }
        },
        "required": [
          "page_id"
        ],
        "additionalProperties": false,
        "$defs": {
          "_SharingRecipient": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "type": {
                "type": "string",
                "enum": [
                  "user",
                  "workspace_group",
                  "workspace"
                ]
              }
            },
            "required": [
              "type",
              "id"
            ],
            "additionalProperties": false
          },
          "_UserOrGroupSharingGrant": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "role": {
                "type": "string",
                "enum": [
                  "viewer",
                  "commenter",
                  "editor"
                ]
              },
              "type": {
                "type": "string",
                "enum": [
                  "user",
                  "workspace_group"
                ]
              }
            },
            "required": [
              "type",
              "id",
              "role"
            ],
            "additionalProperties": false
          },
          "_WorkspaceSharingGrant": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "role": {
                "type": "string",
                "enum": [
                  "viewer",
                  "editor"
                ]
              },
              "type": {
                "type": "string",
                "enum": [
                  "workspace"
                ]
              }
            },
            "required": [
              "type",
              "id",
              "role"
            ],
            "additionalProperties": false
          }
        }
      }
    },
    {
      "type": "function",
      "name": "_update_space_sharing",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "add_or_replace": {
            "type": "array",
            "items": {
              "anyOf": [
                {
                  "$ref": "#/$defs/_UserOrGroupSharingGrant"
                },
                {
                  "$ref": "#/$defs/_WorkspaceSharingGrant"
                }
              ]
            }
          },
          "remove": {
            "type": "array",
            "items": {
              "$ref": "#/$defs/_SharingRecipient"
            }
          },
          "space_id": {
            "type": "string"
          }
        },
        "required": [
          "space_id"
        ],
        "additionalProperties": false,
        "$defs": {
          "_SharingRecipient": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "type": {
                "type": "string",
                "enum": [
                  "user",
                  "workspace_group",
                  "workspace"
                ]
              }
            },
            "required": [
              "type",
              "id"
            ],
            "additionalProperties": false
          },
          "_UserOrGroupSharingGrant": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "role": {
                "type": "string",
                "enum": [
                  "viewer",
                  "commenter",
                  "editor"
                ]
              },
              "type": {
                "type": "string",
                "enum": [
                  "user",
                  "workspace_group"
                ]
              }
            },
            "required": [
              "type",
              "id",
              "role"
            ],
            "additionalProperties": false
          },
          "_WorkspaceSharingGrant": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "role": {
                "type": "string",
                "enum": [
                  "viewer",
                  "editor"
                ]
              },
              "type": {
                "type": "string",
                "enum": [
                  "workspace"
                ]
              }
            },
            "required": [
              "type",
              "id",
              "role"
            ],
            "additionalProperties": false
          }
        }
      }
    },
    {
      "type": "function",
      "name": "_upload_artifact_images",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "page_id": {
            "type": "string"
          },
          "paths": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 1
          }
        },
        "required": [
          "page_id",
          "paths"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_write_page_reference",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "file": {
            "type": "string"
          },
          "page_id": {
            "type": "string"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "page_id",
          "file"
        ],
        "additionalProperties": false
      }
    }
  ]
}
D.12 mcp__codex_apps__codex_document_control（原完整定义约 867 Token） 
{
  "type": "namespace",
  "name": "mcp__codex_apps__codex_document_control",
  "tools": [
    {
      "type": "function",
      "name": "_execute_document_command",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "args": {
            "type": "object",
            "properties": {},
            "additionalProperties": {}
          },
          "executor_session_id": {
            "type": "string"
          },
          "idempotency_key": {
            "type": "string"
          },
          "tool_name": {
            "type": "string"
          }
        },
        "required": [
          "executor_session_id",
          "idempotency_key",
          "tool_name",
          "args"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_get_document_tool_schemas",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "surface": {
                  "type": "string",
                  "enum": [
                    "excel",
                    "powerpoint",
                    "sheets",
                    "word"
                  ]
                },
                "tool_name": {
                  "type": "string"
                },
                "version": {
                  "type": "string"
                }
              },
              "required": [
                "surface",
                "tool_name",
                "version"
              ],
              "additionalProperties": false
            },
            "minItems": 1
          }
        },
        "required": [
          "items"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_list_document_sessions",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "surface": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "excel",
                  "powerpoint",
                  "sheets",
                  "word"
                ]
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false
      }
    }
  ]
}
D.13 mcp__codex_apps__hotline（原完整定义约 138 Token） 
{
  "type": "namespace",
  "name": "mcp__codex_apps__hotline",
  "tools": [
    {
      "type": "function",
      "name": "_get_local_hotline",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    }
  ]
}
D.14 mcp__codex_apps__pets（原完整定义约 1,637 Token） 
{
  "type": "namespace",
  "name": "mcp__codex_apps__pets",
  "tools": [
    {
      "type": "function",
      "name": "_adopt",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "shared_pet_id": {
            "type": "string"
          }
        },
        "required": [
          "shared_pet_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_create_pet",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "name": {
            "type": "string"
          },
          "upload_session_id": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "upload_session_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_delete_pet",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "pet_id": {
            "type": "string"
          }
        },
        "required": [
          "pet_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_get_pet_download_link",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "pet_id": {
            "type": "string"
          }
        },
        "required": [
          "pet_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_list_pets",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "limit": {
            "type": "integer"
          }
        },
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_prepare_pet_upload",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "file": {
            "type": "string"
          }
        },
        "required": [
          "file"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_select_pet",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "pet_id": {
            "type": "string"
          }
        },
        "required": [
          "pet_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_share_pet",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "pet_id": {
            "type": "string"
          }
        },
        "required": [
          "pet_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_unshare_pet",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "pet_id": {
            "type": "string"
          }
        },
        "required": [
          "pet_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_update_pet",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "pet_id": {
            "type": "string"
          },
          "updates": {
            "type": "object",
            "properties": {
              "description": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "name": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "upload_session_id": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "pet_id",
          "updates"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_validate_pet_spritesheet",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "file": {
            "type": "string"
          }
        },
        "required": [
          "file"
        ],
        "additionalProperties": false
      }
    }
  ]
}
D.15 mcp__codex_apps__plugin_management（原完整定义约 2,089 Token） 
{
  "type": "namespace",
  "name": "mcp__codex_apps__plugin_management",
  "tools": [
    {
      "type": "function",
      "name": "_get_app_permissions",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "app_id": {
            "type": "string"
          }
        },
        "required": [
          "app_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_get_plugin_dependencies",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "plugin_reference": {
            "type": "string"
          }
        },
        "required": [
          "plugin_reference"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_search_plugins",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "limit": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ]
          },
          "query": {
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_suggest_plugins",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "plugin_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 1
          }
        },
        "required": [
          "plugin_ids"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_uninstall_app",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "app_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "minItems": 1
          },
          "reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "app_ids"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_update_app_permissions",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "app_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "updates": {
            "type": "object",
            "properties": {
              "app_permissions": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "setting": {
                          "type": "string",
                          "enum": [
                            "permission_mode"
                          ]
                        },
                        "value": {
                          "type": "string",
                          "enum": [
                            "inherit",
                            "always_ask",
                            "ask_before_writes",
                            "review_important_actions",
                            "full_access"
                          ]
                        }
                      },
                      "required": [
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "global_permissions": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "setting": {
                          "type": "string",
                          "enum": [
                            "permission_mode"
                          ]
                        },
                        "value": {
                          "type": "string",
                          "enum": [
                            "always_ask",
                            "ask_before_writes",
                            "review_important_actions",
                            "full_access"
                          ]
                        }
                      },
                      "required": [
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": false
          }
        },
        "required": [
          "updates"
        ],
        "additionalProperties": false
      }
    }
  ]
}
D.16 mcp__codex_apps__safety_settings（原完整定义约 761 Token） 
{
  "type": "namespace",
  "name": "mcp__codex_apps__safety_settings",
  "tools": [
    {
      "type": "function",
      "name": "_get_family_info",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_get_parental_controls",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "user_id": {
            "type": "string"
          }
        },
        "required": [
          "user_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_get_trusted_contact",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_prepare_parental_control_update",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "control_id": {
            "type": "string"
          },
          "user_id": {
            "type": "string"
          },
          "value": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "object",
                "properties": {
                  "enabled": {
                    "type": "boolean"
                  },
                  "end_time": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "start_time": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "enabled",
                  "start_time",
                  "end_time"
                ],
                "additionalProperties": false
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "minItems": 1
              }
            ]
          }
        },
        "required": [
          "user_id",
          "control_id",
          "value"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_update_parental_control",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "confirmation_summary": {
            "type": "string"
          },
          "control_id": {
            "type": "string"
          },
          "operation_id": {
            "type": "string"
          },
          "user_id": {
            "type": "string"
          },
          "value": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "object",
                "properties": {
                  "enabled": {
                    "type": "boolean"
                  },
                  "end_time": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "start_time": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "enabled",
                  "start_time",
                  "end_time"
                ],
                "additionalProperties": false
              },
              {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "minItems": 1
              }
            ]
          }
        },
        "required": [
          "user_id",
          "control_id",
          "value",
          "operation_id",
          "confirmation_summary"
        ],
        "additionalProperties": false
      }
    }
  ]
}
D.17 mcp__codex_apps__search_service（原完整定义约 2,571 Token） 
{
  "type": "namespace",
  "name": "mcp__codex_apps__search_service",
  "tools": [
    {
      "type": "function",
      "name": "_web_run",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "click": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer"
                    },
                    "ref_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "ref_id",
                    "id"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "find": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "pattern": {
                      "type": "string"
                    },
                    "ref_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "ref_id",
                    "pattern"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "image_query": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "domains": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "q": {
                      "type": "string"
                    },
                    "recency": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "q"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "open": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "lineno": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "ref_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "ref_id"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "response_length": {
            "type": "string",
            "enum": [
              "short",
              "medium",
              "long"
            ]
          },
          "screenshot": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "pageno": {
                      "type": "integer"
                    },
                    "ref_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "ref_id",
                    "pageno"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "system2_search_query": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "domains": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "q": {
                      "type": "string"
                    },
                    "recency": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "q"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "time": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "utc_offset": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "utc_offset"
                  ]
                }
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false
      }
    }
  ]
}
D.18 mcp__codex_apps__sites（原完整定义约 8,265 Token） 
{
  "type": "namespace",
  "name": "mcp__codex_apps__sites",
  "tools": [
    {
      "type": "function",
      "name": "_add_custom_domain",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "hostname": {
            "type": "string"
          },
          "project_id": {
            "type": "string"
          }
        },
        "required": [
          "project_id",
          "hostname"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_change_site_slug",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          }
        },
        "required": [
          "project_id",
          "slug"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_create_schedule",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          },
          "task": {
            "type": "object",
            "properties": {
              "prompt": {
                "type": "string"
              },
              "schedule": {
                "type": "string"
              },
              "timezone": {
                "type": "string"
              },
              "title": {
                "type": "string"
              }
            },
            "required": [
              "title",
              "prompt",
              "schedule",
              "timezone"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "project_id",
          "request_id",
          "task"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_create_site",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "creation_intent": {
            "type": "string",
            "enum": [
              "user_requested",
              "proactive",
              "unknown"
            ]
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "enable_plugins": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ]
          },
          "publish_on_push": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "private"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "title",
          "slug"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_create_source_repository_write_credential",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": {
            "type": "string"
          },
          "publish_on_push": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "private"
                ]
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "project_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_deploy_private_site_version",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": {
            "type": "string"
          },
          "tunnel_bindings": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "binding_alias": {
                      "type": "string"
                    },
                    "tunnel_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "binding_alias",
                    "tunnel_id"
                  ],
                  "additionalProperties": false
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "version_id": {
            "type": "string"
          }
        },
        "required": [
          "project_id",
          "version_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_deploy_site_version",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": {
            "type": "string"
          },
          "tunnel_bindings": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "binding_alias": {
                      "type": "string"
                    },
                    "tunnel_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "binding_alias",
                    "tunnel_id"
                  ],
                  "additionalProperties": false
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "version_id": {
            "type": "string"
          }
        },
        "required": [
          "project_id",
          "version_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_generate_siwc_bypass_token",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": {
            "type": "string"
          }
        },
        "required": [
          "project_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_get_deployment_status",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "deployment_id": {
            "type": "string"
          },
          "project_id": {
            "type": "string"
          },
          "version_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "project_id",
          "deployment_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_get_environment_variables",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": {
            "type": "string"
          }
        },
        "required": [
          "project_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_get_site",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "include_mcp_connection": {
            "type": "boolean"
          },
          "project_id": {
            "type": "string"
          }
        },
        "required": [
          "project_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_get_site_version",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": {
            "type": "string"
          },
          "version_id": {
            "type": "string"
          }
        },
        "required": [
          "project_id",
          "version_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_get_site_worker_logs",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "errors_only": {
            "type": "boolean"
          },
          "limit": {
            "type": "integer"
          },
          "project_id": {
            "type": "string"
          },
          "since_minutes": {
            "type": "integer"
          }
        },
        "required": [
          "project_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_list_custom_domains",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": {
            "type": "string"
          }
        },
        "required": [
          "project_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_list_site_versions",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "limit": {
            "type": "integer"
          },
          "project_id": {
            "type": "string"
          }
        },
        "required": [
          "project_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_list_sites",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "include_editable": {
            "type": "boolean"
          },
          "limit": {
            "type": "integer"
          },
          "role": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "owner",
                  "editor"
                ]
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_read_database_overview",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "binding_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "project_id": {
            "type": "string"
          }
        },
        "required": [
          "project_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_read_database_table_rows",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "binding_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "limit": {
            "type": "integer"
          },
          "offset": {
            "type": "integer"
          },
          "project_id": {
            "type": "string"
          },
          "table_name": {
            "type": "string"
          }
        },
        "required": [
          "project_id",
          "table_name"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_refresh_custom_domain_status",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "custom_domain_id": {
            "type": "string"
          },
          "project_id": {
            "type": "string"
          }
        },
        "required": [
          "project_id",
          "custom_domain_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_remove_custom_domain",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "custom_domain_id": {
            "type": "string"
          },
          "project_id": {
            "type": "string"
          }
        },
        "required": [
          "project_id",
          "custom_domain_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_save_site_version",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "archive": {
            "type": "string"
          },
          "commit_sha": {
            "type": "string"
          },
          "project_id": {
            "type": "string"
          }
        },
        "required": [
          "project_id",
          "commit_sha"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_save_version_and_deploy_private",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "archive": {
            "type": "string"
          },
          "commit_sha": {
            "type": "string"
          },
          "project_id": {
            "type": "string"
          }
        },
        "required": [
          "project_id",
          "commit_sha"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_update_environment_variables",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": {
            "type": "string"
          },
          "remove": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "set_values": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "is_secret": {
                  "type": "boolean"
                },
                "key": {
                  "type": "string"
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "envvar"
                  ]
                },
                "value": {
                  "type": "string"
                }
              },
              "required": [
                "key",
                "value"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "project_id",
          "set_values"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_update_site_access",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "access_mode": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "public",
                  "workspace_all",
                  "custom"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "allowed_tenant_group_ids": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "allowed_user_emails": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "allowed_workspace_group_ids": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              {
                "type": "null"
              }
            ]
          },
          "editor_changes": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "add_editor_account_user_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "add_editor_group_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "remove_editor_account_user_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "remove_editor_group_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "project_id": {
            "type": "string"
          },
          "viewer_changes": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "add_external_visitor_emails": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "add_viewer_account_user_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "add_viewer_workspace_group_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "remove_external_visitor_emails": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "remove_viewer_account_user_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "remove_viewer_workspace_group_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "project_id"
        ],
        "additionalProperties": false
      }
    },
    {
      "type": "function",
      "name": "_update_site_metadata",
      "strict": false,
      "parameters": {
        "type": "object",
        "properties": {
          "project_id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "project_id",
          "title"
        ],
        "additionalProperties": false
      }
    }
  ]
}
D.19 get_goal（原完整定义约 58 Token） 
{
  "type": "function",
  "name": "get_goal",
  "strict": false,
  "parameters": {
    "type": "object",
    "properties": {},
    "required": [],
    "additionalProperties": false
  }
}
D.20 create_goal（原完整定义约 149 Token） 
{
  "type": "function",
  "name": "create_goal",
  "strict": false,
  "parameters": {
    "type": "object",
    "properties": {
      "objective": {
        "type": "string"
      },
      "token_budget": {
        "type": "integer"
      }
    },
    "required": [
      "objective"
    ],
    "additionalProperties": false
  }
}
D.21 update_goal（原完整定义约 438 Token） 
{
  "type": "function",
  "name": "update_goal",
  "strict": false,
  "parameters": {
    "type": "object",
    "properties": {
      "status": {
        "type": "string",
        "enum": [
          "complete",
          "blocked",
          "paused"
        ]
      }
    },
    "required": [
      "status"
    ],
    "additionalProperties": false
  }
}
D.22 web_search（原完整定义约 12 Token） 
{
  "type": "web_search",
  "external_web_access": false
}

E：计数方法与样本说明

E.1 文字和 JSON 如何变成估算 Token

以下示例可以独立运行；示例中的工具是为解释方法构造的，不是样本中的某个原始接口。安装 tiktoken 后即可运行。

import json
import tiktoken

enc = tiktoken.get_encoding("o200k_base")

def count_text(text):
    return len(enc.encode(text, disallowed_special=()))

def compact_json(value):
    return json.dumps(value, ensure_ascii=False, separators=(",", ":"))

text = "hello"
example_tool = {
    "type": "function",
    "name": "read_document",
    "description": "Read one document by its identifier.",
    "parameters": {
        "type": "object",
        "properties": {"document_id": {"type": "string"}},
        "required": ["document_id"],
        "additionalProperties": False,
    },
}

print("hello tokens:", count_text(text))
print("serialized tool:", compact_json(example_tool))
print("example tool tokens:", count_text(compact_json(example_tool)))

原采集记录中，这段示例的计数结果为：hello 是 1 Token，示例工具是 46 Token。本文沿用记录中的计数，未重新运行模型请求或完整快照分词。

统计这份快照时，文本块分别编码；工具块先按同样方式紧凑序列化，再编码。工具各块之和为 36,647，整个工具数组编码为 36,648，相差的 1 Token 来自连接边界。随后加上文字块的 23,283，得到 59,931。

完整快照未全部公开，因此这段示例可以复现计数方法，但不能独立复现整份请求的 59,931 Token。

E.2 样本说明

样本采集于 2026-10-24，使用自定义模型接入。首轮文字来自 Codex CLI 0.164.0 的会话记录，配上选定的 90 个 Apps 接口后单独发起请求。文字中的 182 项 Skill 目录沿用历史记录，未按这份工具清单重新扫描。因此，它是一份用于分析输入组成的请求样本，不是默认安装后新会话的基准。

项目 记录值
模型服务报告的输入 Token 51,207
缓存读取 Token 0
实际工具调用次数 0
本地分项估算 Token 59,931

本地估算与模型服务报告的数值存在差异。请求格式转换、工具序列化和分词器差异都可能影响计数，原记录没有确定具体原因。因此，正文的分项占比统一使用本地估算总量。

本文由 Yonghui Wang 创作，采用 知识共享署名4.0 国际许可协议进行许可
本站文章除注明转载/出处外，均为本站原创或翻译，转载前请务必署名
最后编辑时间为: Oct 25, 2026 03:12 pm

→ ↓ ↑
BM25：从词频、IDF 到 RAG 关键词检索
Sep 08, 2026
statistic
Agent 工程：Prompt、Context、Harness 与 Loop
Sep 06, 2026
utils
InfoNCE Loss
Sep 06, 2026
pytorch
从零开始学习 Codex Skill
Aug 15, 2026
utils
向量表征与逻辑回归的分类原理
Aug 13, 2026
statistic
ROC曲线
Aug 01, 2026
statistic