DeepSeek Harness:「一切皆是插件」的開源 Agent 框架,連 Agent 迴圈本身都能被替換
本內容僅供參考,詳細使用規則與工具安全性與否,建議要進行相關安全性測試與評估
這兩個月我們看過許多 Agent 框架與 harness:nanobot、Hermes Agent、Codewhale、ECC……它們大多有一個「核心」,再讓你掛上 Skill、hook 或 MCP。DeepSeek Harness(deepseek-ai/deepseek-harness,指令為 dsh)的設計哲學更激進,標語就是「Everything is a Plugin」——沒有不可動的核心,連 Agent 迴圈本身都是一個可以替換的插件。這個專案在 11 月初的 AI Agent 工具週報中名列前茅,目前約 283k stars、超過 28,000 次 commit。
1. 專案背景與定位
DeepSeek Harness 是 DeepSeek AI 開發、以 MIT 授權開源的「Agent harness」,建構在 Cordis 框架之上(相關論文為 arXiv 2608.25512〈A Programming Paradigm for Spatiotemporal Composability〉)。
需要特別強調的是:它目前是開發者預覽版,README 以全大寫寫著「會有破壞相容性的變更」;SAFETY.md 也明確表示它「未經安全稽核,不應被視為安全或可上線的軟體」。這是一個值得研究其架構、但還不適合直接放進正式環境的專案。
2. 技術架構與核心設計
- 一切皆是插件:架構文件寫道,「產品的每一部分都是插件,包括模型轉接器、工具註冊表、session 紀錄,以及 Agent 迴圈本身,因此每一部分都能透過設定替換」;而且「沒有需要打補丁的特權核心」——要擴充 dsh,就是在其他插件旁邊掛上新插件,插件卸載時它所註冊的東西也會一併撤銷。
- Cordis 的共享 context:插件向一個共享 context 提供服務、具型別的事件與可逆的副作用,例如
ctx.llm(模型轉接)、ctx.tools(工具註冊與受控執行)、ctx.sessions(只能追加的事件紀錄)、ctx.agentLoop(預設的 Agent 驅動器)、ctx.sandbox(沙盒後端)。 - 以 profile 組裝:執行中的 dsh 是開機時由多層設定組成的插件樹;內建的 profile 範本有 web、headless、sdk、sdk-minimal 與 acp,共用的
dsh-base提供模型轉接、工具、持久化、沙盒與核准政策、設定、憑證與遙測。dsh --profile web --dump-config可以印出完整的組裝結果。 - 「模型看得到的就必須被記錄」:session 紀錄是模型 context 的唯一來源,模型的對話歷史由紀錄投影而成,以 JSONL 格式保存——這讓每一輪對話都可追溯、可重播。
- 細粒度的 hook:一個回合由多個步驟組成,每步驟包含一次模型請求與其工具呼叫,並可在 pre-step、request、stream、工具執行前後等時點掛入 hook。
- 一致的執行世界:檔案系統與子程序提供者共享同一個執行環境,把它們指向遠端沙盒時,Bash、終端機與 LSP 會一起搬過去。
- 多種介面:
- Web UI:
npx @deepseek-ai/dsh web,預設在127.0.0.1:3080 - 桌面版:Electron 應用,內含簽章的 dsh 執行環境
- 無頭 CLI:一次性執行、不啟動伺服器
- Python 與 TypeScript SDK:透過 JSON-RPC 與 dsh 溝通
- ACP:給編輯器與自動化使用的 Agent Client Protocol 伺服器
- Web UI:
- Subagent 與 Agent Teams:subagent 提供者可以是全新的子 Agent,也可以是委派給其他產品的回合;Agent Teams 則在根 session 上加入任務政策與共享任務看板。
3. 社群熱度與生態採用
約 283k stars、35.1k forks、1.2k watchers,社群可以為插件 repo 加上 dsh-plugin 主題標籤來互相發現。值得注意的是,repo 中的 BENCHMARK.md 沒有任何數字,只說明如何用 Python SDK 的最小版本執行評測——目前沒有官方公布的效能或任務成功率數據。
4. 局限性與潛在風險
- 官方明說不安全、不適合上線:SAFETY.md 指出,它可以執行模型產生的程式碼與指令、載入第三方插件,並存取提供給它的網路、程序、憑證與檔案;「沙盒、核准提示與權限控制可以降低風險,但不能保證隔離或防止損害」,也不應作為不受信任工作負載的唯一安全控制。官方建議使用最小權限、拋棄式的虛擬機或容器、做好備份,並審查插件與 Agent 提議的指令。
- 破壞性變更:開發者預覽版的 API 與設定格式隨時可能改變。
- 插件就是供應鏈:「一切皆是插件」意味著每個第三方插件都可能改變 Agent 的核心行為,甚至替換 Agent 迴圈本身——彈性越大,審查的必要性越高。
- 資訊不完整:README 與架構文件沒有明確列出支援的模型供應商、MCP 與 Skill 的支援情況,也沒有說明遙測會送出哪些資料、送到哪裡;
dsh-base確實包含遙測元件,導入前應先確認其行為。 - 沒有公開評測:無法從官方資料判斷它與其他 harness 的效能差異。
5. 應用價值與適用場景
目前最適合研究 Agent 架構、或需要高度客製化 Agent 行為的工程師與研究團隊:例如替換 Agent 迴圈做實驗、接入自家的模型或沙盒、用 SDK 把 Agent 嵌入自己的產品,或用完整的 session 紀錄做行為分析與重播。對於只想要一個好用 Coding Agent 的開發者,現階段選擇較成熟的工具會更穩妥。
Monday 的觀點與架構建議
- DeepSeek Harness 把「可組合性」推到了極致:當連 Agent 迴圈都是插件,「Agent 框架」就不再是一個產品,而是一個讓你組裝自己產品的作業系統。這和 ECC 的「全家桶」路線正好相反。
- 「模型看得到的就必須被記錄」是一條非常值得採用的工程原則:context 完全由可追溯的事件紀錄推導而來,除錯、稽核與重現問題都會容易得多。
- 研究與試用建議:在拋棄式容器或虛擬機中執行、不提供正式環境的憑證、先用
--dump-config了解實際載入了哪些插件、確認遙測設定,並只安裝來源可信的插件。 - 從 Anthropic 的 Skill 格式、Google 的官方 Skill,到 DeepSeek 的插件化 harness,可以看到各家都在爭奪「Agent 的擴充標準」。最後勝出的,很可能是最容易審查、最容易組合,同時也最安全的那一套。
Friday