2026 年 8 月 13 日，DeepSeek 开源了 Harness（命令行叫 dsh），采用 MIT 许可证，发布即冲上 GitHub 趋势榜。它补齐了 DeepSeek 生态里"只开源模型、不开源运行底座"的那一半。

一、Harness 到底是什么？

DeepSeek 官方给了一个很好理解的核心公式：

Agent = Model + Harness

  • Model（模型）：那颗"聪明的大脑"，负责思考和生成。

  • Harness（马具）：给大脑装上的"身体"，负责把模型接入文件系统、终端、网页、工具链，让 AI 真正能在真实环境里干活。

你平时接触的 Claude Code、Codex、各类 AI 编程助手，本质都是 Harness——它们必须和模型搭配才能工作。DeepSeek 这次开源的，就是一个可高度定制、对标 Claude Code 的 Agent 运行底座。

核心设计：一切皆插件

Harness 整个框架建立在 Cordis 微内核之上。这个内核极其克制，只负责插件的加载、卸载和依赖管理。最亮眼的设计主张是：

Everything is a plugin（一切皆插件）

模型、工具、技能、会话、沙箱、存储、Agent 循环、调度，甚至连 UI 本身，都是插件，都可以拔掉换成别的。不满意哪一块，随时替换或安装插件来扩展，不需要改框架源码。

  • GitHub 仓库：https://github.com/deepseek-ai/deepseek-harness

二、安装前的准备

Harness 用 TypeScript 编写，启动方式依赖 Node.js。

  • Node.js 22.x 及以上（推荐 22 LTS）

  • 一个可用的 DeepSeek API Key（用于对话；也支持其他 OpenAI 兼容端点）

检查 Node 版本：

node -v
# 推荐输出 v22.x.x

若未安装，前往 https://nodejs.org/zh-cn/download 下载安装包，按提示安装即可。

三、三种安装方式

方式一：npx 一条命令（最推荐）

打开终端，执行：

npx @deepseek-ai/dsh web

# 或先安装再开启web服务
npm install -g @deepseek-ai/dsh
dsh web

命令执行后，终端会输出一个本地地址（默认 http://127.0.0.1:3080），浏览器打开它即可进入 Harness 的 Web 界面。无需手动克隆仓库。

方式二：从源码构建

想研究源码或参与插件开发，可以克隆仓库：

git clone https://github.com/deepseek-ai/deepseek-harness
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

方式三：交给 AI 助手安装

看不懂命令行？直接把下面这句话丢给你常用的 AI 工具（如 WorkBuddy），让它帮你拉起：

帮我安装 DeepSeek Harness：https://github.com/deepseek-ai/deepseek-harness

四、配置 API Key

第一次启动 Web UI 后，需要填入 DeepSeek API Key：

  1. 前往 DeepSeek 开放平台 https://platform.deepseek.com/api_keys 创建一个 API Key；

  2. 复制粘贴到 Harness 的密钥输入框；

  3. 使用前记得往账户里充一点余额。

安全提示：API Key 以只写（write-only）方式存放在 $DSH_HOME/.credentials.yaml，设置里只保留密钥引用，不会明文落库。

模型路由本身也是一个插件——除了 DeepSeek，你还可以在设置里添加 Anthropic、OpenAI、Bedrock、Vertex、Azure、Codex 等厂商，或接入任何 OpenAI 兼容端点，添加后即时生效，无需重启服务。

五、快速上手：Web UI 四步走

进入 Web 界面后，整体布局是：左侧对话历史、中间任务区（可选手工作目录与运行模式）、右侧对话框。

第 1 步：选工作区 Harness 必须先选择一个工作文件夹才能对话。在电脑上建好一个目录并让 dsh 打开它，这就是 Agent 能操作的项目文件范围。

第 2 步：选权限 Harness 提供三级文件护栏：

权限

能力范围

适用场景

Read Only

只能读不能改

只想让它看代码

Workspace Write

可改工作目录内的文件，越界会先问你

日常最常用

Full Access

目录内外都能改

清楚它在做什么时再用

第 3 步：选运行模式（详见下一节）

第 4 步：选模型与推理强度 在右下角选择模型，并可设置高/中/低三档推理强度。

六、四种运行模式详解

Harness 内置四种模式，本质区别在于"当前会话加载了哪些工具插件"：

模式

加载的插件集合

适合谁

标准模式 (Standard)

文件编辑、Shell、搜索、Skills、子 Agent、工作流

所有人，默认选它

PTC / Code 模式

标准模式全部 + 程序化工具调用（SDK）

批量操作、自动化流程

极简模式 (Minimal)

仅 Bash + 文件编辑器

模型基准测试

创造模式 (Creator)

标准模式 + 检查/试验/创建插件

想自己造插件的高级用户

小白建议：第一次使用，无脑选"标准模式"即可，绝大多数日常开发任务用它就够了。

七、总结

DeepSeek Harness 的意义不只是"又一个开源 Claude Code 竞品"。它把 Agent 的运行底座开源出来，它的核心卖点可以浓缩成三句话：

  • 一切皆插件：从模型到 UI 都能换；

  • 完全可追踪：每一次上下文注入都可审计；

  • 模型无关：换掉 DeepSeek，它依然是你的 Agent 运行底座。

如果你正在搭建自己的 Agent 工作流，或者想研究一个"可替换内核"的 Agent 框架长什么样，DeepSeek Harness 值得上手一试。