staff-os/dsh-workbench: DeepSeek Harness 企業級工作臺插件

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在開發和運行 DSH 時，往往需要同時管理 AI 員工、知識庫、技能、MCP 服務器以及插件本身。staff-os/dsh-workbench 提供了一個集中的工作臺，將這五個領域納入統一的管理界面。

這是什麼¶

這是一個 DeepSeek Harness 的企業級工作臺插件，由 staff-os 維護，採用 MIT 許可證。它不依賴外部後端或數據庫，所有狀態以本地文件形式存儲在 $DSH_HOME 目錄下，可獨立運行。

核心功能¶

該插件通過 ctx.tools 掛載點提供五個領域的工具：

技能管理
- 本地技能直接以目錄形式管理，每個目錄包含 SKILL.md。
- 支持從市場安裝技能，安裝後需重啓 DSH 才能生效。
- 提供安全掃描功能，基於正則規則和字符集檢測，防止潛在風險。
AI 員工
- 管理代理預設（Agent Presets），支持通過複製現有預設創建新員工。
- system 級信任的預設不可編輯或刪除。
- 知識庫綁定僅作爲聲明，不自動觸發檢索。
知識庫
- 支持本地分塊與 BM25 關鍵詞檢索，不依賴向量模型。
MCP 服務器
- 配置寫入當前 profile 的補丁文件中。
- 使用 import_json 接口，將環境變量引用（如 ${VAR}）轉換爲 JS 執行表達式（!!js process.env.VAR）。
- 配置更改需在下次 DSH 啓動後生效。
DSH 插件
- 將操作轉發至 dsh plugin CLI。
- 不涉及 pnpm 或直接修改 dsh.profile.bundles，通過列表判斷插件是否生效。

安裝與啓用¶

在終端中執行以下命令即可安裝：

dsh plugin --profile web add @staff-os/dsh-workbench

如果進行本地開發，可使用絕對路徑鏈接：

dsh plugin --profile web add link:/path/to/dsh-workbench

安裝完成後需重啓 DSH。

配置¶

插件通過環境變量和補丁文件進行配置。

環境變量¶

在 $DSH_HOME/.env 或調用 dsh 的同級目錄 .env 中配置：

DSH_PROFILE：指定 MCP 和插件管理的 profile，默認爲 web。
CLAWHUB_REGISTRY：ClawHub 兼容市場的根 URL，未設置則使用內置的公開端點。
CLAWHUB_API_KEY：市場憑證，僅作爲引用名稱，實際值由憑證服務或啓動環境解析，不會內聯寫入配置。

補丁層配置¶

編輯 profile 自身的補丁文件 $DSH_HOME/profiles/<name>/cordis.patch.yml。配置項需完全重寫（非深度合併）：

- id: workbench
  config:
    profile: web
    dshHome: ''
    registries:
      - id: skillhub
        name: Intranet skills
        url: http://10.0.14.55
        flavor: clawhub
        apiKeyEnv: SKILLHUB_REGISTRY_API_KEY
    registryTimeoutMs: 15000
    toolTimeoutMs: 20000
    networkToolTimeoutMs: 120000
    dshExecutable: dsh
    pluginToolTimeoutMs: 300000

flavor 選項決定市場接口風格：clawhub（默認）或 skillhub。

市場源管理¶

技能市場源可在 UI 中增刪，配置寫入 $DSH_HOME/workbench/market.json，實時生效。

運行與注意¶

環境要求：需要 Node.js ^22.19.0 || >=24.0.0。
破壞性操作：刪除或覆蓋等操作需在工具參數中顯式設置 confirm: true，否則操作會被拒絕。
狀態同步：技能寫入後立即同步，MCP 服務器變更需重啓。

適用場景¶

該插件適合需要在 DeepSeek Harness 中統一管理 AI 員工、知識庫、技能、MCP 服務器及插件的用戶。它提供了從 CLI 到 UI 的完整管理閉環，所有數據均爲本地狀態。

參考資料¶

插件目錄：https://www.skillhub.cn/plugins/staff-os/dsh-workbench
源代碼：https://github.com/staff-os/dsh-workbench