术语表

本表定义 DeepSeek Harness 面向用户与开发者的核心术语。上游仓库的完整术语表还涵盖 scope、lineage、Ralph 等实现细节；入门背景见什么是 DeepSeek Harness，架构细节见Cordis 入门。

harness

harness 是承载 agent（智能体）的运行时框架，负责把模型适配器、工具、文件系统、shell、沙箱、审批与持久化以插件形式组合起来。DeepSeek Harness（dsh）就是这样一个 agent harness（智能体框架），核心理念是一切皆插件。

plugin（插件）

组合的基本单位。Harness 的每项能力——工具、skill（技能）、目标、subagent、界面区块、模型路由——都以插件形式存在，并通过 Cordis 组合。一个 Cordis 插件实现一个 Service：可以是带可选 inject 与 apply(ctx) 字段的函数，也可以是 Service 子类。

profile

存放在 $DSH_HOME/profiles/<name> 下的具名组装。它列出自己叠放的组合包、保存自己安装的树外插件，以及用户自己的 cordis.patch.yml。用 dsh --profile <name> 启动；web 与 headless 首次使用会从内置模板自动初始化。

preset（agent preset）

单个会话的 agent 组合，按「一个 preset 一个目录」组织，由 cordis.yml 文件描述：persona、提示词段、工具、skill 与限制。从一个 preset 组合出一个 agent。详见Agent 预设。

skill（技能）

可复用的任务型指令包，按需加载（例如 astro、code-review），通过 skill 提供方注册表注册。详见技能与目标。

goal（目标）

附着在现有会话上的单个持久完成目标，带有按修订号演进的 active / paused / blocked / complete 阶段和 Goal Round 上限。目标是一种状态，不是调度器，也不是一段独立对话；会话日志仍是其真源。

subagent

在自己的上下文里运行自包含任务的委派 agent，通过 subagent 能力 seam 实现，用于把独立工作分流出去。详见子代理与工作流。

workflow（工作流）

多 agent 编排：一个脚本把工作扇出到众多 subagent，分阶段执行并汇总结构化结果，通过工作流能力实现。

Cordis

Harness 底层的插件框架（以 vendored 形式内置）。它负责组合插件、服务、类型化事件与生命周期（fiber），「一切皆插件」正是它的模型。设计思想见相关项目与生态。

seam

一种包含三种角色的可替换能力：Service Definition（拥有自身 ctx.<key> 与词汇类型的 Cordis Service）、一个或多个 Service Provider，以及一个或多个注入该服务的 Consumer。seam 是完整能力，绝不是其中一个角色。

Service Provider

能力 seam 的命名角色：提供某个 Service Definition 的实现。单数固定写作 Service Provider，复数写作 Service Providers。

fiber

一个已加载的插件实例，包含其生命周期状态、经过校验的配置与已注册的作用。ctx.fiber 是当前 fiber，ctx.effect() 会把副作用挂到它上面，使卸载时能按相反顺序清理。

agent loop（智能体循环）

承载一个轮次的核心循环：模型请求以及由模型响应引发的工具执行，直到模型及其工具停止工作或终止策略介入。

tool（工具）

面向模型的能力，agent 可以调用它，通过工具注册表注册。注册与呈现见工具。

slot

客户端架构中的具名可注册位置。Client 插件把界面注册到 slot 中，浏览器 UI 由这些 slot 组合而成。详见客户端 UI 与 Slot。

Host 与 Client

动态插件的两个运行时平面。Host 运行在 Node.js 进程中，负责文件、网络、命令、服务与模型工具，以及可供 Client 调用的 JSON 方法。Client 运行在浏览器页面中，负责主题、布局、页面状态、工具卡片与 Slot UI。两者通过包私有 JSON 方法通信（方向为 Client → Host）。

动态 Cordis 插件（dynamic plugin）

针对运行中进程临时定义并运行的运行时扩展；其定义不写入源码或磁盘，也不在进程重启后保留。详见动态插件。

agent（智能体）

会话中的行动主体：读取与编辑工作区文件、运行命令、委派工作并维护计划。一个活跃的 agent 即其自身 scope 的 key。

turn（轮次）与 step（步骤）

循环层级中的两个单位。轮次是会话中一次对已接纳输入的排空过程，在模型及其工具停止工作或终止策略介入后结束；步骤是一次模型请求加上由其响应引发的工具执行，一个轮次包含零个或多个步骤。