Windows 安装 DeepSeek Harness (dsh) 完整流程

本文档记录在 Windows 上从零安装 dsh、配置启动方式的完整流程可作为新机器部署手册照做。环境Windows 10/11 nvm-windows Node.js v24.19.0一、前置环境准备参考文献1、2注文献2里创建node_global与node_cache文件夹的位置并非最优解1.1 安装 nvm-windows下载地址https://github.com/coreybutler/nvm-windows/releases安装到D:\nvm或任意非系统盘安装程序会自动配置NVM_HOMED:\nvmNVM_SYMLINKD:\nvm\nodejsPATH 中加入上述两个路径验证nvm version1.2 安装 Node.js满足 dsh 要求^22.19.0 或 24.0.0方式 A通过 nvm 在线安装nvm install 24.19.0 nvm use 24.19.0方式 B手动下载安装适合离线/网络差从 https://nodejs.org/dist/v24.19.0/ 下载node-v24.19.0-win-x64.zip解压到D:\nvm\v24.19.0执行nvm use 24.19.0nvm 会自动建立D:\nvm\nodejs符号链接指向该版本验证node--version# 应输出 v24.19.0npm--version# 应输出 11.x1.3 配置 npm 全局目录与缓存迁移到非系统盘节省 C 盘空间先在目录下创建这两个文件夹npm configsetprefixD:\nvm\node_globalnpm configsetcacheD:\nvm\node_cache设置国内镜像加速可选网络好可跳过npm configsetregistry https://registry.npmmirror.com1.4 配置环境变量用户环境变量变量名变量值说明NVM_HOMED:\nvmnvm 安装目录nvm 安装程序通常已自动设置NVM_SYMLINKD:\nvm\nodejsNode 当前版本的符号链接nvm 安装程序通常已自动设置Path追加以下路径D:\nvm或%NVM_HOME%nvm 主程序所在目录D:\nvm\nodejs或NVM_SYMLINKnode/npm 可执行文件目录指向当前nvm use的版本D:\nvm\node_globalnpm 全局安装的命令所在目录dsh、pnpm 等都在这里系统环境变量变量名变量值说明NODE_PATHD:\nvm\node_global\node_modules供 Noderequire解析全局模块可选非必需Path追加以下路径D:\nvm\node_global\node_modules冗余项无害可留可删D:\nvm\node_global最好加上说明NVM_HOME和NVM_SYMLINK一般由 nvm-windows 安装程序自动配置无需手动添加。Path中最重要的是D:\nvm\node_global——dsh、pnpm 等通过npm install -g安装的命令都在这里不加这个路径dsh、pnpm命令会找不到。NODE_PATH和系统 Path 里的node_modules是可选的不影响 dsh 运行。修改环境变量后已打开的 cmd/PowerShell 窗口需重新打开才能生效。二、安装 pnpm关键步骤不可省略这是 dsh 能否正常启动的关键依赖。dsh 通过 pnpm 安装 profile 的 200 插件依赖到~/.dsh/profiles。没有 pnpm依赖装不出来dsh 会报Cannot find package deepseek-ai/dsh-client-ui-plan之类错误崩溃。npm install-g pnpm验证pnpm--version# 应输出 11.x故障信号如果 dsh 启动时报ERR_MODULE_NOT_FOUND或plugin tree failed to load第一时间检查 pnpm 是否存在。这是最常见的根因。三、全局安装固定版本 dsh全局安装而非 npx 临时运行理由避免 npx 缓存被清理/版本更新时重置导致 profiles 依赖 junction 失效这是之前踩过的大坑启动更快不再每次检查新版版本锁死行为可预期npm install-g deepseek-ai/dsh0.1.0-rc.6安装时会有若干allow-scripts警告npm 11 的安全机制拦住原生模块的安装脚本。建议补跑一次允许脚本确保node-pty终端、koffiFFI等原生模块编译完成npm install-g--allow-scriptsdeepseek-ai/dsh-subprocess-local,koffi,node-pty,google/genai,protobufjs deepseek-ai/dsh0.1.0-rc.6验证dsh--version# 应输出 0.1.0-rc.6where.exe dsh# 应指向 D:\nvm\node_global\dsh.ps1安装可能残留临时目录D:\nvm\node_global\node_modules\deepseek-ai\.dsh-xxxxxx无影响可手动删除。四、创建桌面启动批处理4.1 确认真实桌面路径Windows 桌面可能被 OneDrive 重定向先确认真实位置[Environment]::GetFolderPath(Desktop)输出C:\Users\用户名\Desktop→ 用这个路径输出D:\Desktop之类 → 用输出的路径本文档假设为D:\Desktop4.2 创建启动 bat在真实桌面新建文件dsh-web.bat内容如下echo off chcp 936 nul title DeepSeek Harness (dsh web) echo. echo 正在启动 dsh web 服务... echo 浏览器将在几秒后自动打开 http://localhost:3080 echo 关闭此窗口即可停止服务。 echo. start http://localhost:3080 dsh web手动创建步骤记事本法打开记事本WinR 输notepad粘贴上述内容文件 → 另存为保存位置选桌面文件名填dsh-web.bat保存类型选所有文件 (.)否则会变成.bat.txt编码选 UTF-8有中文 echo 必须用 UTF-8保存两个关键点后缀.bat、编码UTF-8。搞错任一项都会导致文件无法使用。4.3 使用方法启动双击dsh-web.bat→ 弹出黑色 cmd 窗口 → 自动打开浏览器访问http://localhost:3080停止关闭那个黑色 cmd 窗口服务监听在127.0.0.1:3080仅本机可访问五、数据存储说明dsh 的所有数据都在C:\Users\用户名\.dsh\下纯本地存储无云同步路径内容备注sessions\对话记录session.jsonl.zstd核心数据务必备份settings.yaml全局设置可备份.credentials.yamlAPI 凭据敏感谨慎备份storages\工作区状态可备份profiles\profile 依赖安装区不要备份让 dsh 自行生成.anonymous-user-id匿名 ID无关紧要关闭浏览器、结束 node 进程对话记录依然保留下次启动还在。六、版本更新全局安装的版本固定不会自动升级。想升级时手动操作6.1 查看可用版本npm view deepseek-ai/dsh version# 最新版npm view deepseek-ai/dsh versions--json# 所有历史版本6.2 升级到新版# 升级前先备份 sessions 目录npm install-g deepseek-ai/dsh新版本号 dsh--version# 验证升级后若启动报错可能是旧 profiles 不兼容删除~/.dsh/profiles让 dsh 重建。6.3 回退到旧版npm install-g deepseek-ai/dsh0.1.0-rc.6npm 上的历史版本不会消失随时可回退。七、故障排查速查表现象可能原因解决Cannot find package deepseek-ai/xxx缺 pnpmnpm install -g pnpmplugin tree failed to loadprofiles 依赖未安装检查 pnpm删~/.dsh/profiles重启端口 3080 不监听进程未起 / 启动崩溃cmd 前台跑dsh web看日志端口被占用上次进程未退出netstat -ano | findstr :3080找 PIDStop-Process -Id PID -Force双击 bat 闪退编码非 UTF-8 / dsh 命令不存在检查 bat 编码、dsh --version找不到桌面 bat桌面被 OneDrive 重定向[Environment]::GetFolderPath(Desktop)查真实路径glibc/not a valid Win32 application用错平台包 / Start-Process 跑 .ps1用 cmd 或直接双击 bat通用排查命令# 端口状态netstat-ano|findstr :3080# 查 dsh 版本dsh--version# 查 pnpmpnpm--version# 查 node 进程Get-Processnode|Select-ObjectId,StartTime,Path八、完整卸载如需# 1. 停止服务关闭所有 dsh cmd 窗口# 2. 卸载 dshnpm uninstall-g deepseek-ai/dsh# 3. 删除数据目录会丢失对话记录先备份Remove-Item-Recurse-Force$env:USERPROFILE\.dsh# 4. 删除桌面 batRemove-ItemD:\Desktop\dsh-web.bat附关键路径速查nvm 安装目录D:\nvmNode 当前版本D:\nvm\v24.19.0Node 符号链接D:\nvm\nodejs指向当前 use 的版本npm 全局目录D:\nvm\node_globalnpm 缓存目录D:\nvm\node_cachedsh 可执行D:\nvm\node_global\dsh.ps1dsh 数据目录C:\Users\用户名\.dsh\桌面启动 batD:\Desktop\dsh-web.bat或C:\Users\用户名\Desktop\dsh-web.bat文档版本2026-08-19 基于 dsh 0.1.0-rc.6 Node v24.19.0 pnpm 11.x 整理