使用说明
- 每个术语后面都给出了它在本专题中的出处笔记，详细的定义和原始出处请看对应笔记的“参考资料”。
- 同一个词在不同 SDK 中含义可能不同，比如 turn 和 session。遇到这种情况会特别标注。
- 资料截至 2026-10-09。
A–G#
| 术语 | 解释 | 出处笔记 |
|---|---|---|
| ACP（Agent Client Protocol） | 让编辑器或客户端驱动 agent 的协议。DSH 提供了一个仅供自动化使用的 ACP 服务器（dsh-acp），也有通过 ACP 驱动子 agent 的后端 | 5.1 DeepSeek Harness 全景 |
| Adaptive thinking（自适应思考） | Claude 新一代模型的推理方式：由模型自己决定是否思考、思考多少，用 effort 引导。它取代了旧的 budget_tokens 手动预算 | 3.2 Anthropic 客户端 SDK 与 Messages API |
| Agent（智能体） | OpenAI 的定义是“配备了指令和工具的 LLM”；Claude Agent SDK 的定义是“通过自己规划步骤、调用工具来完成任务的应用” | 1.1 从 LLM API 到 Agent Harness 的分层 |
| Agent Loop（智能体循环） | 反复执行“调用模型 → 执行工具 → 回填结果”，直到模型不再请求工具。它是所有 agent SDK 的核心 | 1.2 Tool Calling 与 Agent Loop 原理 |
| Agents as tools（Manager 模式） | 把一个 agent 包装成另一个 agent 的工具。中心 agent 始终掌控对话，并负责最终答案 | 2.3 OpenAI Agents SDK |
| Bundle / Profile / Patch（DSH） | 组合包、具名组装、配置补丁。运行中的 dsh 是一棵插件树，按“各个组合包 → profile 的 patch → home 级 patch → 命令行 --patch”的顺序叠加而成 | 5.1 DeepSeek Harness 全景 |
| Client tool / Server tool（客户端工具 / 服务端工具） | 按谁来执行区分：客户端工具由你的程序执行；服务端工具（也叫托管工具），如 web search、code execution，由厂商执行 | 1.1 从 LLM API 到 Agent Harness 的分层 |
| Codemode / PTC（Programmatic Tool Calling） | 让模型写一段代码，在沙箱里批量调用工具，只把代码的输出返回给模型。OpenAI 的 Programmatic Tool Calling、pi 的 codemode、DSH 的 PTC 模式都是这一思路 | 4.4 pi-coding-agent SDK 与扩展系统 |
| Compaction（上下文压缩） | 上下文接近窗口上限时，把较早的历史总结成摘要。Claude Agent SDK、Messages API（beta）、OpenAI Responses、pi、DSH 都支持 | 1.2 Tool Calling 与 Agent Loop 原理 |
| Context（Cordis） | 服务的容器。插件通过 ctx.<服务名> 获取能力，而不是导入具体实现 | 5.2 Cordis 与一切皆插件 |
| Context engineering（上下文工程） | 精确控制哪些内容进入模型的上下文。这是 pi 设计哲学的出发点 | 4.1 pi 全景与设计哲学 |
| Context editing（上下文编辑） | Claude 的 beta 功能，用来清除旧的工具结果或 thinking 块。它和 compaction 的区别是：compaction 是总结，context editing 是删除 | 3.2 Anthropic 客户端 SDK 与 Messages API |
| Conversations API | OpenAI 提供的持久会话对象，配合 Responses 使用，不受 30 天 TTL 限制 | 2.2 OpenAI 客户端 SDK 与 Responses API |
| Effect（Cordis） | 可以撤销的副作用。插件卸载时，它的 effect 会自动回滚 | 5.2 Cordis 与一切皆插件 |
| Effort（推理强度） | 控制模型思考深度和 token 消耗的档位：low、medium、high、xhigh、max | 3.2 Anthropic 客户端 SDK 与 Messages API |
| Environment（托管 agent） | 托管 agent 执行命令、操作文件的地方。OpenAI Agents API 有 none、openai_hosted、self_hosted 三种；Managed Agents 有 cloud、self_hosted 两种 | 2.4 OpenAI Agents API · 3.4 Claude Managed Agents |
| Event sourcing（事件溯源） | 只追加事件，当前状态由回放得出。DSH 的会话日志和 pi 的树状会话都是这种模式 | 5.3 DSH 核心机制与插件开发 |
| Extension（pi） | 一个导出默认工厂函数的 TypeScript 模块，可以注册工具、命令、提供方和事件处理器 | 4.4 pi-coding-agent SDK 与扩展系统 |
| Fail-closed（故障关闭） | 做不到或拿不到确认时，一律拒绝，而不是放行。DSH 的沙箱和审批都遵循这条原则 | 5.3 DSH 核心机制与插件开发 |
| Faux provider（模拟提供方） | pi-ai 内置的脚本化模拟模型，可以在没有 API Key 的情况下测试 agent | 4.2 pi-ai 统一多模型 API |
| Fiber（Cordis） | 一个已加载插件实例的运行时句柄。状态包括 PENDING、LOADING、ACTIVE、UNLOADING、DISPOSED、FAILED | 5.2 Cordis 与一切皆插件 |
| Follow-up / Steering（pi） | follow-up 是在 agent 原本要停下时追加的任务；steering 是在当前这批工具执行完后插入的指令 | 4.3 pi-agent-core 最小 Agent 运行时 |
| Guardrail（护栏） | 对输入、输出或工具调用做校验，不通过时触发 tripwire，中断执行（OpenAI Agents SDK） | 2.3 OpenAI Agents SDK |
H–R#
| 术语 | 解释 | 出处笔记 |
|---|---|---|
| Handoff（转交） | 把对话的控制权交给另一个专家 agent。在模型看来，handoff 就是一个名为 transfer_to_<agent> 的工具 | 2.3 OpenAI Agents SDK |
| Harness（驾驭层） | agent 的完整运行时：在循环之外，还有内置工具、上下文管理、会话、权限与沙箱、扩展机制 | 1.1 从 LLM API 到 Agent Harness 的分层 |
| Hook（钩子） | 在循环的关键节点运行你自己的代码，比如工具执行前后、prompt 提交时、压缩前。Claude Agent SDK 的 hooks 在你的进程里运行，不占用上下文 | 3.3 Claude Agent SDK |
| HITL（Human in the loop，人工审批） | 敏感操作执行前暂停，等人批准。例如 OpenAI Agents SDK 的 needs_approval 加 RunState，Claude Agent SDK 的 can_use_tool | 2.3 OpenAI Agents SDK · 3.3 Claude Agent SDK |
| Idempotency key（幂等键） | 重试时复用同一个键，避免重复提交。OpenAI Agents API 发送消息时建议使用 | 2.4 OpenAI Agents API |
| Inject（Cordis） | 插件声明自己依赖的服务。依赖就绪之前，插件处于 PENDING 状态；依赖消失时，插件会被卸载 | 5.2 Cordis 与一切皆插件 |
| Item（OpenAI Responses） | 输入和输出的基本单元，可以是 message、reasoning、function_call、function_call_output 等 | 2.2 OpenAI 客户端 SDK 与 Responses API |
| MCP（Model Context Protocol） | 一个开放协议，规定应用如何以标准方式向 LLM 提供工具和上下文。Anthropic 于 2024-11-25 发布 | 1.1 从 LLM API 到 Agent Harness 的分层 |
| Outcome（Managed Agents） | 用 user.define_outcome 加评分标准（rubric）启动会话，由 harness 打分，agent 反复修改直到达标 | 3.4 Claude Managed Agents |
| Permission mode（权限模式） | Claude Agent SDK 的审批档位：default、acceptEdits、plan、dontAsk、auto、bypassPermissions | 3.3 Claude Agent SDK |
| Preset（DSH） | 用 YAML 声明一个 agent 由哪些插件组成。web-app 组合包随附了 standard、ptc、minimal 三个 preset | 5.1 DeepSeek Harness 全景 |
| previous_response_id | OpenAI Responses 的链式状态：只发送新输入，由服务端接续上下文。链上的历史输入仍然计费 | 2.2 OpenAI 客户端 SDK 与 Responses API |
| Prompt caching（提示词缓存） | 复用相同的前缀以降低成本和延迟。缓存按前缀匹配，任何一个字节的变化都会让它之后的缓存失效 | 3.2 Anthropic 客户端 SDK 与 Messages API |
| Refusal / Fallback | Claude 新模型的安全分类器拒绝请求时，返回 stop_reason: "refusal"；fallbacks 参数可以自动换成备用模型重试 | 3.2 Anthropic 客户端 SDK 与 Messages API |
| Runner（OpenAI Agents SDK） | 执行 agent 循环的类，提供 run、run_sync、run_streamed 三种方式 | 2.3 OpenAI Agents SDK |
S–Z#
| 术语 | 解释 | 出处笔记 |
|---|---|---|
| Sandbox（沙箱） | 隔离的执行环境。DSH 有 read-only、workspace-write、danger-full-access 三档；pi 默认没有沙箱 | 5.3 DSH 核心机制与插件开发 |
| Seam（DSH） | 可替换的能力，由三种角色组成：Service Definition（接口）、Service Provider（实现）、Consumer（使用方） | 5.2 Cordis 与一切皆插件 |
| Service（Cordis） | 插件提供的具名能力，例如 ctx.tools、ctx.llm | 5.2 Cordis 与一切皆插件 |
| Session（会话） | ⚠️ 不同产品含义不同：OpenAI Agents SDK 中是客户端的历史存储；Agents API 和 Managed Agents 中是托管的 agent 实例；Claude Agent SDK 和 pi 中是本地的 JSONL 文件；DSH 中是事件溯源日志 | 各篇 |
| Skills | 可复用的“说明书 + 脚本”包，是一个带 SKILL.md 的目录，需要时才加载完整内容 | 1.1 从 LLM API 到 Agent Harness 的分层 · 4.4 pi-coding-agent SDK 与扩展系统 |
| Stop reason（停止原因） | 模型为什么停下。Claude 的取值有 end_turn、tool_use、max_tokens、pause_turn、refusal 等；pi-ai 的取值有 stop、length、toolUse、error、aborted | 3.2 Anthropic 客户端 SDK 与 Messages API · 4.2 pi-ai 统一多模型 API |
| Strict tool use / Structured outputs | 强制工具参数或模型输出符合 JSON Schema | 2.2 OpenAI 客户端 SDK 与 Responses API · 3.2 Anthropic 客户端 SDK 与 Messages API |
| Subagent（子 agent） | 派生出来完成子任务的 agent，拥有独立的上下文，只把结论交回给父 agent | 3.3 Claude Agent SDK |
| Tool Runner | Anthropic 客户端 SDK 中的 beta 循环辅助工具（client.beta.messages.tool_runner）。它不是 Claude Agent SDK | 3.2 Anthropic 客户端 SDK 与 Messages API |
| Tool search / defer_loading | 先把用得少的工具隐藏起来，模型需要时再按需加载它们的定义，以节省上下文 | 2.2 OpenAI 客户端 SDK 与 Responses API |
| Tracing / Span | 记录一次工作流中的每一步。OpenAI Agents SDK 默认开启 tracing | 2.3 OpenAI Agents SDK |
| Turn / Step（轮次 / 步骤） | ⚠️ 不同产品含义不同：Claude Agent SDK 的 turn 指一次模型输出加上它触发的工具执行；DSH 的 step 指一次模型请求加上工具调用，而 turn 包含零个或多个 step | 1.1 从 LLM API 到 Agent Harness 的分层 |
| TypeBox | 用来定义 JSON Schema 的 TypeScript 库，同时提供类型推导和运行时校验。pi 用它定义工具参数 | 4.2 pi-ai 统一多模型 API |
| Vault（凭据保险库） | 托管 agent 用来存放凭据的地方。真实的密钥不会进入沙箱，只在出站请求时才被替换进去 | 2.4 OpenAI Agents API · 3.4 Claude Managed Agents |
| Waterfall（Cordis 事件模式） | 环绕中间件式的事件分发。监听器可以改写 next() 的结果，也可以不调用 next() 直接短路 | 5.2 Cordis 与一切皆插件 |