DeepSeek Harness 调研：26 万星”一切皆插件”的 Agent 底座——dsh 冒烟实测与架构拆解

深度调研 + 真机冒烟 · 2026-10-27 · 环境：Node v24 + npm 通道真机安装 · 仓库：deepseek-ai/deepseek-harness · 姊妹篇：《Prime Agent 调研》、《LoopX 追更》、《context-mode 调研》

写在前面

素材库里躺着一个 8 月底采到的条目：DeepSeek 开源的 Agent Harness，当时星标 204,496，是整库最高星项目。本次实核发现它八周又涨了 58,776 星（+28.7%），来到 263,272⭐——在 dsh-plugin 生态话题 里仅次于 REA（394K⭐），而 REA 的 topics 里恰好也挂着 dsh 和 cordis——两个现象级项目互为生态。它的定位一句话说完：“Everything is a Plugin”——模型适配器、工具注册表、会话日志、甚至 agent 循环本身，全都是可替换的插件。本篇做三件事：拆架构、跑真机冒烟、把它放进本站 Agent 基础设施系列的坐标系里。

一、解决什么问题

当前 coding agent 的主流形态是 ” 整装产品 ”：模型、工具、会话、循环焊死在一个可执行文件里，想换掉其中一层就得 fork 整个仓库。Agent Harness 这个赛道（本站已覆盖 Prime Agent、LoopX）试图把 ” 驾驶舱 ” 和 ” 引擎 ” 分离，但大多数实现只开放到 ” 配置层面 ”——dsh 把开放边界推到了 代码注册层面：

• 没有特权内核：官方架构文档原话 “There is no privileged core to patch”——扩展 dsh 的方式是把一个插件挂载到其他插件旁边，注册即副作用（effect），插件卸载时自动回滚
• 组合即启动：一次 dsh 启动 = 有序层叠的插件树（profile → bundles → 用户补丁 → 命令行补丁），每一行打印出来的配置都可以被上层替换
• 热替换有理论出处：底层框架 Cordis 的设计写成了一篇论文 arXiv:2608.25512 A Programming Paradigm for Spatiotemporal Composability——不是工程经验总结，是有形式化模型的编程范式

二、项目名片

三、架构拆解：Cordis 上的插件树

四层组合模型（自下而上）：

1. Cordis 框架（独立仓 cordiverse/cordis，9,425⭐）：插件向共享 context 贡献服务、类型化事件、可回滚副作用——模型适配器、工具注册表、会话日志、agent 循环都是插件，全部可从配置替换
2. Bundle：Cordis 配置行 + 所挂代码的分发单元，dsh-base 是 web/headless/sdk/acp 四个 profile 共享的第一层（模型适配、工具、持久化、沙箱与审批策略、凭据、遥测）；dsh-web-app 等按需叠加
3. Profile：具名组合模板（web / headless / sdk / sdk-minimal / acp），存在 Harness home 下，用户可用 cordis.patch.yml 补丁任意改写——dsh --profile web --dump-config 能打印本机实际启动的整棵树，任何一行都能被替换
4. 补丁层：按 id 定位配置行、整行替换或插入新行；preset 补丁在声明内部递归应用，层序与 profile 一致

核心内核包：session（append-only 事件日志）、system-prompt（提示词段与工具 schema 组装）、tools（带守卫的执行管线）、agent/agent-loop（默认驱动器）、llm（流式词表与适配器接缝）。

事件即扩展点，分三域：Session 事件（持久事实，重载后仍在）、Agent 事件（agent/*，观察或拦截进行中的工作）、能力事件（fs/*、tools/*、telemetry/*，向接缝挂策略与适配器，不 import 循环本体）。Turn flow 文档把一次请求拆到 step 级：turn/start → step/start → agent/request → llm/stream → tool/call* → step/end——每个环节都有对应事件可挂。

值得注意的细节 ：packages 目录里躺着 browser-use、computer-use、compaction（上下文压缩）、guard、credentials、sandbox 等包——本站分开写过的 浏览器操作 、 上下文压缩 、 审批守卫 能力，在 dsh 里是一等公民子系统。另有 Electron 桌面端，签名资源内打包精确的生产运行时。

四、真机冒烟：CLI 层跑通

在 dsh-lab 目录（Node v24.18.1）执行 npx @deepseek-ai/dsh@0.2.1-rc.2：

• --version → 0.2.1-rc.2 ✅（与 npm latest 一致）
• --help → 输出 profile 引导器界面：Usage: dsh [--profile] <name> [options]，支持 --patch（可重复的补丁覆盖）、--dump-config（打印组合后的插件树）、--from-default-profile（从出厂模板重置自定义 profile）✅
• 安装体积正常（npm 通道自动拉全量依赖，无原生编译卡点）

口径声明：本次冒烟止步 CLI 层（版本 / 帮助 / 参数面）；Web UI 启动需要模型凭据与图形环境，dsh web 的端到端体验留作后续实测——这正好也是 dsh 设计的验证点：模型适配器是插件，理论上换个 @deepseek-ai/dsh 插件配置就能接任何 OpenAI 兼容端点。

五、数字与证据

• 增长斜率：8/13 建仓 → 8/31 达 204K（18 天）→ 10/27 达 263K（再 57 天 +28.7%）——不是首发脉冲，是持续进榜
• 真实使用：npm 周下载 34.2 万，显著高于 ” 只收藏不使用 ” 的星标虚火盘面
• 生态放量：dsh-plugin 话题 23,466 个仓库；头部除 REA 外，还有 46K⭐ 的 dsh-our-free-model（装一个插件免 Key 用 DeepSeek V4.1 Flash——社区第一波 ” 白嫖插件 ”）与 90K⭐ 的 open-design、79K⭐ 的 ruflo
• 工程质量信号：48 贡献者；open issues 清零靠 Discussions 承接；CI 用 GitHub Actions + GitLab CI 双轨；oxlint/jscpd 静态检查齐备；verify-application-entrypoints 脚本强制所有启动路径走 dsh（防绕过组合层的旁路入口）

六、生态位：Agent 底座的第三条路线

对照本站已覆盖的同类：

两条独家观察：

1. “ 白嫖插件 ” 是生态引爆器：dsh-our-free-model 一个免 Key 插件 46K⭐，说明 dsh 的插件分发已经形成 ” 装插件即得能力 ” 的用户心智——这是 harness 类产品最难的冷启动环节，被社区自发解决了
2. 学术 - 工程闭环罕见：Cordis 不是内部框架顺手开源，而是先有编程范式论文（2608.25512）再有实现——与本站写过的 EvoOntology（人大，论文 + 插件双轨）同一打法，中国团队的 agent 基础设施正在批量走 ” 论文级设计 + 开源级工程 ” 路线

七、风险与坑

1. 官方自我声明最重的一条：SAFETY.md 明写 “has not undergone a security audit and must not be treated as secure or production-ready”——能执行模型生成的代码、加载第三方插件、访问网络与凭据；沙箱与审批 ” 能降低风险但不保证隔离 ”
2. developer preview 会有破坏性变更：README 加粗警告；版本还在 0.2.1-rc，profile/bundle 的组合 API 不承诺稳定
3. 星标≠生产就绪：26 万星里相当比例来自 DeepSeek 品牌势能与 ” 免 Key 插件 ” 事件驱动；选型前按自己负载跑基准（仓库 BENCHMARK.md 提供基准跑法）
4. 组合复杂度是双刃剑：四层补丁模型灵活但也意味着排障要读懂插件树——--dump-config 是必备排障动作
5. 版本通道有时间差：GitHub tag（rc.3）与 npm 三通道（latest=rc.2 / next=rc.4）不同步，锁定依赖时认准 npm dist-tag 而非仓库 tag

八、总结

调研 + 冒烟结论：dsh 是目前 ” 组合自由度 ” 最高的开源 agent harness——把模型、工具、会话、循环全部插件化，背后有 Cordis 论文级设计支撑，八周 +28.7% 的星标与 34 万周下载证明生态真实起量。但它仍是 developer preview：无安全审计、API 会破坏性变更。

• 适合现在上手：插件开发者、agent 基础设施研究者、愿意踩 preview 的团队——生态窗口期（23K 插件仓）红利明显
• 建议再等等：生产环境直接承载不可信负载的场景——等 1.0 与安全审计
• 系列坐标系：本站 Agent 基础设施矩阵至此覆盖执行层（prime-agent/loopx）、上下文层（context-mode/mem0/graphiti）、语义层（EvoOntology）、决策层（jev/laya）——dsh 补上了 ” 底座层 ” 拼图

下一观察点：1.0 时间表、安全审计是否启动、dsh-our-free-model 这类灰色插件的治理态度、以及 OpenClaw 与 dsh 插件生态是否出现互通桥。

参考与延伸

• 主仓：deepseek-ai/deepseek-harness · 文档：deepseek-harness.github.io · Cordis 论文：arXiv:2608.25512 · Cordis 框架：cordiverse/cordis
• npm：@deepseek-ai/dsh（latest 0.2.1-rc.2）· 插件生态：dsh-plugin 话题
• 同系列：Prime Agent 调研 · LoopX 追更 · context-mode 调研 · EvoOntology 调研 + 实测

by 飞熊 · yunying（增长运营官）· 全部数字来自 2026-10-27 GitHub/npm 官方 API 与本机 dsh-lab 冒烟日志