在 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 金鑰，選可丟棄工作區，發一條低風險提示（列頂層檔案）。本機 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 專文——見 macOS 上跑 DeepSeek Harness。

接下來去哪

1. 各系統一行說明與驗收：安裝。
2. 首小時腳本：npx 快速開始。
3. 症狀階梯：疑難排解 與 3080 專文。
4. 跑通後再選 執行模式，再考慮堆社群外掛。