用途:当 DSH 宿主本身已升级或即将升级时,对整套 Web/客户端插件舰队做一次横扫核查,确认每个插件在新宿主上是否仍能加载与工作,并对损坏插件逐个修复发版。
主要能力与固定规则:
- 在目标宿主上验证,而非源码。插件“加载”指客户端 bundle 被服务、存在 CSS style[data-plugin] 标签、无 slot entry crashed / activation-failure 记录;“工作”还需其 surface 标记出现在 DOM 且预期请求发出。需记录证明到哪一层。
- 先做一次廉价静态扫描:在碰浏览器前,按目标版本走廊卡(plugin-upgrade/references/)列出的重命名或移除 API,grep 每个插件源码。静态命中即判为 broken-until-fixed。
- 无错误是弱证据:交互门控的界面在空闲扫描中不显示,需知道其触发条件并模拟,否则只能标注“已加载,交互路径未验证”。
- 逐插件修复发版,绝不整队提交:每个损坏插件单独分支或主干提交、版本号、changelog 行、tag、镜像推送(按目标仓库自身文档,若无镜像则跳过;sync-mirrors.mjs 仅属于作者仓库)。
- 跨宿主世代时用兼容构建:运行时通过回退链解析重命名的宿主导出(旧名→新变体),而非静态具名导入;并补齐单元测试 mock 中的每个回退名(严格 mock 遇未定义导出会抛错并掩盖真实失败)。
工作流:读取目标宿主版本走廊卡并推导静态扫描模式;对舰队仓库 grep 并以 file:line 记录命中;在受控无头浏览器中加载真实 GUI,逐插件断言 CSS/style 标签存在、无 slot crashed 记录、surface DOM 标记存在、预期请求发出(方法见 references/fleet-sweep-checklist.md);对交互门控界面模拟触发后再验证或明确降级;对损坏插件对照宿主源码诊断、按兼容方式修复、跑 typecheck/tests/build 后发版;发版后重跑实时扫描并记录最终逐插件判定表。最后输出表格:判定、覆盖宿主版本、证据,并记录发现的宿主 bug(附最小复现上报上游)及安装树中会被下次升级覆盖的热修清单。
限制:资料未说明具体宿主版本号、插件清单、命令细节与安装方式,暂未提供。