dsh-experts:DeepSeek Harness 專家目錄插件

DSH (DeepSeek Harness) 採用“一切皆插件”的理念,但在原生設計中並不包含“專家”或“專家組”的概念。社區維護了一個名爲“Awesome DSH Experts”的目錄,但目錄本身與 Web UI 相分離。下面介紹 dsh-experts,這是一個樹外插件,旨在將這個社區目錄帶入 DeepSeek Harness 的 Web UI 中,無需對 deepseek-harness 源碼進行任何修改。

核心功能

該插件通過註冊到 settings.section 槽位,在 Web UI 的設置頁面提供了一個“專家市場”選項卡,並提供了可選的聊天輸入欄入口。

  1. 設置選項卡瀏覽與複製
    在 Web UI 的設置頁面中打開“專家市場”選項卡。這裏可以瀏覽專家和專家組,按類別或類型篩選,查看詳情,並點擊“Add to chat”按鈕,將準備好的 @expert <id> 調用塊複製到剪貼板。

  2. 作曲家入口
    這是一個可選功能,旨在將已安裝的專家組注入到聊天輸入框中。點擊按鈕會彈出一個選擇器,允許選擇並複製專家組的調用塊。該入口註冊在 DSH_EXPERT_MARKETPLACE_COMPOSER_SLOT 配置項指定的槽位上。

  3. HTTP API
    插件提供了一個同源 HTTP API (POST /api/expert-marketplace),支持 bootstrap、list、detail、groups、refresh、packs 和 packDetail 等方法,用於程序化瀏覽目錄。

  4. 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 配置文件後,操作步驟如下:

  1. 打開 Settings(設置)頁面,進入 Expert Marketplace(專家市場)選項卡。
  2. 在列表中搜索或按分類/類型過濾專家或專家組。
  3. 點擊某個條目打開詳情,然後點擊 Add to chat 按鈕。
  4. 將複製到剪貼板的 @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

安全與數據來源

  1. 網絡行爲:瀏覽器端不會直接聯繫 GitHub。插件的主機進程(Node)會從指定的 catalogUrl(默認爲 SkillHub 上的目錄)獲取預構建的 catalog.json。瀏覽器僅調用同源 API (/api/expert-marketplace)。
  2. 數據存儲:目錄數據緩存在內存中,系統臨時目錄 (<tmpdir>/dsh-experts/catalog.json) 作爲輔助緩存,且包含一個內置的 catalog-seed.json 作爲離線備用源。不讀寫個人文件。
  3. 信任與驗證:遠程目錄被視爲不受信任的輸入,所有條目均經過架構驗證,且不執行代碼,僅在 UI 中展示可讀文本和可複製的調用塊提示。
  4. 權限:插件以當前 DSH 進程的權限運行,安裝前應檢查源碼與許可證。

注意事項

  • 版本要求:必須使用 DSH 0.1.0-rc.6 及以上版本。
  • 靜默降級:Composer 入口在較舊的 DSH 版本中會靜默失效,Settings 選項卡是始終可用的核心功能。
  • 無機密傳輸:插件不包含任何憑證,不向外部傳輸用戶數據。
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜