前言¶
DSH 插件生态里，安装、启停和版本排查通常要组合命令行、仓库地址和配置文件。webkong/dsh-plugin-manager 把这一过程放入 Web 设置页：在 设置 → 插件 → 插件管理 中查看内置与第三方插件，执行安装、卸载、启用、停用，并跳转到第三方插件的 GitHub 仓库。
它属于 DSH 插件生态中的社区管理工具，不等价于官方应用商店。
这是什么¶
webkong/dsh-plugin-manager 由 webkong 维护，许可证为 MIT。它的一句话定位是：
DSH 插件管理器：在 Web 设置页列出内置/三方插件，支持安装、卸载、启动、停用，并直跳三方插件 GitHub 仓库。
默认情况下，它管理 web profile。Host 通过 webServer 前缀路由提供 HTTP API，已核实的路由前缀是：
/pmgr/*
该 API 仅限本机 loopback 访问。
核心功能¶
查看插件清单¶
插件管理页会列出插件清单，并展示以下信息：
- 插件状态
- 来源标签
- 版本
- GitHub 入口
它支持枚举：
130+
个内置插件，并识别 profile dependencies 中的第三方插件。
页面还支持：
- 状态 Tab
- 来源筛选
- 模糊搜索
- 分组折叠
安装与解析¶
支持以下安装源：
- npm 包名
github:owner/repo#main- 本地路径
- tarball URL
输入裸包名时，插件会尝试智能解析，并列出 npm 包或 GitHub 仓库候选。
它也支持按关键词搜索 GitHub：
topic:dsh-plugin
用于发现 DSH 插件生态中的插件。
启停与卸载¶
启用和停用不是简单的前端状态切换。它会向目标 profile 的 cordis.patch.yml 写入或移除：
disabled
标记，从而实现插件停用或启动。
卸载插件时，它还会清理残留的停用条目。
自动化与界面¶
支持可选的自动重启：
dsh web
重启后会倒计时刷新页面。该开关默认关闭。
它支持：
GH_TOKEN
自动发现。
界面提供中文与英文，并跟随 DSH 语言偏好切换。
安装与启用¶
从 GitHub 安装时，执行：
dsh plugin --profile web add github:webkong/dsh-plugin-manager#main
本地路径安装，适合开发场景：
dsh plugin --profile web add /path/to/dsh-plugin-manager
安装后，重启：
dsh web
然后进入：
设置 → 插件 → 插件管理
如果需要在装载行指定管理的 profile，可配置：
profile: web
自动重启开关可在页面上切换，配置持久化到：
~/.dsh/dsh-plugin-manager.json
典型用法¶
从 GitHub 安装插件¶
在插件管理页执行安装时，可以使用：
github:owner/repo#main
这种安装源形式。
例如安装本插件：
dsh plugin --profile web add github:webkong/dsh-plugin-manager#main
使用裸包名解析¶
输入裸包名后，插件会尝试解析该名称，并列出 npm 包或 GitHub 仓库候选。
确认候选后，再执行安装。
搜索 GitHub 插件¶
使用关键词搜索 GitHub 上的 DSH 插件：
topic:dsh-plugin
适合在已有安装源之外查找可用插件。
直接打开仓库¶
点插件卡片上的版本号入口，可直接跳转到对应仓库，用于查看文档、star 和代码。
版本兼容¶
已核实的兼容关系如下：
插件 0.6.x：兼容 dsh ≥ 0.1.1-rc.2
已验证 dsh 0.1.1-rc.2 与 0.1.2-alpha.1
插件 ≤0.5.x：兼容 dsh ≤ 0.1.1-rc.x
dsh ≥ 0.1.2 上，旧版 client 可能因 dsh-client-runtime 不存在而无法加载
如果当前 DSH 版本较新，优先确认插件版本与 DSH 版本匹配。
适用场景与注意¶
适合以下场景：
- 希望在 Web 设置页集中管理 DSH 插件
- 需要查看插件状态、来源、版本和 GitHub 入口
- 需要在安装、卸载、启用、停用之间切换插件
- 希望减少命令行和手工配置之间的来回切换
使用前注意：
- 插件以当前 DSH 进程权限运行
- 安装前应检查源码与许可证
- 安装、卸载、停用、启动均在重启后生效
- 若当前进程 HMR 已激活，停用/启动可能即时生效
自动重启默认关闭，可按需在页面打开。
链接¶
GitHub 仓库：
https://github.com/webkong/dsh-plugin-manager
