DeepSeek Harness 深度解析：一个「一切皆插件」的 Agent 底座，凭什么对标 Claude Code / Codex

2026 年 8 月 13 日，DeepSeek 在宣布 API 涨价之后，甩出了一个更耐人寻味的东西：DeepSeek Harness v0.1 开发者预览版，MIT 开源。它不是一个新模型，而是一整套「让模型能干活」的工程框架。发布当天 GitHub 仓库 12 小时冲到 5 万 Star，24 小时内冒出 288 个第三方 dsh-plugin 插件仓库。

如果你在用 Claude Code 或 Codex，最想问的可能是：它跟我手上的工具到底有什么区别？值不值得分神看一眼？ 这篇文章用 5 分钟回答清楚。

---

一、一句话看懂它的位置

DeepSeek 官方给了一个很干脆的等式：

Model（模型）+ Harness（底座）= Agent（智能体）

模型只负责「思考和推理」，Harness 包揽模型之外的一切工程活——工具调用、任务规划、执行调度、沙箱、存储、循环。

打个比方：以前调 DeepSeek API 拿到的是颗「大脑」，现在它顺手递给你一套「手脚和神经系统」。而支撑这套底座的核心设计，就是官方反复强调的那句 「一切皆插件」（Everything is a Plugin）：模型、工具、技能、会话、沙箱、存储、调度，乃至 Web UI 界面本身，全部都是可以自由替换、重新组合的插件。

---

二、Harness 和 Codex / Claude Code 到底差在哪

先给结论：Codex 和 Claude Code 是「成品工具」，Harness 是「开发者底层工具」。

维度	Claude Code	Codex	DeepSeek Harness
本质	精致的产品	封闭的产品	开放的框架/底座
上手门槛	开箱即用	开箱即用	需要组装，有门槛
扩展机制	hooks / skills / MCP	有限的 SDK / 沙箱	一切皆插件
模型绑定	绑定 Anthropic 模型	绑定 OpenAI 模型	模型可替换
运行时	黑盒	黑盒	源码级开放
面向对象	追求效率的终端用户	追求效率的终端用户	想掌控底层的开发者/团队

几点展开说明：

1. 产品 vs 框架。Claude Code 和 Codex 的目标是「给你一个一键可用的智能体」，它们的价值在开箱即用、体验精致。Harness 不打算给你一个终端助手，而是给你一套能自己搭 Agent 技术栈的底座——想换模型、换工具、换存储、换 UI，都不用改它的源码。

2. 开放 vs 封闭。Codex 被社区吐槽最多的是「封闭黑盒」：模型、工具、沙箱锁死在一个套件里，想改任何细节都困难。Harness 反其道而行，从内核层面就做成了可拆卸的「乐高」——有开发者评价「完全模块化，你可以重写、替换任何你不喜欢的部分」。

3. 竞争维度不同。Harness 把竞争从「模型能力」提升到了「模型如何利用工具的底层运行时（Runtime）」领域。这也是为什么它要单独开品牌、用黑色鲸鱼标识——DeepSeek 想把它当独立生态经营，而不是模型的附庸。

---

三、它到底解决什么问题

3.1 厂商锁定（Vendor Lock-in）

过去想做一个复杂 Agent，往往被迫接受厂商的完整套件：模型、工具、沙箱全在一个黑盒里。想换个更便宜的模型？想接内部代码规范？都很难。Harness 让你随时替换模型获取最优性价比，或写个插件适配自己的规范。

3.2 黑盒不可控

企业落地 Agent 最大的顾虑是「不可控」：工具怎么被调用、会话怎么存、权限怎么卡，全在厂商手里。Harness 的答案是掌控力回归——每一个能力都是你可以打开、阅读、替换的插件。

3.3 重复造轮子

每个团队都在重复实现同一批东西：会话管理、上下文压缩、子代理编排、权限审批、沙箱隔离……Harness 把这些工程通用件一次性做好、做成可插拔的模块，你只写差异化的部分。

3.4 缺一个统一的 Agent 运行时标准

模型层有 OpenRouter、工具层有 MCP，但「模型 + 工具 + 循环 + 存储 + 调度」这一整层长期没有统一底座。Harness 想做的是这一层的运行时标准。

---

四、核心设计架构

4.1 内核：Cordis 插件系统

Harness 基于 Cordis（一个「时空可组合」的插件元框架）构建。Cordis 只做一件事：插件的加载/卸载与依赖关系管理。Harness 的所有具体组件——模型接入、工具、技能、会话、沙箱、调度、UI——都是不同的 Cordis 插件，通过 服务（Service）与事件（Event） 彼此协作，在配置层自由组合。

「时空可组合」不是玄学：它指的是插件可以在生命周期（时间） 和依赖注入（空间） 两个维度上被精确地组装、替换、隔离。这是 Harness「一切皆插件」能落地到内核的关键。

4.2 Profile + patch 层：把 Agent 当成「配置文件」

这是 Harness 最优雅的设计之一。一个 Agent 运行环境就是一个 Profile，由多个插件 bundle 按顺序叠加（patch）而成：

# 一个 profile 的组成（示意）
dsh.profile.bundles:        # 各 bundle 的 patch 层（从下往上叠加）
  - @deepseek-ai/dsh-base
  - @deepseek-ai/dsh-web-app
  - @dsh-external/dsh-client-ui-blog-editor   # ← 你自己的插件

cordis.patch.yml            # profile 级用户 patch 层
$DSH_HOME/cordis.patch.yml  # 全局用户 patch 层
--patch 覆盖层               # 命令行临时覆盖

配置树从空根开始，逐层叠加，越靠上的层优先级越高。想改某个插件的某个配置项？不碰源码，写一层 patch 覆盖即可。

4.3 四种模式（预设）

Harness 预置四种模式，每种默认加载不同插件集合：

模式	说明
标准（standard）	完整的工具组合，日常开发用
PTC	程序化工具调用：由模型生成一段代码来组合多轮工具调用
极简（minimal）	只保留 shell + 文件编辑两个工具，用于最小环境基准测试
创造（cordis）	检查运行时、在内存中试验 Cordis 插件，据此组合出新模式

4.4 多界面：Web / TUI / Headless 共用一套内核

Harness 把「宿主（Host）」和「客户端（Client）」分离：

• 同一套 Agent 内核，可以挂 Web GUI（浏览器里的 React 界面）、TUI（终端界面）、Headless（dsh --profile headless "任务" 跑完直接出结果）。
• Web 界面本身也是插件：它通过 Slot（插槽）注册 机制组织——设置页、命令面板、会话区、工具栏都是可扩展的 slot，第三方插件往 settings.plugins.tab 这类 slot 里注册就能长出新的界面。

4.5 工程能力全家桶（都是可替换插件）

从 Harness 的包结构里能直接看出它内置的「通用件」有多全：

• 会话与记忆：会话持久化（JSONL / SQLite）、上下文压缩（compaction）、溢出（spill）
• 多代理编排：子代理（subagent，含 fork / spawn 两种进程模型）、多代理工作流（workflow）、长任务目标循环（goal + round driver）、Ralph 循环
• 工具层：shell、文件系统、待办（todo）、任务（jobs）、Web 检索、提问用户（ask-user）、技能（skill）、MCP 客户端
• 安全与治理：沙箱策略、权限预设（permission presets）、用户审批、文件观察策略
• 模型接入：DeepSeek 官方、Pi-AI 等，模型可插拔

---

五、写一个插件有多简单（实测）

「一切皆插件」不是口号。一个第三方插件只需要一个 package.json + 一个 patch 文件 + 一份客户端 bundle：

{
  "name": "@dsh-external/dsh-client-ui-blog-editor",
  "main": "lib/index.js",
  "dsh": {
    "bundle": { "patch": "./cordis.patch.yml" },
    "client": { "inject": ["@deepseek-ai/dsh-client-runtime"], "platform": "web" }
  }
}

# cordis.patch.yml：往 profile 里插入一个宿主条目
- insert:
    - id: ui-blog-editor
      name: '@dsh-external/dsh-client-ui-blog-editor'

然后一条命令装上：

dsh plugin --profile web add ./dsh-blog-editor

刷新后，Web 设置里就多了一个你自己写的界面。全程不碰 Harness 源码。

---

六、优势总结

1. 可替换：模型、工具、存储、UI 逐项替换，按需选最优性价比
2. 可组合：像拼乐高一样用配置文件组装 Agent 技术栈
3. 可控：源码级开放，运行时行为不再黑盒
4. 可扩展：统一插件机制 + 活跃的第三方 dsh-plugin 生态

---

七、不足与展望

• 成熟度：v0.1 仍是开发者预览版，稳定性和文档在打磨中
• 门槛：对普通用户「很难直接拿来用」，上手成本高于 Claude Code / Codex
• 生态：刚起步，工具和最佳实践还在积累

一句话总结：如果你想要一个开箱即用、体验精致的智能体，Claude Code / Codex 仍是最优解；但如果你想把 Agent 的底层调度逻辑攥在自己手里、做高度定制化部署，DeepSeek Harness 是目前最值得押注的开放底座——它把 Agent 拆成了零件，然后还给了开发者。