5.6 KiB
5.6 KiB
术语表
English | 中文
DeepSeek Harness SDK 的领域词汇为每个概念规定一个规范术语。各术语通过标准 Markdown 锚点链接到相应条目；实现细节留在各包（package）的 README 与 Agent Note（agent 决策记录）中。
FIXME(glossary-completeness): 首次发布前扩充本术语表，使其覆盖 SDK 的其他核心与能力子系统，而非仅限于 agent scope。
agent-scope
- scope：按 agent（智能体）划分的注册单位。一项贡献（工具、提示词片段、变量、限制、监听器）要么是全局的（对所有 agent 可见），要么是有范围的（归属于恰好一个 scope key）。只有两层，扁平结构：有范围的注册不会向下继承给 subagent；子树行为通过 lineage 数据表达，从不通过 scope 结构。
- scope key：scope 的不透明标识，按对象同一性比较。harness 约定：一个活跃的 agent 就是其自身 scope 的 key。
- agent 上下文（
agent.ctx）：agent 的有范围上下文；通过它进行的注册既是 scope 可见的，也是 scope 生命周期的（同一事实决定两者），其上的监听器参与该 agent 的 scope 过滤分发。注册表主体事件可以在各自的事件契约下保持故意不过滤。 - scope carrier：scope 过滤分发所携带的
thisArg（由scopeTarget构建）；其过滤器放行无标签监听器加上主体自身的监听器。无主体的 carrier（没有 key）只放行无标签监听器。 - scoped dispatch：规则是：关于某个 agent 活动的事件以该 agent 的 carrier 进行分发。关于注册表本身的事件（如「一个工具被添加了」）属于注册表主体事件，保持不过滤。
- shadowing：最具体者胜出的名称解析：一个有范围的工具/片段/变量仅在该 scope 内替换同名的全局对应项。这是按 agent 定制 persona 和按 agent 定制工具变体的机制。
- restriction / scope-local 注册：restriction（
tools.restrict）为单个 scope 过滤全局工具表面（多个 restriction 取交集组合）；scope-local 注册在过滤之后合并。被过滤掉的全局工具既不出现在提示词中，也拒绝执行，与不存在的工具无法区分。 - setup window：创建者组装 agent 有范围世界的创建时隙（
CreateAgentOptions.setup）：在 scope 和 agent 对象已存在、但 agent 或会话尚未发布、agent/session-start尚未触发、首次提示词尚未组装之前。setup 只做注册，从不驱动 agent。 - lineage：以数据形式携带的父子关系事实（
parentSession、持久的delegationDepth、运行时subagentDepth）；从不影响可见性。
目标
- 目标：附着在现有会话上的单个持久完成目标，带有按修订号演进的
active/paused/blocked/complete阶段和目标回合上限；blocked保留策略代码与说明。目标是一种状态，不是调度器，也不是一段独立对话；会话日志仍是其真源。 - 目标回合：为当前目标接纳的一次续行周期。同会话驱动器将目标回合具体化为一个来源为目标的轮次，其中可以包含多个步骤；同一会话中无关的人类轮次不消耗目标回合上限。
- 目标激活：续行消费方接纳下一个目标回合的进程本地权限。激活态为
armed或disarmed；它有意不参与持久回放，因此恢复和 fork 后，必须由人类随后通过/goal或模型工具授权恢复变更，自动工作才可开始。
人类命令
- 人类命令：以斜杠开头的指令，由面向人类的适配器通过
ctx.commands解释并执行，不会成为模型消息。它既不同于面向模型的工具，也不同于通过ctx.bash执行 shell 命令。 - 命令平面：由 UI 适配器与命令插件拥有的发现、解析、分发、取消和结果渲染。除非处理器另行改变持久领域，否则命令输出属于 UI 状态。
- 目标命令：
/goal是由dsh-command-goal提供的人类命令；它直接观察或更改当前目标，而目标领域拥有每条持久且模型可见的记录。
循环层级
- 轮次：会话中一次对已接纳输入的排空过程，在模型及其工具停止工作或终止策略介入后结束。
- 步骤：一次模型请求，以及由模型响应引发的工具执行；一个轮次包含一个或多个步骤。
- 回合：包含一个轮次的外层策略迭代，例如一个目标回合或一次全新 agent Ralph 尝试。回合计数器属于该策略，并不统计会话内的每个轮次。