DeepSeek Harness 整体架构：一切皆插件是什么意思

DeepSeek Harness（下文简称 dsh）不是一个新的大模型，也不是 DeepSeek 官方 IDE。它是一套围绕模型的运行环境（agent harness，智能体框架）：模型负责理解和推理，Harness 负责组织工具、会话、权限等能力，让智能体在真实环境里持续干活。官方用 Agent = Model + Harness 概括这个关系。官方中文产品页进一步说明：模型、工具、技能、会话、沙箱、存储、循环、调度和 UI 等智能体能力，都可以由插件提供和组合。运行上，npx @deepseek-ai/dsh web 即可启动 Web 界面，默认地址 http://127.0.0.1:3080。

最容易产生的误解是"一切皆插件 = 没有核心"。实际上官方仓库的 packages/core 是稳定的产品 API 主干（product packages），插件和消费方都针对它构建。"一切皆插件"的真实含义是：产品的每一部分——模型适配器、工具注册表、会话日志、智能体循环本身——都是插件，可以被替换，官方文档原话是"不存在需要打补丁的特权内核"。

示意图点击放大

dsh 的插件能力来自 Cordis——一个第三方开源框架（上游仓库 cordiverse/cordis），其设计写在一篇论文《A Programming Paradigm for Spatiotemporal Composability》里。dsh 以 vendor（固定源码副本）方式把 Cordis 引入自己的仓库。写法上注意：不能说"DeepSeek 开发的 Cordis"。详见本站Cordis 框架页。

官方架构文档给出了一张"核心主干包"（core spine）表，每个包在共享上下文（ctx）里占一个稳定键名：

（core/scope 是库而非服务。）记住这张表，后面每个详情页都是在展开其中一行——比如 core/agent-loop 一行对应智能体循环页，插件怎么挂进来见插件系统页。

官方把"可替换能力"统一抽象为 capability seam（能力接缝），每个接缝有三个角色：Service Definition（服务定义）、Provider（提供方）、Consumer（消费方）。举个官方给的例子：当文件系统与进程的提供方指向远程沙箱时，Bash、PTY（伪终端）、LSP（语言服务器协议）这些能力会一并迁移过去——消费方代码不用改。

示意图点击放大

dsh 有一条运行时不变量，官方称为"模型可见即已记录"：抵达模型请求的一切内容，必须能从会话日志重建。会话日志是模型所见上下文的唯一来源，模型看到的历史是从日志派生出来的，而不是单独存一份聊天记录。这条不变量是整个架构的地基，详见《会话》页。

dsh 的事件分成三个域，用途不同：

• 持久会话事件（session/event 广播）：落盘的事实，可回放；
• 实时 Agent 事件（agent/*）：运行中的协调接口；
• 能力事件（fs/*、tools/*、telemetry/*）：各能力接缝的状态通知。

SDK（软件开发工具包，给外部程序调用的接口包）要回放完整交互记录，应该消费持久会话事件，而不是实时事件。

dsh 当前处于开发者预览（Developer Preview）阶段，官方 README 明确声明"会有破坏兼容性的变更"（THERE WILL BE COMPATIBILITY-BREAKING CHANGES），SESSION_FORMAT_VERSION 保持 0、不提供兼容承诺。npm 上最新预发布版 0.1.1-rc.2 发布于 2026-08-21。本栏目所有"当前行为"的描述都对应这个版本窗口，后续版本可能变化。官方文档站（中英双语）：deepseek-harness.github.io/deepseek-harness。