这份指南用于让其他人从零开始安装并启动 DeepSeek Harness。适用环境：Windows PowerShell；所有新建的 Node、npm 依赖、缓存、临时文件、运行数据和日志都放在 D 盘。

一、准备目录

打开 PowerShell，执行：

$root = 'D:\tools\deepseek-harness'
New-Item -ItemType Directory -Force -Path "$root\runtime", "$root\data", "$root\.tmp", "$root\.npm-cache" | Out-Null

二、下载 D 盘便携版 Node.js

不使用系统安装程序，直接把 Node.js 压缩包下载并解压到 D 盘：

$root = 'D:\tools\deepseek-harness'
$zip = "$root\node-v24.19.0-win-x64.zip"
Invoke-WebRequest -UseBasicParsing `
  -Uri 'https://nodejs.org/dist/v24.19.0/node-v24.19.0-win-x64.zip' `
  -OutFile $zip
Expand-Archive -LiteralPath $zip -DestinationPath "$root\.node" -Force

设置 Node 和 npm 路径并验证：

$root = 'D:\tools\deepseek-harness'
$node = "$root\.node\node-v24.19.0-win-x64\node.exe"
$npm = "$root\.node\node-v24.19.0-win-x64\node_modules\npm\bin\npm-cli.js"
& $node --version
& $node $npm --version

预期输出类似：

v24.19.0
11.17.0

三、安装官方 npm 包

把 npm 的缓存和临时目录定向到 D 盘，然后在运行目录安装 DeepSeek Harness：

$root = 'D:\tools\deepseek-harness'
$node = "$root\.node\node-v24.19.0-win-x64\node.exe"
$npm = "$root\.node\node-v24.19.0-win-x64\node_modules\npm\bin\npm-cli.js"

$env:TEMP = "$root\.tmp"
$env:TMP = "$root\.tmp"
$env:npm_config_cache = "$root\.npm-cache"
$env:npm_config_prefix = "$root\.npm-prefix"

Set-Location "$root\runtime"
& $node $npm init -y
& $node $npm install '@deepseek-ai/dsh' --save --no-audit --no-fund

安装完成后，依赖应位于：

D:\tools\deepseek-harness\runtime\node_modules

如果 npm 提示有待审核的安装脚本，需要启用原生功能时可执行：

& $node $npm approve-scripts --allow-scripts-pending

四、验证安装

$root = 'D:\tools\deepseek-harness'
$env:DSH_HOME = "$root\data"
$env:Path = "$root\.node\node-v24.19.0-win-x64;$root\runtime\node_modules\.bin;" + $env:Path

& "$root\runtime\node_modules\.bin\dsh.cmd" --version
& "$root\runtime\node_modules\.bin\dsh.cmd" --help

本次实测版本：0.1.0-rc.6。

五、启动 Web UI

$root = 'D:\tools\deepseek-harness'
$env:DSH_HOME = "$root\data"
$env:Path = "$root\.node\node-v24.19.0-win-x64;$root\runtime\node_modules\.bin;" + $env:Path
& "$root\runtime\node_modules\.bin\dsh.cmd" web

浏览器打开：http://127.0.0.1:3080

本次实测该地址返回 HTTP 200。

六、推荐启动脚本

为了以后双击或直接运行，创建 D:\tools\deepseek-harness\dsh.cmd，内容如下：

@echo off
setlocal
set "DSH_ROOT=%~dp0"
set "DSH_HOME=%DSH_ROOT%data"
set "PATH=%DSH_ROOT%.node\node-v24.19.0-win-x64;%DSH_ROOT%runtime\node_modules\.bin;%PATH%"
call "%DSH_ROOT%runtime\node_modules\.bin\dsh.cmd" %*
exit /b %ERRORLEVEL%

以后启动只需：

D:\tools\deepseek-harness\dsh.cmd web

七、目录说明

D:\tools\deepseek-harness\
├─ .node\             便携版 Node.js
├─ runtime\           npm 项目和 DeepSeek Harness 依赖
├─ data\              DSH_HOME，运行数据
├─ .npm-cache\        npm 缓存
├─ .tmp\              临时文件
├─ dsh.cmd            推荐启动脚本
└─ web.log            Web UI 日志（后台启动时）

八、常见问题

npm 安装很慢

DeepSeek Harness 会安装数百个依赖；如果 registry.npmjs.org 速度较慢，可在安装前使用临时镜像环境变量：

$env:npm_config_registry = 'https://registry.npmmirror.com'

端口 3080 被占用

Get-NetTCPConnection -LocalPort 3080 -State Listen

可先关闭占用端口的程序，或查看 DeepSeek Harness 文档使用其他端口。