Seryta/dsh-plugin-safety

README 摘要

dsh-plugin-safety — 插件健康告警 DSH 插件故障防控的最后两环： 1. 预检 + 自动禁用 ： scripts/check-profile-plugins.py 在 dsh-web 启动前预检 profile 中每个未禁用的插件入口；import 失败的坏插件自动写入 disabled: true （bundle 则移除 bundle），并落盘告警。 2. 持久告警 + 自动修复会话 ：浏览器半部渲染红色告警卡片，× 掉前 刷新/重开页面都会重现；host 半部在返回告警前保证每个告警 action 都有 对应的 headless 修复会话。 核心不变式 只要出现“不可用插件已被禁用/需人工处理”的告警，就自动创建修复会话。 不区分告警来源：预检脚本检出、直接写 notice.json 的测试/手工场景， 都遵守同一规则。 具体机制： - host 半部 GET /plugins/dsh-plugin-safety/notice 返回告警前先检查 fixActionIds 是否覆盖全部 action；未覆盖就调用 check-profile-plugins.py --ensure-fix 补启动。 - 同一批 action 只启动一次；同一份告警新增坏插件时，只为新增 action 补启动一次。 - Popen 成功才写 fixStartedAt / fixActionIds ；启动失败时前端如实 显示“修复会话自动创建失败”，不再假装已创建。 - 文件锁防多个 GET/预检并发重复启动。 组件 文件 职责 index.js host 半部：告警读写端点 + 返回前 ensure-fix client.js 浏览器半部：持久弹窗、× 关闭（POST 清除） scripts/check-profile-plugins.py 预检、自动禁用、告警落盘、修复会话启动 cordis.patch.yml bundle patch：把插件挂进 profile dsh.plugin.json DSH 插件元数据 零第三方依赖：host/脚本仅用 Node/Python 标准库；client 为原生 DOM。 告警文件 $DSH HOME/storages/plugin-safety/notice.json （未设置 DSH HOME 时为 /.dsh/storages/plugin-safety/notice.json ）： POST 同一端点即视为用户已叉掉告警，文件重置为 {"at": 0, "actions": []} ；下一条新告警会重新生成。 安装 安装后重启 dsh-web（host 半部需要进程重新 import；client.js 是静态服务， 重启前刷新页面也能拿到新逻辑）。 如果同时想要启动前预检（推荐），把随包脚本放到 $DSH…

分类