前言¶
DeepSeek Harness (DSH) 提供了一套完整的智能體開發能力,包括持久會話、模型適配、工具調用等。在 Cordis 插件體系中,直接引入這些能力通常需要手動處理生命週期和依賴注入。dsh-cordis 的作用是將 DSH 的編碼引擎作爲一個標準的 Cordis 插件打包,使其能掛載到調用者現有的 Loader 樹中,解決集成複雜度問題。
是什麼¶
dsh-cordis 是一個將 DeepSeek Harness 編碼引擎打包爲 Cordis 插件的包。
- 維護者:cordisplugins
- 核心價值:將 DSH 基礎組合掛載到調用者的現有 Loader 樹,提供開箱即用的 DSH 能力。
- 類型:客戶端
核心功能¶
該插件包含以下能力:
- 組合掛載:將 DSH 的基礎組合(包括原生代理、持久會話、模型適配器、工具、目標、計劃模式、批准和打包的代理預設)掛載到調用者的 Loader 樹。
- 原生服務:提供原生 DSH 服務提供者,而不是一個全局單例。
- 服務注入:允許調用者通過注入特定服務(如
sessions、agents或tools)來使用,而非直接導入實現。
安裝與啓用¶
使用 pnpm 安裝依賴:
pnpm add dsh-cordis @deepseek-ai/cordis@4.0.1
典型用法¶
在宿主機的配置文件中,使用一個穩定的 Loader 行來引入插件。telemetry 默認爲 false。
- id: dsh-engine
name: dsh-cordis
config:
telemetry: false
架構與注意事項¶
生命週期與歸屬¶
- 無獨立根:該插件不會構建另一個 Cordis 根。
- Fiber 擁有:其 Fiber 擁有包含的 DSH 樹。移除 Loader 條目會移除其活動服務,並讓消費者進入
PENDING狀態,直到另一個提供者可用。 - 依賴倒置:消費者請求
sessions、agents、tools等服務契約,不導入具體的 DSH 提供者。
責任劃分¶
- 宿主責任:
DSH_HOME、憑據、模型選擇、UI 以及 ACRYL 引擎選擇合同的配置由宿主負責。 - Telemetry:默認關閉。
侷限性¶
- 不提供 Pi 集成。
- 不提供引擎切換命令。
- 不提供跨引擎會話翻譯。
適用場景¶
適合需要在 Cordis 插件體系中複用 DSH 編碼引擎能力的開發者。它將 DSH 的複雜內部實現封裝在插件內部,對外暴露標準的 Cordis 服務接口,降低了宿主項目的集成成本。
目錄與鏈接¶
- 目錄頁:SkillHub 插件目錄
- GitHub:cordisplugins/dsh-cordis