前言¶
DeepSeek Harness (DSH) 支持會話歸檔功能，用於長期管理項目會話。原有的歸檔頁面僅提供「取消歸檔」操作，無法清理磁盤上的實際日誌文件。隨着使用時間增長，歸檔會話累積，磁盤佔用會持續增加。本插件在設置 →「已歸檔會話」頁面增加了刪除能力，支持刪除真實的會話記錄。
核心功能¶
本插件爲 DSH 客戶端增加了會話清理能力，具體包括：
* 單條刪除：在設置 →「已歸檔會話」頁面爲每條會話增加單獨刪除按鈕。
* 全部刪除：爲列表頂部增加「全部刪除」功能。
* 真實清理：刪除操作會將會話記錄從磁盤移除，而非僅從列表中移除。
* 殘留處理：顯示「會話記錄已不在磁盤上」的條目，保留歸檔狀態以便重試。
* 失敗重試：刪除失敗時保持歸檔狀態，不會從歸檔列表中消失。
安裝與啓用¶
安裝插件後需要重啓 dsh web 服務以掛載路由。
dsh plugin --profile web add <本倉庫>/plugins/dsh-session-cleanup/0.2.1-rc.2/dsh-session-cleanup-0.1.3.tgz
dsh plugin --profile web install
典型用法¶
- 取消歸檔：點擊每行右側，將會話放回側邊欄，日誌保留。
- 刪除：點擊每行右側的刪除按鈕，刪除該會話及其日誌（需二次確認）。
- 全部刪除：點擊列表上方的全部刪除按鈕，刪除所有已歸檔會話（需二次確認）。
安全邊界¶
- 接口範圍：刪除接口監聽
POST /plugins/dsh-session-cleanup/delete。 - 訪問限制：僅限本機迴環訪問（
127.0.0.1/::1），其他來源返回 403。 - 路徑約束：目標路徑必須落在
<DSH_HOME>/sessions之內。 - 排除項：不刪除
session_projcache/sessions/<id>。 - 不可逆：刪除操作不可恢復，會話日誌會被從磁盤上移除。
結語¶
該插件通過宿主側能力補全了 DSH 的會話生命週期管理，適合需要定期清理歸檔日誌的用戶。
