前言¶
DeepSeek Harness (DSH) 採用插件化架構,允許開發者通過擴展功能來定製工作流。對於開發者而言,會話歷史、配置文件以及自定義數據目錄(如記憶庫)的持久化是剛需。手動備份容易遺漏,且耗時。dsh-backup 插件旨在解決這一問題,提供自動化的備份方案,將重要數據打包存檔。
插件介紹¶
dsh-backup 是一個由社區成員維護的非官方插件,採用 MIT 許可證。
它主要解決 DSH 開發過程中數據丟失的風險,支持對以下內容進行備份:
- 會話記錄
- 配置文件
- 自定義目錄
插件支持定時自動備份和手動備份,具備自動輪轉機制(保留最近的備份文件),並將數據打包爲 .zip 存檔。
安裝與啓用¶
在安裝前,請確保你的 DSH web 版本不低於 0.1.0-rc.6。
通過命令行安裝插件:
dsh plugin --profile web add "github:a903067276-rgb/dsh-backup#main"
安裝完成後,需要重啓 dsh web 以使插件生效。
使用方法¶
-
打開備份面板
在 DSH 界面中,依次打開 Settings → Backup。 -
查看狀態
在狀態行中,你可以看到最後一次備份的時間、下一次定時備份的運行時間以及備份文件夾的默認路徑(~/Documents/DSH/backup)。 -
手動備份
點擊 “Back up now” 按鈕,立即執行一次備份操作。 -
配置備份內容
在 Custom directories 設置項中,你可以添加額外的絕對路徑。例如,如果你將記憶庫存儲在獨立的目錄中,可以將該路徑添加進去,確保備份文件中包含所有關鍵數據。 -
管理備份列表
在備份列表中,你可以查看已生成的備份文件(文件名格式爲dsh-backup-*.zip)、文件大小、創建時間,並支持手動刪除。 -
設置定時任務
插件默認每 6 小時運行一次定時備份。你可以在設置中關閉定時任務,或調整備份的時間間隔。
注意事項¶
- 恢復方式:該插件僅提供備份功能,恢復操作是手動的。你需要停止 DSH 進程,將解壓後的文件放回原始位置,並確保當前數據已確認無誤。
- 覆蓋策略:插件不會自行覆蓋任何現有文件,這是爲了防止意外數據丟失。
- 文件管理:備份文件夾中只有插件生成的文件(
dsh-backup-*.zip)會被列出和刪除,其他無關文件不會被處理。 - 版本兼容性:插件對 DSH 版本的兼容性爲“盡力而爲”,未經過所有版本的測試。建議在 DSH 0.1.0-rc.6 及以上版本使用,若遇到兼容性問題可嘗試切換插件版本標籤。