前言¶
DeepSeek Harness (DSH) 的理念是“一切皆插件”。在本地環境中,會話歸檔的整理、重要輸出的防誤刪以及本地備份的完整性驗證,通常需要額外的腳本或手動操作,存在一定的風險。dsh-conversation-archive 插件將歸檔管理、輸出保留和本地備份功能原生集成到了 DSH 的設置界面中,旨在讓 DSH 成爲會話狀態的唯一事實來源,並通過嚴格的路徑驗證和哈希校驗降低清理風險。
核心功能¶
該插件由 yxv1203-collab 維護,採用 MIT 許可證,主要提供以下能力:
- 原生歸檔管理:直接在 DSH 界面中瀏覽、搜索、篩選已歸檔的會話,支持恢復或批量刪除。歸檔狀態始終由 DSH 同步,而非依賴插件維護的獨立索引。
- 受保護輸出保留:在刪除會話前,插件會調用配置的 DSH 模型審查符合條件的輸出。選中的文件會被複制到共享庫並經過內容哈希驗證,防止誤刪重要數據。
- 經覈實的本地備份:支持手動創建 ZIP 備份,或按計劃、在關機前自動備份。每個備份包含清單和哈希校驗,默認保留 5 個已覈實的備份,自動備份功能默認關閉。
- 工作區與路徑安全:支持跨驅動器的 DSH 註冊工作區。插件會回填歷史元數據,並拒絕通過鏈接或符號鏈接遍歷,確保路徑安全。
安裝與啓用¶
使用官方安裝命令將插件添加到 Web 配置文件中:
dsh plugin --profile web add github:yxv1203-collab/dsh-conversation-archive#v1.1.0
安裝完成後,重啓 DSH,然後在 Settings → Workspace Manager 中即可看到相關功能入口。
典型用法¶
在安裝前,通常建議驗證安裝包的完整性。下載 dsh-conversation-archive-1.1.0.tgz 後,可以使用以下 PowerShell 命令計算哈希值:
Get-FileHash .\dsh-conversation-archive-1.1.0.tgz -Algorithm SHA256
需要移除插件時,使用:
dsh plugin --profile web remove dsh-conversation-archive
適用場景與注意¶
- 環境要求:插件需要 Windows 10 或 11、PowerShell 5.1+、Node.js 20+ 環境。DSH 版本需在
0.1.1-rc.2至0.1.2-rc.1之間測試通過。 - 備份範圍:備份僅涵蓋註冊的 DSH 會話數據和保留文件,不包含整個源代碼倉庫。
- 恢復策略:文件恢復僅能進入空目標位置,絕不會覆蓋現有文件。
- 數據留存:移除插件後,已保留的文件和備份依然存在,不會隨之刪除。