前言¶
在使用 DeepSeek Harness (DSH) 及相關 AI 終端工具（如 Claude Code、Codex CLI、WorkBuddy）時，本地會話文件會持續積累。手動管理這些文件不僅繁瑣，且容易誤刪重要數據。dsh-session-sweeper 插件旨在提供一個安全的會話管理入口，讓你在 DSH Web 界面中掃描、查看並清理這些本地歷史記錄。
這是什麼¶
這是由 HrxSpace 維護的一個 DSH 插件。它掃描並管理電腦本地所有終端的會話（Claude Code、Codex、WorkBuddy、DSH 等）。
核心功能¶
該插件提供以下核心能力：
- 會話掃描與列表：掃描並列出會話，包含標題、項目、消息數、大小、最後活躍時間。
- 內容查看：查看會話內容，支持包含 DSH 日誌在內的預覽。
- 安全清理：默認採用隔離優先策略，將文件移動到回收站，並附帶 SHA-256 清單；支持一鍵批量恢復。
- 硬刪除：提供硬刪除功能，但需輸入確認短語
DELETE。 - 目錄讀取：支持讀取特定目錄下的會話（Claude Code、Codex、WorkBuddy、DSH）。
- API 與隱私：提供同源 JSON API (
/sweeper/api/*)，且無網絡訪問權限。
安裝與啓用¶
使用官方提供的命令進行安裝：
dsh plugin --profile web add github:HrxSpace/dsh-session-sweeper
安裝完成後，重啓 dsh web，然後在 Web UI 中打開 設置 -> 會話清道夫。
典型用法¶
在 會話清道夫 頁面，你可以看到本地所有會話的列表。若要執行硬刪除，系統會要求輸入確認短語 DELETE。
對於測試環境或自定義路徑，可以使用以下環境變量：
* DSH_SWEEPER_HOME：重定向掃描的源目錄
* DSH_SWEEPER_RECYCLE：重定向回收站根目錄
適用場景與注意¶
該插件運行在當前 dsh 進程的權限上下文中，操作前建議檢查源碼與許可證。
- 數據安全模型：默認隔離窗口爲 24 小時，活躍會話會被跳過。當前正在被使用的會話不可清理。
- 文件操作範圍：插件僅觸碰會話文件，不會修改配置、憑據、記憶或待辦事項。
- 目錄讀寫：
- 讀取：
~/.claude/projects/**、~/.codex/sessions/**、~/.workbuddy/projects/**、~/.dsh/sessions/** - 寫入：僅回收站目錄（默認爲
~/.hist-sweeper/recycle）
- 讀取：
- 卸載行爲：回收目錄和審計日誌在卸載後仍會保留，手動刪除
~/.hist-sweeper即可徹底清理。
短結尾¶
更多詳情請訪問 GitHub 倉庫。
