前言¶
DeepSeek Harness（DSH）開發者常面臨多環境管理的難題：官方運行時、團隊定製運行時、開發 Fork 以及不同 Agent Preset 往往混雜在一起，導致配置文件和會話數據難以區分，容易產生環境混淆。dsh-control-plane 是爲此設計的本地優先開發者控制平面。
這是什麼¶
這是一個由 Harzva 維護的插件，旨在爲 DSH 提供一個穩定的核心，用於組合、檢查和管理多個運行時、配置、會話和知識引用。它並不替代 DSH 本身，而是提供一個控制平面核心和一個版本化的 DSH Bundle，可以在 DSH 內部呈現這個控制平面。
核心功能¶
下面介紹該插件的主要能力：
- 多運行時註冊與管理：支持註冊官方、定製、開發和自定義 DSH 運行時。
- 安全檢查：可以在不復制私有配置的情況下檢查 Profile 和 Preset 引用。
- 運行時操作：通過允許列表的適配器，對運行時進行啓動、停止和健康檢查。
- 會話關聯：將 Sessions 連接到計劃、工件和知識引用。
- 集成面板：提供加法式的 DSH Host/Client 集成面板。
- Web 可視化：在 DSH Web 中顯示只讀的 Runtime Catalog、Session Board、Plan Panel、Artifact Board 和 Knowledge Reference 投影。
- 場景適配器：使用和擴展可替換的場景適配器，包括一個 interview-learning 示例。
- 發佈前驗證：在發佈前，使用隔離的 DSH Profile 驗證發佈版本。
架構與集成¶
當前該插件的開發目標是 DSH 0.1.0-rc.8。根包提供一個 dsh.bundle 補丁層、一個嚴格的 ./typert Host 清單和一個預置的 ./client Bundle。內部源模塊被組合成這個可安裝的包，確保 tarball 不依賴同級的 file: 包。Web 面板使用加法式設置插槽和本地失敗邊界。
需要明確的是：
* Web 面板是隻讀投影。
* 運行時啓動/停止和健康檢查的行爲保留在源 Runtime Manager API 中。
* Stage 4 橋接僅解析有界元數據和不可變引用，它不讀取或上傳文檔內容。
開發與構建¶
該倉庫已完成 Stage 7，發佈了第一個公共版本 v0.1.0。如果你需要構建或驗證候選版本，可以使用以下命令：
pnpm install --frozen-lockfile
pnpm run build:dsh
pnpm run check
pnpm run pack:dsh
pnpm run verify:release-candidate
安全與內容¶
這是一個公開倉庫，包含了公共模式、適配器、示例、測試和文檔。它不包含憑據、原始聊天、真實會話、私有知識、私有機器路徑或生產 DSH 配置。
- 機器本地值應放在被忽略的
agentworkos.local.toml中。 - 公共示例使用佔位符和合成標識符。
注意事項¶
- 環境限制：開發人員應使用隔離的 DSH Profile 進行運行時檢查，不要將此目錄或本地配置的 Profile 安裝到生產工作區中。
- 提交狀態：目前提交到
awesome-dsh-plugin是下一個階段，尚未聲明已被合併或接受。
結尾¶
dsh-control-plane 爲 DSH 開發者提供了一種在本地管理多環境、多配置的解耦方案，通過只讀投影和隔離驗證，降低了環境管理的複雜度和風險。
