Windows 上跑 DeepSeek Harness：路径、权限与终端

Windows 不是另一款产品

官方没有面向 Windows 的 DeepSeek Harness 桌面安装包。在 Windows 上跑 DeepSeek Harness，仍然是 Node.js + npx @deepseek-ai/dsh web，再用浏览器打开 http://127.0.0.1:3080/。命令与 安装清单、npx 快速开始 一致。变的是外围环境：哪个 shell 拥有 PATH、Windows 路径在 Git Bash / WSL 里长什么样，以及「受控文件夹访问」会不会静默挡住 Agent 写入。

本文是 Windows 专用补充。若进程根本没绑上端口、或 3080 被占，请直接去 npx / 3080 阶梯，别反复读系统一句话说明。

精确开关仍以上游为准。官方 README 与本页冲突时，以 README 为准。

先选定一个 shell，并盯住它的 PATH

同一台机器可以同时开 PowerShell、Windows Terminal（常是 PowerShell 或 cmd 标签）、经典 cmd、Git Bash 和 WSL。它们可能看到不同的 node——或者根本没有。

1. 决定第一小时用哪个 shell。跟文档对齐时，优先 PowerShell 或 Windows Terminal 的 PowerShell 标签。
2. 只在那个窗口跑 node -v 和 npm -v。上游预览要求 Node ^22.19.0 或 >=24.0.0。
3. 若这里没有 node、别的窗口却有，说明 PATH 按 shell 分裂。修好「另一个窗口」帮不了当前窗口。
4. 别混用：在 PowerShell 装好 Node，却去一个仍带着 Node 18 PATH 的旧 Git Bash 里跑 npx。

Git Bash 在 PATH 正确后可用，但路径引号与盘符写法不同（D:\demo vs /d/demo）。首次评估时，先钉死一个 shell，直到 npx @deepseek-ai/dsh web 打出本机 URL。

让「同一个窗口」能看见 Node

1. 从 nodejs.org 装 Node LTS，或 winget install OpenJS.NodeJS.LTS（见 安装 的 Windows 一行说明）。
2. 关掉并重开终端——安装程序更新用户 PATH；已打开的标签仍是旧环境。
3. 在即将跑 npx 的同一 shell 里确认 node -v 落在范围内。
4. cd 到可丢弃项目目录（例如 D:\scratch\dsh-demo），再执行：

npx @deepseek-ai/dsh web

保持终端开着。关掉它就停掉本机服务。公司代理对 npm 做 MITM 时，症状像产品 bug；镜像落后就改回官方 registry——细节见 排错。

路径、工作区与「受控文件夹访问」

Agent 只看得见你在 UI 里选的工作区根。在 Windows 上，这常撞上日常习惯：

• 首次优先用固定盘上的短路径（D:\scratch\...），别一上来就用 OneDrive 同步的深层 Documents 树。
• 别把第一次会话指到整个用户配置目录。主目录混着密钥、邮件缓存和云同步。
• 受控文件夹访问（Windows 安全中心 → 病毒和威胁防护 → 勒索软件防护）可能让 UI 能开、工具写入却失败或卡住。终端看起来健康但 Agent「写不了」时，检查编辑器/Node 是否被允许，或把可丢弃仓库挪出受保护目录先测。
• 执行策略主要影响你自己写的 PowerShell 脚本——很少直接挡住 npx。别为了「试试 DSH」就全局设 Bypass。

UI 起来后：在设置里粘贴 DeepSeek 平台 API Key，选可丢弃工作区，发一条低风险提示（列顶层文件）。本机 UI 多半是控制面，默认不是离线权重。

端口 3080 与本机浏览器

默认 Web UI 绑在回环地址 http://127.0.0.1:3080/。在 Windows 上查占用：

netstat -ano | findstr :3080

在任务管理器结束该 PID，或 taskkill /PID <pid> /F，或按上游文档改端口启动。首次测试留在 localhost——绑 0.0.0.0 是安全决策。终端健康但页面空白：换干净浏览器配置试试；扩展有时会拦本地脚本。

WSL 对 PATH 和文件来说是另一台机器

WSL Ubuntu 不是「更友好的 Windows 提示符」。装在 Windows 上的 Node 不会自动出现在 WSL 里，反过来也一样。在 WSL 里跑 DSH 时，把工作区放在 Linux 文件系统上——从 Linux 去改 /mnt/c/... 树，权限与性能坑更多。若你钉在原生 Windows PowerShell，就别在同一次排障里再追 WSL 的 Node 版本。

本文不是什么

• 不是第二篇完整快速开始——叙事上手仍在 npx 快速开始。
• 不是每一种启动失败的决策树——用 修复 npx 与端口 3080。
• 不是给非官方「DeepSeek Harness Desktop」套壳背书。社区启动器存在；它们只是包着同一套 Node 服务的可选外壳。
• 不是 macOS 专文——Homebrew、TCC 与完全磁盘访问见 macOS 上跑 DeepSeek Harness。

接下来去哪

1. 各系统一行说明与验收：安装。
2. 首小时脚本：npx 快速开始。
3. 症状阶梯：排错 与 3080 专文。
4. 跑通后再选 运行模式，再考虑堆社区插件。