Windows11安装 DeepSeek‑Harness(DSH)傻白甜保姆教程

⚠️重要提醒：

DeepSeek‑Harness目前是开发者预览版，后续版本会有破坏性改动；必须要有DeepSeek API Key才能使用，需要在平台充值，不会本地跑大模型。

两条路线：路线A【官方命令行原版】：跟着下面一步步敲命令，最正宗。路线B【第三方桌面版】：不用敲命令，有窗口软件（社区非官方），文末给说明。

前置检查（1分钟）

系统：Windows11 64位
网络：可以访问 github、deepseek开放平台
磁盘C盘至少预留5‑10G空间。

第1步：安装 Node.js（必须，不装完全跑不起来）

浏览器打开官网：https://nodejs.org/zh‑cn
下载 LTS长期支持版 Windows(.msi)64位安装包
双击下载好的msi文件，全部默认，一路点下一步（Next），不要改任何勾选！> ✅重点：安装程序自带勾选“Add to PATH”，不要取消！取消后面全部报错。
安装完成，把所有打开的黑窗口全部关掉！！！

验证Node装成功

键盘按 Win，输入 PowerShell，打开 Windows PowerShell（普通用户即可，不用管理员）
复制下面第一行粘贴进去，按回车

node -vnpm -v

👉出现版本号（v22.x.x / v24.x.x）=成功。👉提示“不是内部或外部命令”=没装好，重新安装Node，务必勾选PATH。

第2步：设置国内镜像（强烈建议，解决下载慢、超时失败）

PowerShell窗口复制粘贴，回车执行：

npm config set registry https://registry.npmmirror.com

再输入这条确认镜像生效：

npm config get registry

输出 https://registry.npmmirror.com 就ok。

第3步：两种启动方式（二选一）

方式①：全局安装（推荐，任意窗口都可以调用dsh命令）

PowerShell执行：

npm install -g @deepseek-ai/dsh

等待下载安装完成。

校验是否安装成功：

dsh --version

输出版本号 0.1.0‑rc.x 代表成功。

❗报错 dsh不是内部命令：关掉全部PowerShell，重新新开窗口重试。

方式②：npx临时直接跑（不用全局安装，适合只想试一下）

不用执行上面install，直接运行：

npx @deepseek-ai/dsh web

第4步：启动 DeepSeek‑Harness Web界面

用全局安装版本就输入这条命令，回车：

dsh web

等待程序加载，输出提示：http://127.0.0.1:3080
不要关闭这个PowerShell黑窗口！一关软件直接停止！！
复制 http://127.0.0.1:3080，粘贴到Chrome/Edge浏览器打开，进入DSH网页界面。

第5步：获取 DeepSeek API Key（必须要有，否则无法调用AI）

浏览器打开：https://platform.deepseek.com
注册登录账号，账户余额充值（几块钱就可以测试）
左侧菜单【API Keys】→ 创建新密钥，复制生成 sk‑xxxxxx 这一串字符。> ⚠️密钥只显示一次，复制保存好，泄露会被扣费！

配置API Key两种办法

打开 127.0.0.1:3080，页面设置里找到API Key输入框，粘贴你的sk‑xxxx密钥，保存。

Win+i打开设置 → 系统 → 关于 → 高级系统设置 → 环境变量用户变量 → 新建变量名：DEEPSEEK_API_KEY变量值：粘贴你的sk‑xxxx密钥，全部窗口点确定，重启PowerShell，再执行dsh web。

✅测试是否全部正常

网页新建任务，随便写一个指令，能够正常返回AI结果，代表安装全部完成。

📌日常使用注意事项

每次使用必须先打开PowerShell，输入 dsh web，黑窗口必须挂后台最小化，不能关闭！关闭网页就失效。
下次开机使用：打开PowerShell，输入dsh web，浏览器打开127.0.0.1:3080即可。
更新DSH版本：npm update -g @deepseek-ai/dsh

🧩路线B：第三方桌面客户端（社区非官方，傻瓜点点点，不用敲命令）

开源社区项目，不是DeepSeek官方出品，优点：有桌面窗口，不用挂黑终端窗口。GitHub仓库：https://github.com/hairyf/deepseek‑harness‑desktop下载Windows安装包，双击安装，打开软件填入API Key直接用。

❗高频踩坑故障排查（照着看）

node‑v
提示找不到命令：Node安装没勾选Add to PATH，重装Node，勾选PATH。
npm下载卡住超时：务必执行设置淘宝镜像命令。
浏览器打不开127.0.0.1:3080：确认PowerShell窗口还在运行，不要关闭；看终端有没有报错红字。
AI一直报错：检查API Key是否复制完整，平台账户是否有余额。
终端出现一堆红色报错：预览版本身不稳定，关闭终端重新执行dsh web。

DeepSeek‑Harness（DSH）Windows11 常见报错中文对照表

使用说明：复制终端/网页报错关键词，对照表格看原因，照着【傻瓜解决步骤】操作即可，全部适配小白，不用懂代码。

一、PowerShell终端命令执行报错（安装、启动阶段）

报错原文	中文翻译	傻瓜解决步骤
`'node' 不是内部或外部命令`	Node.js没有安装成功，系统找不到程序	重装Node.js LTS版，务必勾选Add to PATH；全部关掉PowerShell，重新新开窗口再试。
`'dsh' 不是内部或外部命令`	DSH全局安装完成，但终端没读到环境	把所有PowerShell全部关闭，重新打开；还不行就执行 `npm install -g @deepseek-ai/dsh` 重装DSH。
npm安装卡住、超时、ERR_NETWORK	npm下载网络超时	执行设置镜像命令：`npm config set registry https://registry.npmmirror.com`，再重新安装DSH。
`pnpm not found`	找不到pnpm工具	新手直接不要用pnpm，全程用npm / npx，pnpm对DSH兼容性差，容易大量报错。
`plugin tree failed to load`	DSH插件加载崩溃	方案1：升级DSH `npm update -g @deepseek-ai/dsh`；方案2：删除 `C:\Users\你的用户名\.dsh` 整个文件夹，重新启动dsh web。

二、网页界面API、密钥相关报错（调用AI时报错）

报错原文	中文翻译	傻瓜解决步骤
`MISSING_CREDENTIAL`	API密钥缺失，没有读到sk‑密钥	优先网页设置填写API Key；如果配置环境变量，关闭全部PowerShell再重新打开终端，环境变量修改旧窗口不生效。检查密钥前后不要带空格换行。
`401 Unauthorized`	API密钥错误、密钥被删除/过期	1.平台重新复制sk‑密钥，删掉多余空格； 2.确认API Key没有在平台被删除； 3.网页设置里重新粘贴保存。
`402 Insufficient Balance`	账户余额不足没钱了	打开DeepSeek开放平台，查看账户余额，进行充值，几块钱就够用。
`429 Too Many Requests`	请求太频繁，触发限流	不要连续疯狂发送消息，等待10‑30秒之后再提问；不要一次性开大量会话。
`UNKNOWN_MODEL`	选择了不存在的模型名称	在网页模型下拉框，重新选择官方可用模型，不要手动乱改模型名字。
`MODEL_DOES_NOT_SUPPORT_IMAGES`	当前模型不支持上传图片识别	切换带vision的识图模型；普通文本模型不能传图片。

三、网页访问、界面功能异常

报错现象	中文问题说明	傻瓜解决步骤
浏览器打不开 `127.0.0.1:3080`	DSH后台服务没有运行	1.确认PowerShell黑窗口还开着，千万不要关闭；2.看终端打印的地址，少数电脑端口会变，复制终端输出的地址；3.防火墙弹窗允许Node访问网络。
网页输入框灰色，不能打字	没有选择工作文件夹	网页左上角，点击【选择工作区】，新建一个空文件夹选中，输入框就解锁了。
会话打开直接崩溃 `corrupt Zstandard session log`	某一条会话文件损坏，导致整个DSH打不开	关闭dsh，进入 `C:\Users\你的用户名\.dsh`，删除里面session会话文件夹，会丢失历史对话，但软件可以正常启动。
目录选择器失败 `win32 folder dialog worker exited`	Windows文件夹弹窗进程异常残留	任务管理器，结束全部node.exe进程；重新运行 `dsh web`，不要用任务管理器强制杀DSH进程，尽量终端按`Ctrl+C`关闭。

四、服务器返回通用HTTP报错

错误码	问题说明	傻瓜解决步骤
400	请求参数格式错误	不要发送超长内容；换一个简单提问测试。
422	参数非法，模型不接受该参数	切换官方默认模型，不要乱改高级参数。
500	DeepSeek服务器内部故障	等待1‑3分钟重试，属于平台服务器问题，本地不用修改任何东西。
503	服务器过载繁忙	过一会再发送提问。

✨万能急救三板斧（遇到搞不懂的红色报错优先执行）

在运行DSH的PowerShell窗口，按 Ctrl + C 停止服务；全部PowerShell窗口彻底关闭。
新开PowerShell，输入 dsh web 重新启动服务。
浏览器刷新网页，重新测试对话。

如果三板斧还不行：执行升级命令 npm update -g @deepseek-ai/dsh，升级DSH到最新rc预览版本，很多已知bug新版本会修复。

提示：DeepSeek‑Harness属于开发者预览RC版本，本身会存在不少bug，偶尔报错属于正常现象。

如果你需要，我还可以给你一份快速自检清单，复制粘贴几条命令，一键排查你的环境。