自学教程

DeepSeek Harness 简介

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

四种运行模式

框架内置四套开箱即用的运行模式,覆盖完整智能体开发到最小化基准测试的各类场景:

  1. 标准模式
    功能完整的编码智能体,包含文件编辑、Shell执行、文件及网页检索、技能、计划目标、子代理、工作流全套能力,适合绝大多数日常调试场景。
  2. PTC模式
    保留标准模式全部能力,使用Code Mode SDK封装工具,允许模型输出一段TypeScript程序,通过代码编排多步工具操作,减少多轮对话交互。
  3. 极简模式
    仅保留持久bash、文本替换编辑器两个工具,移除其余附加组件。用于干净环境下做模型Agent能力基准评测,消除多余组件带来的干扰。
  4. 创造模式
    用于自定义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 / CrewAIAgent构建编程框架解决“怎么编写Agent”;Harness解决“Agent如何稳定运行、替换各项能力”

0 条笔记