DeepSeek Harness Windows 安装教程(2026 图文版)
从装 Node.js 到跑通第一个任务:DeepSeek Harness(dsh)在 Windows 10/11 上的保姆级图文安装教程,10 个步骤配 17 张实机截图,每张图都能一键跳回来源视频对应的时间点。
最近更新: 2026-08-30
DeepSeek Harness(dsh)目前是开发者预览版,但在 Windows 上的安装和普通 npm 包没什么区别:先装 Node.js,再在 PowerShell 里跑一条全局安装命令,然后打开 http://127.0.0.1:3080 的 Web UI,全程不需要 WSL。
这篇图文教程把整个过程拆成 10 步,截图全部来自真实安装录屏,每张都带时间戳链接——如果你的画面和教程对不上,点一下就能跳回视频看实机操作。
10 步装完 DeepSeek Harness(全程截图)
- 1
先装 Node.js
DeepSeek Harness 需要 Node.js 20 以上(推荐 Node 22 LTS)。去 nodejs.org 下载 Windows 安装包,按默认选项一路装完,然后在任意终端里敲 node --version 回车,输出 v20 及以上就说明装好了。
$node --version
nodejs.org 下载页——选 Windows 的 Prebuilt Installer。回看视频 1:01 - 2
打开 PowerShell,全局安装 DSH
从开始菜单打开 PowerShell,运行下面的全局安装命令。-g 表示全局安装,装完在哪个文件夹都能直接用 dsh 命令。npm 大概半分钟跑完,最后输出 added 454 packages;接着敲 dsh web 回车,终端会打印 dsh web: http://127.0.0.1:3080,并默认自动打开浏览器。
$npm install -g @deepseek-ai/dsh$dsh web
PowerShell 已就绪,安装命令就敲在这里。回看视频 1:27 
全局安装命令:npm install -g @deepseek-ai/dsh。回看视频 1:37 
npm 正在从 registry 拉取 DeepSeek Harness 的包。回看视频 2:07 
出现 added 454 packages,接着 dsh web 打印本地地址。回看视频 2:21 - 3
不想安装?用 npx 一行搞定
只是想先试试?不用装,直接跑 npx @deepseek-ai/dsh web,它问 'Ok to proceed?' 时敲个 y,DSH 就会临时下载并启动,不会在系统里常驻。注意:下面这张截图来自 macOS 终端,但命令和 PowerShell 里完全一样。
$npx @deepseek-ai/dsh web
一行命令的替代方案:npx @deepseek-ai/dsh web(与 PowerShell 中完全一致)。回看视频 1:51 - 4
首次启动:测试提示和 API key
Web UI 第一次打开时会先弹出 Internal Testing Notice(内部测试提示)——DSH 目前是开发者预览版,点 Continue 继续即可。接下来 DSH 会要求配置官方 DeepSeek provider:去 platform.deepseek.com 创建一个 API key(模型调用由 DeepSeek 按量计费),粘贴进去点 Save and continue。API key 等同于密码,注意保管。
首次启动先出现 Internal Testing Notice,点 Continue。回看视频 2:43 
粘贴 DeepSeek API key,点 Save and continue。回看视频 2:52 - 5
选择工作区和模式
工作区(workspace)就是允许 agent 修改的文件夹——在 Workspace Write 权限模式下,它是权限的边界。选一个你在意的项目文件夹,模式保持默认的 Standard 即可,它是完整的编码 agent 预设。
选好工作区文件夹,模式保持 Standard。回看视频 2:01 - 7
认识四个 agent 预设
DeepSeek Harness 内置四个 agent 预设:Standard(完整的编码 agent)、PTC(同样的工具,通过 Code-Mode TypeScript SDK 串联)、Minimal(只保留常驻 shell 和文件编辑器)、Creator(自己编写预设)。在 Settings 里随时可以切换。
四个内置预设:Standard、PTC、Minimal、Creator。回看视频 7:20 - 9
一切皆插件
打开 Settings → Plugins:Shell、Agent loop、Web search 等 160 多个插件共同拼成这个 agent。每个插件都能查看、配置甚至替换——这就是 harness 的设计思路。可安装的社区插件可以在我们的插件目录里逛。
Settings → Plugins:Shell、Agent loop、Web search 等。回看视频 8:40
Windows 安装常见问题
在 Windows 上安装 DeepSeek Harness 时最常被问到的问题。
DeepSeek Harness 支持 Windows 10 和 11 吗?
支持。DeepSeek Harness 走 npm 基于 Node.js 安装,Windows 10 和 Windows 11 都能直接装,不需要 WSL。它目前还是开发者预览版,不同版本之间行为可能有变化。
在 Windows 上运行 dsh 需要 WSL2 吗?
不需要,PowerShell 就能完成安装和运行,不用折腾 WSL2。不过 DSH 是迭代很快的预览版,如果后续版本的平台支持有变化,以官方 README 为准。
npm install -g 报 PowerShell 执行策略错误怎么办?
如果你看到 running scripts is disabled on this system 之类的红色报错,npm 本身没问题——是 PowerShell 的 ExecutionPolicy 拦掉了 npm 全局安装生成的脚本。常见做法是执行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned,或者干脆用 npx @deepseek-ai/dsh web 免安装运行。
DeepSeek Harness 在 Windows 上免费吗?
harness 本身开源免费。模型调用是另一笔账:用你自己的 DeepSeek API key,token 费用由 DeepSeek 按量计费——按 DeepSeek 的定价,日常用下来成本通常很低。
浏览器没有自动打开 Web UI,怎么找到它?
dsh web 会在 http://127.0.0.1:3080 提供 Web UI,手动在浏览器打开这个地址即可,终端里也会打印这个 URL。如果用 dsh web --no-open 启动,DSH 会刻意不自动开浏览器,只打印地址。
装好之后下一步做什么?
去装插件:我们的插件目录收录了上万个社区插件;安装插件教程会教你在动手前怎么甄别第三方代码。
相关教程
dsh 跑起来之后,接着看这几篇。
安全地安装插件
dsh 里“安装插件”到底发生什么，附一套第三方代码审查清单。
阅读指南故障排查与报错百科
症状 → 原因 → 修复：安装失败、pnpm workspace allowlist 报错、cordis.patch.yml 冲突、bundle 格式错误与 Profile 不生效。
阅读指南沙箱、审批与密钥
dsh 的安全模型：沙箱三档、审批策略、守卫，以及你的密钥去了哪里。
阅读指南什么是 DeepSeek Harness？
Agent = Model + Harness 的思路、Profile 与 Patch、Preset 与四种模式。
阅读指南DeepSeek Harness 插件目录 | dsh 插件市场
dsh 插件市场：浏览 12400+ DeepSeek Harness 插件 —— UI 皮肤、工具、工作流、Agent，全部与 GitHub 同步，可按分类、星标与更新时间搜索。
阅读指南来源与致谢
本页截图来自以下两段视频的实机演示,已逐张人工核对;每张截图都会深链回原视频的对应时间点。