前言¶
在 DSH 的插件化思路下，社區插件通常分散在不同倉庫。dsh-plugin-index 提供的是一個社區插件索引：按 GitHub 星標瀏覽帶 dsh-plugin topic 的倉庫，並在 web profile 中完成安裝、更新、修復、卸載。它解決的是“從哪找、怎麼裝、後續怎麼維護”的問題。
這是什麼¶
dsh-plugin-index 由 GGigHub 維護，許可證爲 MIT。它面向 DSH web profile，把帶 dsh-plugin topic 的 GitHub 倉庫整理成可瀏覽的市場列表，並提供插件生命週期操作。
核心功能¶
- 按 GitHub 星標降序瀏覽帶
dsh-plugintopic 的倉庫。 - 在
web profile中安裝、更新、修復、卸載插件。 - 市場與已安裝插件按功能打多標籤分類。
- 在已加載目錄上按倉庫名、描述、
spec、分類做本地過濾搜索。 - 點擊分類芯片可查看含該標籤的列表。
- 刷新會重新請求 GitHub，繞過 15 分鐘緩存。
- 安裝隊列串行執行，可查看狀態、耗時與日誌。
- 對“未入 bundles”或已知需裝子目錄的插件，提供安裝說明 / 複製安裝命令。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add github:GGigHub/dsh-plugin-index
安裝後重啓 DSH，打開左側欄「插件」。
卸載本包：
dsh plugin --profile web remove @dsh-external/dsh-plugin-index
然後重啓 DSH。
倉庫已帶構建好的 lib/，安裝不需要 prepare 或 pnpm allowBuilds。
典型用法¶
- 首屏會先返回第 1 頁或本地緩存，後臺補全後自動更新。
- 在列表中按星標瀏覽；點擊分類芯片，查看含該標籤的插件。
- 輸入關鍵詞後，只在已加載目錄上做本地過濾，搜索範圍包括倉庫名、描述、
spec、分類；清空輸入回到全量列表。 - 點擊刷新時重新請求 GitHub，繞過 15 分鐘緩存；搜索關鍵詞不參與服務端過濾。
- 點擊安裝前會看到“未審計”風險確認。安裝進入隊列串行執行，可查看狀態、耗時與日誌。
- 裝、更、修、卸成功後都要重啓 DSH。
適用場景與注意¶
適合在 DSH web profile 中查找社區插件，並希望用統一入口做安裝、更新、修復、卸載的使用者。
使用前注意：
- 本項目只作只讀分發，不接受 Pull Request 與 Issue。
- 社區倉庫索引中的插件均未檢查木馬、病毒或惡意代碼，點擊安裝前有“未審計”風險確認。
- 一鍵安裝不會替用戶做安全審計；建議先
clone倉庫、審查源碼，再決定是否安裝。 - 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 - 市場安裝只接受
github:owner/repo，安裝的是倉庫根目錄；已知需裝子目錄的倉庫會禁用市場「安裝」，需走手動流程。 - 當插件顯示“未入 bundles”或已知需裝子目錄時，可使用安裝說明 / 複製安裝命令。
支持的環境變量：
GITHUB_TOKEN / GH_TOKEN
DSH_HTTPS_PROXY / DSH_HTTP_PROXY
DSH_HOME
DSH_PROFILE
DSH_CHECKOUT
結尾¶
dsh-plugin-index 把社區插件的查找和生命週期管理放進 DSH 的 web profile：從 GitHub dsh-plugin topic 瀏覽，到安裝、更新、修復、卸載。倉庫地址：
- https://github.com/GGigHub/dsh-plugin-index
目錄頁 URL 未在已覈實資料中給出，本文不提供；安裝後從左側欄「插件」進入。
