前言¶

DeepSeek Harness（DSH）的聊天記錄、工作區數據、設置和憑據通常保存在本地 ~/.dsh 中。當需要重裝、遷移，或本地數據被清空後，缺少獨立備份會讓恢復變得困難。

dsh-vault 是 DSH 生態中的一個社區插件，用於把關鍵數據備份到 ~/.dsh 之外，並在數據疑似被清空時給出告警、支持按範圍恢復。它由 feiyang-dev 維護，許可證爲 MIT。在 DSH 的插件機制中，dsh-vault 可作爲社區插件掛載到 web profile。

這是什麼¶

dsh-vault 的 npm 包名爲 @feiyang666/dsh-vault，主要提供三件事：

• 備份：把 DSH 關鍵數據複製到獨立備份目錄
• 清空檢測：啓動時比較備份與當前會話數，疑似清空時紅色告警
• 恢復：通過設置頁或 backup_vault 工具按範圍恢復

備份目錄格式爲：

~/.dsh-backups/<timestamp>/

該目錄位於 ~/.dsh 之外。恢復操作會覆蓋當前數據，執行前需確認備份時間點。

核心功能¶

備份管理頁¶

安裝並重啓後，Web Settings 中會提供 Backup Manager。

在該頁面可以：

1. 查看備份目錄、上次備份時間、備份數量、數據完整性
2. 執行 Back Up Now
3. 按範圍恢復：All、chat history only、workspace settings only
4. 刪除備份，刪除前需要確認

備份內容¶

默認備份 DSH 的以下數據：

~/.dsh/sessions/
~/.dsh/storages/
~/.dsh/settings.yaml
~/.dsh/.credentials.yaml
~/.dsh/.anonymous-user-id
~/.dsh/profiles/

如果已安裝 dsh-usage-plugin，其用量數據也會一併備份和還原，包括：

usage-records.json
pricing.json

.credentials.yaml 中可能包含 API keys，因此備份目錄需要妥善保管。

清空檢測¶

插件啓動時會比較備份中的會話數與當前會話數。若疑似數據被清空，會給出紅色告警。

backup_vault 工具¶

插件註冊 backup_vault 工具，支持以下動作：

status
backup
list
restore
delete
make_script

其中：

• restore 需要 name 和 scope，scope 可爲 all、sessions、data
• delete 需要 name
• make_script 用於生成 restore-latest.ps1

安裝與啓用¶

桌面端安裝¶

打開 DeepSeek Harness Desktop，按以下路徑操作：

Install Plugins → Recommended → Data Vault → Install → Restart Service Now

命令行安裝¶

在已有 dsh 的環境執行：

dsh plugin --profile web add @feiyang666/dsh-vault

如需啓動 Web UI：

npx @deepseek-ai/dsh web

默認地址：

http://127.0.0.1:3080

重命名說明¶

項目已從舊名稱遷移到 dsh-vault：

• GitHub 倉庫：feiyang-dev/deepseekharnessdesktop-vault → feiyang-dev/dsh-vault
• npm 包：@feiyang666/deepseekharnessdesktop-vault → @feiyang666/dsh-vault

舊 GitHub URL 會 301 跳轉到新地址。舊 npm 包不再維護。安裝或升級時請使用新包名：

dsh plugin --profile web add @feiyang666/dsh-vault

典型用法¶

在設置頁中操作¶

1. 打開 Settings → Backup Manager
2. 點擊 Back Up Now 創建一次備份
3. 在備份歷史中選擇一次備份
4. 選擇恢復範圍：All、chat history only 或 workspace settings only
5. 如需刪除舊備份，執行刪除並完成確認

通過 backup_vault 工具操作¶

可以向助手提出類似請求：

• “檢查 dsh-vault 備份狀態”
• “立即備份 DSH 數據”
• “列出所有備份”
• “從指定備份恢復聊天記錄”
• “刪除指定名稱的舊備份”
• “生成離線恢復腳本”

工具參數可寫成：

backup_vault action=status
backup_vault action=backup
backup_vault action=list
backup_vault action=restore name=<備份名> scope=all|sessions|data
backup_vault action=delete name=<備份名>
backup_vault action=make_script

scope 的含義：

• all：全量恢復
• sessions：聊天記錄
• data：工作區設置/數據

離線恢復¶

如果已生成恢復腳本：

1. 退出桌面應用
2. 運行 ~/.dsh-backups 下的 restore-latest.ps1

如果沒有使用腳本，也可以手動複製：

~/.dsh-backups/backup-<timestamp>/
→ ~/.dsh/

恢復聊天記錄前最好退出桌面應用，因爲 DSH 運行期間聊天記錄文件可能被鎖定。

適用場景與注意¶

dsh-vault 適合以下場景：

• 需要把 DSH 的聊天記錄、工作區數據、設置和憑據備份到 ~/.dsh 之外
• 需要在數據被清空後儘快恢復
• 已安裝 dsh-usage-plugin，希望一併備份用量數據

使用前注意：

• 插件以當前 dsh 進程權限運行，安裝前建議檢查源碼與許可證
• 運行環境要求 Node.js >= 18
• 備份目錄包含 .credentials.yaml，可能包含 API keys，避免暴露給不可信位置
• 恢復會覆蓋當前數據，先確認備份時間點
• 舊 npm 包不再維護，請使用新包名

鏈接¶

• GitHub：https://github.com/feiyang-dev/dsh-vault
• 目錄頁：https://www.skillhub.cn/plugins/feiyang-dev/dsh-vault（該地址來自插件目錄線索，未在本次抓取資料中確認）