DeepSeek Harness

DeepSeek Harness（简称 DSH） 是由 DeepSeek 官方开源的 AI Agent（智能体）开发与运行环境/脚手架框架。

• 核心设计哲学：“一切皆插件”（Everything is a Plugin）： 基于轻量级框架 Cordis 构建，将大模型适配器、Shell/文件工具、沙箱、会话追踪、规划调度乃至前端 UI 都解耦为独立插件。
• 定位与用途： 充当大语言模型与真实系统交互的“双手与运行中枢”。它不仅是一个类似 Claude Code 的本地编程智能体，更是一个允许开发者自由组装、替换底层能力的 Agent 运行底座。
• 核心运行模式：
• Standard 模式： 具备完整工具链（文件编辑、终端、网页搜索、子智能体与多步规划）。
• Code 模式： 将工具封装为 TypeScript SDK，支持模型单次生成脚本完成批量多步操作。
• Minimal 模式： 仅保留 Shell 和文件替换编辑工具，适合基准测试与轻量任务。
• Creator 模式： 专为编写与调试自定义 Agent 插件及预设设计。

---

环境准备

在安装前，请确保电脑已安装：

• Node.js：Node.js 版本 >= 22.19.0（或 Node 23 / 24+）
• npm 或 pnpm / yarn
• Git
• 拥有有效的大模型 API 密钥（如 DeepSeek API Key，或其他兼容 OpenAI 格式的模型 Key）

---

安装教程

DeepSeek Harness 提供了两种主流使用方式：免克隆快捷运行 与 源码克隆开发。

方式一：快捷运行（推荐普通使用者）

无需手动下载仓库，直接通过 Node 的包管理工具即开即用，以管理员身份运行终端，在终端输入下面命令即可安装：

npm install -g @deepseek-ai/dsh

安装完成后，直接在终端输入：

dsh web

首次启动，需要配置一下 API Key，这个很简单的

官网地址：
DeepSeek | 深度求索
api接口改到这里了，点击开发平台

下图应该是旧版本的网页，官网应该更新了

自行注册

登录后的样子，有免费的额度，演示应该够用了

在 DeepSeek 平台创建即可，创建时候记住 keys 值，它只会出现一次

注意事项

Node.js 版本太低的话会启动报错：

SyntaxError: The requested module ‘node:zlib’ does not provide an export named ‘createZstdDecompress’

原因：
DeepSeek Harness 要求：Node.js 版本 >= 22.19.0（或 Node 23 / 24+）

解决方法：
将 Node.js 升级到 v22.19.0 或更新的版本（推荐升至最新的 LTS 版本）：

直接更新 Node.js：
前往 Node.js 官方网站 下载最新的 安装包（Installer）覆盖安装即可。








查看 Node.js 版本

node -v  

---

方式二：克隆源码部署（推荐二次开发与定制）

1. 克隆仓库到本地：

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness

2. 安装项目依赖：

pnpm install
# 或使用 npm install

3. 构建项目：

pnpm build

---

配置与使用方法

1. 配置 API Key

首次运行前需要配置模型服务密钥。可以通过环境变量或本地配置文件设置：

• 环境变量方式：

# Linux / macOS
export DEEPSEEK_API_KEY="your_deepseek_api_key_here"

# Windows PowerShell
$env:DEEPSEEK_API_KEY="your_deepseek_api_key_here"

• 配置文件方式： 在项目根目录或运行目录下编辑生成的配置文件（如 .env 或 YAML 配置），填入对应供应商的 apiKey 与 baseURL。

---

2. 启动与交互

• 启动 Web 界面：

pnpm dev
# 或通过 CLI 启动 web 服务
dsh web

启动后，控制台会输出本地访问链接（通常为 http://localhost:xxxx），在浏览器中打开即可通过图形化界面创建会话、分配工作目录及监控任务执行轨迹。

• 在 CLI 中处理编码任务：
  在目标代码仓库目录下打开终端并执行：

dsh

在提示符后输入自然语言任务指令，例如：

“检查当前项目的 package.json 依赖，帮我编写一个 Express 基础路由并补充单元测试。”

---

3. 插件扩展（生态使用）

如果需要添加第三方能力插件（带有 dsh-plugin 标签的社区扩展）：

1. 在项目根目录使用包管理器安装对应插件：

pnpm add dsh-plugin-xxx

2. 在 Harness 的配置文件中启用该插件，DSH 运行时会自动将其能力注入到 Agent 上下文中。