DSH 恢复中心

DSH 更新快，插件动不动就把它搞崩。折腾前先存个档，崩了就离线回滚——就算 DSH 网页打不开，独立应急界面照样能开。

预览版 0.1.2：已验证 macOS、Node.js 22、DSH 0.1.2-rc.1。Linux 已实现但未经实机验证；Windows 暂不支持。恢复前会中断 DSH 正在执行的任务。

安装

dsh plugin --profile web add [email protected] --config.auto-install-peers=false

重启 DSH，进入「设置 → 恢复中心」。界面跟随 DSH 的中英文语言设置；独立应急界面可单独切换语言。

使用

1. 环境正常时，填写名称并保存第一个恢复点。
2. 每次安装或更新插件前，先保存恢复点，等待完成后再修改插件。
3. 发生问题时，选择正常的恢复点，确认恢复并重启。
4. DSH 网页打不开时，双击桌面上的 DSH Emergency Recovery-安装标识.command，选择恢复点。使用期间保持终端窗口开启。

首次启用时，本地 Mac 会自动生成桌面入口（需要桌面存在且可写）。「独立应急入口」显示实际位置，并可创建或修复入口。文件被删后，也可重启 DSH 重新生成。

入口使用各自电脑的安装路径，打开随机本机端口，不访问作者电脑。恢复程序存放在插件目录之外，恢复旧插件或移除插件后仍会保留。入口位于运行 DSH 的电脑；Linux 或通过 SSH 启动时保留独立启动文件，不自动创建 Mac 桌面入口。配置 desktopShortcut: false 可关闭自动创建桌面入口。

恢复范围

恢复当前 profile 的插件文件、依赖清单及加载配置，包括 node_modules、package.json、锁文件、Cordis 配置和 .dsh-market/state.json。不恢复聊天、工作区文件、DSH 主程序或单独存储的模型凭据。插件加载配置可能包含私人信息，请勿公开恢复点。

恢复前校验 SHA-256、profile 和 DSH 版本；自动保存恢复前状态。恢复包含实际插件文件，不依赖重新联网下载。事务日志用于中断后修复。外部依赖符号链接会被拒绝；内部链接原样保留。

恢复点不会自动清理，大小约为已安装依赖的大小；APFS 克隆可共享磁盘块。备份期间不要同时安装或更新插件。此插件不是整机或完整 DSH 备份工具。

受管理的服务

使用 launchd、systemd、pm2 或 Desktop 管理 DSH 时，关闭自动重启（allowRestart: false），先通过服务管理器停止 DSH，再使用离线恢复命令。自动检测仅尽力而为。

更多离线命令、目录位置及开发说明见 English README。