| 术语 | 英文 | 一句话定义 | 出处 |
|---|---|---|---|
| PTC | Programmatic Tool Calling（呈现方式） | 只把run_code与生成的SDK发给模型，让模型用一段程序组合多步工具调用 | ToolPresentationMode = native | ptc | both |
| native | native presentation | 把每个可见工具的完整schema发给模型，逐个调用 | 同上 |
| preset | agent preset | 一套可挂载的agent组合（工具、提示、能力），目录名即id | presets/{standard,ptc,minimal,cordis} |
| profile | dsh profile | $DSH_HOME/profiles下的一套启动配置，由bundles叠加patch层合成 | cordis.yml顶部注释 |
| bundle | bundle | package.json里dsh.profile.bundles列出的可装载包，按顺序叠加 | profiles/web/package.json |
| patch层 | patch layer | 最后应用的覆盖层，改配置改这里 | Edit cordis.patch.yml, not this file |
| run_code | run_code | PTC模式下模型唯一能直接调用的工具 | config-catalog |
最容易混的两组
- preset ≠ profile：preset是「agent长什么样」（工具与提示的组合），profile是「怎么启动」（入口配置与bundle列表）。换preset改的是能力面，换profile改的是加载路径。
- bundle ⊂ profile：bundle是列在profile的package.json里的包，按顺序叠；patch层在它们之后。所以改patch层永远压得住bundle的默认值。
一句忠告
这几个词在不同版本里含义可能漂移。术语条目一定要带出处，出处写明是哪个文件、哪一行——不然半年后你自己也不知道当时指的是什么。