DeepSeek Harness：用插件優先架構打造可維護的 AI Agent 執行環境

DeepSeek Harness（亦稱 dsh）是供開發者建置與運行 AI Agent 的開源執行環境，採 MIT 授權，目前仍處於開發者預覽（developer preview）階段。它不是一個固定功能的 Agent 產品，也不是新的基礎模型；它提供的是一個可自行挑選、拼裝 Agent 各項元件的環境。現有報導顯示，v0.1 於 2026 年 8 月 13 日發布，並非 9 月。12

核心概念：沒有需要修改的「特權核心」

Harness 把「萬物皆插件」落實到架構層面：模型適配器、工具、技能、會話、沙箱、儲存、排程、Agent 迴圈，甚至使用者介面，都能透過設定替換或重新組合。開發者要擴充執行環境，重點不是修改核心程式，而是把新插件與既有元件並列掛載。221

這種設計特別適合需要更換模型供應商、限縮工具權限、加入自訂核准政策，或改用不同執行環境的情境。這些差異可由執行環境的組合來表達，避免長期維護一個自行分叉的版本。

Cordis 在其中扮演什麼角色？

Harness 底層採用內嵌（vendored）的插件框架 Cordis。插件可向共享上下文提供服務、型別化事件與可逆副作用；當插件卸載時，所註冊的內容也能一併撤銷。2122

Cordis 也支援感知相依關係的組合方式：若某個回呼宣告需要的服務發生變動，該回呼會被卸載並重新執行；ctx.plugin 則可依插件宣告的綱要（schema）驗證設定後載入插件。19

對擴充功能開發者來說，這提供了清楚的客製切點。例如，工具插件可註冊到 ctx.tools；而在工具執行前的政策鉤子（hook）中，則能回傳具型別的允許或拒絕決策。相同的擴充點可用於權限控管、沙箱與計畫模式等政策。17

內建四種執行模式

Harness 提供四種可作為開發起點的預設組合：2

• Standard：提供完整的程式開發 Agent 工作流程與工具組。
• Code：透過 Code Mode SDK 開放工具，讓模型產生的 TypeScript 可以協調多步驟工作。
• Minimal：提供持久化 shell 與 str_replace_editor，適合受限環境或基準測試。
• Creator：加入執行環境檢視與記憶體內插件實驗能力，面向要建立新預設組合的開發者。

這四種模式是可立即使用的起始配置，而非永久界線。團隊仍可隨需求替換或加入能力。221

安裝與首次使用流程

Harness 以 npm 套件與 CLI 形式發行，套件名稱為 @deepseek-ai/dsh。文件列出的快速啟動方式是：

npx @deepseek-ai/dsh web

若需要從原始碼執行，或直接參與程式碼開發，也可以複製原始碼儲存庫。130

使用 Web UI 時，先到 Settings → Models 設定模型憑證，再選擇工作區後開始編排任務。dsh 預設以啟動指令所在的目錄作為檔案系統位置；不過剛開啟的 Web UI 尚未選定工作區，必須先加入一個工作區。25

可觀測性：會話日誌是執行紀錄的一部分

Harness 會將模型看到的內容寫入僅附加（append-only）的會話日誌，包括系統提示詞、推理、工具呼叫及結果、子 Agent 排程與所有上下文注入。Trajectory 檢視可按來源檢查這些紀錄；恢復執行（resume）、分叉（fork）、搜尋與重播（replay）也都使用同一條事件流。2

換句話說，這份日誌不只是事後除錯資料，而是可用於檢視一次執行、回到先前分支，以及重現影響 Agent 行為之執行事件順序的正式紀錄。

處於開發者預覽，升級更需要紀律

Harness 明確標示為開發者預覽，因此團隊不應假設插件與 API 已承諾長期穩定相容。26

較務實的做法是固定正在使用的版本、閱讀每次發行變更、在隔離的 profile 或工作區測試升級，並在擴大部署前重播具代表性的會話。這是基於預覽階段特性提出的風險控管建議，並非官方保證每次升級都不會破壞相容性。

插件驗證最好分成兩個層次：

1. 先驗證插件本身：檢查設定綱要、必要服務、故障行為與工具政策邏輯。
2. 再驗證實際組合：讓插件與真正會一同運作的模型適配器、工具、沙箱、權限、會話儲存與其他插件共同測試。

Harness 的設定機制可協助做到這一點。cordis.yml 項目可帶有 config 區塊，插件則提供在 apply 執行前驗證的綱要；若設定不正確，載入會直接失敗，不會讓插件在半設定狀態下啟動。2728 系統產生的設定目錄可透過 pnpm run verify-config-catalog 檢查。18

在發佈方面，文件支援將擴充功能封裝成可安裝的 bundle，再以 dsh plugin add 加入 profile。將 bundle 與設定明確化，有助於重現、稽核、測試及升級一套由多個元件組成的執行環境。24

結論

DeepSeek Harness 最適合被理解為 Agent 建置者的基礎設施：Agent 的模型連線、工具、政策、執行環境、迴圈、狀態與介面，都是可組合的選擇。Cordis 處理插件生命週期；多種執行模式提供可用的預設起點；僅附加會話日誌則留下詳細的操作紀錄。高度彈性正是它的吸引力，但在開發者預覽階段，審慎測試與升級管理同樣不可或缺。221