標題為「Windows 上的 DeepSeek Harness」的 OrcaRouter 卡片,副標題為「現在已有官方桌面應用程式——但對大多數人來說,這兩道指令仍是更快的進入方式」。深色指令區塊寫著「npx @deepseek-ai/dsh web」,並以箭頭指向寫著「http://127.0.0.1:3080」的淺色區塊。下方有三個統計方塊:「MIT · 開源」、「v0.2.1-rc.2」附註為「開發者預覽版——重大變更會提前公告」,以及「一切都是外掛」附註為「預設部署中有超過 150 個外掛」。頁尾:Node 22.19 或更新版本,然後是上述指令,最後是瀏覽器分頁。
Guides & Insights

Windows 上的 DeepSeek Harness:兩個指令,還是官方桌面應用程式

作者

Gideon Frost

發佈日期

最新模型 · 20查看全部模型 →
基準測試:Artificial Analysis · 每日更新
返回全部文章

There is an official DeepSeek Harness desktop app for Windows now, and for most people these two commands are still the faster way in. 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. 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. That address serves the same Web UI the official Electron build wraps, so the only thing the installer adds is the window. If you would rather have the window, our guide to the DeepSeek Harness desktop app covers what the installer writes, which of the three builds has no link on the download page, and why the harness and the app must always carry the same version. 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」,現在看到的結果混雜了 DeepSeek 自家的下載頁面,以及一長串社群封裝的儲存庫,而且很難一眼看出到底該安裝哪一個。本文要回答的是搜尋背後真正的問題:DeepSeek Harness 究竟是什麼、目前官方在 Windows 上執行它的方式、什麼情況下改用具安裝程式更划算、終端機的替代方案,以及執行一款預覽階段工具時該誠實面對的注意事項。這是一篇操作指南,不是發布消息——發布本身與洩漏過程的來龍去脈另有專文介紹。

DeepSeek Harness 是什麼(以及不是什麼)

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

它同時也明確是一款預覽版。dsh 目前為 0.2.1-rc.2 版,README 將其標示為開發者預覽版,並以大寫字母警告:「將會有破壞相容性的變更。」這些都未減緩其採用速度:該專案在 2026-08-13 公開發布後的首 12 小時內,就達到約 50,000 個 GitHub 星號,而在 2026 年 10 月 22 日查閱時,已達 256,853 個星號與 30,970 個 fork——這是 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 是本機網頁應用程式,而瀏覽器就是用戶端。這與 Electron 版本從 dsh-app://app/ 載入的介面完全相同,只是少了視窗外框。

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

Terminal-window card titled 'Run DeepSeek Harness on Windows' with eyebrow 'Windows · PowerShell', showing a dark terminal window with the lines 'PS> node --version' (comment: needs v22.19+, Node 24 LTS safer), 'PS> npm install -g @deepseek-ai/dsh', 'PS> dsh web' (comment: arrow to http://127.0.0.1:3080), and 'PS> dsh --profile headless "summarize this repo"' (comment: one-shot, prints & exits), with a footer sourcing the commands to the deepseek-ai/deepseek-harness README and user guide, August 2026. OrcaRouter logo composited bottom-right.

如果你想留在瀏覽器裡,這就是完整的官方流程。如果機器上已經裝好 Node 22+,從「什麼都沒有」到「agent 跑起來」的時間不到一分鐘。

「DeepSeek Harness Desktop」儲存庫:官方應用程式做了哪些變更

第 1 頁的查詢結果仍大多是社群桌面封裝程式——Electron、Tauri 和 WebView2 外殼,它們會打包 Node 執行環境,並在帶有框架的視窗中啟動官方 Web UI。它們都不是 DeepSeek 的產品,也都沒有增加 harness 能力;它們增加的是啟動器。改變之處在於,DeepSeek 自 2026 年 10 月起推出自家的安裝程式,因此封裝程式不再是避開終端機的唯一方式。這些封裝程式的共同點是:

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

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

• 他們以不同步調追蹤官方專案:有些仍固定在 0.1.0-rc.6,有些跟隨 master,還有許多是上次針對 0.1.x 更新,因此 wrapper 與 harness 的版本會隨時間逐漸脫節。

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

Two-column card titled 'Official dsh vs the GitHub 'desktop' wrappers' with eyebrow 'What page 1 of this search actually shows'. Left column 'Official dsh' with checkmarks: two commands + browser UI, Web UI at 127.0.0.1:3080, headless CLI + TUI plugins, you control the version, no install wizard. Right column 'Community wrappers' with crosses: double-click installer, bundles Node + official UI, unsigned — SmartScreen warns, version drift: rc.5 / rc.6 / master, third-party update layer. Footer: every page-1 'DeepSeek Harness Desktop' repo wraps the official web UI — none is a DeepSeek product. OrcaRouter logo composited bottom-right.

什麼時候封裝器值得用?現在幾乎從來不值得,而這正是改變所在。當「雙擊圖示、看到系統匣、永遠不用碰終端機」曾是決定性因素時,封裝器是唯一途徑——DeepSeek 如今推出自己的安裝程式,所以封裝器唯一真正的優勢已消失,剩下的只是一個第三方,擋在預覽階段工具的更新與安全層之前。什麼時候官方途徑仍然合適?兩道指令和一個瀏覽器分頁——如果你已經有 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 的最終答案來除錯』與『逐步檢視它為何發出每次呼叫』之間的差別。

當官方路徑是錯誤答案時

• 你需要一鍵完成、免終端機。自 2026 年 10 月起已有官方安裝程式,所以這不再是你需要退而使用包裝器的理由。這仍然是避開終端機的好理由,而這是個合理的選擇:你換掉的是瀏覽器分頁,得到的是一個會隱藏而非關閉、並且會在沒有穩定版本的通道上自行更新的 Electron 視窗。

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

• 這是預覽版,而且會造成破壞。 0.2.1-rc.2 附帶警告,指出即將出現破壞性變更;在 rc 組建之間,外掛與設定檔可能停止運作,而在桌面版中,測試框架與 Electron 外殼必須始終保持完全相同的版本。若有任何以腳本執行的內容,請鎖定你的版本。

• 模型費用由你承擔。 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.1 Flash 處理廉價的機械式修改。

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

Screenshot of the OrcaRouter model page for DeepSeek V4 Pro: the Flagship badge, roughly $0.44 input / $0.88 output per 1M tokens, a 1M-token context window, 384K max output, and 1.6T total / 49B active parameters, with OpenAI-compatible code samples.

簡短版本

DeepSeek Harness 在 Windows 上對多數人而言仍是兩道指令的設定流程:先安裝 Node 22.19+(或 Node 24),再執行 npx @deepseek-ai/dsh web,接著在瀏覽器開啟 http://127.0.0.1:3080。截至 2026 年 10 月已有官方 Electron 版本,只有當你希望視窗關閉後仍能繼續運作時才值得使用;GitHub 上社群的「desktop」儲存庫只是封裝同一個本機伺服器,已不再比 DeepSeek 自家下載版更具優勢。對終端機而言,無頭模式可為 CI 執行一次性任務,TUI 外掛則提供 Claude Code 風格的介面。四種預設集——Standard、PTC、Minimal、Creation——決定工具介面範圍,而 MCP 加上軌跡重播讓它真正實用。它免費、開源,且處於 0.2.1-rc.2 的預覽階段:鎖定版本、留意模型帳單,並將模型與 harness 分開路由。