一切皆插件,DeepSeek-harness震撼开源

兄弟们，今天不聊别的，聊一个我连夜试完、决定必须写出来的东西。

DeepSeek 官方，开源了一个 agent harness，叫 DeepSeek Harness，命令叫 dsh。

可能有人要问：DeepSeek 不是做模型的吗？怎么下场做框架了？

对，这就是我第一反应。但我试用完的感受是——这可能是目前最接近"agent 操作系统"的东西。

别急，听我慢慢说。

一、先说结论：这是什么玩意儿

一句话：DeepSeek Harness 是 DeepSeek AI 官方开源的智能体框架，英文叫 agent harness。

什么意思？就是让你能跑一个真正"干活的 AI agent"的完整运行时——模型适配、工具调用、文件读写、跑命令、沙箱隔离、审批策略、会话持久化、子 agent 委托、Web UI……全都有。

注意关键词：官方。

不是某个野路子开发者搞的套壳，是 DeepSeek 自己下场做的。MIT 协议，随便用。

而且它是"一切皆插件"的架构——这句话我等会儿展开说，因为它真的不是营销话术。

二、为什么我要连夜试

先交代一下背景，我是那种把 AI 工具用到极致的人，Claude Code 我一个月烧过 35 万 token 那种。

这些年我用过的 agent 框架、工具、套壳、缝合怪，两只手数不过来。多数是什么情况？

要么黑盒——你根本不知道它内部怎么运作的，出 bug 只能干瞪眼。

要么封闭——想换个模型？想加个工具？对不起，写死在里面了。

要么假开源——代码是公开了，但你想改个配置都得看半天源码。

所以当 DeepSeek 官方说：我们搞了个 harness，每个部分都是插件，包括模型适配器、工具注册表、甚至 agent 主循环本身……

我心想：吹吧。

然后我打开了文档。然后我沉默了。

三、上手有多简单？一条命令

先别管架构，直接跑起来看：

```

npx @deepseek-ai/dsh web

```

没了。

就这么一条命令，Web UI 起来了，默认地址 http://127.0.0.1:3080。

打开之后：设置 → 模型，填 DeepSeek API Key（也可以配 Anthropic、OpenAI，甚至任意 OpenAI 兼容端点，公司网关、自建服务器都行），然后选个工作区，开聊。

你让它"总结这个仓库、找出主要模块"，它会真的去读文件、跑命令、给你干活。

跟我预期不一样的是：填完 key 立刻生效，不用重启。这种细节，说明是真做过产品的人做的。

四、重点来了："一切皆插件"到底牛在哪

这是这篇文章的核心，我尽量用人话讲。

传统框架是什么结构？核心是固定的，你只能在外面加东西。加不进去的，就 hack。

DeepSeek Harness 不一样。它没有特权核心。

模型适配器是插件，工具注册表是插件，会话日志是插件，agent 主循环本身——也是插件。

什么意思？

你能从配置层面替换掉任何一个部分，而不需要动核心代码。

它底层跑的是 Cordis 这个插件框架，整个产品就是一棵插件树。你挂一个插件上去，能力就有了；插件卸载，注册的东西自动清理，干干净净，不留垃圾。

用他们的话说，叫"可逆的 effect"。插件卸载时自动撤销自己注册的所有东西——你不用手动 removeListener、clearInterval，框架帮你收拾。

我试的时候就在想：国内那些做 agent 平台的，有几个敢这么设计？

还有两个概念特别戳我：

Profile / Bundle 分层。 跑起来的实例是插件树按顺序叠出来的：dsh-base（模型、工具、沙箱、审批）→ dsh-web-app（浏览器应用）→ 你自己的 patch 层。想看机器实际跑的是什么树？

```

dsh --profile web --dump-config

```

打印出来的每一行，你都能用自己的 patch 覆盖。不是看文档猜，是把真相给你看。

能力接缝（Capability Seam）。 一个可替换能力 = 接口定义 + 实现 + 消费者。比如文件系统和子进程共享同一个执行世界——你把它们指向远程沙箱，Bash、PTY、LSP 跟着一起迁走，不用写一堆 provider 分支。

换一个 provider，整个产品的行为跟着变。这就是接缝的意义。

五、会话日志：这个设计我服

很多 agent 工具，上下文是怎么组装的？黑盒，对吧。

DeepSeek Harness 有个铁律：模型可见 = 已记录。

任何到达模型请求的输入，都必须能从会话日志里重建。日志是追加式的，不可篡改，是模型上下文的唯一来源。

这意味着什么？

• Fork：随时从某个历史点复制出一个新会话

• Resume：中断了能接着聊

• Replay：能完整回放当时模型看到了什么、工具干了什么

• Telemetry：全程可观测

我自己做产品最烦的就是"出了事没法复盘"。这个设计直接把这个痛点焊死了。

六、开发者友好到什么程度

这是我最惊喜的部分。第一个插件，十几行代码：

```

import type { Context } from '@deepseek-ai/cordis'

export const name = 'hello-plugin'

export function apply(ctx: Context) {

  console.log('[hello-plugin] plugin loaded!')

}

```

就这。一个导出 apply 函数的模块，就是完整插件。用 --patch 挂载，启动即加载。

加个工具呢？也不复杂，注册到 ctx.tools 就行。加配置？导出个 Schema，用户在 cordis.yml 里改，热替换，不用重启。

还有 Python SDK——pip install deepseek-harness-sdk，Python 3.10+ 就能用同一套 API 编程调用，不需要系统装 Node.js。

这种"开发者友好"，是装不出来的。说明设计者自己天天在写插件。

七、泼点冷水：它还不是成品

我写东西从来不只吹。说几个现实问题：

开发者预览阶段。 官方自己说了：正在快速迭代，未来会有破坏性变更。现在上车的，得做好跟着改的准备。

生态还没起来。 插件市场、第三方工具链都还早。你现在用到的很多能力，得自己动手。

上手有门槛。 想跑起来很容易，一条命令；想玩明白架构，得啃文档。它不是那种"开箱即用、啥都给你配好"的工具，它更像乐高——上限高，但要自己拼。

但我恰恰觉得，这三点不是缺点，是机会。

破坏性变更说明在快速进化；生态空白说明现在进来就是第一批吃螃蟹的人；乐高式设计说明——它不限制你。

八、想要更系统的教程？我整理了一份

光看这篇文章肯定不过瘾。

我把 DeepSeek Harness 的完整教程整理成了一份飞书文档，从快速开始到架构核心、从插件开发到测试策略，一共 13 章 + 2 个附录，都是能直接上手照做的干货：

《DeepSeek Harness 详细教程》(已公开，任何人可打开)

👉 https://a1dkg5x3xzt.feishu.cn/docx/IFa9duOvVoqVIYxtYFHcQJOlncc

收藏这份，比收藏这篇文章值钱。建议配合本文一起看：文章给你"为什么值得用"的判断，文档给你"怎么用"的全部细节。

九、我的判断

这两年 agent 工具我见太多了。多数是"披着 AI 外衣的脚本集合"，少数是"想做成平台结果做成缝合怪"。

DeepSeek Harness 是少见的、从底层设计就对了的东西：一切皆插件、日志即事实、能力可替换。

如果你跟我一样，是那种喜欢把工具拆开看内部的人，你会爱上它。

如果你是普通用户，想开箱即用——再等等，等生态起来。

但如果你是开发者，或者你想在 agent 这条赛道上做点什么——现在就是最好的上车时间。

官方给了个很实在的社区入口，想找组织、讨论插件开发的，可以加 DeepSeek Harness 的企微群（GitHub README 里有二维码）。

仓库地址：github.com/deepseek-ai/deepseek-harness

对了，最后补一句：他们管自己叫"开发者预览"。以 DeepSeek 的迭代速度，我赌明年这个时候，这个项目会比现在火一个数量级。

不信？收藏这篇文章，明年回来看。

本文基于 DeepSeek Harness 仓库（开发者预览版）实际试用整理。文风参考，观点自负。