AI大模型已经可以独立完成复杂编码任务,但真正的难点早已不是提升模型本身的智力,而是如何将模型能力稳定、可靠、可观测地组织成一套能够落地的Agent智能体。2026年8月深度求索开源的DeepSeek Harness(简称dsh),正是为解决该问题而生,它提出核心理念:Agent = Model + Harness。模型是Agent的灵魂,Harness则赋予智能体感知环境、调用工具,在真实场景持续工作的执行能力。

什么是 DeepSeek Harness
DeepSeek Harness是深度求索开发的开源Agent运行框架,采用MIT开源许可证,全部使用TypeScript编写,目前处于开发者预览阶段,官方提示后续版本可能存在不兼容变更。
它并不对大模型推理能力做优化,而是专注优化模型运行的外部环境,贯彻Everything is a Plugin(一切皆插件) 的设计思想。模型适配器、工具集、技能、会话、沙箱、存储、Agent循环、任务调度、UI界面,所有智能体能力全部以插件形式实现,依托Cordis插件内核,通过服务与事件完成模块间协作。开发者不需要修改源码,仅在配置层就可以选择、替换、扩展任意一项能力。
底层Cordis插件系统有对应的学术论文支撑,框架运行时不存在特权内核,所有能力注册都是可逆操作,卸载插件时对应的功能会自动撤销,扩展功能只需要挂载新插件即可。
为什么需要Harness
AI Agent领域已经形成共识:性能瓶颈往往不在于模型本身,而在于Agent运行的基础设施。有实验表明,在底层模型参数完全不变的前提下,仅仅优化工具约束、反馈回路、追踪体系等基础设施,编码Agent评测得分就可以获得大幅提升。
DeepSeek Harness正是这套思想的产品化落地,它不去追求打造更强的大模型,而是将Agent所需要的约束条件、反馈机制、工具系统、记忆管理、可观测能力全部封装为可自由组合的插件基础设施,让开发者可以按照自身业务需求驾驭大模型。
AI工程范式的三次跃迁
行业AI开发范式经历了三次迭代,Harness代表第三代驾驭工程范式:
| 范式 | 核心问题 | 优化对象 | 交互模式 |
|---|---|---|---|
| 提示词工程 | 怎么把话说清楚 | Prompt措辞、格式、示例 | 一问一答 |
| 上下文工程 | 怎么给AI喂入有效信息 | 文档、代码片段、历史对话 | 信息注入→生成结果 |
| 驾驭工程 | 怎么保障Agent可靠持续工作 | 约束、反馈回路、控制系统 | 人类掌舵,Agent自主执行 |
提示词工程、上下文工程解决输入层面的问题,而驾驭工程(Harness Engineering) 聚焦Agent运行环境,DeepSeek Harness就是驾驭工程理念完整的开源实现。
核心架构:一切皆插件

Harness的整体架构以Cordis内核为中心,各类插件环绕在内核周边,依靠服务与事件完成互相通信协作。
框架引入 Profile(配置集)+ Bundle(能力组合包) 的分层组装机制。运行的dsh实例本质上是一棵插件树,启动时会按顺序叠加多层配置包,依次应用profile内的bundle组合、补丁配置。
执行下面命令,就可以打印当前实例完整的配置树,输出的每一项配置,都能够通过自定义补丁进行替换:
dsh --profile web --dump-config
四种运行模式

框架内置四套开箱即用的运行模式,覆盖完整智能体开发到最小化基准测试的各类场景:
- 标准模式
功能完整的编码智能体,包含文件编辑、Shell执行、文件及网页检索、技能、计划目标、子代理、工作流全套能力,适合绝大多数日常调试场景。 - PTC模式
保留标准模式全部能力,使用Code Mode SDK封装工具,允许模型输出一段TypeScript程序,通过代码编排多步工具操作,减少多轮对话交互。 - 极简模式
仅保留持久bash、文本替换编辑器两个工具,移除其余附加组件。用于干净环境下做模型Agent能力基准评测,消除多余组件带来的干扰。 - 创造模式
用于自定义Agent预设模板。拥有标准模式全部能力,额外开放运行时检查、插件实验、自定义预设创作能力,面向插件开发人员。
核心特性
1. 运行全流程可追溯
框架采用仅追加(append‑only)会话日志。模型接收的系统提示词、思维链推理内容、工具调用入参与返回结果、子Agent调度、上下文注入等全部信息都会持久保存。通过Trajectory轨迹视图可以查看完整过程,支持会话恢复、分叉、检索、回放,所有任务步骤都可以复现调试。

2. 多形态部署,适配不同场景
- Web UI:默认地址
[http://127.0.0.1:3080](http://127.0.0.1:3080),提供图形交互界面; - headless无头模式:一次性执行任务,输出结果直接退出,适配脚本、CI流水线;
- CLI命令行;
- Python SDK、TypeScript SDK,方便将Agent能力嵌入自有业务系统。
3. 开放可控,无特权内核
MIT开源协议,没有不可修改的特权核心,插件注册全部可逆。依靠Profile、Bundle、补丁实现分层配置,用户可以完整审查当前运行实例的全部配置,智能体的行为完全由配置决定。
4. 模型无关,热切换适配器
填入DeepSeek API密钥即可直接使用,同时兼容其他服务商、本地OpenAI兼容接口。切换模型不需要重启服务,依托会话、Agent、能力三级事件扩展点,可以挂载自定义策略与适配器。
Harness与同类工具的定位差异
DeepSeek Harness不是普通的Agent开发库,它处于SDK与应用框架之上,聚焦解决Agent如何稳定可靠运行这一层问题,和主流项目定位区别如下:
| 项目 | 定位 | 与DeepSeek Harness的关系 |
|---|---|---|
| Claude Code | 闭源商用编码助手 | 功能对标,Harness开源、支持自托管、全部能力可替换 |
| Hermes Agent | 自进化个人Agent | 侧重跨会话记忆沉淀;Harness侧重插件组合、全链路可观测,理念互补 |
| OpenClaw | 本地优先消息型Agent | 侧重多渠道接入;Harness提供Web、Headless、SDK多种运行形态 |
| LangGraph / AutoGen / CrewAI | Agent构建编程框架 | 解决“怎么编写Agent”;Harness解决“Agent如何稳定运行、替换各项能力” |
0 条笔记