欢迎光临我的个人博客查看最新文章：river's blog

一、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

若未安装，前往 Node.js — 下载 Node.js® 下载安装包，按提示安装即可。

---

三、三种安装方式

方式一：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 开放平台 DeepSeek 创建一个 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 值得上手一试。