DeepSeek Harness 术语表：Scope、目标与轮次

DeepSeek Harness 对 Scope、Goal、Turn 和 Step 等词有明确的工程定义。把它们当作普通口语使用，容易写错配置，也会让 Bug 报告失去准确性。这份中文术语表用实际场景解释官方概念，并说明几个容易混淆的词到底差在哪里。

规范定义来自 DeepSeek Harness 官方中文术语表。本文在保留技术含义的前提下增加了例子和检索友好的说明。

能力接缝（Capability Seam）

能力接缝是一条“可替换能力”的边界，由三部分组成：

1. Service Definition 声明契约；
2. 一个或多个 Provider 实现契约；
3. 一个或多个 Consumer 调用能力。

可以把 Shell 执行理解为例子：Consumer 只通过统一 Service 请求运行命令，本地、远程或测试 Provider 决定具体如何执行。Consumer 不需要直接依赖所有实现。

能力接缝不只是一个 TypeScript Interface，它还涉及 Provider 注册、插件生命周期、选择与错误处理。何时值得使用，可查看 DeepSeek Harness 架构指南。

Agent Scope

Agent Scope 是为单个 Agent 创建的 Cordis Scoped Context，agent.ctx 就是该上下文。它保存属于该 Agent 的注册项与行为。

Scope Key 使用对象身份，不是同名字符串。Scope 结构刻意保持扁平：Subagent 拥有自己的 Scope，而不是自动继承一棵很深的父级 Scope 树。Parent 与 Subagent 的关系属于 Lineage 数据，并不代表能力自动可见。

系统先过滤全局工具，再合并 Scope Local Tool，因此 Agent 可以加入自己的工具，又不会暗中撤销全局限制。Setup Window 会在 Session 正式发布前完成注册，避免其他组件看到一个只配置到一半的 Agent。

Goal

Goal 是挂在 Session 上的单个持久目标，可以进入 active、paused、blocked 和 complete 等阶段。Goal Round 则为持续追求目标提供有预算的自主工作周期。

Goal 不是另一段对话，也不是通用任务调度器。对话记录仍由 Session 保存；安排未来执行属于 Schedule 能力。可在 工具目录 中分别查看 Goal 与 Schedule 工具。

Goal 还能在本地被 armed 或 disarmed，但这个启用开关属于控制状态，不会被当成新的持久目标事实反复回放。

Human Command

Human Command 是由 Human Adapter 处理的斜杠命令。它不是发送给模型的普通 User Message，也不自动等于 Shell 命令。

这条边界可以避免界面控制信息污染模型对话。文档介绍命令时，应明确它是在改变 Adapter、调用工具，还是加入模型可见消息，不能只让用户根据 / 前缀猜测。

Turn

Turn 是一次由输入触发的完整响应周期，可以包含零个或多个模型 Step。它从输入开始，在 Agent 完成一连串模型与工具工作，或进入终止路径后结束。

讨论对话级 Trace 与状态时使用 Turn。通常一条 Follow-up 会开启一个 Turn，但这个 Turn 内可能调用模型多次。

Step

Step 是一次模型请求及其相关工作。模型返回 Tool Call 后，工具结果可能使同一个 Turn 再进入下一个 Step。

统计模型请求、排查 Prompt 组装、分析 Provider 错误或工具循环时，应使用 Step。完整时序可阅读 Agent 生命周期详解。

Goal Round

Goal Round 是追求 Active Goal 时使用的、有边界的自主工作周期。它与 Turn、Step 不同：

• Step 表示一次模型请求；
• Turn 表示一次输入驱动的响应周期；
• Goal Round 表示一段有预算的自主目标工作。

把三者分开，预算与监控数据才有意义。“三轮目标预算”不能在没有证据时直接解释为“三次模型请求”。

核心术语对照表

术语	主要作用	本身是否持久化
Capability Seam	隔离可替换的 Provider	定义属于代码或配置
Agent Scope	保存 Agent 本地注册项	Scope 属于运行时状态
Goal	保存 Session 的目标与阶段	是
Human Command	控制 Human Adapter	不是模型消息
Turn	一次输入驱动的响应周期	相关事件可持久化
Step	一次模型请求周期	结果可按需持久化
Goal Round	有预算的自主目标工作	取决于 Goal 系统记录

官方原文

本文依据 DeepSeek Harness 官方术语表（中文） 扩展编写，核对日期为 2026-08-20。如果第三方文章使用了不同定义，应优先采用官方仓库的当前术语。