DeepSeek Harness深度解析:一切皆插件

拆解 DSH 基于 Cordis 的「一切皆插件」架构与自定义插件开发方法。
本文系统解析 DeepSeek Harness(DSH)的架构设计与插件开发实践。DSH 是一个通用 Agent 运行框架,提供 Web、Electron 桌面端及三种 SDK,并通过标准、PTC、最小、创作者等模式适配不同场景。其底层是独立于 DeepSeek 起源的 Cordis 插件系统,「一切皆插件」是字面意义:Agent 循环、工具注册表、执行层、模型提供商乃至 UI 均可替换,插件通过共享上下文、依赖注入与四种事件发射模式协作。文章还演示了从最小 apply 函数到带安全拦截的守卫插件如何编写,并说明 YAML 配置的分层加载机制,最后指出其核心价值在于每一层都可替换组合。
DeepSeek Harness(DSH)近期发布了桌面端应用,作为基于 Electron 的封装层,它让这个以「一切皆插件」为设计哲学的开源 Agent 框架获得了更直观的交互入口。本文基于 B 站 UP 主的完整技术解析视频,拆解 DSH 的架构设计、Cordis 插件系统的工作原理,以及如何从零编写并加载自定义插件。
DSH 是什么:不止于编程 Agent

DeepSeek广告 Harness 本质上是一个通用的 Agent 运行框架(agent harness)。虽然官方定位偏向编程 Agent,但它自带了完整的 Agent 循环、工具集、系统提示词、会话文件管理和用户界面,因此同样可以承载其他类型的 Agentic 应用。
它提供了多种形态:可自行部署的 Web 应用、Electron 桌面应用(对 Web 版的封装),以及 TypeScript、Python 和 ACP 三种 SDK。桌面版是近期发布的新入口,但两者在核心行为上保持一致。
DSH 的一个关键设计是「模式」机制。标准模式运行常规编程 Agent;PTC 模式在调用工具时不走常规流程,而是将工具调用写成脚本执行,从而实现工具并行化或在单次调用中组合多个工具——据 UP 主介绍,这正是小型 Agent 最初的运作方式。最小模式尽可能减少上下文注入,而创作者模式则额外加载关于 DSH 自身架构的技能与上下文。
创作者模式的意义在于:由于「一切皆插件」,Agent 可以修改自身。UP 主在视频中直接要求创作者模式「创建一个注册 hello world 工具的插件」,DSH 随即生成了包含 package.json 和 index.js 的插件目录,并在新会话中成功调用该工具向指定用户问好。
Cordis:插件系统的底层引擎
一个独立于 DeepSeek 的项目

Cordis 是支撑 DSH 架构的插件系统,但它并不等同于 DeepSeek,也并非由 DeepSeek 从零开发。UP 主指出,Cordis 的首次提交早于 DeepSeek 公司成立约一年,其创作者后来加入 DeepSeek,并将 Cordis 作为 DSH 的基础架构整合进来。Cordis 仓库虽然不归属于 DeepSeek,但将 DSH 官网列为官方项目页,论文也由 DeepSeek 发表,且项目的主要贡献者中有 DeepSeek 员工。
Cordis 并非专为编程 Agent 设计,它可以驱动任何应用,只是其可组合性在 Agent 场景中价值最大。
一切皆插件的真实含义
在 DSH 中,「一切皆插件」是字面意义上的:Agent 循环本身是插件,理论上可以被替换为一个只回显用户输入、从不调用 LLM 或工具的循环;工具注册表、bash 工具、文件系统、MCP 客户端、系统提示词、工具执行层、模型提供商、技能、会话日志与存储,乃至用户界面,全部都是插件。
工具执行层作为插件意味着可以替换执行环境——DSH 开箱提供 bash 沙箱、文件系统沙箱和子进程执行插件,开发者也能编写将工具调用转发到远程机器的执行插件。模型提供商同理,GLM、Hugging Face 等第三方模型都通过新增 provider 接入。
说个细节,DSH 实际上包含两个 Cordis 应用:后端和前端(Electron 界面本身也是一个 Cordis 应用),二者通过通信协作。
MCP(Model Context Protocol) 是一种让模型以标准化方式访问外部工具与数据源的开放协议,DSH 将 MCP 客户端本身也实现为插件。这意味着接入外部工具生态不需要改动核心代码,而是通过插件把 MCP 服务端暴露的能力注册进工具注册表,与内置工具享受同一套调用、权限和事件机制。对开发者而言,这降低了扩展 Agent 能力边界的成本:既可以编写原生插件直接注册工具,也可以通过 MCP 桥接已有的工具服务,两种路径最终都汇入同一个 tools 服务与统一的执行层。
共享上下文与依赖注入
所有插件共享一个由 Cordis 暴露的应用级上下文(ctx)。插件通过声明名称来提供服务,其他插件通过 inject 数组声明依赖,Cordis 据此保证依赖先于使用者挂载。这正是整个生态运转的核心机制:依赖注入加服务注册。

插件还可以监听上下文中的事件。例如一个日志插件只需监听 tool result 事件并输出到控制台。Cordis 会记录插件定义的所有内容,在禁用插件时按正确顺序清理,避免移除仍被其他插件使用的依赖;开发者也可以自行添加清理逻辑,UP 主建议将其作为编写插件的最佳实践。
事件发射的四种方式

插件发射事件有四种模式:普通 emit(发出即忘,如工具结果)、waterfall(如 LLM 流式生成、多工具执行)、串行(需等待前序事件,如 Agent 轮次停止)、以及并行。插件也可以声明全新事件供其他插件监听,压缩插件就创建了自己的 compaction 事件。
事件按上下文作用域发射。插件可以嵌套,嵌套内的插件共享上层上下文,事件向上冒泡。不过 UP 主建议不要让所有插件都嵌套,更理想的做法是让插件连接到同一上下文,通过依赖注入建立关系。
依赖注入(Dependency Injection) 是 Cordis 运作的核心范式,理解它有助于读懂后文的插件协作机制。简单说,依赖注入指的是一个组件不自行创建或查找它所依赖的对象,而是由外部容器在运行时把这些依赖「注入」进来。在 Cordis 中,插件通过 inject 数组声明自己需要哪些服务,框架负责在挂载前解析并传入。这样做的好处是:插件之间不产生硬编码的引用关系,可以独立开发、替换和禁用;框架也能根据依赖图决定加载顺序,并在卸载时安全清理。它与「服务注册」构成一对互补机制——一方声明提供什么,另一方声明需要什么,由容器完成撮合。
瀑布式(waterfall)事件 是理解 DSH 拦截与放行逻辑的关键。与「发出即忘」的普通 emit 不同,waterfall 事件把监听器串成一条链:每个监听器接收上一位的返回值,并决定是把它继续传给下一位(调用 next),还是直接返回一个结果终止链条(如返回 deny 对象拦截)。这使得中间件式的横切逻辑成为可能——安全守卫插件正是利用这一特性,在工具执行前统一审查 bash 命令,正常放行时返回 next,命中危险模式时短路并拒绝。与之相对,串行模式强调按顺序等待前序事件完成,并行模式则同时触发多个监听器,各自独立处理。
亲手写一个 DSH 插件
最小插件:一个 apply 函数
UP 主在 DSH 仓库中创建了 scratch-plugin 目录,放入三个示例插件。最简插件只需导出一个 apply 函数,接收 Cordis 的上下文参数,内部打印一行日志即可。
更实用的例子是 greet 工具插件:它导出 name、inject 数组(声明依赖 tools 插件)和 apply 函数。在 apply 中,通过 tools 服务注册一个新工具,使用从同一包导入的 defineTool 方法定义工具名称、参数和行为。
第三个示例是安全守卫插件:同样依赖 tools 插件,监听 tool result 事件并记录日志;同时拦截 tools pre-execution 事件,若模型调用 bash 且命令包含 rm -rf,则拒绝执行并提示模型让用户自行运行。由于该事件走 waterfall 模式,正常放行需返回 next,拦截则返回 deny 对象。
配置文件加载机制

在 Cordis 中,插件的加载方式是配置而非代码。开发者编写 YAML 文件,在 insert 属性下列出插件 ID 和名称:若插件已发布为 npm 包则填写包名,否则填写插件文件的绝对路径。
通过 dsh web --patch 指定补丁文件,即可在 Web 配置基础上追加插件。这些配置分层叠加:基础 bundle 的 cordis.patch.yaml 定义预装插件,补丁文件在其上追加,最后是用户级配置覆盖全部——位于用户目录下 profiles 中的 cordis.patch.yaml。桌面版用户的真实配置也存放在这里,其中可以设置模型提供商与各项参数。
UP 主实际测试了 Web 版补丁加载:注册的 greet 工具成功问候了指定用户,rm -rf 命令被守卫插件拦截,证明插件已正确挂载。桌面版则需将插件打包为 npm 包,通过 DSH 的服务完成添加,无需手动编辑配置文件。
为什么这套架构值得关注
DSH 的核心创新不在于某个具体工具,而在于将 Agent 的每一层都抽象为可替换的插件:Agent 循环、工具、提示词、执行层、UI 全部接入同一上下文,通过依赖注入组合。这意味着开发者可以只替换执行层来增加安全性,只替换 Agent 循环来改变行为模式,或在不改动核心的前提下扩展能力边界。创作者模式则把这种可扩展性交给了 Agent 自身——你无需手写代码,只需描述需求,DSH 就能生成并加载插件。理解这套机制,也就理解了 DSH 与传统 CLI 编程 Agent 在设计思路上的根本差异。
相关推荐

Gemini 4 Neon发布:前沿智能与高效任务执行的平衡之作
Google DeepMind 发布 Gemini 4 Neon,主打前沿智能与快速端到端任务执行。本文解析其在编程、企业分析、科学推理与网络安全上的基准表现、四档思考等级、定价与安全对齐数据。

AI是全球断网元凶?NSA、FAA接连宕机背后的信任危机
NSA机密网络五天内第四起重大故障,微软称软件bug、FAA否认新AI系统有关、NSA称例行维护。参议员沃纳提出AI加速漏洞发现导致仓促修复的另一种解释,而39%美国人对AI的负面看法让信任危机浮出水面。

机器人开发者自研B-rep内核,测试达3487项
机器人开发者自研B-rep几何内核并编写3,487项测试,探讨机器人领域为何需要专用CAD工具,以及自研内核的机遇与门槛。