DeepSeek Harness详解：一切皆插件的Agent运行时

为什么DeepSeek Harness一出来就火了

当OpenClaw、Hermes Agent、Codex等Agent工具逐渐进入稳定阶段、功能日趋完善之后，开发者的期待悄然转向了一个更高的目标——能够自主循环干活的Agent。所谓自主循环Agent（Autonomous Loop Agent），是指能够在无需人类持续介入的情况下，自主规划任务、执行操作、评估结果并根据反馈迭代改进的AI系统。与传统的单轮对话或简单指令执行不同，这类Agent具备持续运行的能力，可以将复杂目标拆解为多个子任务，逐步完成并自我校正。这一概念的兴起源于ReAct（Reasoning + Acting）范式的成功——让大语言模型在推理的同时调用外部工具，形成"思考-行动-观察"的闭环。说白了，很多人真正想要的，是让AI把活全部干完，自己只管看结果。虽然距离这个理想还有一段路要走，但这类自主循环Agent已经让人看到了希望。

正是在这个时间点，DeepSeek推出了DSH（DeepSeek Harness），一经发布便迅速走红。据B站UP主「大叔大」的介绍，它的核心理念可以用一句话概括：一切皆插件。用公式表达就是——Agent = Model + Harness。模型、工具、技能、对话、沙箱、存储、循环、调度、UI这些Agent能力，全部由插件组合而成。

目前DeepSeek Harness处于开发者预览版阶段，采用MIT开源协议，所有能力都可以自由替换与重组。值得一提的是，MIT协议是目前最宽松的开源许可证之一，允许任何人自由使用、修改、分发甚至商用，唯一要求是保留原始版权声明。相比GPL等具有"传染性"的开源协议，MIT协议意味着企业可以放心将Harness集成到商业产品中，这也表明DeepSeek的战略意图是最大化社区采纳率，通过生态繁荣来反哺自身模型的使用量。

灵魂与身体：理解Agent核心公式

很多人可能都遇到过这样的痛点：模型在对话框里对答如流，却没法真正动手做事——不会读写文件、不会执行命令，也不能持续工作好几个小时。原因很简单，对话模型只是灵魂，它缺一副能理解环境、使用工具的身体。

这正是Agent = Model + Harness这个公式想要表达的：

• Model（灵魂）：负责思考、推理、生成回复，是智能核心；
• Harness（身体）：给Agent提供理解环境、使用工具、持续工作的执行框架。

换句话说，模型决定了Agent「聪不聪明」，而Harness决定了Agent「能不能真正干活」。DeepSeek Harness要做的，就是把这副「身体」彻底模块化。这种分离设计也意味着，同一个Harness可以搭配不同的模型（DeepSeek、Claude、GPT等），而同一个模型也可以运行在不同的Harness之上，实现真正的解耦。

一切皆插件：三大设计特点

DeepSeek Harness基于Cordis插件系统构建，其核心理念就是「一切皆插件」。Cordis是一个源自Koishi（跨平台聊天机器人框架）的通用插件运行时系统，其设计哲学深受微内核操作系统思想的影响。在微内核架构中，内核只提供最基本的进程管理和进程间通信机制，所有上层功能都以独立服务的形式运行。Cordis将这一理念移植到应用层，通过"服务（Service）"和"事件（Event）"两种核心机制实现插件间的解耦协作——服务机制允许插件声明自己提供或依赖哪些能力，事件机制则实现插件间的松耦合通信。具体有三个关键设计特点：

极简内核

Cordis内核只负责插件的加载、卸载和依赖关系管理，不承载Agent的具体能力，从而保持内核的极简与稳定。这种设计的优势在于：任何插件的故障不会导致整个系统崩溃，且插件可以在运行时动态替换而无需重启整个Agent。

插件提供全部能力

模型调用、工具集成、技能定义、对话管理、沙箱执行、存储方案、循环调度、UI展示，全部由独立插件提供，通过Cordis的服务与事件机制进行协作。

配置即自由组合

不用改动源码，就能在配置层面选择、替换或扩展任意能力，按需组装出理想的Agent。

简单说，就是把Agent拆成一堆可插拔的零件——你想要什么能力就装什么插件，想换模型就换个插件，想加新工具就装个插件即可。

与传统Agent的核心区别

传统Agent的能力通常固化在系统内部，而DeepSeek Harness把每个能力都变成了可替换的插件。二者的差异主要体现在四个维度：

对比维度	传统Agent	DeepSeek Harness
能力架构	能力写死在系统里，扩展要改源码	一切皆插件，配置层直接组合
扩展方式	添加功能需重新开发、重新编译	选择/替换/扩展插件即可，无需改源码
运行可追踪	过程像黑盒，出问题难排查	每次运行有迹可循，Trajectory视图可回放
运行模式	通常固定单一模式	标准/PTC/极简/创造四种模式按需切换

用一句话概括：传统Agent是「整机出厂」，而Harness是「模块化DIY」。此外，它还把模型看到的一切都记录成对话日志，支持恢复、分叉、检索、回放，且共享同一份事件流。

这种架构差异的背后，反映了Agent领域从"框架时代"迈向"运行时时代"的行业趋势。早期的LangChain、AutoGen等属于"框架"（Framework），提供了构建Agent的编程抽象，但开发者仍需编写大量胶水代码。2024年下半年开始，行业逐渐转向"运行时"（Runtime）的理念——提供一个开箱即用的执行环境，开发者只需通过配置而非编码来组装Agent。这一转变的驱动力包括大模型能力提升使更多编排逻辑可以交给模型处理，以及沙箱隔离技术（如Docker容器、WebAssembly、E2B等云沙箱服务）的成熟为Agent安全执行代码提供了基础设施保障。

四种运行模式详解

DeepSeek Harness按场景提供了四种运行模式，覆盖从日常编码到实验探索的各类需求：

1. 标准模式：功能完整的编码Agent，包括文件编辑、Shell、文件与网页检索、Skills、计划目标、子代理和工作流；
2. PTC模式：让模型用一段TypeScript程序组合多个工具调用，复杂操作一步到位；
3. 极简模式：只保留持久Bash与文件编辑两个工具，用于最小化环境下的模型基准测试；
4. 创造模式：可以创建自定义Agent Preset、检查运行时、试验Cordis插件、创作新模式。

其中PTC（Programmatic Tool Composition，程序化工具编排）模式尤为值得关注。在传统的Agent框架中，模型每次只能调用一个工具，然后等待结果返回后再决定下一步——这种串行的"乒乓式"交互会带来显著的延迟开销，因为每次工具调用都需要一轮完整的LLM推理。PTC模式的思路则完全不同：模型直接生成一段TypeScript程序，在程序中组合多个工具调用，包括条件分支、循环、变量传递等编程逻辑，随后在沙箱环境中一次性执行。TypeScript被选为编排语言而非Python，可能是因为其静态类型系统能在执行前捕获更多错误，且与Node.js生态天然兼容。这种设计本质上将Agent从"对话式编排"升级为"程序式编排"，在处理批量文件操作、多步API调用等复杂任务时效率提升尤为明显。

每一次运行都有迹可循

可追踪性是DeepSeek Harness的一大亮点。模型看到的一切都会写入仅追加的对话日志，包括系统提示词、思维链、工具调用与结果、子Agent调度，以及每一次上下文注入。

这种"仅追加日志"（Append-only Log）的设计实际上借鉴了分布式系统中的事件溯源（Event Sourcing）模式。在事件溯源中，系统不存储当前状态的快照，而是记录所有导致状态变化的事件序列——当前状态可以通过重放这些事件来精确重建。这种模式在金融系统、版本控制（如Git的commit链）和数据库WAL（Write-Ahead Log）中被广泛应用。将其引入Agent系统带来了三大好处：一是完全可复现性——任何一次Agent运行都可以通过重放日志精确还原；二是支持分叉（Fork）——可以从任意历史节点创建新的执行分支，尝试不同的策略而不影响原有路径；三是可审计性——所有决策过程都有完整记录，这对于企业级应用中的合规要求至关重要。

在Trajectory视图里，可以按来源查看这些记录；恢复、分叉、检索、回放这些操作都共享同一份事件流。Trajectory视图本质上是这套事件流的可视化前端，让开发者能像调试器的单步执行一样逐步回放Agent的行为。这对于调试和理解Agent的行为路径极为重要——它把过去黑盒式的Agent运行过程，变成了完全透明、可复现的流程。

快速上手：一行命令即可体验

对于想快速体验DeepSeek Harness的用户，安装非常简单：

1. 先装好Node.js；
2. 在终端里输入一行命令并回车：

npx @deepseek-ai/dsh web

这里的npx是Node.js自带的包执行工具，它会自动从npm仓库下载并运行指定的包，无需预先全局安装。web参数表示启动Web UI模式，会在本地开启一个浏览器可访问的界面。Web UI就会一键启动，特别省事。

如果想拿到完整源码进行二次开发，可以通过git clone从DeepSeek的仓库拉取harness项目，按仓库说明完成安装即可。

装完后的界面中，左侧是设置页，展示已安装插件及启用状态，可以随时开关、替换、组合能力；右侧则是Trajectory视图，从对话日志还原完整运行过程。官方还提供了一段不到一分钟的演示视频，观看时可以重点关注三点：模型如何调用工具、对话日志如何记录，以及Trajectory视图如何把整个运行过程还原出来。

总结

DeepSeek Harness代表了Agent架构的一种新思路——从固化整机走向模块化组装。它降低了扩展与替换能力的门槛，同时通过完善的日志与回放机制，让Agent的运行过程变得透明可控。对于希望自定义Agent、探索自主循环工作流的开发者来说，这是一个值得尝试的开源工具。

从更宏观的视角来看，Harness的出现也预示着Agent生态可能走向类似"应用商店"的模式——社区开发者贡献各种功能插件，使用者按需组合即可获得定制化的Agent能力。这种模式能否成功，取决于插件生态的丰富程度和社区的活跃度，而MIT协议的选择无疑为此奠定了良好的基础。

本期核心要点回顾：

• DeepSeek Harness是「一切皆插件」的Agent运行时；
• 内核极简，Cordis只负责插件加载与依赖管理；
• 与传统Agent的核心区别是能力可替换、运行有迹可循；
• 提供标准、PTC、极简、创造四种运行模式；
• 一条npx命令即可快速体验。