DSH | dsh-plugin-hub | 框架升级安全与插件适配门（把 9/4 升级事故教训固化进控制台）

[Noob-stupid]

_> 非官方项目，由社区成员独立开发和维护；与 DeepSeek 官方无任何关联。

项目地址： https://github.com/Noob-stupid/dsh-plugin-hub ｜ npm：@noob-stupid/dsh-plugin-console v0.3.25（npm ｜ README ｜ Release）

一句话： DSH 插件管理面板 + 多源插件市场 + 技能/套装安装，并首次把「框架升级安全三件套」与「插件适配门（兼容检测）」做成控制台机制——9 月 4 日 0.1.1-rc.2 → 0.1.2-rc.1 升级事故的全部教训都在这里。

事故背景（为什么要做这个）

9/4 官方升级后本机服务无法拉起，复盘根因：

1. 升级脚本在错误工作目录执行：require.resolve 返回 .pnpm 内部 realpath，旧逻辑把新 CLI 原位覆盖进旧的 .pnpm 目录，依赖树新旧混版本（settingsNamespace / installSettingsSection 类错误）；
2. 第三方 UI 插件拖死服务：@linxin666/dsh-web-ui-all@0.3.4 深度绑定旧版设置注册 API，升级后客户端注册即崩，整个 Web 页面起不来；
3. 自动回滚失效：控制台旧回滚只替换 CLI 本体、不动依赖树，回滚后依旧损坏。

新设计（v0.3.25 核心）

一、升级安全三件套

• 框架安装根识别：定位真正含 .pnpm 的顶层 node_modules（进程入口 + realpath 上溯双路径），定位不到拒绝升级、服务保持在线——根因级修复；
• 升级前框架全树 checkpoint：镜像 .pnpm 全部 @deepseek-ai 版本自包 + 顶层 scope + lock.yaml，写入 ~/.dsh/plugin-console/framework-backups/<版本>/fw-tree/；
• 拉起失败自动全树回滚并重试：安装失败 或服务拉起失败 都自动恢复升级前全树并再次拉起，不再只留「请手动运行」提示；回滚后跳过重链/修复步骤，避免对已恢复旧树二次破坏。

二、一键回滚

升级后框架卡片出现「回滚到上一版」按钮：停服 → 全树恢复 → 自动拉起 → 健康检测，全程状态可见（/plugin-console/framework-rollback）。

三、插件适配门（插件兼容检测）

• 升级后与框架不兼容的插件强制禁用（补丁层 disabled + 服务端 /toggle 409 双保险，无法绕过）；
• 行状态以启用按钮文案「待适配」提示，详情面板给出说明：检测更新 → 更新并适配；
• 更新后自动校验：内置零依赖 semver 判定器，扫描最新版 dsh.engines.framework / engines.dsh 显式声明 + @deepseek-ai/* 依赖范围（依赖判定遵循 npm prerelease 严格规则、声明判定宽松）；版本已变化且未判定不兼容 → 自动移除禁用块解锁；聚合包更新连带校验同步的全部子包；
• AI 赋能适配预检：规划部署时服务端预检 registry 最新版声明与适配门命中情况，注入子代理提示词（计划必须向用户解释适配结论），面板标注不兼容（标红）。

与 DSH 的集成方式

通过 dsh.bundle 官方清单作为 profile bundle 挂载（dsh plugin --profile web add @noob-stupid/dsh-plugin-console），提供 /plugin-console/* 路由（仅环回 + 同源写校验）与设置页 tab；可读写补丁层、管理插件开关、检测框架版本，升级流程与框架卡片联动。

其余能力（同面板）

• 插件 / 技能双市场（静态索引 500+ 插件 / 300 技能，CI 每 6 小时自动收录，jsDelivr CDN 秒开、零限流）；
• 多源检索（GitHub / Gitee 仓库直装 / 自定义源，可带请求头认证）；
• AI 赋能一键部署（文当驱动计划-执行分离 + 安全护栏，服务器类组件自动生成控制卡片）；
• 框架层面 cordis.patch.yml 解析容错补丁（issue #5，幂等）。

截图

已知边界

• 适配门只针对升级后的第三方插件；框架自带组件与已兼容插件不受影响；
• 无新版的插件保持「待适配」锁定（需作者发布适配版本后自动解锁）；
• 期望官方升级器未来参考同样的防线（版本隔离安装 / 全树 checkpoint / 启动探活失败自动回滚 / 依赖兼容门）。

[Noob-stupid]