在 Linux 上安装 DeepSeek Harness

安装兼容的 Node.js

下面用 nvm 安装 Node.js 24。使用 v0.2.2-alpha.2 时，确认版本不低于 24.9。

在终端执行下面的命令安装 nvm。它会下载并执行 nvm 官方仓库的安装脚本，并修改当前用户的 Shell 配置。不要使用 sudo。

安装完成后关闭终端，重新打开 Bash 或 Zsh 窗口，依次执行：

第一条命令应输出 nvm。如果没有输出，查看 nvm 安装排查；如果系统没有 curl，可使用 Node.js 下载页中适合当前环境的安装方式。

检查当前终端使用的版本：

启动 DeepSeek Harness

用普通用户打开常用 Shell。许多桌面发行版可以按 Ctrl + Alt + T 打开终端。

首次运行会下载 DSH，下载速度取决于网络。使用期间保持终端运行；结束后可按 Ctrl+C 停止。

如果出现 Ok to proceed?，确认包名是 @deepseek-ai/dsh 后输入 y。

本机启动通常会自动打开浏览器。没有打开时，复制终端打印的完整地址；如果地址包含访问令牌，也要保留。不要把带令牌的地址公开分享。

配置 DeepSeek API Key

API Key 是 DSH 调用 DeepSeek 时使用的密钥。没有的话，先到 DeepSeek API Keys 创建。

回到 DSH，打开设置（Settings）→ 模型（Models）→ DeepSeek，粘贴 API Key 并保存。随后打开模型选择器，选中 DeepSeek 下可用的模型。

不要把真实 API Key 放进截图、代码仓库或公开的求助消息。API 余额不足时，即使保存了 Key，也无法完成请求。

选择一个空的测试文件夹

回到 DSH，点击 Choose workspace，选择 ~/dsh-test。

发送一条测试消息

复制下面这句话发给 DSH：

检查通过后，可以继续创建第一个文本文件。如果请求失败，按下面的症状排查。

没有成功？按症状处理

通过 SSH 连接服务器时，浏览器不会自动打开，需要配置端口转发。见远程启动说明；不要直接向公网开放 DSH。

更多安装方式

参与开发或修改源码时，再看源码运行指南。

企业网关、自建模型服务等情况，再看自定义 Provider 指南。

可选：接入聊天平台

需要从手机或群聊发起 DSH 任务时，再接入你常用的平台。以下接入方案来自社区，不属于安装必需项。

选择已有账号的平台即可，不需要全部安装。