环境准备

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

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

安装教程

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

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

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

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

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

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

自行注册

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

在 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 版本

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

1. 克隆仓库到本地：

2. 安装项目依赖：

3. 构建项目：

配置与使用方法

1. 配置 API Key

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

• 环境变量方式：

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

2. 启动与交互

• 启动 Web 界面：

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

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

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

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

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

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

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

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