DeepSeek Harness（命令行工具名：dsh）是 DeepSeek AI 开源的 Agent Harness。它既是可直接运行的 Coding Agent（提供 Web UI 与 headless 两种形态），也是一套「一切皆插件」的运行框架。当前处于 developer preview。

官方仓库：https://github.com/deepseek-ai/deepseek-harness
官网介绍：https://deepseek.com/harness/en/
npm 包：@deepseek-ai/dsh

本文按 Windows / Ubuntu 分别给出国内镜像安装与启动方式，帮助你尽快跑通第一次 Web UI。

0. 前置条件

  • 安装 Node.js：建议 ^22.19.0 或 >=24.0.0
  • 准备 DeepSeek API Key（本地 Web UI 默认走 API，不是本地推理）
  • 可选：配置 npm 国内镜像，加快安装

验证 Node：

node -v
npm -v

1、Windows 上使用

(1) 配置国内镜像并全局安装

在 PowerShell 中执行：

$env:npm_config_registry="https://registry.npmmirror.com"
$env:npm_config_disturl="https://npmmirror.com/mirrors/node/"
npm install -g @deepseek-ai/dsh

说明：

  • npm_config_registry：npm 包走 npmmirror
  • npm_config_disturl：部分原生依赖下载走国内 Node 镜像
  • -g：全局安装，之后可直接用 dsh 命令

(2) 更新（可选）

$env:npm_config_registry="https://registry.npmmirror.com"
$env:npm_config_disturl="https://npmmirror.com/mirrors/node/"
npm update -g @deepseek-ai/dsh

(3) 启动 Web UI

dsh web

默认地址一般是：

http://127.0.0.1:3080

浏览器打开该地址即可。停止服务：在对应终端按 Ctrl + C。

(4) 不想全局安装时

也可用一次性命令：

npx @deepseek-ai/dsh web

(5) 首次进入界面后做什么

  1. 配置模型：设置 → 模型，填入 DeepSeek API Key 并保存（通常无需重启）
  2. 选择工作区：添加并选中一个本地项目目录；未选中前，会话输入框通常不可用
  3. 发送任务：例如「总结这个仓库的主要模块」

2、Ubuntu 上使用

(1) 配置国内镜像并全局安装

在 bash / zsh 中执行：

export npm_config_disturl=https://npmmirror.com/mirrors/node/
export npm_config_registry=https://registry.npmmirror.com
npm install -g @deepseek-ai/dsh

若提示权限不足，可用：

sudo npm install -g @deepseek-ai/dsh

更推荐用 nvm 管理 Node，避免 sudo npm。

(2) 更新

export npm_config_disturl=https://npmmirror.com/mirrors/node/
export npm_config_registry=https://registry.npmmirror.com
npm update -g @deepseek-ai/dsh

(3) 启动 Web UI

dsh web

浏览器访问：

http://127.0.0.1:3080

(4) 一次性启动（不全局安装）

npx @deepseek-ai/dsh web

(5) 把镜像写进 shell 配置（可选）

若希望每次新开终端都默认用国内源，可写入 ~/.bashrc 或 ~/.zshrc：

export npm_config_registry=https://registry.npmmirror.com
export npm_config_disturl=https://npmmirror.com/mirrors/node/

然后：

source ~/.bashrc
# 或
source ~/.zshrc

3、第一次任务建议

工作区选好后，可以从小任务开始：

总结这个仓库的目录结构，并指出主要入口文件。

Agent 可能会读写文件、执行命令；若触发权限策略，Web UI 会先征求你的批准。

4、常用命令速查

命令 作用
dsh web 启动 Web UI（日常开发主入口）
npx @deepseek-ai/dsh web 不全局安装时启动
npm update -g @deepseek-ai/dsh 更新全局包
dsh --version 查看版本（若该版本支持）

5、常见问题

Node 版本太旧

报 engines 不满足时，升级到 Node 22.19+ 或 24+。

安装很慢或失败

确认已设置：

  • registry.npmmirror.com
  • npmmirror.com/mirrors/node/

Windows 注意：PowerShell 里要用 $env:...，不要直接写 Linux 的 export。

打开了页面但不能聊天

通常是还没选择工作区，或还没配置可用模型 / API Key。

本地 UI ≠ 本地模型

dsh web 默认是本地界面 + 远程 API。需要自行准备 DeepSeek 平台密钥。

总结

新手最快路径：

  1. 装好较新的 Node.js
  2. Windows / Ubuntu 分别配置 npm 国内镜像
  3. npm install -g @deepseek-ai/dsh
  4. dsh web 打开 http://127.0.0.1:3080
  5. 配置 API Key → 选择工作区 → 开始第一个任务

后续若要写插件、用 headless 脚本化，或从源码开发，可继续看官方仓库文档与 Web UI 快速开始。