第 01 章 · 第一性原理：Agent = Model + Harness

本篇目标：把任意一个 Agent 系统，干净地拆成「模型」与「非模型」两半。

1.1 一个公式，两个盒子

官方 DeepSeek 官网首页把产品定位写成一行：

Agent = Model + Harness

社区 LangChain 的 Vivek Trivedy 在 The Anatomy of an Agent Harness（2026-03-10）给出等价的强表述：

"If you're not the model, you're the harness. A harness is every piece of code, configuration, and execution logic that isn't the model itself."

这个公式的价值不在简洁，在它强迫你做二分类：

判据 1：答不上来「它是模型吗」的，都是 Harness。

推论：当你说「这个模型不行」时，有极大概率你在描述一个 Harness 缺陷。第 06 章会给出可操作的判别流程。

1.2 一个更硬的类比：Harness 是操作系统

社区 Beren Millidge（Scaffolded LLMs as Natural Language Computers, 2023）把原始 LLM 类比为没有内存、没有硬盘、没有 I/O 的 CPU。补全这张表：

这个类比给出一个直接可用的设计原则：

判据 2（能力上限）：Harness 不能提升模型的推理上限，但能决定这个上限有多少比例被稳定兑现。提示词写得再狠，也换不来不存在的推理能力；但环境设计错了，会把已有的能力成片浪费掉。

原文那句「门槛不在安装，在心智模型」，工程含义就是：把优化对象从模型权重切换到环境。

1.3 三次演进：不是替代，是包含

社区 2022–2026 年 AI 工程的重心迁移，主流梳理为三到五个层次。下表合并 Nicolas Neira 的三时代与 Heym 的五层划分：

关键差异 社区：

"A context engineer asks what the model was missing. A harness engineer asks what in the environment allowed the mistake, and what would catch it next time without a person."

Harness engineering 增加的唯一新维度是时间：不是把这一轮做对，是把环境改到这个错误在类上永久消失。第 07 章整章讲这个 ratchet。

1.4 六个要素：Harness 的最小完备集

社区 一个可运行的 Agent Harness 至少包含六部分。右列给出 DSH 中的对应实现 官方：

docs/architecture.md 的核心包表还给出更细的接缝：ctx.llm（模型适配器）、ctx.agents（Agent 注册表）、core/scope（按 Agent 隔离注册）。这些在第 03、11 章展开。

判据 3（完备性）：评审一个 Harness，逐个问「这六件事谁负责」。答不出来的那一格，就是线上事故的入口。

1.5 Inner / Outer：哪一半真正属于你

社区 Birgitta Böckeler（martinfowler.com, 2026-04-02）把 Harness 切成两层：

DSH 的特殊性在于它把 inner/outer 的边界主动拆掉了。官方 架构文档原句：

"There is no privileged core to patch: you extend dsh by mounting a plugin beside the others, and registrations are effects that unwind when their plugin unloads."

即：模型适配器、工具注册表、会话日志、Agent Loop 本身全是插件，配置层可替换。这是「一切皆插件」的工程含义，也是本系列选它做主解剖对象的原因——它把通常不可见的 inner harness 变成了可读、可改、可复盘的教材。

1.6 为什么这件事值得系统学：三组证据

第二、三组数字来自原文，本教程未独立复现，只用于说明量级，不作为性能承诺。但它们共同指向一个非直觉的结论：

工具越多，每次对话的固定成本越高。 二十多个工具的说明书会写进系统提示词，你每一次交互都在为它们付费。Harness 设计里存在一条明确的「能力—开销」帕累托前沿，第 09 章量化它。

以及一条评测纪律 原文：

一个 benchmark 分数，部分反映测试时使用的 Harness，而不仅是模型。

所以第 15 章要求：固定 Harness 才能比模型，固定模型才能比 Harness。 混着比得出的结论无效。

1.7 本章产出与验收

核心产出：一张你自己系统的「组件归类清单」——把当前项目里每个模块标成 Model / Harness，并标注它属于六要素中的哪一格。

验收点：

• 能指着任意一个组件，在 3 秒内判定 Model / Harness
• 能说出六要素各自在你系统里的责任模块；说不出的记为缺口
• 能区分 inner / outer，并指出哪些文件已经进了 git、哪些还只存在某个人的脑子里
• 能解释「写得更狠 ≠ 写得更准」在概率采样意义下的原因

最后一问：你现在的 AGENTS.md 里，有多少行能追溯到一次具体的线上失败？答不上来，就去第 07 章。

延伸阅读