前言¶
DeepSeek Harness（DSH）的用戶數據集中在 ~/.dsh。DSH 生態強調“一切皆插件”，社區目錄是獨立站點，不是官方應用商店，也與 DeepSeek / 幻方沒有官方從屬關係。dsh-backup 解決的是這類用戶數據的備份、恢復、校驗、定時任務、GitHub 同步，以及在 DSH 無法啓動時的救援恢復。
這是什麼¶
dsh-backup 是一個 DSH 插件，由 xiaoyuyu6420 維護，許可證爲 MIT。它面向 DeepSeek Harness 用戶，用來備份和恢復 ~/.dsh 下的用戶數據，並提供 sha256 校驗、保留策略、憑據脫敏、定時備份、GitHub 同步拉取和圖形設置面板。
該插件要求：
macOS / Linux / Windows 10+DSH 0.1.1-rc.2 or compatible
核心能力¶
已覈實的能力包括：
- 用
/backup備份 DeepSeek Harness 用戶數據（~/.dsh） - 用
/backup auto配置定時自動備份，且配置在重啓後仍保留 - 爲備份生成 sha256 checksums，並支持完整性校驗
- 備份輪換 / 保留策略，默認
keep 7 - 恢復前可用
--dry-run預覽，恢復失敗時自動回滾並給出結果回執 - 憑據默認從歸檔中脫敏，明文只保存在本地 vault
- 支持 GitHub 同步拉取，以及跨機恢復預檢
- 提供 Visual Settings panel，可執行 list、verify、restore、delete，並編輯設置
- DSH 無法啓動時，可使用 rescue console 進行恢復
/backup doctor用於會話日誌健康檢查與修復- 當 host version 變化時，可生成 pre-upgrade snapshots
- 支持
macOS / Linux / Windows 10+
安裝與啓用¶
先安裝插件，然後按插件說明重啓 dsh web。官方安裝命令如下：
dsh plugin --profile web add @xiaoyuyu6420/dsh-backup
安裝前建議檢查源碼與許可證。插件以當前 dsh 進程權限運行，權限範圍取決於你的 dsh 運行環境。
已覈實材料中版本信息不一致：package.json 聲明 0.9.1，README 示例與近期發佈說明提到 0.9.0。實際以安裝包的 package.json 爲準。
典型用法¶
下面按常見操作順序介紹。
1、手動備份¶
/backup
這一步會對 ~/.dsh 生成備份歸檔。默認備份目標爲：
~/Desktop/dsh-backups/
2、查看備份列表¶
/backup list
用於查看已有備份。
3、校驗備份完整性¶
/backup verify all
用於檢查備份的 sha256 checksums 與完整性。
4、預覽恢復¶
/backup restore latest --dry-run
先預覽即將恢復的內容，不直接覆蓋當前狀態。
5、執行恢復¶
/backup restore latest
確認無誤後執行恢復。若恢復失敗，會觸發自動回滾並給出結果回執。
6、配置定時自動備份¶
/backup auto 12
這一步開啓定時自動備份；12 是命令中的定時參數。該配置在重啓後仍保留，並按默認保留策略輪換，默認 keep 7。
7、檢查會話日誌¶
/backup doctor
用於會話日誌健康檢查與修復。
8、從 GitHub 拉取備份¶
/backup github pull
用於從 GitHub 同步拉取備份歸檔。
9、跨機恢復並處理依賴¶
/backup restore latest --sync-deps
用於跨機恢復場景，並同步相關依賴。
默認路徑與保留策略¶
默認備份目錄爲：
~/Desktop/dsh-backups/
默認保留策略爲：
keep 7
憑據處理¶
憑據默認從歸檔中脫敏。明文只保存在本地 vault，不隨歸檔擴散。
DSH 無法啓動時¶
如果 dsh 無法啓動，可以使用備份生成的 rescue console 進行恢復。它面向的是 DSH 無法正常啓動時的恢復場景。
適用場景與注意¶
適合以下情況：
- 升級前保留一份可回滾的快照
- 誤刪或損壞
~/.dsh後需要恢復 - 定時備份，減少人工遺漏
- 跨機遷移或 GitHub 同步拉取
- 校驗備份完整性
注意：
- 平臺要求：
macOS / Linux / Windows 10+ - DSH 要求：
0.1.1-rc.2 or compatible - 安裝後需要重啓
dsh web - 插件以當前
dsh進程權限運行 - 版本信息存在不一致，建議以實際
package.json爲準
鏈接¶
目錄頁：
https://www.skillhub.cn/plugins/xiaoyuyu6420/dsh-backup
GitHub：
https://github.com/xiaoyuyu6420/dsh-backup
