DeepSeek Harness 一键安装并接入 DeepSeek API（Windows / macOS）

上一篇《Codex Desktop 接入 DeepSeek 官方 API》是把 DeepSeek API 接到 Codex Desktop。这篇换到 DeepSeek 自己的 Harness，npm 包名是 dsh。装好 Node.js 后，复制一段命令，桌面就会出现 DeepSeekHarness 图标，双击就能打开网页。

Harness 目前还是 developer preview，界面和命令以后可能更新。文章里和实际页面对不上时，以页面提示为准。

一、拿 DeepSeek API Key

1. 打开 platform.deepseek.com，注册并登录。
2. 左侧点「API Keys」，再点「创建 API Key」。
3. 复制生成的 sk- 开头字符串。弹窗关掉后就看不到了。

注意：用开放平台生成的 Key，不是 DeepSeek 手机 App 里充值的账号余额。

二、装 Node.js（先分 Windows / macOS）

dsh 是 npm 包。装好 Node.js 后，首次双击图标会自动用 npm 安装 dsh，所以环境只需要 Node.js。建议用 Node.js 22 LTS 或更新版本；npm 包没有声明 engines，Node 18 及更早版本先不要用。官网下载慢的话，可以从 npmmirror 的 Node 镜像 下载：Windows 选 .msi，macOS 选 .pkg。

Windows

1. 打开 nodejs.org，下载 Windows Installer（.msi），选 LTS 版本。
2. 双击安装，一路「下一步」。
3. 打开 PowerShell，执行：

node -v
npm -v

两条命令都有版本号输出，就说明装好了。

macOS

1. 打开同一个网址，下载 macOS Installer（.pkg），选 LTS 版本。
2. 双击安装，按提示继续。
3. 打开「终端」（Terminal），执行同样的命令：

node -v
npm -v

如果提示“找不到命令”，先完全关掉 PowerShell / 终端再重新打开。

三、一键创建图标并开始使用

装好 Node.js 后，重新开一个 PowerShell / 终端窗口。把下面对应系统的整段命令复制进去，回车执行一次，桌面就会出现 DeepSeekHarness 图标。--registry 只对这次安装命令生效，不改全局 npm 配置。

Windows

$work = Join-Path $env:USERPROFILE 'deepseek-work'
New-Item -ItemType Directory -Force -Path $work | Out-Null
$bat = Join-Path $work 'DeepSeekHarness.bat'
@'
@echo off
cd /d "%~dp0"
where dsh >nul 2>nul
if errorlevel 1 (
    npm install -g @deepseek-ai/dsh --registry=https://registry.npmmirror.com
)
curl.exe -s -o nul --max-time 5 http://127.0.0.1:3080
if errorlevel 1 (
    start "" /min cmd.exe /c "dsh web"
) else (
    start "" http://127.0.0.1:3080
)
'@ | Set-Content -Path $bat -Encoding ascii
$desktop = [Environment]::GetFolderPath('Desktop')
$shell = New-Object -ComObject WScript.Shell
$shortcut = $shell.CreateShortcut((Join-Path $desktop 'DeepSeekHarness.lnk'))
$shortcut.TargetPath = Join-Path $env:SystemRoot 'System32\cmd.exe'
$shortcut.Arguments = '/d /c "' + $bat + '"'
$shortcut.WorkingDirectory = $work
$shortcut.WindowStyle = 7
$shortcut.Save()
Write-Host 'Done: DeepSeekHarness shortcut on desktop'

macOS

mkdir -p "$HOME/DeepSeekWork" "$HOME/Desktop"
cat > "$HOME/Desktop/DeepSeekHarness.command" <<'EOF'
#!/bin/bash
cd "$HOME/DeepSeekWork" || exit 1
if ! command -v dsh >/dev/null 2>&1; then
    npm install -g @deepseek-ai/dsh --registry=https://registry.npmmirror.com
fi
if curl -s -o /dev/null --max-time 5 http://127.0.0.1:3080; then
    open http://127.0.0.1:3080
else
    nohup dsh web > "$HOME/.dsh-launcher.log" 2>&1 &
    disown
fi
EOF
chmod +x "$HOME/Desktop/DeepSeekHarness.command"
echo "Done: DeepSeekHarness.command on desktop"

然后按顺序做：

1. 双击桌面的 DeepSeekHarness 图标。
2. 第一次启动会自动安装 dsh，需要几秒到几分钟；安装完成后服务启动并自动打开网页。没打开就等服务几秒再双击一次，不要连续双击。
3. 打开「设置 → 模型」，粘贴 sk- Key 并保存。Key 立即生效，不用重启 Harness。
4. 点「选择工作区」，添加 %USERPROFILE%\deepseek-work（Windows）或 ~/DeepSeekWork（macOS），并选中它。
5. 新建会话，发一句话开始用。

网页标签关掉不会停掉服务。下次双击图标，脚本会先检查 3080 端口；服务还在就直接打开网页，不会再启动一次。

四、常见问题

现象	处理
首次安装 dsh 很慢	默认已走 npmmirror；还慢就检查网络，或把命令里的 registry.npmmirror.com 改回 registry.npmjs.org
网页关了，再双击没反应	等服务启动几秒，再双击一次；网页关闭不会停掉服务
提示 401 或模型不可用	打开「设置 → 模型」，确认 sk- Key 粘完整并保存；Key 必须是开放平台创建的
端口 3080 被占用	Harness 已经在跑就直接双击图标打开网页；被别的程序占用时，打开 Windows 的 %USERPROFILE%\deepseek-work\DeepSeekHarness.bat 或 macOS 的 ~/Desktop/DeepSeekHarness.command，把检查地址和浏览器地址从 3080 改成 3081，并给 dsh web 加 --port 3081
提示 Node 版本太老或运行报错	重新安装 Node.js 22 LTS 或更新版本，重启 PowerShell / 终端后再试
Windows 想彻底停掉服务	关掉任务栏里那个最小化窗口
macOS 想彻底停掉服务	在终端执行 pkill -f "deepseek-ai/dsh"，或用活动监视器结束 Node 进程
macOS 首次双击打不开	重新运行第三节的 macOS 命令；首次双击会先在终端安装 dsh，安装完成后服务会自动打开网页。若没打开，等服务几秒再双击一次

---

参考：DeepSeek Harness 官方仓库 ｜ Web UI 使用指南 ｜ DeepSeek 开放平台