前言¶
DeepSeek Harness (DSH) 的功能擴展主要依賴社區插件。開發者需要從外部目錄瀏覽、驗證並管理這些插件。@czj-git/dsh-plugin-hub 是一個插件，它將 DSH Plugin Hub 的社區插件目錄集成到 Harness 內部，提供搜索、兼容性檢查和安裝管理功能。
插件介紹¶
本插件隸屬於 @czj-git/dsh-plugin-hub，由 czj-git 維護。它是一個聯網工具，用於搜索和排序 DSH Plugin Hub 上已驗證的社區插件。通過它，你可以在不離開 Harness 界面的情況下，查看插件市場、已安裝列表、排行榜和任務中心。
安裝與前置條件¶
安裝前請確保環境滿足以下條件：
- 已安裝 DeepSeek Harness。
- Node.js 版本爲
^22.19.0 || >=24.0.0。
設置頁需要 Web profile 的客戶端擴展支持。在終端執行以下命令安裝到 Web profile：
dsh plugin --profile web add @czj-git/dsh-plugin-hub
安裝完成後，重新啓動 Harness 並刷新頁面。
核心功能¶
該插件主要提供兩類使用方式：設置頁管理和對話工具調用。
設置頁管理¶
在 Harness 的設置中，左側會出現「插件中心」，包含四個標籤頁：
- 插件市場：按關鍵詞、分類和分頁瀏覽插件。卡片展示插件名、作者、簡介、驗證狀態、分類、Stars、瀏覽量、安裝來源和主要語言。主按鈕根據兼容性和本機狀態顯示「安裝」、「更新」、「已安裝」或「不兼容」。點擊「查看安裝計劃」可審閱兼容性。
- 已安裝：讀取當前 profile 的本機清單，包括依賴聲明、實際安裝版本、來源、bundle 狀態、目錄版本，以及啓用狀態。支持單項或批量更新和卸載。
- 排行榜：切換日增長、Star 總榜、最新上架或最近活躍榜單。支持分類篩選和分頁。
- 任務中心：跟蹤當前 profile 的生命週期隊列，包括排隊、校驗、執行、覈對與最終狀態。支持取消、重試、脫敏日誌和重啓提示。
對話工具¶
在對話中，Agent 可調用以下工具：
dsh_plugin_search：搜索插件，支持按分類、運行形態、安裝來源、排序和分頁篩選。dsh_plugin_rankings：查詢指定榜單。dsh_plugin_installed：查詢本機已聲明的插件信息（包名、版本、來源、啓用狀態）。dsh_plugin_task_status：查詢本機安裝、更新與卸載任務的狀態、失敗原因和重啓要求。
技術細節¶
插件會校驗公網 API 的每個返回字段，並暴露分頁、數據更新時間和匿名限流信息。它支持 Harness 取消信號、可配置超時和 429 重試信息。Native 模式返回緊湊文本，PTC 模式返回完整結構化結果。
使用示例¶
在對話中搜索¶
你可以直接在對話中下達指令，讓 Agent 搜索插件：
用 DSH Plugin Hub 搜索 memory 相關插件，選出最多 5 個，用中文說明用途，並給出安裝命令和詳情鏈接。
查看本機狀態：
用 DSH Plugin Hub 查看當前 profile 的已安裝插件和最近任務，告訴我哪些已生效、哪些還需要重啓。
在設置頁操作¶
- 打開「設置」 -> 「插件中心」。
- 在「插件市場」中輸入關鍵詞，如 “memory”。
- 瀏覽列表，點擊插件的詳情鏈接或「安裝」按鈕。
- 在確認面板中審閱計劃，確認後創建安裝任務。
- 在「任務中心」中跟蹤執行結果。
注意事項¶
- 環境要求：必須安裝 DeepSeek Harness 和 Node.js
^22.19.0 || >=24.0.0。設置頁僅在 Web profile 環境下可用。 - 安裝流程：安裝需要用戶在設置頁審閱並確認結構化計劃，點擊不會立即執行修改。
- API 訪問：公網目錄訪問不需要 API Key。對話搜索工具需要 Harness 已配置可用的模型。
- 返回模式：對話工具在 Native 模式下返回緊湊文本，PTC 模式返回完整結構化結果。
- 瀏覽器限制：瀏覽器不能直接請求跨域公網 API，所有請求通過插件代理處理。
- 版本依賴：中轉頁需要本插件 0.4.0 或更新版本。
總結¶
@czj-git/dsh-plugin-hub 將 DSH Plugin Hub 的社區生態整合進 Harness 的本地環境。它通過設置頁和對話工具兩種方式，爲開發者提供了插件發現、兼容性檢查、安裝管理和任務跟蹤的一站式解決方案。
