前言¶
DeepSeek Harness 更新快,社区插件也多。一次不兼容的主题、前端插件或依赖更新,可能让 DSH 白屏、无法进入设置,甚至导致整个插件环境不可用。dsh-recovery-center 专为解决这类问题设计:它能在系统正常时保存插件状态,发生崩溃后离线恢复;即使 DSH 网页界面打不开,独立的应急页面仍可启动。
是什么¶
这是一个本地插件,用于保存当前插件文件、依赖清单和加载配置。它不恢复聊天记录、工作区、DSH 主程序或单独存储的模型凭据。该插件由 supery0ung 维护,使用 MIT 许可证。
核心功能¶
- 离线恢复:保存当前插件文件和加载配置,恢复时不依赖网络重新下载。
- 安全校验:恢复前进行 SHA-256 校验并检查 DSH 版本;损坏或不匹配的恢复点不会直接覆盖现有文件。
- 可逆性:每次恢复前自动保存当前状态,避免一次恢复操作造成新的问题。
- 独立救援:恢复程序位于插件目录之外,即使 DSH 前端或插件本身已损坏,仍可打开。
- macOS 入口:首次启用后自动生成桌面应急入口;入口丢失后可以重新创建。
- 中断恢复:使用分阶段文件替换和磁盘日志,防止中断导致数据损坏。
安装与启用¶
安装插件:
dsh plugin --profile web add dsh-recovery-center@0.1.2 --config.auto-install-peers=false
重启 DSH,进入 设置 → 恢复中心。在系统正常时先保存第一个恢复点。以后安装或更新插件前再保存一次。
典型用法¶
通过 CLI 操作:
- 列出所有恢复点:
dsh-recovery list --profile web
- 捕获一个新的恢复点:
dsh-recovery capture --profile web --label "Before a new theme"
- 恢复到指定点(需先停止 DSH):
dsh-recovery restore <point-id> --profile web --yes
- 修复损坏的恢复目录(日志恢复):
dsh-recovery repair --profile web
独立应急入口¶
在 macOS 上,首次启用后会自动生成桌面应急入口文件(例如 DSH Emergency Recovery-安装标识.command)。如果该入口丢失,可以在恢复中心界面中点击“创建 / 修复入口”重新生成。双击该入口可以打开独立的应急恢复页面,用于选择和恢复正常的恢复点。
适用场景与注意¶
- 适用场景:插件导致 DSH 界面无法加载,需要回滚插件更改;需要在不联网的环境下恢复插件环境。
- 不支持的场景:Windows 系统不受支持。
- 重要限制:
- 不恢复聊天、工作区、DSH 主程序或单独存储的模型凭据。
- 安装或更新其他插件前应先保存恢复点。
- 捕获恢复点时不要安装或更新包。
- 恢复点在 DSH 停止时才会被手动删除。
总结¶
dsh-recovery-center 提供了针对 DeepSeek Harness 插件环境的本地化回滚能力。通过离线恢复和独立的救援入口,它能在插件导致系统崩溃时提供有效的恢复手段。