前言¶
DeepSeek Harness（DSH）採用插件化架構，環境數據和持久化通常需要依賴特定的配置或數據庫。在遷移工作環境或備份會話記錄時，這種分離式的存儲方式往往帶來不便。dsh-vault 旨在解決這個問題，它通過將所有對話和日誌直接寫入工作區文件夾內部，使該文件夾成爲一個自包含、可移植的存檔。
核心功能¶
該插件由 XiaoWind 維護，專注於爲 DSH 提供本地化的記憶存儲能力。其主要功能包括：
- 自包含存檔：將所有對話和日誌保存在工作區文件夾內部。
- 實時鏡像：在
dsh-session-vault/目錄下實時鏡像會話日誌到sessions/<id>.l文件。 - 標題緩存：工作區標題被緩存在
workspace.json中。 - 自動恢復：啓動時或打開工作區時自動恢復 DSH 持久化中的會話。
- 路徑可便攜：導入時重新綁定會話的
cwd到當前絕對路徑。 - 冪等操作：無需變更時不會產生寫入。
- 自動補全：記錄會自動補全，支持
/vault export強制重寫。 - 斜槓命令：提供
/vault斜槓命令用於查看狀態、恢復和導出。 - 零依賴：無第三方依賴，無需構建步驟。
安裝與啓用¶
安裝時必須使用 github:owner/repo 格式，因爲該插件未發佈到 npm registry。
DeepSeek Harness 桌面版¶
- 在桌面版的插件管理中添加插件。
- 輸入規格：
github:XiaoWind/dsh-vault。 - 安裝完成後，必須重啓桌面應用才能生效。
CLI / Web 版¶
# 安裝插件
dsh plugin --profile web add github:XiaoWind/dsh-vault
安裝後，請重啓 Web 應用。該插件依賴 dsh-app-boot 版本（例如 0.2.0-rc.2）及相關的 peerDependencies，不兼容的版本會被拒絕安裝。
典型用法¶
插件提供 /vault 斜槓命令進行管理：
/vault status：查看已保險的工作區及每個工作區的會話數量。/vault restore：立即爲已知工作區導入保險庫中的會話和標題。/vault export：立即把當前持久化數據（重新）寫入保險庫文件。
新電腦遷移流程¶
- 在原電腦上，複製整個工作區文件夾（包括
dsh-session-vault/）。 - 將文件夾複製到新電腦。
- 在新電腦上打開該文件夾作爲工作區。
- 插件會自動檢測並恢復保險庫中的會話和標題。
注意事項¶
- 重啓生效：桌面版安裝後必須重啓桌面應用，CLI/Web 版安裝後請重啓 Web 應用。
- 記錄完整性：DSH 的持久化日誌要求
seq從 0 開始且連續。不完整的記錄（如 seq 不連續）會被跳過，並在日誌中註明原因。 - 運行時捕獲：插件只在自己運行期間鏡像事件。如果會話在插件未加載時繼續追加事件，這段記錄不會進入保險庫文件。會話再次打開時，插件會比對並補全文件。
- 冪等性：已存在於持久化中的會話不會被重複導入。
