DeepSeek Harness（又叫 dsh）係畀開發者建立同營運 AI Agent 嘅開源 runtime。佢採用 MIT 授權，目前仍係開發者預覽版；重點唔係提供一個固定 Agent 產品，亦唔係推出新嘅基礎模型，而係畀你自行揀選同組裝 Agent 所需嘅部件。現有資料顯示，v0.1 喺 2026 年 8 月 13 日發布，並唔係 9 月。 12

核心概念：冇一個「改唔得」嘅核心

Harness 對「所有嘢都係插件」呢句口號係認真嘅：模型適配器、工具、技能（skills）、session、沙盒、儲存、排程、Agent Loop，以至 UI，都可以透過設定替換或重新組合。要擴充 runtime，做法係將新插件掛載喺既有組件旁邊，而唔係直接修改核心實作。 221

實際上，當你想轉用另一個模型供應商、收窄 Agent 可用工具、加入自訂審批規則，或者改用另一套執行環境，呢啲選擇都可以變成 runtime 組合設定，而唔使長期維護一個自行 fork 出嚟嘅版本。

Cordis 做咩？

Harness 底層用咗隨專案整合嘅插件框架 Cordis。每個插件可以喺共享 context 入面提供服務、型別化事件，同埋可逆嘅 effects；插件卸載時，佢註冊過嘅內容亦可以一併撤銷。 2122

Cordis 亦支援按依賴關係去組裝。當一個 callback 依賴指定服務，而該服務有變動時，callback 會被卸載再重新執行；ctx.plugin 則會按照插件宣告嘅 schema 驗證設定後載入插件。 19

對寫 extension 嘅開發者而言，呢種設計提供咗清晰嘅擴充接口。例如工具插件可以註冊去 ctx.tools；而喺工具執行前嘅 policy hook，則可以回傳型別化嘅允許或拒絕決定。同一個 hook 位亦可用作權限、沙盒同 plan-mode 策略。 17

內置四種 runtime 模式

Harness 提供四個適合不同開發工作嘅起步 preset： 2

• Standard：提供完整 coding-agent 工作流程同工具集。
• Code：透過 Code Mode SDK 暴露工具，畀模型生成嘅 TypeScript 去協調多步工作。
• Minimal：提供持續存在嘅 shell 同 str_replace_editor，較適合受限制環境同基準測試。
• Creator：加入 runtime 檢視同記憶體內插件實驗功能，方便開發者建立新 preset。

呢四種模式係起步配置，唔係功能界線。團隊可以隨需求變化，透過插件架構增添或替換能力。 221

安裝同第一次啟動

Harness 以 @deepseek-ai/dsh npm 套件同 CLI 形式發布。官方快速開始指令係：

npx @deepseek-ai/dsh web

如果你想由原始碼執行，或者直接參與程式碼開發，亦可以 clone 原始碼儲存庫。 130

喺 Web UI 入面，先去 Settings → Models 設定模型憑證，再選擇 workspace 後先開始組合工作。dsh 預設會使用你執行指令時所在嘅目錄作為檔案系統位置；不過新開嘅 UI 未加入 workspace 前，並未選定任何工作區。 25

可觀測性唔係事後補上，而係 session 本身一部分

Harness 會將模型所見嘅內容寫入只可追加（append-only）嘅 session log，包括 system prompt、推理內容、工具呼叫與結果、subagent 排程，以及每次 context 注入。Trajectory 檢視可按來源查看紀錄；resume、fork、search 同 replay 亦都使用同一條事件流。 2

換句話講，呢份 log 唔止係 debug 紀錄：佢同時係檢視一次執行、回到舊分支，以及重現影響 Agent 行為嘅 runtime 事件序列嘅依據。

開發者預覽版：相容性要有紀律咁管理

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

較穩陣嘅做法係：鎖定目前使用嘅版本、留意 release 變更、喺獨立 profile 或 workspace 測試升級，並喺大規模採用前 replay 具代表性嘅 sessions。呢啲係基於預覽版狀態而提出嘅風險控制建議，唔代表官方保證每次升級都會向後相容。

插件驗證最好分兩層做：

1. 驗證插件本身：確認設定 schema、所需服務、失敗行為，同埋工具政策邏輯。
2. 驗證完整 preset 組合：將插件放入實際會一齊運行嘅模型適配器、工具、沙盒、權限、session store 同其他插件中測試。

Harness 嘅設定設計有助做呢一步。cordis.yml 項目可以包含 config 區塊；插件提供嘅 schema 會喺 apply 函式執行前驗證設定。設定有錯會令載入失敗，而唔會喺半配置狀態下啟動插件。 2728 生成出嚟嘅設定目錄則會用 pnpm run verify-config-catalog 驗證。 18

至於發佈，文件支援將 extension 打包成可安裝 bundle，再用 dsh plugin add 加入 profile。將 bundle 同設定清楚列明，會令整套 runtime 較易重現、審核、測試同升級。 24

總結

DeepSeek Harness 最適合被理解成 Agent 開發者嘅基建：模型連接、工具、政策、執行環境、Agent Loop、狀態同介面，都係可以自行組合嘅選擇。Cordis 處理插件生命週期；多種 runtime 模式提供可即時起步嘅預設；而只可追加嘅 session log 就提供詳細嘅營運紀錄。彈性係佢最大賣點，但由於仍係開發者預覽，審慎測試同有規劃嘅升級流程同樣不可或缺。 221

DeepSeek Harness（又叫 dsh）係畀開發者建立同營運 AI Agent 嘅開源 runtime。佢採用 MIT 授權，目前仍係開發者預覽版；重點唔係提供一個固定 Agent 產品，亦唔係推出新嘅基礎模型，而係畀你自行揀選同組裝 Agent 所需嘅部件。現有資料顯示，v0.1 喺 2026 年 8 月 13 日發布，並唔係 9 月。 12

核心概念：冇一個「改唔得」嘅核心

Harness 對「所有嘢都係插件」呢句口號係認真嘅：模型適配器、工具、技能（skills）、session、沙盒、儲存、排程、Agent Loop，以至 UI，都可以透過設定替換或重新組合。要擴充 runtime，做法係將新插件掛載喺既有組件旁邊，而唔係直接修改核心實作。 221

實際上，當你想轉用另一個模型供應商、收窄 Agent 可用工具、加入自訂審批規則，或者改用另一套執行環境，呢啲選擇都可以變成 runtime 組合設定，而唔使長期維護一個自行 fork 出嚟嘅版本。

Cordis 做咩？

Harness 底層用咗隨專案整合嘅插件框架 Cordis。每個插件可以喺共享 context 入面提供服務、型別化事件，同埋可逆嘅 effects；插件卸載時，佢註冊過嘅內容亦可以一併撤銷。 2122

Cordis 亦支援按依賴關係去組裝。當一個 callback 依賴指定服務，而該服務有變動時，callback 會被卸載再重新執行；ctx.plugin 則會按照插件宣告嘅 schema 驗證設定後載入插件。 19

對寫 extension 嘅開發者而言，呢種設計提供咗清晰嘅擴充接口。例如工具插件可以註冊去 ctx.tools；而喺工具執行前嘅 policy hook，則可以回傳型別化嘅允許或拒絕決定。同一個 hook 位亦可用作權限、沙盒同 plan-mode 策略。 17

內置四種 runtime 模式

Harness 提供四個適合不同開發工作嘅起步 preset： 2

• Standard：提供完整 coding-agent 工作流程同工具集。
• Code：透過 Code Mode SDK 暴露工具，畀模型生成嘅 TypeScript 去協調多步工作。
• Minimal：提供持續存在嘅 shell 同 str_replace_editor，較適合受限制環境同基準測試。
• Creator：加入 runtime 檢視同記憶體內插件實驗功能，方便開發者建立新 preset。

呢四種模式係起步配置，唔係功能界線。團隊可以隨需求變化，透過插件架構增添或替換能力。 221

安裝同第一次啟動

Harness 以 @deepseek-ai/dsh npm 套件同 CLI 形式發布。官方快速開始指令係：

npx @deepseek-ai/dsh web

如果你想由原始碼執行，或者直接參與程式碼開發，亦可以 clone 原始碼儲存庫。 130

喺 Web UI 入面，先去 Settings → Models 設定模型憑證，再選擇 workspace 後先開始組合工作。dsh 預設會使用你執行指令時所在嘅目錄作為檔案系統位置；不過新開嘅 UI 未加入 workspace 前，並未選定任何工作區。 25

可觀測性唔係事後補上，而係 session 本身一部分

Harness 會將模型所見嘅內容寫入只可追加（append-only）嘅 session log，包括 system prompt、推理內容、工具呼叫與結果、subagent 排程，以及每次 context 注入。Trajectory 檢視可按來源查看紀錄；resume、fork、search 同 replay 亦都使用同一條事件流。 2

換句話講，呢份 log 唔止係 debug 紀錄：佢同時係檢視一次執行、回到舊分支，以及重現影響 Agent 行為嘅 runtime 事件序列嘅依據。

開發者預覽版：相容性要有紀律咁管理

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

較穩陣嘅做法係：鎖定目前使用嘅版本、留意 release 變更、喺獨立 profile 或 workspace 測試升級，並喺大規模採用前 replay 具代表性嘅 sessions。呢啲係基於預覽版狀態而提出嘅風險控制建議，唔代表官方保證每次升級都會向後相容。

插件驗證最好分兩層做：

1. 驗證插件本身：確認設定 schema、所需服務、失敗行為，同埋工具政策邏輯。
2. 驗證完整 preset 組合：將插件放入實際會一齊運行嘅模型適配器、工具、沙盒、權限、session store 同其他插件中測試。

Harness 嘅設定設計有助做呢一步。cordis.yml 項目可以包含 config 區塊；插件提供嘅 schema 會喺 apply 函式執行前驗證設定。設定有錯會令載入失敗，而唔會喺半配置狀態下啟動插件。 2728 生成出嚟嘅設定目錄則會用 pnpm run verify-config-catalog 驗證。 18

至於發佈，文件支援將 extension 打包成可安裝 bundle，再用 dsh plugin add 加入 profile。將 bundle 同設定清楚列明，會令整套 runtime 較易重現、審核、測試同升級。 24

總結

DeepSeek Harness 最適合被理解成 Agent 開發者嘅基建：模型連接、工具、政策、執行環境、Agent Loop、狀態同介面，都係可以自行組合嘅選擇。Cordis 處理插件生命週期；多種 runtime 模式提供可即時起步嘅預設；而只可追加嘅 session log 就提供詳細嘅營運紀錄。彈性係佢最大賣點，但由於仍係開發者預覽，審慎測試同有規劃嘅升級流程同樣不可或缺。 221