前言¶
在 DSH 裏用久了，環境會散在多處：profile 下的 package.json、cordis.yml，node_modules 裏的 registry 插件，本地 dshbox-plugins，Skill、MCP 連接、Agent Preset，以及 .credentials.yaml 和外部工作目錄。手工逐項複製很難做到完整，升級 DSH、大改插件或換機器時一旦出錯，代價也更高。社區插件 dsh-backup-all（維護者 luotianhao21）的定位是：把上述內容打成可回滾的壓縮快照，並在設置裏提供列表、導出與恢復入口；SkillHub 上歸類爲 admin-security。它不是隻做「遷移」的專用工具，更接近在動環境之前先留一份完整現場。
這是什麼¶
dsh-backup-all 是面向 DeepSeek Harness（DSH）的 Web profile 插件，當前 npm / GitHub 標註版本爲 1.3.0，許可證 MIT。創建快照時，Host 掃描固定配置、憑據、Skill、插件與 MCP 等；AI 在可配置模型下判斷哪些「插件外但運行時仍被引用」的外部數據應入包，並生成恢復計劃與 RESTORE.md。恢復時先自動做「恢復前快照」，再比對差異、分批寫回（覆蓋前有逐文件安全備份），最後重裝依賴。跨操作系統恢復列爲附加能力，同系統完整回滾纔是 README 中的主路徑。
備份範圍與打包策略¶
下面列出插件 README 中寫明會納入快照的內容：
- profile 配置：如
package.json、cordis.yml、cordis.patch.yml、pnpm-lock.yaml等； - 插件：registry 來源以記錄爲主，恢復時重裝；本地
file:/link:或無法再下載的插件代碼可按策略入包； - Skill / Agent Preset：掃描到的條目與配置；
- MCP 連接：連接定義與相關配置；
- 憑據：
.credentials.yaml（可在策略中關閉打包）； - 外部數據：由 AI 結合環境清單與運行時引用發現，並經安全規則校驗後納入。
默認插件代碼策略爲 local-only（僅打包本地不可再下載插件），避免把能重新拉取的 registry 插件本體塞進歸檔。歸檔格式爲 tar + Brotli（quality 11），包內附帶 manifest.json、INVENTORY.md、RESTORE.md；README 稱壓縮後體積常爲原數據的大約一成，全程有進度且可中斷。
創建工作方式簡述¶
創建快照：Host 掃描 → AI 選定外部數據 → 寫恢復說明 → 打包爲 .backup.tar.br（文件名含系統類型，如 ...-linux.backup.tar.br / ...-windows.backup.tar.br）。
恢復：自動創建恢復前快照 → AI 對比差異 → 分批寫回並重裝依賴 → 重啓 DSH 生效。恢復前快照意味着回滾操作本身也可以再回滾。
設置頁提供「Backup ALL」：快照列表、已歸檔、高級設置；支持卡片導出與「引入快照」導入任意 .backup.tar.br；另有後臺懸浮進度球與移動端適配。快照與恢復使用可獨立配置的 AI 模型（OpenAI 兼容 / Anthropic），工具調用可見、可中斷。
安裝與啓用¶
前置條件：DSH 0.2.1-rc.5（或 README 所稱兼容版本）、Node.js >= 22、pnpm（由 DSH 插件管理使用）。插件以當前 DSH 進程權限運行，安裝前請自行查看倉庫源碼與 MIT 許可證。
推薦從 npm 安裝：
dsh plugin --profile web add dsh-backup-all
或從 GitHub 安裝：
dsh plugin --profile web add github:luotianhao21/dsh-backup-all
安裝後重啓 DSH，在 設置 → 插件 中確認 dsh-backup-all 已啓用；設置側欄會出現 Backup ALL。
快速開始¶
- 打開 設置 → Backup ALL → 高級設置，配置 AI 模型（Base URL、API Key、Model ID），使用「測試模型接通性」驗證；
- （可選）在「快照策略」中調整插件代碼打包範圍、是否不打包憑據、跨 OS 恢復插件代碼（
skip/ 實驗性js）； - 在「快照」頁點擊 創建新快照，經兩步確認後等待完成；
- 需要回滾時，在對應卡片點 恢復（會先自動創建恢復前快照）；
- 離線保管時點 導出 保存
.backup.tar.br；換環境時用 引入快照 導回。
快照策略默認值（來自 README 表格）：
| 設置 | 默認 | 可選 |
|---|---|---|
| 插件代碼本體 | 僅本地不可再下載 | local-only / all / none |
| 不打包憑據 | 關 | 開啓後恢復需重填憑據 |
| 跨 OS 恢復插件代碼 | 跳過 | skip / js（跨 OS 時生效） |
同系統恢復爲完整恢復；跨系統爲兼容恢復（配置/數據/憑據遷移，插件代碼默認跳過，registry 插件重裝）。原生插件與系統相關內容需在目標系統重建。
適用場景與安全注意¶
README 歸納的典型場景包括：升級 DSH 或大改插件前先快照；誤刪配置 / Skill / 本地插件後回滾；重裝系統或換電腦前導出歸檔；定期留保險副本；或僅通過 INVENTORY.md / RESTORE.md 清點環境裏有什麼。
安全方面需特別注意：默認策略下快照可能包含 明文 .credentials.yaml，應將 .backup.tar.br 當作敏感文件保管；README 寫明 Host 不會把憑據明文放進 AI prompt，但恢復或遷移後仍建議輪換 API Key 等憑據。DSH 生態理念是「一切皆插件」；SkillHub 目錄站與 DeepSeek / 幻方無官方從屬關係，本插件由個人維護，與 DeepSeek 官方亦無隸屬關係。
