x2802490130-prog/dsh-guard

dsh-guard

DSH 开发配套守护插件：滚动快照 + 失败自动回退 + 本机管理面板。

能力

• 滚动快照：每次存档保留最近 N 份（默认 5，带时间戳+原因），同时镜像 last-good 供外部启动器/bat 互操作
• 自动存档：启动成功且度过宽限期后自动存档（reason=auto）
• 自动回退：监听到插件运行失败，三道护栏内自动回退 last-good（每启动一次、宽限期内、快照早于本次启动）
• 管理面板（仅本机）：http://127.0.0.1:<端口>/dsh-guard —— 状态 / 快照列表 / 一键存档 / 回退 / 恢复备份 / 事件日志
• 管理 API（仅本机）：/api/dsh-guard/{status,snapshots,backups,log,save,rollback,restore}
• 事件日志：snapshotRoot/guard.log

配置（profile 补丁层，均可省略）

- id: dsh-guard
  config:
    snapshotRoot: D:\path\to\snapshots
    profileDir: C:\path\to\profiles\web
    sourceDirs: [D:\path\to\plugin-src]
    restartCommand: D:\path\to\restart.bat   # 空 = 只回退不重启
    graceMs: 120000
    autoSaveDelayMs: 150000
    keepSnapshots: 5

安全边界（重要）

• boot 崩坏插件救不了：进程在启动期崩溃时插件无法运行，boot 救援由外部启动器承担（见 dsh-balance-float 仓库的 windows/launch-dsh.vbs SNAP_TOOL 机制）
• 管理面板/API 仅限本机回环地址访问
• 每次启动最多自动回退一次（防死循环）

测试

node test.mjs   # 21 项

License

MIT