如何安裝 DeepSeek Harness (dsh)：桌面應用程式、npx 一行指令、原始碼建置與外掛程式

DeepSeek Harness（dsh）——DeepSeek 於 2026 年 8 月 13 日發布的開源代理執行環境——在 2026 年 9 月 24 日推出了官方桌面用戶端。這是一款為 Windows 與 Apple Silicon macOS 打包的應用程式，由 DeepSeek 自家的下載主機發布，並在內部捆綁了 harness 執行環境：無需安裝 Node.js、不用 npx、也不必開啟終端機。命令列並沒有消失——npx @deepseek-ai/dsh web 仍是 Linux 上最快的途徑，而桌面版並未涵蓋 Linux。開始之前有兩件事要先知道：dsh 不是模型——它是將 DeepSeek V4 Flash 0731 或 DeepSeek V4 Pro 0813 這類模型連接至工具、檔案與終端機的 harness 層——而且它的每個管道都仍處於開發者預覽階段，因此預期各版本之間會有破壞性變更。本指南涵蓋桌面應用程式、npx 一行指令、原始碼建置、無頭模式、外掛、MCP，以及那些毫不掩飾的粗糙邊緣。

DeepSeek Harness 是什麼——以及它不是什麼

Deep​Seek 的內部公式，經資深研究員 Chen Deli 證實，即為 Model + Harness = Agent。模型是大腦；工具層（harness）則是將它轉化為能實際完成工作的所有一切：上下文與記憶管理、工具呼叫、任務規劃、檔案讀寫、終端機執行、錯誤回饋，以及判斷任務何時完成。Deep​Seek Harness 就是這一層，於 2026 年 8 月 13 日以 MIT 授權開源——同日 DeepSeek V4 Pro 0813 版本也上線於 Deep​Seek API。

有兩個事實定義了安裝體驗。第一，其架構是「一切皆為外掛」，建構於 Cordis 之上——一個 TypeScript 外掛容器——因此你安裝的是一個小型核心，加上一組提供模型適配器、工具、工作階段與 UI 的外掛。第二，目前的 npm 頻道是 latest 上的 0.1.5-rc.3，以及 next 上的 0.1.7-rc.2，兩者都是候選版本，而專案本身也將其標示為開發者預覽版：README 以全大寫字母警告，破壞相容性的變更即將到來。其熱度是真實的——最初 12 小時內就累積了 50,000 個 GitHub 星星，到 2026 年 9 月下旬已達 235,000 個——但星星衡量的是關注度，而非穩定性。請像規劃預覽版那樣規劃你的安裝：快速試用，便宜丟棄。

開始之前：實際的系統需求

對於命令列安裝，唯一的硬性需求是 Node.js。此專案指定的引擎範圍為 ^22.19.0 || >=24.0.0——簡單來說，就是 Node 22.19 或更新版本，或任何 Node 24.x。用 node --version 檢查你的版本。如果你使用的是較舊的 Node，npx 安裝將會失敗或行為異常，而不會優雅地降級。下方的桌面應用程式則是例外：它自帶執行環境，因此完全不需要 Node.js。

其他一切都比模型優先派所假設的更輕量：

• 模型 API 金鑰。 dsh 會執行真實模型；它需要一個用於 Deep​Seek 的 API 或任何你設定的 Open​AI 相容提供者的金鑰。你可以在首次啟動後於網頁 UI 中新增一個。

• pnpm — 僅供從原始碼建置時使用。請安裝一次，使用 npm install -g pnpm。

• 約 1 GB 的可用磁碟空間，用於 npm 套件、工作區與工作階段記錄，以及本機模型所需的任何空間（dsh 本身不會執行權重）。桌面版安裝程式較為龐大——Windows .exe 為 288 MB，macOS 的磁碟映像檔為 368 MB——因為它內部攜帶了該執行環境。

• 作業系統：npm 這條路徑可在 Windows、macOS 和 Linux 上運作。桌面應用程式的支援範圍較窄——僅限 Windows x64 與 Apple 晶片 macOS，沒有 Intel Mac 版本，也沒有 Linux 目標。Python SDK 的支援範圍又更窄（Linux x64/arm64、macOS 14+ arm64——不支援原生 Windows），詳見下方。

你不需要 GPU。該 harness 僅負責編排；模型透過 API 遠端執行。

方法 1 — 官方桌面應用程式（Windows 與 macOS）

2026 年 9 月 24 日，Deep​Seek 發布了 Deep​Seek Harness 的首個封裝桌面版。它是一個包住同一個 Web UI 的 Electron 外殼，並在內部隨附 dsh 執行階段，因此不必先安裝任何東西，也不必手動啟動任何東西：不需要 Node.js、不需要 npx、不需要終端機，也沒有瀏覽器分頁會一直開在 127.0.0.1:3080。原始碼位於公開儲存庫中 apps/desktop 底下，套件為 @deepseek-ai/dsh-desktop，建置產物由 Deep​Seek 自家的正式下載主機提供，網址是 download.deepseek.com/dsh-desk/，而應用程式完全依照 harness 版本——目前建置版本是 0.1.7-rc.2。

該主機在 2026 年 9 月 25 日所供應的內容：

• Windows — deepseek-harness-0.1.7-rc.2-win-x64.exe，一個 288 MB 的安裝程式，旁邊附有 .blockmap 檔案，可用於差異更新。

• macOS — deepseek-harness-0.1.7-rc.2-mac-arm64.dmg，368 MB 的磁碟映像檔，或相同組建的 373 MB .zip 壓縮檔。僅限 Apple silicon。

• 版本 — 0.1.7-rc.2，發佈日期為 2026 年 9 月 24 日，與 npm 的 next 標籤上的 harness 版本相符。

• 缺少 —— 沒有 Intel-Mac 版本（mac-x64 更新來源會傳回 404），也沒有任何形式的 Linux 目標平台。

每個目標也會在 download.deepseek.com/dsh-desk/feeds/ 底下發佈更新摘要，其 releaseDate 欄位即為組建日期。檢查該檔案是查看是否有較新組建存在的最快方式，而不必等待應用程式主動提供。

為什麼官方客戶端和社群封裝是不同的東西。它是第一方且會自我更新，執行環境直接隨附在安裝程式裡，而不是在首次啟動時才去取得，而且它不會從網頁設定檔的 3080 提供使用者介面：外殼是透過內部的 dsh-app:// 配置載入應用程式，並與位於自身連接埠（預設為 19387）的私有主機程序通訊。它的行為也像桌面應用程式——關閉視窗會讓執行中的任務繼續存活（Windows 會保留系統匣圖示），有工作正在進行時退出會先詢問，而 0.1.7-rc.2 的發行說明新增了首次執行導引，介紹可用額度並區分由帳號付費的任務與使用 API 金鑰的任務，因此你可以用 Deep​Seek 帳號登入，而不必貼上金鑰。

兩點但書，因為這個用戶端是悄悄推出，而非正式發布。該儲存庫的 README 仍只記載 npx 與原始碼建置，而 www.deepseek.com/harness 的專案頁面完全沒有下載連結——二進位檔及其更新資訊源已在 Deep​Seek 自家主機上線，這是我們在 2026 年 9 月 25 日所驗證的，但沒有任何地方的版本說明提到它們。而且我們尚未執行安裝程式，因此本指南不對已發布二進位檔的簽署或公證狀態表達立場；該儲存庫中的封裝管線確實包含 Windows 程式碼簽署與 Apple 公證步驟，而這就是從外部所能說的一切。

桌面版建置跟隨 harness 版本所帶來的一個後果是：它目前領先預設的命令列安裝。npm 的 latest 標籤仍指向 0.1.5-rc.3，而每個桌面成品都是 0.1.7-rc.2。如果你想在桌面應用程式未涵蓋的平台上使用最新的 harness，請明確安裝該標籤——npx @deepseek-ai/dsh@next web——而不是信任預設值。

方法 2 — npx 單行指令（所有平台，包括 Linux）

官方快速入門就是一個指令，而且確實就是一個指令：

npx @deepseek-ai/dsh web

npx fetches the @deepseek-ai/dsh package (npm's latest tag currently resolves to 0.1.5-rc.3, not the newest harness), installs it into npm's cache, and starts the Web UI profile. Watch the output for the line that tells you it's listening — by default that is http://127.0.0.1:3080. Open it in your browser. Note the 127.0.0.1 loopback address: the UI binds to localhost only, which is the right default for a tool that can read and write files in your workspace — it also means you won't casually expose it on your network.

首次啟動正好有兩個設定步驟：

• 新增模型金鑰。設定 → 模型 → 輸入你的 API 金鑰。它會儲存在$DSH_HOME/.credentials.yaml，且之後不會以明文顯示。在預設安裝中 DSH_HOME 預設為 ~/.dsh。

• 選擇工作區。新增 dsh 允許工作的專案目錄。在兩個步驟完成前，輸入會保持鎖定。

接著送出第一個任務——一個好的冒煙測試是「總結這個儲存庫並識別其主要套件。」如果摘要回傳，而且執行追蹤中出現工具呼叫，你的安裝就正常運作。

方法 3 — 從原始碼建置

偏好從儲存庫執行？官方路徑是：

git clone https://github.com/deepseek-ai/deepseek-harness.git

cd deepseek-harness

pnpm install

pnpm run build

pnpm dsh web

你需要 pnpm 才能執行此操作（貢獻者鎖定 pnpm 11.7.0）。請選擇源碼建置：當你想執行最新的main 而不是已發佈的候選版本、當你計劃閱讀或修改測試框架，或當你想從 repo 的apps/cli/config/agent-presets/ 目錄建立自訂預設時。對其他人而言，npx 路線是相同的軟體，但更簡單——源碼建置並不會解鎖 npm 套件所缺少的功能。

三個設定檔：web、headless 和 tui

dsh 提供三種執行設定檔，使用哪一種取決於工作在哪裡執行：

• web（預設）— 連接埠 3080 上的完整瀏覽器 UI。這就是 npx @deepseek-ai/dsh web 所啟動的內容，也是大多數人會首先安裝的設定檔。

• headless — 單一任務，然後結束。 dsh --profile headless "run the test suite and report failures" 會啟動一個工作階段，執行任務，寫入結果，然後終止。headless 執行環境明確是單一任務流程：你無法在執行中途插入後續任務，修正則是對同一個工作區重新執行。這就是要整合到腳本和 CI 的設定檔。

• tui — 用於鍵盤驅動工作階段的終端機介面：dsh --profile tui.

三者共用相同的配置（~/.dsh/profiles/<name>/）與相同的插件系統，因此將任務從 Web UI 移到無頭模式只是換個指令，而非重新安裝。

新增外掛程式

外掛程式管理是第一等的 CLI 指令，而非就地編輯的操作：

npx @deepseek-ai/dsh plugin --profile web add <來源>

來源可以是 npm 套件名稱、GitHub 儲存庫（github:user/repo）、tarball，或本機資料夾。最值得優先安裝的是官方外掛市集，它能將外掛探索變成一個 UI：

npx @deepseek-ai/dsh plugin --profile web add dshmarket

然後重新啟動 Web 服務，並開啟 設定 → 外掛程式市集，即可從目錄中瀏覽並一鍵安裝。有兩個容易讓人搞混的規則：外掛程式套件會在設定檔啟動時掛載，因此新加入的外掛程式需要重新啟動 dsh web；而單純的 npm install並不會將外掛程式註冊到設定檔中——你必須使用 dsh plugin。這個生態系雖然年輕，但並非空無一物：由社群維護的 awesome-dsh-plugin 清單已經收錄了數百個外掛程式，涵蓋 UI、技能、工具、提供者及通知等類別。

MCP、四個預設與軌跡重播

過了基本安裝階段之後，有三個功能很重要：

MCP。dsh 通過內建的 @deepseek-ai/dsh-mcp-client 外掛程式來使用模型上下文協議。目前這是通過檔案配置的，而非在 UI 中：你編輯 ~/.dsh/profiles/web/cordis.patch.yml（或專案本地的 patch）並宣告每個伺服器的傳輸方式——stdio用於本機命令，例如 npx @playwright/mcp@latest、streamable-http 用於遠端 URL。它能運作，但這是預覽版中最不完善的部分；預期會有不穩定情況，且沒有 GUI 可以切換伺服器。

預設。dsh 每個工作階段會載入四個代理預設之一，而每個都是不同的取捨：

• Standard — 完整的工具集：檔案編輯、shell、檔案與網路檢索、技能、規劃、子代理、工作流程。日常使用的預設。

• PTC（程式化工具呼叫）— 標準版加上 Code Mode SDK，讓模型可以撰寫 TypeScript 程式來編排多輪工具呼叫。更強大，副作用也更多。

• 極簡 — 僅需 bash 和一個檔案編輯器，除此之外什麼都不用。專為模型基準測試和最小重現而建；DeepSeek V4 Flash API 文件在揭露自家 agent 分數時所引用的模式，就是運行在「Deep​Seek Harness minimal mode」上。

• Creation — 一個執行時期遊樂場：在記憶體中檢查並載入 Cordis 外掛程式，進行實驗，並將可行的組合鞏固成新的預設。

軌跡重播。每次執行都會寫入一份僅可追加的會話日誌——系統提示、推理過程、工具呼叫及其結果、子代理排程。軌跡檢視可讓您依來源檢查、繼續、分叉、搜尋及重播執行。這就是代理工作的除錯器：當任務失敗時，您不會重新執行並寄望於運氣；您會重播失敗的軌跡，在出錯的步驟將其分叉，並在不丟棄原始軌跡的情況下測試修正。

Python SDK 選項

如果你比較想用 Python 而不是瀏覽器來驅動 harness，這裡有官方 SDK：pip install deepseek-harness-sdk。它整合了 dsh runtime（pip wheel 內含 Node runtime，所以無需另外安裝 Node），用法是一個 context manager：建立 Deep​SeekHarness 實例，然後呼叫 run("task")。它會繼承標準環境變數，例如 DEEPSEEK_API_KEY 和 DEEPSEEK_BASE_URL，因此更換 provider 只是設定變更。缺點是：它僅支援 Python 3.10+ 及 Linux x64/arm64 與 macOS 14+ arm64——沒有原生 Windows wheel，如果你的主機是 Windows，這確實是個缺口。在 Windows 上，請沿用 npm 方案。

將 dsh 指向您付費使用的模型

dsh 需要一個模型 API 金鑰，而且它刻意與供應商無關：設定 → 模型 接受具有 Open​AI 相容基礎 URL 的自訂供應商（在 settings.yaml中，即 api: openai-completions、baseURL，以及一個 models清單）。預設是 Deep​Seek 自己的 API；自訂供應商正是路由閘道派上用場的地方。

OrcaRouter is an Open​AI-compatible endpoint that passes Deep​Seek's list price through with zero markup — https://api.orcarouter.ai/v1. The models dsh will actually call are all on it: DeepSeek V4 Flash 0731 (deepseek/deepseek-v4-flash-0731, $0.22 per million input tokens and $0.66 per million output), DeepSeek V4 Pro 0813 (deepseek/deepseek-v4-pro-0813, $0.66/$1.98) and DeepSeek V4.1 Flash (deepseek/deepseek-v4.1-flash, $0.15/$0.60), the model Deep​Seek's own rate card bills as deepseek-flash. Every rate doubles inside Deep​Seek's peak windows, 01:00-04:00 and 06:00-10:00 UTC on weekdays; the router passes that surcharge through rather than hiding it, and automatic failover moves a request to another provider if one wobbles. Figures checked against both rate cards on September 25, 2026. For dsh, the practical win is that you can keep the cheap tier for the bulk of everyday agent tasks and switch the same harness to V4 Pro for the hard passes — one key, one base URL, and the swap is a model name in the settings, not a reinstall.

為了釐清界線：OrcaRouter 託管模型供 dsh 呼叫；它本身不託管 dsh，也不提供桌面用戶端——那來自 DeepSeek 自己的下載主機。dsh 是本地代理執行環境，而你要在自己的機器上執行它。

這份指南在哪些地方對你不適用——預覽版的誠實問題

只告訴你該輸入什麼的安裝教學，只算做了一半的工作。以下是預覽版目前會出錯的地方，免得你在凌晨兩點才發現：

• 重大變更是一項承諾，而非警告。你目前使用的是候選版本——若採用 npm 的預設值，是 0.1.5-rc.3；若安裝的是桌面應用程式或 next 標籤，則是 0.1.7-rc.2。設定鍵、外掛 API 與預設格式都可能無預警變動。請將 ~/.dsh 視為可拋棄的狀態——一次糟糕更新的代價就是重新安裝，而在這個階段這之所以可以接受，是因為這裡的每種安裝途徑都只是一次下載或單一指令。

• 你並不需要 dsh 就能將 Deep​Seek 模型用作 agent。如果你現在的唯一目標是在 agent 中使用 DeepSeek V4 Flash 或 DeepSeek V4 Pro，Deep​Seek 的 Anthro​pic 相容端點已經能在 Claude Code 和其他 agent 工具中運作，無需任何新軟體。dsh 是第一方選項，並非必要條件。先略過此安裝，直到你確實需要原生 harness。

• MCP 採用檔案設定，且偶爾會不穩定。沒有圖形介面，也沒有個別伺服器的啟動/停止開關，實測報告指出會間歇性故障。如果你的工作流程依賴 MCP 伺服器，請預留時間進行 YAML 除錯。

• 外掛程式信任是一項安全決策。第三方外掛程式會在工具框架的核心程序中執行，安裝時沒有簽章或來源驗證。只安裝你讀過或來自可信來源的外掛程式，並在將它們用於實際工作之前，先在一次性工作區中測試。danger-full-access沙盒設定檔可以修改任何可見檔案——請僅用於一次性簽出的工作副本。

• 預覽版本中存在已知錯誤。 bash 迴圈卡住是已記錄的失敗模式（中斷後重試），而長時間執行工作階段的相關行為仍在調整中。

• 非官方的桌面版本已不再有其存在意義。在 2026 年 9 月 24 日之前，唯一能點擊安裝的 dsh 桌面應用程式是未經簽章的社群封裝版本，而使用者只能在那類版本與命令列之間二選一。官方用戶端消除了這項取捨：第一方開發、內建執行環境、可自我更新。這兩種 shell 之間並沒有真正的移轉路徑——它們封裝的是同一套 harness——因此請解除安裝其中一個、改安裝另一個，並沿用同一個工作區目錄。

• 若您需要生產穩定性，請等待非 rc 版本釋出。 這個 harness 功能強大但尚未成熟。就生產級 agent 技術棧而言，在 dsh 達到穩定版本之前，成熟的、經過實戰考驗的 harness — 或 Anthro​pic 相容的 endpoint 路線 — 才是站得住腳的選擇。

重點

安裝 Deep​Seek Harness 現在依你的平台分成兩種不同的工作。在 Windows 或 Apple 晶片 Mac 上，從 Deep​Seek 自家主機下載 0.1.7-rc.2 就完成了——不需要 Node.js、不需要終端機，而且是所有通道中最新的 harness 版本。在其他所有地方，仍然是在 Node 22.19+ 上執行一行指令：npx @deepseek-ai/dsh@next web，接著加入模型金鑰與工作區，再送出一個測試任務。腳本請用 headless，只有想修改或追蹤 main 時才用原始碼建置，並把 MCP 當成仍在開發中的東西。老實說的但書沒變：這些通道每一個都是 0.x 版的候選發行版，在走向穩定版的路上一定會弄壞一些東西——如果你想看看 Deep​Seek 把 agent 層帶往何方，這是筆划算的交易。它執行的模型——DeepSeek V4 Flash 0731、DeepSeek V4 Pro 0813 與 DeepSeek V4.1 Flash——今天就可透過 OrcaRouter 以定價取得，準備好在安裝的另一端驅動這個 harness。