onlyforchris/dsh-plugin-manager

README 摘要

DSH Plugin Manager DSH 插件管家 ：验证过的插件推荐 + 页内安装/升级/卸载与结构体检。 Native DSH plugin discovery, first-use & lifecycle manager : verified recommendations, in-page install / update / remove and structural health checks. DSH 的插件发现与生命周期管理入口：推荐插件、页内安装/升级/卸载、结构体检，以及操作进度与重启确认。自 0.8.0 起，插件操作显示实时进度（阶段与日志），完成后明确提示「需要重启 DSH 才能生效」，支持立即重启或稍后重启（横幅持续提醒）。 使用 安装后运行 dsh web ，进入 设置 → 插件 → 插件推荐 。 页面分为： - 推荐插件：来自受控远程目录，展示用途、兼容范围、验证状态和推荐理由。 - 已安装插件：展示版本、更新状态和结构健康，可升级或卸载。 - 高级安装：手动安装可信的 npm 固定版本、GitHub 仓库或本地 .tgz。 - 关于与环境自检：管家自身和 DSH 运行状态。 第一次成功使用 推荐卡不仅告诉用户“装什么”，还要解释“为什么推荐”和“第一次怎么用”。安装/升级会显示实时进度（阶段：解析依赖 → 下载 → 安装 → 完成，附最近日志）。完成后如果新版本需要重启才能生效，页面会明确提示「操作完成，需要重启 DSH 才能生效」，并提供两个选择： - 立即重启 ：管家安全退出并按原启动参数拉起 DSH，页面等待服务恢复后自动刷新； - 稍后重启 ：插件页顶部保留黄色横幅提醒（刷新后仍在），直到重启完成。 只有自动重启不可用时才显示命令行兜底。回到推荐卡后，可直接打开真实存在的设置入口，或复制一段可立即试用的示例提示。 远程目录中的 firstUse 负责提供 1–5 个首次使用步骤； launch 仅允许打开已注册的设置入口或复制示例提示，不允许目录下发任意 URL、脚本或 Shell 命令。 推荐策略 推荐不是 npm 搜索结果。条目必须说明维护者、源码、许可证、DSH 兼容范围、验证日期、权限和推荐理由。 验证状态： - verified ：完成标准 CLI 安装、DSH 启动和结构体检。 - community ：来源明确，尚未完成当前版本实机验证。 - experimental ：功能或兼容性仍处于实验阶段。 “已验证”只代表兼容性验证，不代表漏洞或供应链安全认证。 远程目录 目录文件位于 registry/plugins.json，默认从 GitHub Raw 获取， GitHub Raw 不可达时自动回退 jsDelivr CDN 镜像 （内容一致，国内网络通常可达）。服务端请求超时 4 秒，限制 256 …

分类