3.5 KiB
Agent Note: 将 code-mode 重命名为 ptc——传输层命名为 PTC，用户文案使用 PTC mode
Status: implemented
English | 中文
问题
通过生成的 SDK 与 run_code 传输层向模型呈现工具的注册表模式，发布时用的名字是 Code Mode；而选择该模式的客户端预设早已以「PTC mode」发布（locale presetPtcName: 'PTC mode'，中文 PTC 模式）。同一功能有两套名字：配置值、插件与事件名、文件与文档写的是 code／code-mode，用户可见的名字却是「PTC mode」。预发布阶段的更名必须一次性更新所有引用——不加任何兼容别名。
决策
该功能更名为 PTC（programmatic tool calls，程序化工具调用）。代码标识符使用 ptc——该传输层并非 plan-mode 的同类模式，因此标识符不带 -mode。用户可见文案沿用「PTC mode」（英文）／「PTC 模式」（中文），与已发布的预设名一致。
本 PR 完成的重命名包括：
- 配置值
tools.mode: 'code'→'ptc'（ToolPresentationMode以及dsh-tools、dsh-agent-tool-presentation中的 zod union） - 预设目录
presets/code/→presets/ptc/（预设 id 为ptc） - 源文件与测试文件
code-mode.ts→ptc.ts等；根 demodemo:code-mode→demo:ptc（scripts/demo-ptc.mjs） - 分发 waterfall
tools/code-dispatch-log→tools/ptc-dispatch-log，类型CodeDispatch*→PtcDispatch* - 提示词规则
tools:code-only→tools:ptc-only - 文档、README 与八个以该功能命名的 implemented Agent Note 中的文案 "Code Mode" → "PTC mode"／"PTC 模式"（这些 Note 文件一并就地改名）
延后到堆叠的持久化 PR：会话持久词汇——持久事件类型 tool/code-dispatch／tool/code-dispatch-start、日志中的插件名 tools-code-mode、子调用 id 段 :code:。该 PR 被阻塞，直到 SESSION_FORMAT_VERSION v0→v1 迁移与其一同落地。
保持不变：run_code 及其 code 参数（它们描述程序载荷，而非模式）、CodeSdkLanguage、CodeRunFailedError、dsh-code-runtime* 包族、第三方二进制名 codex-code-mode-host，以及所有冻结的 archived Note。
备选方案
- 使用
ptc-mode标识符——否决：PTC 是工具呈现传输层，不是 plan-mode 意义上的模式，标识符不应宣示这种亲缘关系。 - 仅重命名表面——否决：预发布立场要求一次性更新所有引用。
- 连
run_code一起改名——否决：该工具名描述的是运行程序，不是模式，而且是对模型可见的 API 表面。 - 在本 PR 中一并重命名持久事件词汇——否决：在没有格式版本提升的情况下重命名
tool/code-dispatch*会让更名前的会话日志无法读取；该重命名属于与 v0→v1 迁移一同落地的堆叠持久化 PR。
后果
配置中写 mode: code、预设 id 为 code，在本构建上不再受支持。会话持久词汇仍为 tool/code-dispatch*、tools-code-mode 与 :code:，因此既有会话日志照常读取，无需 SESSION_FORMAT_VERSION 提升。堆叠的持久化 PR 负责重命名该词汇，并被阻塞到 v0→v1 迁移与其一同落地（版本机制见 Session log 版本 Note）。无密钥的 snapshot refresh 携带本 PR 的词汇；持久化 PR 刷新包含分发的夹具。本 Note 所更名的已发布决策是 PTC 基础 Note。