在 Windows 上執行 DeepSeek Harness：沒有桌面應用程式？沒問題 — 官方執行方式

There is no official DeepSeek Harness desktop app for Windows, and you do not need one. DeepSeek Harness (dsh) — the open-source agent runtime DeepSeek released under an MIT license on 2026-08-13 — is a Node.js tool that runs a local web server you open in your browser, with a headless CLI for the terminal as the alternative. On Windows the whole setup is two commands: install Node.js 22.19 or newer (Node 24 LTS is the safer pick), then run npx @deepseek-ai/dsh web and open http://127.0.0.1:3080. Every "DeepSeek Harness Desktop" repository on GitHub is an unofficial community wrapper around that same two-command setup — useful to some people, but not required. It is also the harness DeepSeek uses to produce the agentic coding results it reports for DeepSeek V4 Pro and DeepSeek V4 Flash, which is why the two models keep showing up in any conversation about it.

如果你搜尋過「deepseek harness windows」，那你大概正盯着一整頁的包裝版 repo，不知道到底該裝哪一個。這篇文章要回答搜尋背後真正的問題：DeepSeek Harness 到底是什麼、目前在 Windows 上執行的官方方式、終端機的替代方案，以及使用一個預覽階段工具時必須知道的老實話。這是一篇教學文，不是發表文——發表和洩漏的來龍去脈會另外寫文章說明。

DeepSeek Harness 是什麼（以及不是什麼）

DeepSeek Harness 不是模型，也不對任何模型進行基準測試。它是代理執行環境（agent runtime）：將模型連接到工具、檔案、Shell 與網際網路的那一層——閱讀你的程式碼、規劃變更、執行指令，並反覆迭代，直到任務完成。其架構正如其標語所述：「一切皆為外掛。」模型、工具、技能、工作階段、沙箱、代理迴圈本身，甚至 Web UI，都是在啟動時組合而成的外掛程式，建構於 Cordis 元框架之上——也就是 Koishi 聊天機器人生態系統背後的同一核心。預設部署會隨附超過 150 個外掛程式。

這也明確地是一個預覽版。dsh 目前為 0.1.0-rc.6 版本，README 將其標記為開發者預覽版，並以全大寫字母警告：「將會有破壞相容性的變更。」但這些都未能減緩它的採用速度：該專案於 2026-08-13 公開後，最初的 12 小時內即獲得約 50,000 顆 GitHub 星標，截至 2026-08-16 已約有 126,000 顆——這是 DeepSeek 迄今發布、被採用速度最快的開源版本。

簡短的回答：官方的 Windows 路徑是兩個命令。

DeepSeek 官方 README 用一行說明 Windows 的執行路徑：安裝 Node.js，然後執行 npx @deepseek-ai/dsh web。具體步驟如下：

• 安裝 Node.js 22.19+ 或 Node 24。目前的 dsh 版本需要 Node 22.19 或更新版本；Node 24 LTS 在 Windows 上是較安全的選擇，原因很平凡——較新的 Node 版本包含原生的 zstd 解壓縮功能，dsh 使用它來讀取壓縮的工作階段日誌。請檢查您的安裝，使用node --version在 PowerShell 或 cmd 中。

• Run the harness. Either run it on the spot with npx @deepseek-ai/dsh web, or install it once with npm install -g @deepseek-ai/dsh and then run dsh web from any folder afterwards. The first run prints the URL and starts the Web UI at http://127.0.0.1:3080.

• 在瀏覽器中開啟該網址。Web UI 是一個本機網頁應用程式——這就是為什麼沒有桌面應用程式；瀏覽器就是桌面應用程式。

• 新增模型金鑰一次。在網頁介面中，開啟設定 → 模型，貼上 DeepSeek API 金鑰並儲存。這會立即生效，無需重新啟動伺服器。dsh 會以你啟動它的資料夾作為預設的檔案系統位置，而介面的選擇工作區步驟可讓你將其指向任何專案目錄。

這就是完整的官方路徑。如果機器已經安裝了 Node 22+，從「零」到「agent 運行」的時間不到一分鐘。

為什麼每個「DeepSeek Harness Desktop」儲存庫都是一個包裝器？

此查詢的第 1 頁結果全都是社群桌面包裝器 — 也就是 Electron、Tauri 和 WebView2 殼層，它們捆綁了 Node 執行環境，並在框架視窗內啟動官方 Web UI。它們不是 DeepSeek 產品，也不會增加 harness 能力；它們增加的是啟動器。它們的共同點：

• 他們雙擊啟動，完全避免使用命令列，這就是他們真正的賣點。

• 它們未經簽署，因此 Windows SmartScreen 會在安裝時發出警告 —「More info → Run anyway」是流程的一部分。

• 他們追蹤官方專案的速度不一：有人釘住 0.1.0-rc.5，有人釘住 0.1.0-rc.6，也有人跟隨 master，因此 wrapper 與 harness 的版本會隨著時間逐漸分歧。

• 它們會將 dsh 一直使用的相同本機資料儲存在 ~/.dsh 下，因此在包裝器與官方 CLI 之間切換不會重設您的工作階段。

什麼時候包裝器才值得？當「雙擊圖示、看到托盤、從不碰終端機」是決定性因素，而且你接受第三方現在成為預覽階段工具前方的更新與安全層時。什麼時候不值得？官方路徑只是兩個指令加一個瀏覽器分頁——如果你已經有 Node，包裝器給你的只是一個你可能不需要的啟動器，並以增加自己的維護表面作為交換。

終端路線：無頭 CLI 與 TUI 外掛程式

如果瀏覽器不是您的工作環境，dsh 也有終端機的應用，分為兩種模式。

Headless 是非互動式設定檔：dsh --profile headless "summarize this repository" 不需要介面即可執行單一工作，印出結果後結束——這是適合 CI 的模式。在 Windows 上，指令碼和排定的工作也應使用此模式，因為它不需要顯示器或已登入的工作階段。

TUI是一種 Claude Code 風格的互動式終端機前端，以社群外掛套件而非核心套件的形式發布。諸如 dsh-tui 這類套件可透過dsh plugin --profile tui add <package>安裝到設定檔（profile）中，並以dsh --profile tui執行；其中至少有一個套件附帶 Windows 的 .cmd 啟動器。在嘗試之前值得留意的一點是：TUI 需要真正的終端機來進行輸入和輸出——如果你的環境使用了管道或重新導向，dsh 會拒絕執行，並告訴你改用 headless 模式。

四個預設：哪一個適合哪種工作？

dsh 內建四種代理預設，它們並非難度階梯 — 而是四種不同的工具表面。你可以在 ~/.dsh/settings.yaml 的 agent-presets.default 下設定預設值。

• Standard完整的日常代理——檔案編輯、Shell、檔案與網頁搜尋、技能、子代理、規劃。這是大多數 Windows 使用者應該開始使用的。

• PTC（也稱為 Code 模式）保留了 Standard 的所有功能，但改變了工具的呈現方式：不再是一長串孤立的工具呼叫，而是由模型編寫 TypeScript 程式，組合多步驟操作——迴圈、篩選、條件分支。適用於複雜、重複或多步驟的工作流程。

• Minimal 刻意將代理精簡為僅兩種工具——持久化 shell 和檔案編輯器——旨在用於評估與基準測試，而非日常工作。DeepSeek 自身的代理評分就是在這個預設上運行的。

• 建立（Cordis）用於建置自訂預設集：包含執行階段檢查、記憶體中的外掛程式實驗，以及預設集撰寫指引。用於調整框架本身。

MCP 與軌跡重播：為什麼這值得運行

有兩項功能讓 dsh 勝過一般聊天客戶端。首先，它內建了 Model Context Protocol（MCP）用戶端——透過 /mcp 指令及 Settings 的 MCP 分頁，可將外部 MCP 伺服器接入執行框架，因此你的其他 agent 所用的相同工具也能接入 dsh。其次，每次執行都會寫入一份僅供附加（append-only）的 session log，而 Trajectory 檢視可讓你依來源檢視執行內容、繼續執行、fork、搜尋與重播。這就是『盯著 agent 的最終答案來除錯』與『逐步檢視它為何發出每次呼叫』之間的差別。

當官方路徑是錯誤答案時

• 你需要一鍵完成，無需終端機。沒有官方安裝程式。如果雙擊是必要條件，那麼你使用的是社群包裝器——這些包裝器未經簽署，所以請在便利性與第三方維護負擔之間權衡。

• 您的 Windows 電腦老舊或受到鎖定。 dsh 需要 Node 22.19+（或 Node 24）。在受管理的機器上，這代表需要安裝執行環境，而且可能需取得您沒有的核准。

• 這是預覽版，而且會破壞相容性。 0.1.0-rc.6 附帶警告，破壞性變更即將到來；在 rc 版本之間，外掛程式和設定檔可能停止運作。任何以指令碼執行的工作，請鎖定版本。

• 模型費用由你承擔。 dsh 是免費的；每項任務都會消耗你所配置金鑰的 token。代理迴圈會重新讀取檔案並重試，而冗長的模型在處理困難任務時，一個下午就可能花掉驚人的預算。這就是模型選擇（而非工具選擇）主導成本的地方。

• 固定月費訂閱可能勝過按 token 計價的路由方案。如果你使用某一家實驗室的方案且用量在其上限內，固定月費通常比任何按 token 計價的路徑都更便宜。路由方案在混合使用多種模型或需要故障切換時才有優勢——並非預設就比較好。

將模型路由至 harness 後方

原生路徑是 DeepSeek 自家的 API：在 Settings → Models 貼上金鑰就能直接使用。但 dsh 也接受與 OpenAI 相容的 base URL——在環境變數中設定 DEEPSEEK_BASE_URL，或在 settings.yaml 中設定 LLM provider——這表示框架背後的模型可以替換，而無需改動框架本身。你可以在同一個本機 dsh 安裝上，用 DeepSeek V4 Pro 處理困難的重構，用 DeepSeek V4 Flash 處理低成本的機械式修改。

這就是 OrcaRouter 所處的層級。一個相容 OpenAI 的 base URL、200 多個模型、零加成——按供應商牌價原價轉傳——並在供應商觸發速率限制或效能下降時自動故障轉移。將 dsh 指向它，測試框架仍留在你的機器上，而模型目錄變成一個路由決策，而非一筆採購。兩個誠實的提醒：我們不代管 dsh——它在你的 Windows 機器上本機執行；而且若你想要 DeepSeek 自家 API 以外的模型，我們僅是模型存取層。此外，對於方案額度內的單一重度使用模型，無論採用哪種路由器，固定費率訂閱往往才是更划算的選擇。

簡短版本

Windows 上的 DeepSeek Harness 只需兩個指令即可設定完成，而非應用程式商店安裝：Node 22.19+（或 Node 24），接著執行 npx @deepseek-ai/dsh web，然後在瀏覽器開啟 http://127.0.0.1:3080。GitHub 上的「desktop」儲存庫是圍繞同一本機伺服器的非官方封裝。就終端機而言，headless 模式可為 CI 執行一次性任務，而 TUI 外掛程式提供類似 Claude Code 的介面。四種預設——Standard、PTC、Minimal、Creation——決定工具面，MCP 加上軌跡重播讓它真正實用。它免費、開放原始碼且處於預覽階段：鎖定版本、留意模型費用，並將模型與 harness 分開路由。