DeepSeek Harness（指令名稱 dsh）是 DeepSeek 開發的開源智慧代理框架。依 README 的介紹，它採用以 Cordis 框架為基礎的「一切皆外掛」架構，工具、技能乃至部分介面都是外掛，可以自由增減，也能自行撰寫。DeepSeek 官網表示，它能處理整理資料、分析試算表這類日常工作，也能在程式碼儲存庫中寫程式、查資料並附上來源，以及在背景執行耗時任務。程式碼以 MIT 授權在 GitHub 開源。

它目前仍處於開發者預覽階段。README 以大寫字母提醒，未來會出現破壞相容性的變更；DeepSeek 的安全說明也寫明，這套軟體尚未經過安全稽核。由於代理可以執行模型產生的指令、載入第三方外掛，並存取交給它的檔案與憑證，DeepSeek 建議只給它必要的最小權限，最好在虛擬機器、容器或其他專用環境中執行，做好備份，並在放行前先審查外掛與它提出的指令。

DeepSeek 有多重視這套工具，眼下就看得出來。10 月 17 日發布 DeepSeek-V4.1-Flash-1017 時，更新日誌特別寫到新模型針對 DeepSeek Harness 做了優化，並請使用者將 Harness 升級至 0.2.1-rc.1 以上版本。

桌面版、網頁版還是命令列

DeepSeek 提供三種用法。最省事的是桌面版：DeepSeek 的 Harness 頁面提供 Apple 晶片 Mac 與 64 位元 Windows 兩種下載，沒有 Linux 桌面版。依桌面版 README 的說法，桌面應用程式把完整的網頁版裝進原生視窗，並內建 Node.js、pnpm 與 Python 執行環境，系統不必另外安裝 Node.js。

第二種是 README 首推的 npm 方式，啟動網頁版；第三種是從原始碼執行，主要給開發 Harness 本身的人使用。Linux 使用者只能選擇 npm 或原始碼這兩種方式。README 沒有寫明 npm 方式支援哪些作業系統，不過另一份 Python SDK 指南列出了 Linux x64 與 arm64、macOS 14 以上（Apple 晶片）以及 Windows x64。

DeepSeek Harness 安裝步驟

依 DeepSeek 的 README 與網頁版指南，透過 npm 跑起第一個工作階段的流程如下：

  • 安裝 Node.js。README 沒有指定版本。
  • 在想讓代理處理的專案資料夾中開啟終端機，執行 npx @deepseek-ai/dsh web。網頁版會在本機 3080 埠啟動，並以預設瀏覽器開啟；透過 SSH 啟動時只會印出網址，加上 --no-open 則只啟動伺服器、不開瀏覽器。
  • 在網頁版中選擇工作區，把啟動 dsh 的資料夾加入並選取。選好工作區之前，輸入框無法使用。
  • 依下一節設定模型，然後開始工作階段。

若要從原始碼執行，README 的做法是複製儲存庫，依序執行 pnpm install 與 pnpm run build，再以 pnpm dsh web 啟動。

Windows 桌面版的安裝程式只會為目前使用者安裝。桌面版 README 提到，關閉視窗只會把應用程式收進系統匣，執行中的任務不會中斷；應用程式選單中的 Manage dsh Command 可以把 dsh 指令加入 Windows 目前使用者的 PATH，macOS 則安裝到 /usr/local/bin，如此不必另外透過 npm 安裝也能在命令列使用。

有個細節和後面的升級建議有關。截至北京時間 10 月 17 日 18:30，npm 上 @deepseek-ai/dsh 的預設標籤「latest」仍指向 0.2.0-rc.2，0.2.1-rc.2 則發布在「next」標籤下。README 中的指令沒有帶版本號，DeepSeek 的文件也沒說明如何指定特定版本，因此安裝後最好確認實際執行的是哪個版本。若想使用較新的版本，可以依 npm 指定標籤的通用寫法執行 npx @deepseek-ai/dsh@next web。這是 npm 的標準用法，並非 DeepSeek 文件中的內容，而且標籤在本文發布後可能會變動。

npx 安裝卡住怎麼辦

DeepSeek 的 README 與文件都沒有提到安裝卡住的情況，各版本的發布說明中也沒有相關修正。在官方 GitHub 儲存庫的 Discussions 討論區，從 8 月起就有使用者回報執行 npx @deepseek-ai/dsh web 後 CPU 滿載、遲遲無法結束，Windows、macOS 與 Linux 上都有人重現。DeepSeek 的維護者 8 月 22 日回覆表示會調查跟進，此後官方並未提出解決辦法。討論串中的各種因應方式都來自其他使用者，並非 DeepSeek 的說法。在官方提供的幾種方式中，只有桌面版不經過 npm 安裝，依其 README 的說法，它不依賴系統中的 Node.js 與 pnpm。

將 DeepSeek Harness 接上 deepseek-flash

DeepSeek 的模型設定指南這樣介紹以 API 金鑰接入：

  • 在 DeepSeek 開放平台取得 API 金鑰。
  • 在 Harness 中開啟「設定」→「模型」。DeepSeek 卡片只有一個 API 金鑰欄位，填入後儲存即可。金鑰會存進 Harness 主目錄下的憑證檔，之後頁面只會顯示遮蔽後的資訊，也不需要重新啟動。
  • 在模型選擇器中選 deepseek-flash。Harness 內建的 DeepSeek 模型目錄包括支援文字與圖像的 deepseek-flash，以及純文字的 deepseek-v4-pro，上下文皆為 1M tokens。選取的模型會成為新工作階段的預設模型。
  • 視需要在 Effort 選單中選擇推理強度。DeepSeek 自家的路由提供 off、low、high、max 四個等級。

DeepSeek API 現在以 deepseek-flash 這個名稱提供 V4.1-Flash-1017，因此想使用新模型不必再調整其他設定。已經送出過請求的工作階段，會繼續使用其日誌中記錄的模型。

除了 API 金鑰，也可以直接登入 DeepSeek 帳號。自 v0.2.1-rc.1 起，透過本機 HTTP 開啟的網頁版支援帳號登入，桌面版也有自己的登入畫面。依 DeepSeek 文件的說法，以帳號登入時模型清單來自帳號本身，需要較新版本用戶端的模型會被 Harness 隱藏，若硬要呼叫會報錯並提示需要安裝的版本。DeepSeek 沒有說明 1017 是否設有這樣的最低版本。

無頭模式（dsh headless 後面接任務）的情況不同。從 0.2.1 的 alpha 版本開始，它預設不再讀取網頁版中儲存的金鑰，而是從環境變數 DEEPSEEK_API_KEY 或 .env 檔案讀取。

為什麼要升級至 v0.2.1-rc.1 以上

DeepSeek 給的理由很簡單。10 月 17 日的更新日誌表示，1017 針對 DeepSeek Harness 等代理工具做了優化，並建議升級至 Harness 0.2.1-rc.1 以上版本，「以獲得新模型的最佳體驗」。北京時間 16:35 在 X 上的公告也是同樣的建議。

這個版本具體帶來什麼，可以看發布說明。v0.2.1-rc.1 於北京時間 10 月 17 日 13:22 在 GitHub 發布，是 0.2.1 系列的第一個候選版本，彙整自 v0.2.0-rc.2 以來的變更，包括網頁版帳號登入、DeepSeek 帳號的模型清單隨帳號可用模型更新、在介面中依模型設定推理等級、自動遮蔽訊息中貼上的金鑰與權杖、從自訂索引來源安裝外掛，以及用 /compact 手動壓縮上下文等。也有一些行為變更，例如上述無頭模式讀取金鑰的方式，以及 Azure 供應商改名。這份說明並未點名 1017 或 Search/Fetch。這兩項寫在同一天 16:16 發布的 v0.2.1-rc.2 中：新增對 DeepSeek-V4.1-Flash-1017 的支援，以及對 DeepSeek Search 與 Fetch API 的支援，可在網頁搜尋設定中開啟。GitHub 將這兩個版本都標為預先發布版。

桌面版可透過應用程式內建的更新檢查與 Check for Updates 選單升級。目前桌面版下載檔對應哪個 Harness 版本，DeepSeek 並未寫明。

外掛、代理與其他模式

外掛是整體設計的核心。可以在「外掛」頁安裝現成外掛，也可以在創造模式中描述想要的外掛，讓代理寫好並裝上。DeepSeek 官網就示範了用這種方式做出番茄鐘。依 rc.1 發布說明，官方外掛清單可依需要安裝與目前版本對應的 Claude Code 與 Codex 組合包；另有實驗性的 Claude Code Mods 相容層，DeepSeek 表示它目前並非為了提供實際可用的完整相容。實驗性的「自訂外掛市集」功能可以瀏覽第三方外掛索引，但 Harness 不內建任何索引來源，DeepSeek 也提醒市集內容屬於第三方。開發者也可以用 dsh plugin 指令從命令列安裝外掛，DeepSeek 並請外掛作者為自己的 GitHub 儲存庫加上 dsh-plugin 主題標籤。

代理方面，文件介紹它可以讀寫工作區檔案、執行指令、把工作委派給子代理並維護計畫，遇到需要核准的操作會先詢問。「外掛」頁的實驗性外掛中還有代理團隊與自動化任務。除了網頁版，dsh 指令還有處理完一個任務就結束的無頭模式、透過 Agent Client Protocol 為用戶端提供服務的 ACP 模式，以及供 Python SDK 使用的 SDK 模式；Python SDK 可用 pip 安裝，套件名稱為 deepseek-harness-sdk。官方另提供選用的 GitHub webhook 設定，在拉取請求轉為待審時自動開啟唯讀的審查工作階段。

DeepSeek 的文件沒有提到 VS Code 擴充功能或其他編輯器整合。README 只寫到，透過 SSH 啟動時，轉送位址由 SSH 用戶端或編輯器持有。

費用

DeepSeek Harness 本身是免費的開源軟體，DeepSeek 沒有為它標價。真正要付費的是 DeepSeek API 的模型呼叫。依 DeepSeek 價格頁，deepseek-flash 尖峰時段每百萬 tokens 輸入（快取未命中）人民幣 2 元、輸入（快取命中）0.04 元、輸出 8 元，離峰時段減半。尖峰時段為北京時間平日 9:00 至 12:00、14:00 至 18:00（不含中國法定假日）。若是登入帳號而非使用 API 金鑰，用量如何計費，DeepSeek 文件沒有說明。

在 Harness 中連網搜尋另有計價。DeepSeek 價格頁寫明，在 DeepSeek Harness、Claude Code 或 Codex 中使用 DeepSeek API 時，伺服器端工具呼叫已經會用到 Search 與 Fetch 介面，這部分目前不收費，將自北京時間 2026 年 11 月 1 日 00:00 起按次計費，兩個介面皆為每 1,000 次成功請求人民幣 5 元。這兩個介面和 1017 模型本身，我們另有文章詳細介紹，連結見文末。