DSH (DeepSeek Harness) 採用“一切皆插件”的理念,但在原生設計中並不包含“專家”或“專家組”的概念。社區維護了一個名爲“Awesome DSH Experts”的目錄,但目錄本身與 Web UI 相分離。下面介紹 dsh-experts,這是一個樹外插件,旨在將這個社區目錄帶入 DeepSeek Harness 的 Web UI 中,無需對 deepseek-harness 源碼進行任何修改。
核心功能¶
該插件通過註冊到 settings.section 槽位,在 Web UI 的設置頁面提供了一個“專家市場”選項卡,並提供了可選的聊天輸入欄入口。
-
設置選項卡瀏覽與複製
在 Web UI 的設置頁面中打開“專家市場”選項卡。這裏可以瀏覽專家和專家組,按類別或類型篩選,查看詳情,並點擊“Add to chat”按鈕,將準備好的@expert <id>調用塊複製到剪貼板。 -
作曲家入口
這是一個可選功能,旨在將已安裝的專家組注入到聊天輸入框中。點擊按鈕會彈出一個選擇器,允許選擇並複製專家組的調用塊。該入口註冊在DSH_EXPERT_MARKETPLACE_COMPOSER_SLOT配置項指定的槽位上。 -
HTTP API
插件提供了一個同源 HTTP API (POST /api/expert-marketplace),支持bootstrap、list、detail、groups、refresh、packs和packDetail等方法,用於程序化瀏覽目錄。 -
Agent 工具
插件註冊了expert_list和expert_detail工具,供 Agent 使用。這些工具的可用性取決於@deepseek-ai/dsh-tools包是否存在。
安裝與啓用¶
安裝插件需要使用 Web 配置文件,並確保 DSH 版本滿足要求。
dsh plugin --profile web add https://github.com/fuchao2pku/dsh-experts.git
安裝完成後,需要重啓 Web 配置文件以加載插件:
dsh --profile web web
典型用法¶
安裝並重啓 Web 配置文件後,操作步驟如下:
- 打開 Settings(設置)頁面,進入 Expert Marketplace(專家市場)選項卡。
- 在列表中搜索或按分類/類型過濾專家或專家組。
- 點擊某個條目打開詳情,然後點擊 Add to chat 按鈕。
- 將複製到剪貼板的
@expert <id>代碼塊粘貼到聊天輸入框中。
示例:在聊天輸入框中粘貼 @software-team,隨後輸入功能需求,即可在對話中調用包含產品經理、架構師、工程師和 QA 的多角色軟件團隊。
配置與兼容性¶
該插件依賴 DSH 0.1.0-rc.6 版本及 Web 配置文件 (dsh.client.platform: "web")。在舊版本中,作曲家入口會靜默降級,Settings 選項卡仍可正常工作。
所有配置項均可通過 cordis.patch.yml 或環境變量覆蓋,默認值如下:
| 配置項 | 環境變量覆蓋 | 默認值 |
|---|---|---|
catalogUrl |
DSH_EXPERT_MARKETPLACE_CATALOG_URL |
發佈的 catalog.json (來自配套倉庫 awesome-dsh-experts) |
maxAgeMs |
- | 172800000 (48小時) |
timeoutMs |
- | 15000 (15秒) |
maxBytes |
- | 5000000 (5MB) |
composerSlot |
DSH_EXPERT_MARKETPLACE_COMPOSER_SLOT |
composer.toolbar (設置爲空字符串可禁用) |
composerIntegration |
- | true |
agentTools |
- | true |
安全與數據來源¶
- 網絡行爲:瀏覽器端不會直接聯繫 GitHub。插件的主機進程(Node)會從指定的
catalogUrl(默認爲 SkillHub 上的目錄)獲取預構建的catalog.json。瀏覽器僅調用同源 API (/api/expert-marketplace)。 - 數據存儲:目錄數據緩存在內存中,系統臨時目錄 (
<tmpdir>/dsh-experts/catalog.json) 作爲輔助緩存,且包含一個內置的catalog-seed.json作爲離線備用源。不讀寫個人文件。 - 信任與驗證:遠程目錄被視爲不受信任的輸入,所有條目均經過架構驗證,且不執行代碼,僅在 UI 中展示可讀文本和可複製的調用塊提示。
- 權限:插件以當前 DSH 進程的權限運行,安裝前應檢查源碼與許可證。
注意事項¶
- 版本要求:必須使用 DSH 0.1.0-rc.6 及以上版本。
- 靜默降級:Composer 入口在較舊的 DSH 版本中會靜默失效,Settings 選項卡是始終可用的核心功能。
- 無機密傳輸:插件不包含任何憑證,不向外部傳輸用戶數據。