Agent Harness 从入门到精通 / A01

附录 A · 术语表

按主题分组。凡本教程出现的英文术语、命令、配置键、事件名，尽量收全。标注 官方 / 原文 / 社区 / 推断 的来源等级同 README 第 1 节。

A.1 核心概念

术语	英文 / 全称	含义	来源
Harness	Agent Harness / agent scaffolding	模型之外让 Agent 能行动的全部软件：loop、工具、状态、上下文、沙箱、护栏	社区
公式	`Agent = Model + Harness`	模型负责思考，Harness 负责把思考变成动作	官方 DeepSeek 官网
Inner Harness	—	厂商内置：loop、bundled tools、权限模型	社区 Böckeler
Outer Harness	user harness	你叠加的：`AGENTS.md`、hooks、skills、MCP、测试	社区
Seam	Capability Seam	可替换能力：Service Definition + Provider + Consumer 三元组	官方
Ratchet	harness engineering ratchet	每次犯错都改环境，使同类错误不再发生	社区 Hashimoto
信息对等	information parity	人能看到的信息，Agent 也必须能看到	社区
观测等价	observational equivalence	不同组件的效应交错而不互相干扰（Cordis 论文）	论文
固定成本	—	工具 schema 与系统提示词带来的每轮固定 token 开销	推断
Done	defined state	「完成」是可机器判定的状态，不是感觉	社区
Fail closed	—	依赖缺失时让运行失败，而非静默降级	社区
HITL	Human-in-the-Loop	副作用前的人工审批	社区
EDD	Eval-Driven Development	评测驱动开发	社区

A.2 DSH 四种模式与命令 [官方 / 原文]

术语	含义
`Standard`	标准模式，完整工具组合，做事
`PTC`	Programmatic Tool Calling，模型生成代码编排多轮工具调用；早期称 Code mode
`Minimal`	极简模式，仅持久化 bash + `str_replace_editor`，用于基准测试
`Creator`	创造模式，检查运行时、内存试插件、组合新预设
`native` / `code`	工具呈现模式的两个取值，`native → code` 即切到 PTC
`run_code`	PTC 下提交程序的工具
`dsh`	CLI 命令名
`dsh web`	启动 Web UI，默认 `http://127.0.0.1:3080`
`--no-open`	起服务但不开浏览器
`--profile <name>`	指定 profile：`web` / `headless` / `sdk` / `sdk-minimal` / `acp`
`--dump-config`	打印实际启动的插件树
`--patch`	叠加 patch overlay
`/plan` / `/plan off`	计划模式进 / 出
`/goal`	长期目标；`edit` / `pause` / `resume` / `clear`
`/compact`	手动压缩上下文
`/permission`	查看与切换权限预设
`/repo`	原文示例：自定义斜杠命令

A.3 DSH 架构与配置官方

术语	含义
Cordis	时空可组合性元框架，DSH 的插件内核
Profile	存在 Harness home 的具名组合，列出 bundles + `cordis.patch.yml`
Bundle	Cordis 配置行 + 所挂载代码的分发格式
Patch	按 row id 整行替换或插入配置
Preset	预设，在 `config.plugins` 内做 patch 操作
`dsh-base`	`web` / `headless` / `sdk` / `acp` 共享第一层
`dsh-web-app` / `dsh-headless` / `dsh-sdk-app` / `dsh-acp-app`	各 profile 的应用层 bundle
`dsh-sdk-minimal`	唯一不套 `dsh-base` 的独立显式 SDK 树
`dsh-hmr`	config-only 热模块替换
`ctx` / `Context`	共享上下文，所有 effect / coeffect 经它中介
`ctx.effect()`	注册可逆副作用，卸载时按 inverse 撤销
`ctx.tools` / `ctx.llm` / `ctx.sessions` / `ctx.agents` / `ctx.agentLoop` / `ctx.systemPrompt`	核心包对应的服务键
`ctx.commands` / `ctx.goals` / `ctx.sandbox` / `ctx.fs` / `ctx.jobs` / `ctx.terminals`	其他扩展接缝
`apply`	插件入口函数
`inject`	依赖声明（`static inject` / 对象字段）
`Service` / `super(ctx, '服务名')`	类形式插件，向其他插件提供服务
`agent.inject()`	新增模型可见上下文的正规入口
`SessionEvent`	append-only 会话事件
`deriveMessages()`	从日志投影出模型历史
`Model-visible means logged`	每次模型请求必须可从日志重建
`Trajectory`	按来源查看模型所见一切的视图
`step` / `turn`	step = 一次模型请求 + 其工具调用；turn = 零到多个 step
`subagent` / `subagent_fork` / `workflow` / `ralph`	四个派活工具
`list_agents` / `send_message` / `interrupt_agent`	后台管理三件套
`schedule_create` / `list` / `update` / `delete`	定时任务四工具（子 Agent 被 deny）
`dsh-automation` / `dsh-agent-teams`	社区插件；Captain 为队长
`dsh-plugin`	GitHub topic，用于插件可发现性
`SAFETY.md` / `AGENTS.md` / `BENCHMARK.md`	仓库根文档

A.4 事件与 hooks

事件	域 / 平台	含义
`turn/start`、`turn/end`、`step/start`、`step/end`	DSH durable	回合与步骤边界
`system/message`、`user/message`、`assistant/message`、`tool/call`、`tool/result`	DSH durable	模型可见事实
`assistant/attempt`	DSH durable	失败/重试/取消的尝试，不进模型历史
`agent/*`	DSH live	inbox / step / status / request / validation / continuation
`agent/pre-step`、`agent/request`、`agent/turn-stopping`	DSH live	改写/拒绝输入、请求钩子、停止判定
`tools/pre-execute`、`tools/execute`、`tools/post-execute`	DSH live	工具执行三级流水线（waterfall）
`fs/`、`telemetry/`	DSH live	能力事件
`PreToolUse` / `PostToolUse` / `PostToolUseFailure`	Claude Code	工具前阻断 / 工具后反馈
`Stop` / `StopFailure`	Claude Code	结束前自检
`PreCompact` / `PostCompact`	Claude Code	压缩前后归档
`SubagentStart` / `SubagentStop` / `TeammateIdle`	Claude Code	子 Agent 生命周期
`WorktreeCreate` / `WorktreeRemove`	Claude Code	工作树隔离
`SessionStart` / `SessionEnd` / `InstructionsLoaded`	Claude Code	会话与规则审计
`TaskCreated` / `TaskCompleted`	Claude Code	任务门禁
`PermissionRequest` / `PermissionDenied`	Claude Code	审批

waterfall：上述 DSH 的 agent/pre-step、agent/request、llm/stream、tools/* 监听器必须调用 next() 委托；agent/turn-stopping 串行且无 next()。

A.5 评测与生产

术语	含义
Terminal Bench 2.0	命令行 Agent 基准；LangChain 称只改 Harness 使排名 top 30 → top 5
Self-verification middleware	结束前自检，对应 Stop hook
Exact Match / Contains / LLM-as-judge	三种评分方式
Coverage test	只检查「规则是否被覆盖」、让构建失败的测试
Guide / Sensor	事前引导 / 事后反馈；各分 computational 与 inferential
七层	Guide → Constrain → Gate → Sense → Alert → Audit → Recover
Time-window alert	基于时间窗（非单事件）的告警
Redaction	把 `password` / `secret` / `token` 等字段替换为 `***`
Worktree	每 Agent 独立工作树与分支，零共享可变状态
Golden principles	编码进仓库、由后台任务持续强制的机械规则（OpenAI）
Ralph Wiggum Loop	自审 → 多 reviewer → 响应反馈 → 循环直到满意（OpenAI 用语）
AI slop / entropy	Agent 复制仓库已有坏模式造成的漂移
Deterministic node / Agentic node	脚本节点 / 模型节点（Stripe 转述）

A.6 缩写

缩写	全称
DSH	DeepSeek Harness
PTC	Programmatic Tool Calling
MCP	Model Context Protocol
HMR	Hot Module Replacement
HITL	Human-in-the-Loop
OTel	OpenTelemetry
IANA	Internet Assigned Numbers Authority（时区标识，如 `Asia/Shanghai`）
SRE	Site Reliability Engineering
JSONL	JSON Lines
SDK	Software Development Kit
ACP	Agent Client Protocol（DSH `acp` profile）
FDE	Forward Deployed Engineer（本站主体）

本系列为本站原创教程，基线为微信公众号《DeepSeek Harness 最新高阶指南》（2026-11-05），并汇总 DeepSeek 官方仓库与文档站、Cordis / arXiv:2608.25512、以及 OpenAI / Anthropic / LangChain / Martin Fowler 等一手资料。每条引用均标证据等级，完整清单见附录 B；未定位到一手来源的线索单列，未编造补位。DeepSeek Harness 为 developer preview，官方 SAFETY.md 明确「未经过安全审计、不得视为生产就绪」，命令与配置键可能随版本失效。资料截止 2026-11-06。姊妹篇：《FDE 入门到精通》。