DSH 的插件生態日益擴大,但找到合適的插件往往需要跨越多個目錄。簡單的 GitHub 搜索容易混入通用倉庫或冷門項目,而僅靠名稱匹配又會遺漏已收錄但名稱不相關的優質插件。dsh-find-plugins 插件旨在爲 agent 提供一個工具,直接在本地通過聚合多源數據來解決這個問題。
插件簡介¶
該插件由 Eray114514 維護,採用 MIT 許可證。它爲 DSH agent 提供了一個名爲 find_dsh_plugins 的工具。該工具搜索整個 DSH 插件生態,並按 相關性 × 信任度 × 新鮮度 × 熱度 進行排序,而不僅僅是依賴 GitHub stars。
安裝與啓用¶
安裝前請確保環境滿足要求:
* Node.js 版本 >= 22
* DSH 已安裝 @deepseek-ai/dsh-tools(版本 >= 0.1.5-rc.2 或 >= 0.2.0-rc.1)
* 注意:dsh-tools 必須與宿主共享同一個實例(通過 peerDependencies 實現)。
安裝命令如下:
dsh plugin --profile <你的 profile> add dsh-find-plugins
安裝完成後,重啓 DSH 以激活 find_dsh_plugins 工具。
核心功能¶
- 全生態搜索:該工具檢索整個 DSH 插件生態,而非單一來源。
- 多維排名:結果按
相關性 × 信任度 × 新鮮度 × 熱度排序。這種機制避免了單純按 star 數排名帶來的噪音,也解決了僅靠字面名稱匹配導致的優質插件沉底問題。 - 七源聚合:數據來源於 7 個獨立源,包括:
- dsh.so
- dsh.works
- radar
- awesome-dsh-plugin
- 嵐叔目錄
- npm registry
- GitHub topics
- 運行時特性:
- 只讀操作:插件本身不執行安裝、卸載或啓停操作,也不修改 profile 或
cordis.patch.yml。 - 內存緩存:數據僅保存在內存中,不落盤,不擁有索引,避免緩存過期問題。
- 無模型調用:插件不進行模型調用,減少延遲和開銷。
- 只讀操作:插件本身不執行安裝、卸載或啓停操作,也不修改 profile 或
使用方法¶
安裝並重啓 DSH 後,agent 可以直接使用 find_dsh_plugins 工具。
使用時支持空格分隔的多個關鍵詞。例如:
find_dsh_plugins terminal memory
如果需要禁用加載時的預預熱(默認會在插件加載後 5 秒起後臺預熱一次),可以設置環境變量:
DSH_FIND_PLUGINS_NO_PREWARM=1
適用場景與注意事項¶
- 適用場景:需要在 DSH 生態中快速定位特定功能的插件,或希望獲取經過多源驗證的插件列表。
- 權限限制:該插件以當前 DSH 進程的權限運行,且爲只讀操作。在安裝任何插件前,建議閱讀其源碼與許可證。
- 依賴檢查:由於
dsh-tools必須共享實例,錯誤的依賴配置會導致服務激活失敗。