DeepSeek Harness · 一切皆外掛

外掛提供全部 Agent 能力 Cordis 只管理載入與相依性

DeepSeek Harness 把「能做什麼」做成可插拔模組:模型適配、工具、技能、會話、沙箱、儲存、迴圈、排程和 UI 都是外掛。先用 DeepSeek 網頁版與 DeepSeek-V4 對齊需求,再在 Harness 設定裡替換對應外掛。

核心

Cordis

載入 / 卸載 / 相依性

能力

全是外掛

含模型與 UI

設定

自由組合

不必改原始碼

生態

dsh-plugin

GitHub topic 發現

外掛涵蓋的能力面

從模型到 UI,DeepSeek Harness 沒有特權核心功能

官方表述:所有 Agent 能力均由外掛提供。這意味著 DeepSeek-V4 適配、工具集甚至介面,都可以被替換或擴充。

模型外掛

模型是 Agent 的靈魂,但在 Harness 裡也是外掛。你可以按設定切換適配器,把 DeepSeek-V4 或其他提供方接到同一套工具與會話日誌上。

DeepSeek-V4 模型外掛

工具與技能

檔案編輯、Shell、檢索、Skills 等以外掛註冊到工具表。標準模式給出完整組合,極簡模式可裁到 bash + 編輯器以便評測。

DeepSeek Harness 工具

會話與 Trajectory

會話日誌僅附加:系統提示、思維鏈、工具結果、子 Agent 排程與上下文注入同源可回放,便於除錯「模型到底看見了什麼」。

DeepSeek 會話日誌

沙箱與儲存

沙箱、檔案系統與持久化同樣是外掛。替換沙箱策略時不必改 Agent 迴圈,只需在設定層切換實作。

DeepSeek Harness 沙箱

迴圈、排程與子 Agent

Agent 迴圈、任務排程與子代理編排可組合。PTC / Code 模式進一步讓模型用 TypeScript 程式串聯多步工具。

DeepSeek Agent 迴圈

UI 也是外掛

Web UI 並非不可替換的外殼。dsh web 拉起瀏覽器介面,本身也在外掛樹中,可按 profile(如 web / headless)疊加不同套件。

DeepSeek Harness Web UI
執行階段如何疊起來

一次 dsh 啟動 = 有序外掛樹

官方架構把執行中的 dsh 描述為啟動時由多層設定組成的外掛樹。理解分層,有助於你擴充而不是 fork。

01

Profile 設定

Profile 是命名組合:列出疊加的 bundle、樹外外掛以及使用者自己的 cordis.patch.yml。web 與 headless 以範本形式提供。

02

dsh-base

幾乎每個 profile 的第一層:模型適配、工具、持久化、沙箱與核准策略、設定、憑證、遙測等基礎能力。

03

dsh-web-app / headless

web-app 疊加瀏覽器應用;headless 疊加無伺服器的一次性執行器。同一套外掛哲學,不同交付形態。

04

社群外掛

用 dsh-plugin topic 讓外掛可被檢索。預覽階段 API 會變,外掛作者應按官方開發指南與 Discussions 跟進。

為什麼這套設計重要

開源可檢查,外掛可改造

授權讓程式碼可稽核;Cordis 讓執行階段可重組。這對 DeepSeek Agent 開發者意味著更低的 fork 成本。

01

用 inject 表達相依性

外掛透過 inject 宣告所需服務(如 tools、llm),Cordis 在服務就緒後再啟動消費者。載入順序由相依性決定,而不是 YAML 行號。

02

可逆副作用

監聽器、工具註冊與計時器隨外掛卸載自動清理。需要明確釋放的資源用 effect 登記 disposer,避免熱替換後洩漏。

03

先對話,再改外掛

不確定要換模型還是換工具時,先在 DeepSeek 網頁版用 DeepSeek-V4 把任務邊界問清楚,再回到 Harness 改設定,避免盲目改外掛。

外掛組合之前,先用 DeepSeek 網頁版對齊目標

DeepSeek-V4 幫你把任務說清楚;Harness 外掛負責把能力接進真實環境。

外掛 FAQ

寫 DeepSeek Harness 外掛前要知道的事

結合官方文件口徑:外掛形態、設定組合,以及和 DeepSeek 網頁版的分工。

01 外掛長什麼樣?

常見形態是匯出 apply(ctx) 的 TypeScript 模組;也可以是帶 apply 的物件,或提供服務的 Service 子類別。框架載入時把共享上下文 ctx 傳入。

02 如何把外掛掛進執行階段?

在 cordis.yml / overlay / patch 中登記模組路徑或套件名稱。官方教學強調外掛路徑在部分場景需絕對路徑,並以 profile 疊加而不是改核心套件。

03 UI 真的能換掉嗎?

官方把 UI 列為與模型、工具同級的外掛能力。你可以在設定層選擇或擴充介面,而不必修改 DeepSeek Harness 原始碼。

04 和直接用 DeepSeek 網頁版衝突嗎?

不衝突。網頁版適合快速對話與 DeepSeek-V4 推理;外掛適合把驗證過的流程固化成工具鏈。本站 CTA 會先帶你進入網頁版對話。

05 預覽版外掛會不會經常壞?

會有破壞性變更,這是官方大寫警告。把外掛當作可演進實驗,關注 Discussions,不要假設 API 長期穩定。

06 在哪裡看架構細節?

官方儲存庫 docs/architecture.md、Cordis primer 與開發指南。本頁是面向檢索與產品理解的介紹,不替代上游文件。

從對話到可插拔 Agent

需要本機工具與沙箱時再啟用 dsh;現在可以先進入 DeepSeek 網頁版。