DeepSeek Harness（dsh）安装教程

简介

DeepSeek Harness（命令名dsh）是DeepSeek官方开源的一个agent框架，采用一切皆插件的架构。它既可以当终端里的AI助手用，也有Web界面管理会话和插件。项目在github.com/deepseek-ai/deepseek-harness，目前还是开发者预览版，迭代比较快。官网是deepseek.com/harness。

安装方法

dsh是Node.js项目，通过npm发布，包名是@deepseek-ai/dsh。所以思路很简单：装好Node.js（自带npm），再用npm全局安装dsh。下面分平台说明。

macOS / Linux（Homebrew）

先装Homebrew，macOS直接运行官方脚本：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Linux（Linuxbrew）先装构建依赖：

sudo apt-get install -y build-essential procps curl file git

然后执行同样的官方脚本，装好后brew在/home/linuxbrew/.linuxbrew。国内用户嫌下载慢，可以参考我之前写的《opencode安装教程》里的清华镜像源配置。

然后安装Node.js 24：

brew install node@24

node@24是keg-only的，不会自动加进PATH，需要手动链接：

brew link --overwrite node@24

或者把bin目录加进shell配置（以Apple Silicon为例）：

echo 'export PATH="/opt/homebrew/opt/node@24/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Intel mac是/usr/local/opt/node@24/bin，Linux（Linuxbrew）是/home/linuxbrew/.linuxbrew/opt/node@24/bin。确认一下版本：

node -v
npm -v

接着用npm安装dsh：

npm install -g @deepseek-ai/dsh
dsh --help

不想全局安装的话，也可以用npx临时跑，效果一样：

npx @deepseek-ai/dsh web

Windows

Homebrew不支持原生Windows，Windows用户直接装Node.js就行，后面的命令和macOS/Linux完全一样。推荐用winget：

winget install OpenJS.NodeJS.LTS

装的是Node.js 24 LTS，自动加入PATH，装完新开一个终端验证：

node -v
npm -v

或者去nodejs.org/en/download下载Windows 24 LTS的MSI安装包双击安装。然后安装dsh：

npm install -g @deepseek-ai/dsh
dsh --help

启动和使用

启动Web界面：

dsh web

默认监听http://127.0.0.1:3080，本机启动会自动打开浏览器，SSH远程启动只打印URL，不想自动开浏览器就加--no-open。

第一次用要先配置模型。打开设置→模型，填入DeepSeek API Key（在platform.deepseek.com申请），保存即可，不用重启。然后点选择工作区，把启动dsh时所在的项目目录加进去并选中，就能新建会话了。agent可以读写工作区文件、跑命令、维护计划，需要权限的操作会先征求同意。

常用命令

dsh web                                   # 启动Web UI
dsh --profile headless "run the tests"    # 无头模式，跑一次会话输出结果后退出
dsh plugin --profile        # 管理profile的插件
dsh --help                                # 帮助

国内加速

npm默认走官方源，国内可以换npmmirror镜像：

npm config set registry https://registry.npmmirror.com

或者安装时临时指定：

npm install -g @deepseek-ai/dsh --registry=https://registry.npmmirror.com

总结

dsh安装不复杂，关键是装好Node.js 24，然后用npm全局安装。更多用法看官方文档（github仓库的docs目录下），有问题也欢迎在评论区留言。