前言¶

在使用 DSH 構建應用時，管理插件生態往往需要在不同網站間切換，手動複製倉庫地址，並在客戶端界面中填寫安裝信息。dsh-plugin-top 是一個側邊欄插件，旨在解決這一痛點。它將插件目錄、榜單搜索和一鍵安裝流程集成在瀏覽器側邊欄中，由維護者 yhbd-top 開發。

功能介紹¶

該插件在瀏覽器側邊欄提供了一套完整的插件瀏覽與安裝入口：

1. 側邊欄入口
   安裝後，瀏覽器側邊欄底部會出現 plugin_top 按鈕。寬欄顯示完整名稱，窄欄僅顯示圖標。

2. 大面板與榜單
   點擊按鈕打開大面板（最大 880×700）。面板包含頂層“全部”（3900+ 插件全集）以及五個榜單：原生星榜、飆升、今日新秀、兼容工具、分類冠軍。

3. 聯動過濾與搜索
   分類條會隨榜單聯動。切到不同榜單時，分類僅統計該榜內的插件分佈。點擊分類可在當前榜單內進行過濾。同時支持本地即時搜索，可疊加關鍵詞、倉庫名或分類進行篩選。

4. 一鍵安裝
   面板內每行右側有“安裝 ->”按鈕。點擊後會依次執行：複製 GitHub 倉庫地址到剪貼板、打開客戶端自帶的“插件”頁、自動填充“添加插件”的輸入框並觸發安裝流程。

5. Agent 工具
   在對話中可直接調用 Agent 工具進行插件檢索與趨勢查看。

安裝與啓用¶

通過官方命令行安裝：

dsh plugin --profile web add github:yhbd-top/dsh-plugin-top

安裝完成後，必須重啓 DSH 進程並硬刷新頁面，側邊欄纔會出現 plugin_top 按鈕。

Agent 工具調用¶

插件爲 Agent 提供了兩個工具接口：

• plugin_top_search：按關鍵詞、分類或星數搜索插件，返回簡介、安裝命令及詳情頁鏈接。
• plugin_top_trending：獲取當日新入庫、近期飆升或原生總星榜的插件列表。

注意事項¶

1. 環境要求：Node.js 版本需 >= 18.17.0。
2. 重啓與刷新：安裝後務必重啓 DSH 並執行硬刷新。
3. 數據源與隱私：插件內置反向代理拉取數據，無需用戶配置 CORS。瀏覽器端數據緩存於 sessionStorage（6h），無上傳或遙測行爲。
4. 配置覆蓋：Agent 側可通過 cordis.patch.yml 覆蓋 baseUrl、cacheTtlHours 和 timeoutMs。

結尾¶

dsh-plugin-top 將目錄瀏覽與客戶端安裝流程打通，適合需要頻繁查找和安裝 DSH 插件的開發者。更多細節可訪問 GitHub 或 目錄頁。