DeepSeek Harness是什麼？架構、四種模式與上手全解

2026 年 8 月 13 日夜裡，GitHub 上出現了一個叫 deepseek-harness 的儲存庫。兩週之內，它累積了接近 19.8 萬 star、2.25 萬 fork——多數開源專案一輩子都摸不到的數字。與此同時，中文搜尋框裡湧進一大批「DeepSeek Harness桌面版」「DeepSeek Harness內測入口」，大家直覺認定這是個新發布的 App，有下載頁、有資格申請。

真實情況跟這兩種想像都不太一樣。DeepSeek Harness 不是從應用商店下載的軟體，也沒有任何排隊名單——它比這兩者都有意思：一個開源的智能體框架，官方給它的定義只有一句話，「一切皆插件」（Everything is a plugin）。這篇文章講清楚它到底是什麼、架構怎麼運轉、五分鐘怎麼跑起來，以及所有人都在問的那幾個問題的誠實答案。

DeepSeek Harness 是什麼？

DeepSeek Harness——命令列名字叫 dsh——是 DeepSeek 官方開源的智能體執行環境（agent harness），以 MIT 授權發布了開發者預覽版。可以把它想成一套馬鞍、馬鐙和韁繩，配給一匹非常聰明的馬。模型是那匹馬，負責思考；harness 負責讓思考變成真正的活兒——讀檔案、跑命令、調工具、讓一個任務跨幾十步不脫軌。

DeepSeek 把這層關係壓縮成產品頁上印的公式：AGENT = MODEL + HARNESS。模型負責生成下一步；harness 決定模型能看到什麼、可以碰哪些工具、高風險動作誰來核准、出了錯怎麼恢復。沒有 harness 的強模型，只會告訴你「我會怎麼做」；有了 harness，它是真的動手做。

幾個錨點事實：

  • 2026 年 8 月 13 日公開發布，原始碼全開，MIT 授權——同一天，V4-Pro 模型正式 GA。
  • 截至 2026 年 8 月 27 日，GitHub 儲存庫約 19.8 萬 star、2.25 萬 fork。
  • 目前版本 dsh v0.1.1-rc.2（8 月 21 日），與新的 V4-Flash-Vision-Exp 多模態模型同日發布。
  • 它在 DeepSeek 內部有獨立身分：黑色鯨魚 logo、專門的「DeepSeek Harness 團隊」微信公眾號，與聊天產品的藍鯨明顯區隔。

還有一句話適合放在最前面說：這是開發者預覽版（developer preview），README 說得很直白——迭代很快、會有破壞性變更。今天就要基於它做東西的話，請鎖好版本號。

一切皆插件：架構怎麼運轉

大多數智能體工具把零件焊死在一起：廠商選什麼模型介面，你就用什麼；廠商配什麼工具集，你就用什麼。DeepSeek Harness 押了相反的方向：幾乎所有能力都是插件，可以載入、卸載、替換、重組，全程不碰核心程式碼。

插件品項讀起來像一份智能體的零件目錄——模型、工具、技能、會話、沙箱、儲存、Agent 迴圈、任務排程，連 UI 本身都是。想像一套組合音響，而不是一台一體機：擴大機、喇叭、唱盤、串流播放器，每件都是獨立的盒子。換掉串流播放器，擴大機毫無感知。這就是它的設計目標：換掉模型介面，你的工具、權限、會話歷史原封不動。我在專案中途換過一次模型介面，可以作證：會話、權限、任務清單——連眼皮都沒眨一下。

底層是一個叫 Cordis 的插件系統，學術名片是一篇關於「時空可組合性」（spatiotemporal composability）的論文——這個聽起來很玄的詞，實際是兩個樸素承諾。時間上：插件卸載時，它註冊過的服務和副作用一併撤銷，系統不會因為反覆重組而腐爛。空間上：插件宣告依賴，周圍的元件變了，協作關係自動重建。落到使用者身上，收益更簡單：選什麼、換什麼、加什麼，全在設定檔裡完成，不用 fork 原始碼。

為什麼要這麼折騰？三個實在的好處。你可以保留同一套環境，把不同模型放進來賽馬——分清一次效果提升到底來自模型還是來自你的工程。企業可以把自己的沙箱、儲存、審核流程做成插件保留下來，不必交給廠商。插件作者發布能力即可——官方建議插件儲存庫打上 dsh-plugin 標籤——不必維護 Harness 的分岔版本。

四種執行模式

Harness 給的不是單一的固定智能體，而是四套預設執行模式，各自載入不同插件組合——與其說是「帶設定的產品」，不如說是給同一個學生的四間不同考場。

模式載入什麼適合什麼
Standard 標準模式完整工具箱：檔案編輯、shell、檔案與網頁搜尋、skills、規劃、目標、子 Agent、工作流日常 Agent 任務，預設選擇
Code 模式（PTC）標準模式的工具經 Code Mode SDK 暴露，模型寫一段程式來編排多輪工具呼叫多步驟、帶分支的任務；往返更少、上下文更乾淨
Minimal 極簡模式只留一個 shell 工具和一個檔案編輯器在最簡環境裡給模型跑分
Creator 創造模式標準模式能力 + 執行環境檢查、記憶體中試驗插件、創作預設打造新 Agent 預設、探查執行環境本身

一個命名提醒，免得被繞暈：英文文件管第二種叫 Code mode；中文報導常叫 PTC 模式（Programmatic Tool Calling，程式化工具呼叫）。同一個模式，兩個名字——模型直接寫 TypeScript 把工具呼叫串起來，而不是一次一次地要。

極簡模式值得單獨說一句它的誠實。DeepSeek 自己的基準說明目前只寫了怎麼跑 jsonrpc-agent 極簡變體，專案尚未公布與其他 harness 的對比成績。誰宣稱「跑分吊打誰」，都是拿想像填空白。

五分鐘跑起來

接下來是讓「桌面版」搜尋者們踩空的部分：官方沒有 .exe 或 .dmg 安裝包可下載。 DeepSeek Harness 的官方形態，是一條命令拉起的本機 Web UI。用起來很像桌面軟體——它在你瀏覽器裡開啟 http://127.0.0.1:3080——但本質上是你啟動了一個本機小伺服器。

三步：

  1. 裝 Node.js（nodejs.org 下載，LTS 版穩當；README 沒標最低版本）。
  2. 一條命令啟動：npx @deepseek-ai/dsh web。命令會印出地址並自動開啟瀏覽器；SSH 場景只印地址，加 --no-open 可以完全不開瀏覽器。
  3. 一次性設定：Web UI 裡開啟 Settings → Models，貼上你的 DeepSeek API key，儲存即生效，不用重啟。然後選一個工作區資料夾，把第一個任務交給它。我的第一個任務小得有點丟臉——數一個資料夾裡有多少檔案——但管線全通之後，我才敢把要緊的事交給它。

官方路徑真的只需要這些。社群確實也做了第三方桌面封裝，把以上全部打包成雙擊安裝的程式——對怕命令列的人是真實有用的存在，但那不是 DeepSeek 的產品，細節和注意事項放在下載安裝指南裡展開。

值得了解的關鍵特性

插件架構是標題，底下有三個能力值得單獨打光。

可回放的事件流日誌

Harness 裡的每個會話都是一份只追加（append-only）的事件序列——整個執行過程的唯一事實來源。系統提示詞、推理過程、工具呼叫及其結果、子 Agent 排程、每一次上下文注入：全部按序記錄，可以在 Trajectory 視圖裡按來源查看。恢復、分岔、搜尋、回放，全部作用在同一條事件流上。

把它想成飛機黑盒子。當 Agent 在第四十步做了個可疑決定，你不用憑記憶爭論它「大概看到了什麼」——拉日誌、拖到那一刻、檢查模型上下文裡到底是什麼。能看到多少思維鏈，取決於模型介面實際回傳多少，這個提醒寫得很誠實。

自帶模型，不限模型

名字裡帶 DeepSeek，卻不鎖 DeepSeek。Settings → Models 接受其他廠商、任何 OpenAI 相容端點、本機部署的模型，設定寫在 YAML 裡。社群實測跑過從 Qwen 到 Claude 的各種組合——更能說明設計的一點是，你可以把 Claude Code 或 Codex 本身當作子 Agent，編進 Harness 的工作流裡。與其說它是 Claude Code 的對手，不如說是能坐在它們上面的一層。

多數 Harness 藏起來的即時統計

任務執行時，介面即時顯示每秒 token 數、快取命中率、輪次、耗時。有位早期測試者做一個即時 ISS 軌跡追蹤器，兩輪 35 分鐘燒了約 2000 萬 token，最終快取命中率 100%——這些數字在多數程式 Agent 上根本看不到，而它邊跑邊顯示。

它與 Claude Code、MCP 是什麼關係

兩組關係說清楚，Harness 的位置就清楚了。

與 MCP：MCP 是管「連接」的開放標準——AI 應用與外部工具、資料之間的統一插頭形狀。Harness 在它上面一層：決定工具什麼時候交給模型、呼叫要不要核准、失敗怎麼重試、什麼時候派子任務。一個 MCP 伺服器完全可以是 Harness 管理的工具之一。它們是隊友，不是對手。

與 Claude Code：DataCamp 做了個對照實驗——同一個損壞的儲存庫、同一個 Claude 模型、兩個工具。兩邊產出了一模一樣的補丁，都通過了原始測試套件。在那次 Windows 環境裡，Claude Code 用時 55.0 秒；Harness 用了 125.4 秒、外加三次核准確認。單一案例說明不了排名，但它把真問題挑明了：不是「誰快」，而是你想擁有執行環境的多少。Claude Code 把打磨好的迴圈打包圍繞 Claude 模型；Harness 把迴圈本身拆開交給你，模型側還是 DeepSeek 的價格。

DeepSeek Harness 免費嗎？

免費，但值得用三句話說精確。框架本身 MIT 開源——沒有授權費，永遠沒有。模型用量按你設定的廠商計費；設的是 DeepSeek API 的話，就是往餘額裡儲值的按量計費。另外，「免費」不等於「完工」：開發者預覽意味著快速迭代和偶爾的破壞性變更，把它當車間用，別當家具用。

如果你真正想找的是別家 AI 廠商那種包月訂閱——DeepSeek 沒有，而「把按量計費用出包月效果」的帳怎麼算，值得單獨讀一篇：Coding Plan 詳解。

常見問題

有 DeepSeek Harness桌面版嗎？官方沒有。官方形態就是 npx @deepseek-ai/dsh web 拉起的本機 Web UI。社群維護的桌面封裝存在——包括一個把官方引擎打包成 Windows 安裝包的開源 Electron 用戶端——但都是第三方專案。細節與風險提示見下載安裝指南。

需要內測資格或邀請碼嗎？不需要。2026 年 8 月初確實有過封閉內測（據報導約 769 位開發者、712 個儲存庫參與），8 月 13 日專案全球開源那天內測就結束了。今天任何人都能直接用，完整時間線放在內測與公測指南裡。

DeepSeek Harness 是免費的嗎？框架：是，MIT 開源。模型：按 token 計費，走你設定的廠商。DeepSeek 自己的 API 價格在官方定價頁，離峰時段半價。

它支援哪些模型？你設定的任何模型——開箱即用 DeepSeek V4 系列，也支援其他廠商、OpenAI 相容端點、自架模型。社群測試者跑過 Qwen、Claude 和 Codex 相關的工作流。

Harness 和 DeepSeek 聊天 App 有什麼區別？聊天 App 回答問題。Harness 是一個執行環境，讓模型操作你的檔案、執行命令、管理多步任務、協調子 Agent——顧問與正職員工的區別。

接下來去哪？Harness官網看定位，GitHub 儲存庫看原始碼，官方開發者文件看手冊，發布說明看 v0.1.1 改了什麼。

Edward Wang