dsh-session-cleaner：DeepSeek Harness 歸檔會話管理插件

DeepSeek Harness 長期運行後，歸檔會話會積累大量數據，可能佔用存儲空間或干擾當前的會話管理。手動管理這些數據不僅繁瑣，還容易誤刪或造成狀態不一致。dsh-session-cleaner 插件通過提供專門的“歸檔會話”頁面，解決了這一問題。它不修改現有菜單，而是複用 DSH 的語義設計，專注於對已歸檔會話的集中管理。

該插件由 TheM14 維護，採用 MIT 許可證。核心價值在於對已歸檔會話的集中管理，支持恢復、安全刪除、清理殘留以及基於新預設的歷史延續。

核心功能¶

會話列表：按工作區列出歸檔會話，包含標題、創建時間、日誌狀態和在線狀態。
預設檢查：顯示每個會話的有效預設，並標記缺失或損壞的預設。
恢復會話：將會話恢復到原工作區，並立即更新官方側邊欄。
永久刪除：通過回滾感知的隔離和提交流程，永久刪除歸檔會話。
清理殘留：清理幽靈歸檔條目、孤立工作區槽位、孤立投影緩存行和隔離日誌。
歷史延續：創建完整的歷史延續，選擇任意可用系統或用戶預設繼續對話。

安裝與啓用¶

在本地克隆倉庫並構建後，將插件添加到 dsh Web 配置中。

cd path\to\dsh-session-cleaner
dsh plugin --profile web add .
dsh web

使用方法¶

打開 dsh 設置，選擇“歸檔會話”。
選擇“恢復”將對話返回原工作區。
選擇“刪除”並確認，永久移除日誌和註冊表數據。
選擇目標預設並選擇“使用預設繼續”，創建帶有完整繼承歷史的新會話。
選擇“清理殘留”以移除安全可識別的殘留物。

數據安全與限制¶

刪除操作具有嚴格的順序，以確保數據安全：

驗證 archived + not live
  -> rename log into quarantine
  -> commit workspace registry
  -> commit projection cache
  -> purge quarantined log

如果在提交註冊表或投影緩存時失敗，插件會停止並嘗試回滾先前的更改。如果邏輯刪除提交成功但文件清理失敗，隔離日誌將保留在 $DSH_HOME/storages/.dsh-session-cleaner-trash/ 目錄中，可通過“清理殘留”功能移除。

注意以下限制：
* 刪除是永久的，活動會話永不刪除。
* 如果主機仍擁有會話，請重啓 dsh 並在刪除前不再打開該會話。
* 每次請求都需要插件特定的哨兵頭。
* 請求體限制爲 64KB。

適用場景與注意¶

此插件適合需要徹底清理歸檔數據或需要基於舊會話歷史開啓新任務的用戶。由於插件以當前進程權限運行，安裝前應檢查源碼與許可證。