前言¶
在智能体开发中，环境配置、记忆数据和依赖插件往往分散在多个目录，一旦重装、迁移或遭遇故障，恢复成本较高。现有的 DSH 插件管理多聚焦于在线更新与依赖安装，缺乏对整体环境（包括 Profile、记忆、会话、附件等）的离线、冷备份与可验证恢复能力。DSH Environment Packer 旨在填补这一空白，提供本地离线冷备份与在全新宿主上恢复的能力。
是什么¶
DSH Environment Packer 是一个面向 DSH 的本地离线冷备份与恢复插件。它通过独立助手在目标宿主上锁定载荷文件，生成包含当前 Profile 及相关存储的 ZIP，并逐文件校验清单、CRC 与 SHA-256。恢复时使用可信安装包在全新目标上执行，不覆盖或合并，不联网安装依赖。维护者为 379385796-sys。
核心功能¶
创建完整环境备份（离线）¶
- 在 DSH 设置 → 环境恢复包点击主按钮。
- 使用 Windows Save As 选择已存在的文件夹和新 ZIP 文件名。
- 保存未完成工作，阅读私人范围及外部写入者警告，确认本次备份。
- 等待“独立助手已接管”和自动显示的独立进度窗口。
- 手动通过菜单或托盘正常退出所有 DSH 实例。
- 在助手点击“我已正常退出，检查后继续”。
- 助手锁定载荷文件防止写入/删除，生成 ZIP 并校验条目集合、CRC、清单和全部载荷 SHA-256。
- 成功后查看路径、大小、SHA-256 和清理结果。
恢复到全新宿主¶
恢复使用可信安装包 assets/restore-private.cjs，参数包括：
- –zip：备份 ZIP 路径
- –home：全新目标目录（不存在的）
- –profile-name：目标 Profile 名称
- –dsh-version：目标 DSH 版本
- –confirm-private：确认包含私人数据
专家 CLI（备份）¶
离线专家 CLI 位于 bin/backup-private.mjs，参数包括：
- –home：源 DSH_HOME
- –profile：源 Profile 名称
- –zip：输出 ZIP 路径
- –dsh-version：目标 DSH 版本
- –confirm-private：确认包含私人数据
- –source-quiescent：确认源宿主已静止
安装与启用¶
从 v0.4.2 Release 下载 tgz 和 SHA-256 文件，核对后通过 DSH 本地插件安装功能安装。构建时使用：
npm pack --ignore-scripts --pack-destination <OUTPUT_DIRECTORY>
典型用法¶
- 在隔离 Profile 验证插件功能。
- 正常退出 DSH，使用设置 → 环境恢复包创建离线备份。
- 检查 ZIP 的清单、CRC 与 SHA-256，确认无误。
- 在全新目标目录（–home）使用 assets/restore-private.cjs 恢复。
- 验证宿主与业务功能正常。
适用场景与注意¶
- 适合重装、迁移和灾难恢复的低频场景。
- 必须在源宿主完全静止且所有 DSH 实例正常退出后操作。
- 恢复后需另做宿主与业务验证。
- ZIP 未加密，仅本地保存，不适合公开分享。
- Windows 私人 ACL 仅限当前用户/SYSTEM，非加密。
- 不保证外部数据库、网络盘、杀软等场景的兼容性。
短结尾¶
DSH Environment Packer 提供本地离线冷备份与可验证恢复能力，适合需要离线迁移与灾难恢复的场景。完整文档与源码见 GitHub。
