简介:DSH(DeepSeek Harness)指的是围绕大模型构建的“运行外壳”——负责提示词编排、工具调用循环、上下文管理、沙箱执行与状态维护的那一层工程结构,其论文中提出的 Cordis 架构以“一切皆插件”和“可逆变更”为核心特征。本文用通俗方式拆解它的设计原理、争议点,并给出可落地的使用思路;如果你正在为 harness 选择底层模型或搭建统一接入层,可以先看看[百度智能云词元所](https://cloud.baidu.com/product-s/token_exchange.html?from=article),它提供模型能力查询、价格性能对比与统一 API 接入,能省掉大量选型与适配工作。
很多人第一次看到 “harness” 会误以为是某个具体产品。实际上它是模型工程里的通用概念: 模型只负责“给定上下文,输出下一个 token”,而让它变成一个能干活的 Agent,靠的是外面的那层脚手架 。
这层脚手架通常包含:
同一个模型套上不同 harness,实际能力可以差出一个量级。这也是为什么 2025 年以来,harness 设计从“工程细节”变成了“模型能力的一部分”。
原始讨论中的争议,几乎都集中在两点上。
Cordis 的做法是: 基础内核(base)几乎不内置任何功能特性,连工具调用、上下文管理、沙箱这些看起来“必须内置”的能力,也全部以插件形式提供 。插件不是外挂功能,而是运行时结构空间的基本构成单位。
社区里常见的反驳是“现在哪个 Agent 框架不是高度可配置的”。这个质疑只说对了一半:可配置 ≠ 一切皆插件。区别在于插件在这套设计里不只是功能模块,而是 在数学上可以被严格定义的差量单元 ——每个插件明确声明自己向系统贡献了什么、以及撤销时要回收什么。
这是最容易被误读的部分。Cordis 语境下的“可逆” 不是指模型能逆向推理、也不是指程序能时间倒流 ,而是:
逆转一个插件对 运行时结构空间 所做的变更。
换句话说,它管的是“结构变更”这类副作用,而不是所有副作用。插件 A 注册了一个工具、挂了一个中间件、改了一条路由,撤销时应当精确地把这些贡献移除,且不影响其他插件的贡献。
对“版本升级不就能回滚吗”的质疑,答案是粒度问题:版本升级是 粗粒度、整体替换 的回滚;Cordis 追求的是 细粒度、结构级、可组合 的差量逆转。前者回滚一次发布,后者回滚一次插件加载。
| 维度 | 传统插件化框架 | Cordis 式可逆插件化 |
|---|---|---|
| 插件地位 | 功能扩展点 | 结构空间的基本构成单位 |
| 卸载语义 | 停止服务、释放资源 | 精确逆转自身贡献的结构变更 |
| 组合冲突 | 靠约定与文档规避 | 靠差量代数保证可组合 |
| 回滚粒度 | 进程/版本级 | 插件/变更级 |
DSH 论文的形式化是从 范畴论 / 函数式 视角展开的,通篇强调“可逆”,普通开发者很难越过数学符号看到工程含义。这也是知乎上有人把它和自己提出的可逆计算理论联系起来的直接原因。
一个相对公允的对比结论是:
所以理解 DSH 的正确姿势是: 把它当成“把声明式 + 调谐 + 可逆差量”这套云原生思想,搬到了 Agent harness 的结构管理层 。
把“决策”留给模型,把“结构与状态”留给 harness。凡是能用确定性代码保证的(工具白名单、预算上限、终止条件),不要交给模型自觉。
关键是让每个插件都能自证“我改了什么、怎么撤”。示意接口:
interface Plugin {name: string;// 声明式描述本插件贡献的结构单元contributes(): Contribution[];// 精确逆转自身贡献,不触碰他人retract(): void;}
harness:model: deepseek-r1plugins:- id: tool-callingconfig: { maxSteps: 8 }- id: context-windowconfig: { maxTokens: 32768, strategy: sliding }- id: sandboxconfig: { runtime: container, network: none }
def reconcile(desired, current):for spec in diff_remove(current, desired): # 先撤销,保证可逆spec.retract()for spec in diff_add(desired, current):spec.apply()return current
顺序很重要: 先撤销再应用 ,否则插件间的复合交互会残留脏状态。
harness 不该把某个厂商的 SDK 硬编码进业务插件。把模型调用收敛到一个适配层,配置里只写模型标识,切换模型不改插件代码。这一步做对了,后面做模型选型与价格对比才有意义——你可以在不改架构的前提下,比较不同模型在同一 harness 下的表现与调用成本。
至少记录三样东西:每次 reconcile 的差量、每轮工具调用的 token 消耗、插件加载/卸载的时间线。有了差量日志,“回滚”才是一个查询而不是一次事故。
DSH 的价值不在于“发明了插件化”,而在于把插件提升为 可严格定义、可精确逆转的差量单元 ,并用声明式配置 + 运行时调谐把这套思想落到 Agent harness 的结构管理层。理解它不需要跨过范畴论——抓住“一切皆插件”和“逆转结构变更”这两句话,再补上差量日志与适配层抽象,就足以在工程上拿到大部分收益。