DeepSeek Harness（DSH）採用插件化架構，通過插件擴展功能。在開發過程中，會話數量增多後，歸檔、移動、恢復以及查看會話詳情會變得繁瑣。dsh-sessions-manager 是一個由 TOBYCAI 維護的客戶端插件，旨在提供一個統一的會話管理面板，並增強主頁側邊欄的功能，解決會話碎片化管理的痛點。
該插件提供統一的視圖面板、跨工作區拖拽、批量操作、血緣關係查看以及存儲佔用分析等功能。
核心功能¶
統一面板與篩選¶
插件在「設置 → 會話管理」中提供了一個統一的會話管理面板，頂部提供「全部 / 活動 / 已歸檔」三個常駐視圖，低頻的「已收藏 / 空白 / 回收站」視圖則通過箭頭按鈕橫向滑出。支持按標題、會話 ID、工作區搜索，並按工作區篩選和創建時間或標題排序。
工作區與標籤管理¶
- 工作區篩選：支持按工作區進行篩選和排序。
- 標籤管理：支持爲會話打標籤（全局標籤數 ≤200，單會話 ≤10），並按標籤篩選。標籤索引跟隨本地 DSH 數據目錄，而非賬號。
- 篩選預設：可以將「視圖 + 工作區 + 排序 + 標籤」的組合保存爲篩選預設（≤20 條），一鍵應用。
側邊欄增強¶
在主頁側邊欄，插件提供了以下增強功能：
- 跨工作區拖拽：直接將側邊欄的會話拖拽到目標工作區標題即可切換工作區。
- 狀態圓點：會話左側顯示狀態圓點（未讀/工作中/等待反饋/完成/出錯），顏色直接讀取 DSH 原生狀態。
- 快捷菜單：通過 ⋯ 菜單可快速執行「標記未讀/已讀」、「移動會話」或「刪除會話」。
會話詳情與血緣¶
點擊會話行可查看詳情，包括磁盤佔用、輪次/步驟/消息/工具調用統計、圖片附件列表以及 write/edit 文件列表。
- 血緣視圖：提供「血緣（摺疊分組）」與「平鋪」兩種視圖。在血緣視圖下，子代理會話摺疊在父會話下（顯示爲「▸ N 子代理」），分支會話顯示綠色「⑂ 分支」標記。
- 空白會話：支持識別空白會話（僅包含生命週期元數據的會話），並在「空白」視圖中集中管理。
批量操作與回收站¶
- 批量多選：支持全選，並對選中項進行批量歸檔、恢復、刪除或移動。批量操作欄會吸頂，方便長列表操作。
- 回收站：刪除會話會先移入回收站，可在設置面板恢復或徹底刪除。回收站支持按時間自動清理（7/30/90天）。
導出與分析¶
- 導出：支持導出會話原始日誌（ZIP）和 Markdown 格式。
- 存儲佔用：提供按工作區聚合的存儲佔用分析，列出佔用最大的 Top 10 會話。
安裝與啓用¶
使用官方插件安裝命令進行安裝。
# 安裝插件
dsh plugin --profile desktop add "github:TOBYCAI/dsh-sessions-manager"
# 如果使用 Web 端
dsh plugin --profile web add "github:TOBYCAI/dsh-sessions-manager"
安裝完成後，重啓 DSH 或刷新頁面即可在「設置 → 會話管理」和主頁側邊欄看到該插件。
典型用法¶
- 統一管理：在「設置 → 會話管理」中查看所有會話，利用篩選欄和預設快速定位目標會話。
- 移動會話：直接在側邊欄將會話拖拽到其他工作區標題，或使用批量操作欄的「移動所選」功能。
- 查看詳情：點擊任意會話行，查看其磁盤佔用、工具使用分佈及血緣關係。
- 導出內容：在詳情面板底部下載 Markdown 或原始日誌。
- 自動歸檔：在設置面板維護欄中配置自動歸檔規則（如 30/60/90 天未活躍），自動清理無用會話。
注意事項¶
- 標籤索引：標籤索引跟隨本地 DSH 數據目錄，換機遷移時需要備份本地索引。
- 活躍會話移動：對於新版 Runtime 下正在被佔用的活躍會話，移動操作不會失敗，而是進入排隊隊列。需要重啓 DSH 後才能自動完成移動。
- 刪除機制：刪除會話會先進入回收站，並非立即物理刪除。已徹底刪除的會話無法恢復。
- 血緣顯示：在血緣視圖中，如果父會話被歸檔或刪除，其分支會話會掛在「來源」組頭下。
- 空白會話：空白會話需要進入設置面板的「空白」視圖中才能查看和清理。
- 兼容性：插件兼容 DSH 0.1.5+ 會話格式 v3。
總結¶
dsh-sessions-manager 通過統一的面板和側邊欄增強，提供了從歸檔、移動到詳情分析的一整套會話管理解決方案。它適合需要精細化管理大量會話、關注工具使用統計以及希望優化工作區結構的 DSH 用戶。
