前言¶

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。隨着插件數量增多，在 Web 界面中查看插件狀態、分類和元數據變得繁瑣。傳統的插件列表往往依賴靜態數據文件，更新滯後且維護成本高。

下面介紹 dsh-plugin-live-catalog。這是一個只讀插件目錄插件，它直接讀取當前 Loader 和插件包的元數據，在 DSH Web 設置中按來源和模塊類別進行分組展示。

插件定位¶

該插件由 vivi77-max 維護，類別爲客戶端。它不修改 DeepSeek Harness 源碼，零依賴，旨在提供實時的插件清單視圖，替代或增強原有的靜態列表功能。

實時讀取與緩存：插件清單實時讀取，不生成靜態插件分類數據文件。插件啓停狀態每次讀取；包描述和類別按 package.json 修改時間緩存，文件未變化時不重複讀取，修改後下次打開自動更新。
來源分類：將插件來源分爲三類：
- 官方內置：模塊名以 @deepseek-ai/ 或 cordis: 開頭。
- 我的插件：包名符合 dsh-plugin-* 或 @scope/dsh-plugin-*。
- 未知：其他模塊。
模塊類別：將插件按九個固定類別分組：
- 核心與啓動、會話、模型與憑證、執行環境、智能體能力、交互與權限、宿主與傳輸、瀏覽器 UI、工作區。
界面交互：每類默認展示四個插件，其餘可展開。支持搜索、篩選、啓停統計、類別數量展示及卡片詳情。

使用官方 CLI 安裝：

dsh plugin --profile web add github:vivi77-max/dsh-plugin-live-catalog

安裝完成後，啓動或重啓 DSH Web。進入「設置 → Plugins → 插件目錄」，該插件會替換內置的「插件列表」頁籤，但保留「插件配置」功能。

分類的順序和映射統一配置在 lib/categories.js 中。數組順序即爲界面順序。修改該文件後，服務端歸類和前端顯示會同時更新。

在個人插件的 package.json 中，使用 dsh.category 字段指定分類。該字段的值應與 lib/categories.js 中的 key 對應。

目錄僅展示 Loader 中的配置條目。若要保留舊插件但不運行，應在 Profile Patch 中插入該插件配置並設爲 disabled: true，不要刪除其配置條目。

DSH 社區目錄與 DeepSeek / 幻方無官方從屬關係，本插件同樣屬於社區項目。