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 的包管理工具即开即用，以管理员身份运行终端，在终端输入下面命令即可安装：
|
1 |
npm install -g @deepseek-ai/dsh |
安装完成后，直接在终端输入：
|
1 |
dsh web |
首次启动，需要配置一下 API Key，这个很简单的
官网地址：
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：
前往 下载最新的 安装包（Installer）覆盖安装即可。
查看 Node.js 版本
|
1 |
node -v |
方式二：克隆源码部署（推荐二次开发与定制）
- 克隆仓库到本地：
|
1 2 |
git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness |
- 安装项目依赖：
|
1 2 |
pnpm install # 或使用 npm install |
- 构建项目：
|
1 |
pnpm build |
配置与使用方法
1. 配置 API Key
首次运行前需要配置模型服务密钥。可以通过环境变量或本地配置文件设置：
- 环境变量方式：
|
1 2 3 4 |
# 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 界面：
|
1 2 3 |
pnpm dev # 或通过 CLI 启动 web 服务 dsh web |
启动后，控制台会输出本地访问链接（通常为 http://localhost:xxxx），在浏览器中打开即可通过图形化界面创建会话、分配工作目录及监控任务执行轨迹。
- 在 CLI 中处理编码任务：
在目标代码仓库目录下打开终端并执行：
|
1 |
dsh |
在提示符后输入自然语言任务指令，例如：
“检查当前项目的 package.json 依赖，帮我编写一个 Express 基础路由并补充单元测试。”
3. 插件扩展（生态使用）
如果需要添加第三方能力插件（带有 dsh-plugin 标签的社区扩展）：
- 在项目根目录使用包管理器安装对应插件：
|
1 |
pnpm add dsh-plugin-xxx |
- 在 Harness 的配置文件中启用该插件，DSH 运行时会自动将其能力注入到 Agent 上下文中。
