DeepSeek Harness (DSH) 採用插件化架構。在開發或調試過程中,會話積累較多時,清理歸檔或徹底刪除會話通常需要進入特定路徑或等待後臺清理。dsh-session-dustbin 插件通過在左側會話菜單直接提供刪除入口,並在設置面板中統一管理歸檔會話,簡化了這一流程。
是什麼¶
該插件由 Github-CJX 維護,旨在解決 DSH 會話管理中刪除操作不便的問題。它爲會話列表增加了“刪除會話”選項,並提供了一個獨立的“會話紙簍”界面來查看和清理已歸檔的會話。
核心功能¶
- 左側會話菜單直接刪除會話:在會話行「⋯」菜單中,在「歸檔會話」下方追加「🗑 刪除會話」。
- 刪除鏈路:先經平臺
workspaceRegistry.archiveSession()歸檔(側邊欄立即收走該行)→ 刪除本地會話目錄 → 刪除頭幀緩存 → 清理workspace.json標記。 - 歸檔會話管理:在設置 -> 插件 -> 可配置 -> 「會話紙簍」中管理已歸檔會話。
- 輕量級列表:列表僅展示頭幀(標題/創建時間/輪數),不解壓
session.l.zstd,單條操作 O(1)。 - 不讀取內容:沒有任何對話內容讀取接口,也不提供展開查看詳情。
安裝與啓用¶
倉庫提供了 sync-profile.mjs 腳本用於同步。克隆倉庫後,運行該腳本即可將插件安裝到 DSH 的 profile 中,最後重啓 DSH Desktop 使其生效。
node sync-profile.mjs
典型用法¶
- 在左側會話行菜單點擊“🗑 刪除會話”。
- 在設置 -> 插件 -> 可配置中點擊“會話紙簍”管理歸檔。
適用場景與注意¶
- 不可逆操作:刪除操作不可逆,需勾選確認框。
- 菜單機制:菜單注入爲 DOM 注入,重開菜單可能恢復。
- 會話匹配:會話 id 通過標題反查,重複標題取第一個。
- 內存殘留:運行中 host 內存保留已刪 id,列表按目錄存在性過濾。
- 性能考量:不讀取對話內容以保證性能,需要查看內容請使用平臺的會話打開功能。
- 權限風險:插件以當前 DSH 進程權限運行,安裝前應檢查源碼與許可證。
總結¶
dsh-session-dustbin 是一個專注於會話清理的工具,它通過剝離對話內容、僅維護頭幀信息,在保證性能的前提下實現了直觀的刪除與歸檔管理。