dsh Session Manager（會話管理插件）

前言¶

DeepSeek Harness（DSH）的部署級插件，在 Web 設置的「會話管理」頁統一管理所有會話。它解決了在原生界面中分散管理歸檔、刪除和批量操作的需求，支持恢復歸檔、刪除會話、按工作區分組及多選批量操作。

核心功能¶

恢復歸檔¶

將已歸檔的會話移回側邊欄。插件通過平臺 host/archived-sessions-changed 幀實時同步所有瀏覽器頁面。

刪除會話¶

刪除操作包含三步：移除工作區記賬、歸檔集合隱藏、刪除磁盤日誌。
* 冷會話：立即刪除。
* 運行中會話：隱藏後，等會話停止（刷新頁面或 60 秒掃描後）自動刪除。

批量操作¶

支持多選刪除、刪除所選、刪除全部已歸檔、全部刪除，以及恢復全部已歸檔。

按工作區分組¶

清單包含未分組項，每行可進行歸檔、恢復或刪除（刪除需二次確認）。

狀態持久化¶

已刪/待刪記錄寫入 .session-manager-state.json。插件或進程重啓後，該狀態不會自動復活。

安裝與啓用¶

該插件依賴 dsh 運行時與構建環境，不支持遠程直接安裝，必須先 clone 倉庫再本地安裝。

1. 拉取代碼

git clone git@github.com:DM-Odyssey/dsh-session-manager.git
cd dsh-session-manager

2. 本地安裝
   在倉庫根目錄執行：

dsh plugin --profile web add "$PWD"

這會將該目錄作爲 bundle 安裝，並處理依賴關係。

3. 重啓

npx @deepseek-ai/dsh web

重啓後進入「設置 → 會話管理」即可使用。

使用方法¶

1. 在側邊欄（原生三點菜單）將不需要的會話「歸檔」。
2. 打開 設置 → 會話管理。
3. 單個操作：每行可執行「歸檔 / 恢復 / 刪除」（刪除需二次確認）。
4. 批量操作：
   * 全選
   * 恢復全部已歸檔 (N)
   * 刪除全部已歸檔 (N)
   * 刪除所選 (N)
   * 全部刪除

注意事項與安全¶

• 刪除機制：刪除會話涉及工作區記賬移除、歸檔集合隱藏以及磁盤日誌目錄刪除。日誌路徑經嚴格校驗，僅允許刪除以會話 id 命名的 session.jsonl[.zstd] 所在目錄。
• 孤立 ID：歸檔集合裏的孤立 id（對應日誌已不存在的會話）會被當作清除項處理，不再反覆出現。
• 狀態文件：刪除記錄保存在 <workspace>/.session-manager-state.json 中，手動刪除該文件可重置記錄。

參考資料¶

• 插件目錄頁
• GitHub 倉庫