前言¶
在智能體開發中，環境配置、記憶數據和依賴插件往往分散在多個目錄，一旦重裝、遷移或遭遇故障，恢復成本較高。現有的 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。
