前言¶
在 DeepSeek Harness（DSH）的日常使用中，隨着會話數量的增加，對已歸檔會話的管理和清理成爲維護工作的一部分。現有的 Web UI 提供了基礎的歸檔操作，但缺乏集中的瀏覽界面和自動化清理策略。dsh-plugin-archive-manager 插件爲此提供了集中的歸檔管理界面，以及基於規則的自動歸檔能力。
插件定位¶
這是一個客戶端插件，旨在爲 DSH Web UI 補上會話歸檔管理功能，並附帶 Codex 風格的對話刻度尺軌道。該插件前身爲 dsh-plugin-atlas，在 0.3.0 版本起，由於官方 Web UI 已內置對話刻度尺與輸入歷史，插件不再重複內置這些功能，轉而專注于歸檔管理本身。
核心功能¶
插件提供以下核心能力：
- 瀏覽與分組：已歸檔會話按工作區分組顯示，支持通過關鍵詞搜索。
- 批量取消歸檔：支持對多個會話執行取消歸檔操作，還原後側邊欄會實時恢復，無需重啓。
- 自動歸檔：默認關閉，可配置“不活躍超過 N 天”或“每個工作區保留最近 M 條”的規則，系統每日覈查一次。
- 試運行：在執行自動歸檔前，支持預覽清單。
安裝與啓用¶
通過命令行安裝：
dsh plugin --profile web add dsh-plugin-archive-manager
也可以在 Web UI 的 設置 → 插件 路徑下，按包名進行安裝。
卸載與升級：
- 卸載時將 add 替換爲 remove。
- 若從舊版 dsh-plugin-atlas 升級，需先執行 remove dsh-plugin-atlas 再安裝本包，歸檔規則會自動沿用。
典型用法¶
- 在 Web UI 的設置中找到該插件入口。
- 進入歸檔管理界面，瀏覽或搜索已歸檔會話。
- 在自動歸檔配置頁，設定保留策略。
- 每日覈查一次自動歸檔規則，執行前可使用預覽清單確認操作對象。
適用場景與注意事項¶
該插件適用於需要長期維護 DSH 會話歷史、希望自動化清理舊會話的開發者或運維人員。
注意事項：
- 插件的所有寫操作要求同源 POST。
- 自動歸檔只調用 DSH 公開的 archiveSession 接口，取消歸檔經由註冊表預留的狀態寫入路徑完成。
- 規則數值有範圍校驗。
- 插件不刪除任何會話或文件，僅改變其歸檔狀態。若未來 DSH 的改動使其失效，插件會明確報錯而不是損壞數據。
- DSH Desktop 內嵌同一 Web UI，插件安裝後即刻在桌面端生效。
總結¶
dsh-plugin-archive-manager 通過集中的界面和自動化規則，解決了 DSH 會話歸檔管理的痛點。它不破壞數據安全，僅在註冊表層面進行狀態變更，適合作爲 Harness 生態中會話生命週期管理的補充工具。
