前言¶

在使用 DeepSeek Harness（DSH）進行智能體開發時，側欄中的會話與子代理會話會隨着調試迭代不斷累積。手動刪除這些目錄或清理配置文件不僅繁瑣，還容易誤刪重要數據。dsh-session-remover 插件通過在 UI 菜單中增加刪除入口，利用 Windows 回收站機制提供了一種可還原的清理方式。

是什麼¶

這是一個 DSH 插件（包名 dsh-session-remover），由維護者 sailoumili 開發。它解決了側欄會話管理的清理痛點，允許用戶在菜單中直接刪除對話及其子代理會話，並將文件移入 Windows 回收站，而非直接永久刪除。

安裝¶

安裝需針對 Web 和 Desktop 兩個 Profile 分別執行。安裝完成後，需在 DSH 插件設置中啓用該插件，並重啓客戶端。

# 網頁版
dsh plugin --profile web add dsh-session-remover

# 桌面版
dsh plugin --profile desktop add dsh-session-remover

使用¶

啓用插件後，側欄會話行的操作菜單將增加兩項功能。

1. 刪除單條會話
   將鼠標指針移至側欄任一會話行，點擊行尾的「…」。
   在彈出的菜單中點擊「刪除對話」。
   在確認彈窗中點擊「確定」。
   頁面自動刷新，該會話行消失。

2. 批量刪除會話
   點擊「批量刪除…」。
   在浮層中勾選目標對話（支持全選/全不選）。
   勾選確認項，點擊「刪除選中的 N 個」。
   批量刪除期間不響應關閉操作，需等待執行完畢。

工作原理與清理¶

該插件執行刪除操作時會進行多項清理工作：

• 回收站機制：將對話及其子代理會話目錄移入 Windows 回收站。刪除前會檢查目標磁盤是否啓用了回收站功能，若未啓用則拒絕刪除。
• 清理記錄：同步清理三處記錄——投影緩存、工作區記賬、歸檔集合。
• 子會話處理：連帶刪除子代理會話（子會話不顯示於側欄與搜索）。由 fork 產生的獨立分叉會話不屬於子代理會話，不會被連帶刪除。

注意事項¶

• 平臺限制：僅支持 Windows。刪除邏輯依賴系統腳本宿主 cscript.exe，在其他系統上會報錯並拒絕操作。
• 還原後的位置：由於插件清除了工作區記賬，還原後的對話會出現在側欄的「未分組」中，而非原工作區。
• 附件處理：插件不回收附件，因爲附件按內容尋址且無引用計數，無法安全判斷其歸屬。
• 安全限制：刪除接口 /api/session.delete 僅接受本機請求（127.0.0.1 等），局域網訪問會返回 403。
• 磁盤要求：會話目錄若位於網絡盤、U 盤或未啓用回收站的磁盤（如 FAT/exFAT），插件會拒絕刪除，不會退化爲永久刪除。

總結¶

dsh-session-remover 爲 DSH 用戶提供了可視化的會話清理方案，通過回收站機制降低了誤刪風險。安裝和使用過程簡單，但在使用前需確認操作系統環境與磁盤迴收站設置。