前言¶
DeepSeek Harness（DSH）採用“一切皆插件”的架構。隨着使用時間增長，會話數據會不斷積累，手動篩選和管理變得低效。這個插件提供了一套結構化的會話管理方案，旨在解決會話堆積帶來的查找困難問題。
插件簡介¶
dsh-session-manager 是由 duo-stack 維護的 DSH 客戶端插件。它將現有的會話列表按工作區進行分組展示，並提供歸檔、取消歸檔、刪除以及批量清理歸檔會話的能力，不改變宿主原有的行爲邏輯。
安裝與啓用¶
通過官方 CLI 將插件安裝到指定的 profile 中：
dsh plugin --profile <profile> add @duo-stack/dsh-session-manager
安裝完成後，使用該 profile 啓動 DSH 即可加載插件。
使用方法¶
啓動 DSH 並打開 設置，左側導航欄會出現名爲 「會話管理」 的分區，這是插件的唯一界面入口。
- 未歸檔頁籤：顯示當前未歸檔的會話。在此頁籤中，可以對單個會話進行 歸檔 或 刪除 操作。
- 歸檔頁籤：顯示已歸檔的會話。在此頁籤中，可以將會話 取消歸檔、刪除，或者按工作區/全部進行 批量刪除。
功能細節¶
- 按工作區分組展示：會話列表以工作區爲單位分組，每個工作區對應一張卡片。
- 實時刷新與無需重啓：所有操作（歸檔、取消歸檔、刪除）通過 registry 機制同步更新內存態與磁盤，觸發
domain/changed事件，左欄會話列表及頁面即時刷新。 - 自動清理幽靈會話：插件啓動時會自動清理因早期刪除失敗而殘留的“有記賬、無目錄”的幽靈會話，只列出磁盤上仍有內容目錄的會話。
- 雙頁籤設計：界面分爲「未歸檔」與「歸檔」兩個頁籤，操作邏輯清晰。
注意事項¶
- 數據修改風險：歸檔、取消歸檔、刪除操作會直接修改真實會話數據，請務必在測試環境中確認操作邏輯後再在生產環境使用。
- 構建限制：該插件的客戶端 bundle 不能使用 DSH 官方 preset 構建，項目採用手動復刻官方懶加載工廠格式的方案。
