安装 · 下载
DeepSeek Harness 安装与下载 （DSH 安装 · DSH 下载）
DeepSeek Harness（DSH）是一个 Node.js 包——唯一的要求就是 Node.js。先看清官方发行渠道与校验方式（下载），再选你的系统一键安装，或从源码构建。装好后见 rc.8 枢纽。
DeepSeek Harness 下载：官方发行渠道
DSH 不提供独立的 .exe / .dmg 安装包——任何第三方"DSH 安装包下载"站都不是官方渠道。官方获取方式只有两条：
- npm 发行包：包名
@deepseek-ai/dsh（当前 0.1.1-rc.2，开发者预览迭代中）。安装命令见下文；只想拿压缩包的话，直接下载 registry 的 tarball：registry.npmjs.org/@deepseek-ai/dsh/-/dsh-0.1.1-rc.2.tgz（换版本号即可取对应版本）。 - GitHub 源码：github.com/deepseek-ai/deepseek-harness（官方仓库，Releases 页提供版本归档）。
版本与 SHA 校验——下载前后核对包完整性：
npm view @deepseek-ai/dsh dist.integrity # 输出 sha512-… 完整性值
npm view @deepseek-ai/dsh version # 当前最新版号经 npm install / npx 安装的包由 npm 客户端自动做完整性校验（对照 registry 的 SHA-512），无需手动核对；只有从非 npm 渠道拿到的 .tgz 才需要自己比对 sha512sum。
开始之前
- 需要 Node.js LTS（18+）——下面每个脚本都会先检查它。
- DeepSeek Harness 处于开发者预览阶段——迭代很快，未来会有破坏性变更。
- 想要离线版？下载 DeepSeek Harness 指南 PDF（安装 · 插件 · 排错 · vs Claude Code）。
Windows — 一键（PowerShell）
打开 PowerShell（右键开始 → 终端）粘贴：
if (-not (Get-Command node -ErrorAction SilentlyContinue)) { winget install OpenJS.NodeJS.LTS }
npx @deepseek-ai/dsh web如果没有 winget，从 nodejs.org 下载 LTS 安装包手动装 Node.js，再运行 npx @deepseek-ai/dsh web。
macOS — 一键（终端）
command -v node >/dev/null 2>&1 || brew install node
npx @deepseek-ai/dsh web没有 Homebrew 的话先装它，或从 nodejs.org 装 Node.js。
Linux — 一键（bash）
Debian / Ubuntu（用 NodeSource）：
command -v node >/dev/null 2>&1 || (curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs)
npx @deepseek-ai/dsh web其他发行版、或想避免 sudo，用 nvm，然后 npx @deepseek-ai/dsh web。
WSL（Ubuntu on WSL）— 一键
在 WSL 的 Ubuntu 终端里：
command -v node >/dev/null 2>&1 || (curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs)
npx @deepseek-ai/dsh web从源码构建（所有平台通用）
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web使用 pnpm——没有的话先 npm install -g pnpm。
验证运行
打开 http://127.0.0.1:3080，填入 DeepSeek API Key。要换端口，传给应用即可：
npx @deepseek-ai/dsh web --port 8080安装为全局命令
npx 每次启动都会重新解析包。要长期使用——尤其是 CLI / 无头模式——建议一次性安装 dsh 命令：
npm install -g @deepseek-ai/dsh
dsh --version # 例如 0.1.0-rc.6
dsh web确保 npm 全局 bin 目录在你的 PATH 里（用 npm prefix -g 查看）。如果用的是便携版 Node（无全局安装），把 npm 的 prefix 指向你控制的目录（npm config set prefix D:\dsh\npm-global），并把 Node 目录和全局 bin 目录都加进用户 PATH。
配置 API key
Web UI 在 设置 → 模型 里存 key。CLI / 无头模式则写在 $DSH_HOME/.credentials.yaml（默认 ~/.dsh/.credentials.yaml）：
DEEPSEEK_API_KEY: sk-your-key-heremacOS / Linux 上要把文件设为 chmod 600——DSH 会拒绝其他用户可读的凭证文件。DEEPSEEK_API_KEY 环境变量同样生效且优先级更高。
安装排错
ERR_PNPM_FETCH_404/ 包找不到——默认 npm 镜像可能落后于官方。加--registry=https://registry.npmjs.org重试。'pnpm' 不是内部或外部命令——插件管理会调用 pnpm；先npm install -g pnpm。node: command not found——Node.js 不在 PATH 里。把 Node 目录（和 npm 全局 bin）加进 PATH。- 3080 端口被占用——换端口启动：
dsh web --port 8080。