dsh-backup v0.9.0 — 一条命令备份/恢复整个 ~/.dsh：升级自动快照、起不来也能自救的救援通道、会话日志 doctor

[xiaoyuyu6420]

做了个备份插件，解决我自己最怕的三件事：升级把环境搞坏、误删找不回、换电脑搬家。

30 秒了解

dsh plugin --profile web add @xiaoyuyu6420/dsh-backup
# 重启 dsh web，输入：
/backup

会话、设置、技能、插件配置全在 ~/.dsh 一个目录里，一条命令全量备份，sha256 校验，默认保留 7 份轮换。Settings → 插件 → 备份 有可视化面板（改目录/份数/排除模式立即生效，不用重启）。

v0.9.0 的三个新东西

1. /backup doctor —— 会话日志体检 + 定点修复。损坏的会话文件先隔离再入档，防止轮换把好副本也带走。
2. 进程外救援通道 —— 每次备份都会往备份目录写一个零依赖的 rescue 网页（双击「点我恢复」即可）。DSH 本身起不来的时候，它用纯 Node 起本地 web UI，照样能浏览和恢复备份。这是给最坏情况准备的。
3. 升级自动快照 —— 宿主版本一变（升级/降级）先自动拍 dsh-pre-upgrade- 快照再继续，想试新版不怕翻车，坏了直接回滚。恢复失败也会自动回滚并给出结果回执。

其他

• 凭据默认脱敏：.credentials.yaml、.env 明文只存本机 vault，不进备份包不上云
• /backup auto 12 定时备份，重启不中断；每日/每周分级保留
• GitHub 同步换机：github pull + restore --sync-deps
• macOS / Linux / Windows 10+

仓库（含真实输出演示和面板截图，中英双语）：https://github.com/xiaoyuyu6420/dsh-backup

从 0.1.0 一路迭代到 0.9.0，多个修复直接来自社区 issue 的根因分析（README 里有致谢）。用过或试过的同学欢迎到 反馈收集帖 说两句——哪里别扭、缺什么，都会进路线图。

[leenkcool]

我是插件库，我感觉你的想法很好，我想收录，可以提ISSUE。 具体提的方法如下。
#4456

我也帮你置顶帖子，省得被埋没。 被收录的插件审核前送STAR

[xiaoyuyu6420]

感谢收录意向和置顶！已经按 #4456 的模板在 Blue-Whale-Harness 提了收录申请（issue #88），分类 utility，中英双语简介都填好了。

也看了你那句「卡了崩了丢了」——dsh-backup 恰好就是冲着「丢了」来的：除了备份本身，v0.9.0 还做了宿主起不来也能用的零依赖救援通道和会话日志 doctor 定点修复，跟你们社区的方向很合。后续有反馈我会持续跟进，谢谢！

[xiaoyuyu6420]

来交一份拖了很久的进度账——标题停在 v0.9.0，实际上过去几周跟着社区的升级/数据事故又往前走了四个版本（当前 0.13.0）。只挑和这个讨论区最近的话题直接相关的说：

迁移预检 /backup migrate-check——#6151 / #6779 / #7824 那一串「升级后老会话打不开」逼出来的：升级前静态扫全部会话日志（v0/v1/v2/v3 四代都认），列出哪些会话升完会挂、挂在哪条规则，顺带探测文件系统硬链接支持（exFAT 用户 #6358 的坑）。纯只读，不动任何文件。

升级前快照 + 一键更新——宿主版本变化自动留升级前快照；/backup update 更新插件前也先留一份，失败可回滚。settings.yaml 一次性导入吃文件那类事故（#7453 / #7534 / #7814）至少数据还在。

凭据哨兵——旧扁平布局的 .credentials.yaml 被宿主原子替换前，先自动存进本地 vault。

doctor 与救援台——会话日志体检（容器契约对齐宿主读端字节语义、seq 连续性、溯源引用一致性）；rescue.mjs 零依赖单文件放在备份目录，宿主起不来也能直接拉起来做恢复。

素材全部来自在这个讨论区跟过的真实事故帖——感谢每一个把日志、复现步骤和版本矩阵写完整的人，这比任何测试计划都有用。