前言¶
在使用 DeepSeek Harness (DSH) 進行智能體開發或日常交互時，隨着會話數量的積累，側邊欄工作區的管理效率往往成爲瓶頸。缺乏直觀的會話統計、歸檔功能受限以及跨工作區會話流轉不便，是常見的痛點。dsh-session-xc 插件旨在通過擴展側邊欄的交互能力，解決這些問題。
插件介紹¶
這是一個爲 DSH 側邊欄工作區提供會話管理增強的插件。插件由開發者 xchannel1987 維護，採用 MIT 許可證。
核心價值在於對現有工作區列表的補充：它不再只是簡單的列表展示，而是增加了統計維度、歸檔與恢復機制、跨工作區的拖拽流轉能力，以及針對新會話的自動化命名輔助。
核心功能¶
插件提供以下已覈實的功能：
- 會話數統計展示：在工作區名稱旁顯示會話數量。支持兩種格式：
(3)表示 3 個活躍會話；(2/3)表示 2 個未讀完成會話 / 3 個活躍會話（綠色數字）。 - 歸檔會話管理：在側邊欄工作區操作區提供歸檔入口。用戶可以在歸檔面板中查看已歸檔會話，並支持恢復或刪除操作。
- 跨工作區移動：支持通過拖拽將會話移動到其他工作區。移動時會自動更新會話歸屬，且在特定條件下（如常駐排隊會話）會自動排隊持久化，並在重啓後自動完成。移動操作支持標題保留。
- 只看活躍會話篩選：提供篩選開關，可僅顯示當天（最後操作時間）有活躍記錄的會話，幫助快速聚焦當前工作流。
- 新會話首輪自動起名：在新會話完成第一輪對話後，插件會嘗試調用模型爲會話生成一個有意義的標題。此功能僅針對非官方模型路由（非
deepseek-official）生效。
安裝與配置¶
安裝
通過 DSH CLI 安裝：
dsh plugin --profile web add dsh-session-xc
安裝完成後需重啓 DSH 以加載插件。
配置項
插件在設置頁面提供了以下可配置項（默認值均爲 true）：
| 配置項 | 說明 |
|---|---|
showSessionCount |
顯示工作區旁的會話數統計 |
showArchiveEntry |
工作區操作區顯示歸檔按鈕 |
enableSessionMove |
啓用拖拽移動會話功能 |
showActiveFilterEntry |
搜索按鈕左側顯示“只看活躍會話”開關 |
autoTitleFirstRound |
開啓新會話首輪自動起名（僅非官方路由生效） |
使用示例¶
查看會話統計
在工作區列表中，工作區名稱旁邊會直接顯示當前工作區的會話數量。展開工作區後，可以看到更詳細的統計信息。
恢復與刪除歸檔會話
- 點擊工作區旁的歸檔按鈕（通常爲文件夾圖標）。
- 在彈出的歸檔面板中找到目標會話。
- 恢復：點擊「恢復」按鈕（PC 端）或點擊整行（移動端）。
- 刪除：在歸檔面板中，PC 端點擊紅色「刪除」按鈕，移動端則需左滑後點擊「刪除」。確認後會話文件將被永久移除。
移動會話到其他工作區
- 長按會話行開始拖拽。
- 將其拖拽到目標工作區或目標工作區下的會話上。
- 當目標高亮顯示時釋放鼠標/手指。
- 在確認對話框中確認移動。若提示“已排隊”，說明該會話在當前進程內處於常駐激活狀態，需重啓 DSH 後纔會完成移動。
篩選活躍會話
點擊抽屜頭部搜索按鈕左側的開關按鈕（開啓後呈主題藍色按壓態），列表將僅顯示今天有操作記錄的會話及其所在工作區。再次點擊即可恢復完整列表。
新會話自動起名
- 開啓一個新會話並完成第一輪對話。
- 約 1.5 秒後，插件會使用該會話自身的模型生成標題。
- 側邊欄或標籤頁的標題會自動更新。注意，此功能僅在非官方模型路由下生效。
注意事項¶
- 版本要求：插件需要 DSH 版本
0.1.7或更高版本。設置入口位於新版插件頁，舊版設置入口已移除。 - 路由限制：新會話首輪自動起名功能僅在非官方 DeepSeek 模型路由（
provider非deepseek-official）下生效。官方路由下已有內置起名機制，插件不會重複調用。 - 移動端操作：在移動端刪除歸檔會話時，必須使用左滑手勢操作。
- 重啓機制：對於常駐激活的會話（例如在 DSH 進程中被打開過的會話），拖拽移動後可能需要重啓 DSH 才能完成實際的文件流轉。
結尾¶
dsh-session-xc 通過引入統計、歸檔、移動和篩選等機制，顯著提升了 DSH 在多工作區場景下的管理效率。對於需要精細化管理會話的開發者或用戶而言，這是一個實用的增強工具。
