dsh-plugin-studio:DSH Web 設置頁的插件管理與插件市場

前言

DSH 的理念是“一切皆插件”。在 web profile 下,插件安裝、啓停、卸載和查找新插件通常要從命令行或配置入手。dsh-plugin-studio 把這部分入口放到 Web 設置頁:按官方/社區分組管理已安裝插件,並內置 GitHub 插件市場。

這是什麼

  • 包名:dsh-plugin-studio
  • 版本:0.3.1
  • 許可證:MIT
  • 倉庫路徑:fazhu4/dsh-plugin-studio
  • 說明:已抓取資料未提供顯式維護者字段,因此這裏不把它寫成確定維護者。

它面向 DSH 0.1.0 系列(web profile),解決“在 Web 設置頁裏查看已安裝插件、一鍵啓停、查看詳情、卸載社區插件,並從 GitHub 搜索安裝新插件”的問題。

插件管理

分組與搜索

插件管理頁按官方/社區分組展示已安裝插件,並支持搜索。

描述與詳情

內置 129 個包的中文/英文描述庫;未收錄的包回退英文 package.json 描述。詳情面板展示版本、主頁、倉庫、許可、README 摘要。

啓停與受保護行

一鍵啓停會寫入用戶補丁層 cordis.patch.yml,DSH 配置熱重載約 1-3 秒生效。熱加載與 Web 服務鏈上的核心插件屬於受保護行,禁止開關與卸載。

社區插件卸載

社區插件卸載走 pnpm remove,並同步 bundle 層;重啓服務後徹底移除。

插件市場

榜單與搜索

插件市場基於 GitHub,提供高收藏、增長最快榜單和搜索。

  • 高收藏按 GitHub dsh-plugin 話題全量排序,可能包含官方主倉庫,如 deepseek-ai/deepseek-harness。
  • 增長最快是近似口徑:近 90 天新建倉庫按 star 排序。
  • GitHub 搜索未帶 token 時受限流:10 次/分鐘,結果 60 秒緩存。
  • 倉庫根 package.json 探測或 npm 註冊表探測失敗時,卡片降級爲“GitHub 安裝”標籤。

一鍵添加並啓用

選擇插件後,一鍵添加並啓用會執行 npm 安裝到 profile,並自動同步 bundle 層;重啓服務生效。

安裝與啓用

要求

  • DSH 0.1.0 系列(web profile)
  • pnpm(dsh plugin 依賴)

安裝命令

從 npm 安裝已發佈包:

dsh plugin --profile web add dsh-plugin-studio@0.3.1

從本地倉庫安裝,推薦先構建:

dsh plugin --profile web add file:/path/to/dsh-plugin-studio

從 GitHub 安裝時,需使用實際倉庫路徑;示例使用佔位符:

dsh plugin --profile web add github:<your-name>/dsh-plugin-studio

啓用入口

安裝後重啓 dsh 服務,然後刷新頁面,進入:

1、設置
2、插件
3、插件管理 / 插件市場

典型用法

1、查看已安裝插件:在插件管理裏按官方/社區分組查看,搜索包名,打開詳情面板確認版本、主頁、倉庫、許可、README 摘要。
2、啓停插件:對可操作插件執行一鍵啓停;它寫入用戶補丁層 cordis.patch.yml,DSH 配置熱重載約 1-3 秒生效。受保護行會被硬攔截。
3、安裝新插件:在插件市場選擇榜單或搜索。看到卡片後,先確認倉庫與安裝方式;一鍵添加並啓用會 npm 安裝到 profile 並同步 bundle 層,重啓服務生效。
4、卸載社區插件:卸載走 pnpm remove 並同步 bundle 層;成功後立即從當前列表隱藏,重啓 dsh 服務後完成運行時移除。

適用場景與注意

適合在 DSH web profile 中維護多個插件,並希望在 Web 設置頁內完成查看、啓停、搜索和安裝的人。

注意:

  • 插件會以當前 dsh 進程權限運行;安裝前應檢查源碼與許可證。
  • 安裝/卸載等價於 CLI dsh plugin add/remove,pnpm 走完整 TLS 校驗。
  • 全部 HTTP 路由僅允許環回地址訪問。
  • 受保護行硬攔截開關與卸載。
  • 包名、運行時插件 ID、HTTP 路由和本地分組存儲文件統一使用 dsh-plugin-studio。

鏈接

  • 目錄頁:https://www.skillhub.cn/plugins/fazhu4/dsh-plugin-studio
  • GitHub:https://github.com/fazhu4/dsh-plugin-studio
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜