前言¶
DeepSeek Harness 的桌面版默認操作中,存檔只會將會話移入存檔列表,會話本身依然存在。若要徹底刪除會話,通常需要手動清理文件。這個插件爲桌面版 DeepSeek Harness 增加了一個真正的“刪除會話”功能,利用回收站機制(默認 15 天)來管理會話,提供可逆的刪除操作和批量管理能力。
插件定位¶
名稱:cckbc/dsh-session-recycle-bin
維護者:cckbc
類別:記憶
許可證:MIT
這是一個爲 DeepSeek Harness 桌面應用(desktop profile)定製的插件。它通過修改應用內部狀態,將標準的“刪除”操作轉換爲“移動到回收站”,支持 7/15/30 天的保留期設置,並在設置頁面提供可視化的恢復或永久刪除入口。
核心功能¶
- 可逆刪除:刪除操作實際上是將會話日誌和緩存移動到回收站目錄。恢復時會逐個文件放回,包含標題和工作目錄。
- 即時反饋:側邊欄中的會話行會在刪除後立即移除,應用無需重啓。若刪除當前正在查看的會話,主視圖會自動切換到一個新會話,而非顯示空頁面。
- 多入口操作:
* 行菜單:會話行的...菜單末尾新增“刪除會話”。
* 懸停按鈕:鼠標懸停在會話行上時出現的垃圾桶圖標。
* 批量按鈕:側邊欄頂部工作區列表上方的批量刪除按鈕。 - 批量處理:批量刪除時會打開選擇器,在“設置 → 回收站”表格中勾選會話後,可通過表頭的按鈕進行批量恢復或永久刪除。
- 統一保留期:回收站的保留期(默認 15 天)是全局設置,適用於所有條目,可調整爲 7、15 或 30 天。
安裝與啓用¶
該插件僅支持 DeepSeek Harness 桌面應用(desktop profile)。
通過命令行安裝(Web 配置文件示例)¶
dsh plugin --profile web add github:cckbc/dsh-session-recycle-bin
通過插件頁面安裝(桌面應用)¶
- 在 DSH 側邊欄打開“插件”頁面,點擊“添加插件”。
- 輸入 Git 地址
github:cckbc/dsh-session-recycle-bin。 - 點擊“安裝”並啓用插件。
- 必須完全退出應用並重新打開,插件纔會生效。
通過本地目錄安裝¶
git clone https://github.com/cckbc/dsh-session-recycle-bin.git
將克隆的目錄添加到插件管理中,使用絕對路徑。安裝後需保持該目錄不變,否則依賴會失效。
典型用法¶
- 單次刪除:在側邊欄會話行的菜單或懸停按鈕中選擇“刪除會話”,確認後該會話即進入回收站。
- 批量刪除:點擊側邊欄頂部的工作區列表旁的批量按鈕,勾選多個會話後確認。
- 查看回收站:進入“設置” -> “回收站”,這裏以表格形式列出所有已刪除會話。
- 恢復或清空:在回收站表格中勾選會話,使用表頭出現的“恢復”或“刪除”按鈕操作。勾選“不再詢問”後,後續刪除將不再彈出確認框。
適用場景與注意¶
- 適用場景:需要定期清理大量會話,但又希望保留一段“後悔藥”以備恢復的場景。
- 版本與系統限制:當前僅驗證在 Windows + 0.2.0-rc.2 上有效。macOS/Linux 和其他 Harness 版本未經測試。
- 非原生功能:這不是 DSH 官方內置功能,而是通過打補丁的方式“嫁接”到應用上。應用更新可能導致插件失效,表現爲刪除或恢復報錯或無效。
- 數據安全:
- 沒有操作系統的回收站,也沒有“撤銷”按鈕。永久刪除或過期後文件直接移除。
- 沒有級聯清理:會話的附件(
<DSH_HOME>/attachments)、AgentTeams 工作目錄等衍生數據不受回收站保護,不會被自動清理。 - 恢復操作不會恢復會話的“固定”或“歸檔”狀態。
- 重複 ID 處理:如果同一 ID 存在於多個工作區目錄中,刪除操作只會移動第一個匹配的實例。
- 內存緩存:應用內存中維護的會話列表僅在下次啓動時重建。
結語¶
該插件爲 DeepSeek Harness 桌面版提供了實用的會話生命週期管理能力,通過回收站機制在便捷刪除和數據安全之間提供了平衡。如需查看源碼或目錄詳情,請參考下方鏈接。