前言¶
在使用 DeepSeek Harness 的 Web 模式時,側邊欄是主要的工作區。默認的會話列表會混合活躍會話、空白會話和歸檔會話,查找特定對話或管理歷史記錄需要頻繁滾動。dsh-session-control 旨在解決這一問題,通過替換側邊欄主體來提供結構化的會話管理功能。
插件定位¶
這是一個客戶端插件,由開發者 GooDAnDReaDY 維護。它接管側邊欄中原本顯示工作區和會話列表的部分,提供固定、搜索、歸檔和降噪等能力,而不改變側邊欄的其他 UI 組件(如品牌區、新建按鈕或設置入口)。
安裝與啓用¶
通過 DSH CLI 安裝該插件:
dsh plugin --profile web add @goodandready/dsh-session-control
安裝完成後,需要重啓 DeepSeek Harness 的 Web Profile 以激活插件。
核心功能¶
-
固定會話
將重要對話固定在側邊欄頂部,形成一個全局可見的固定區域。配置會持久化存儲,刷新頁面或切換設備後依然存在。 -
帶上下文的搜索
搜索對話內容時,不僅返回標題,還會顯示匹配片段的預覽,幫助快速判斷會話相關性。 -
按時期歸檔
會話自動按時間分組爲“今天”、“本週”、“本月”和“更早”。摺疊時期可以提升性能,尤其是當歷史會話數量較多時。 -
只讀歸檔查看器
對於已歸檔的會話,無法直接用於聊天。插件提供了一個只讀的轉寫查看器模態框,用於檢查過往的對話記錄、工具調用和用戶提示。 -
自動降噪
自動隱藏無消息的空白會話(如調度程序或網關產生的會話),保持側邊欄整潔。當前活躍的會話即使爲空也不會被隱藏。 -
可逆的會話隱藏
支持一鍵隱藏活躍會話。與歸檔不同,這種隱藏是可逆的,可以隨時恢復查看。 -
多選和批量操作
通過複選框和 Shift+Click 範圍選擇,支持批量隱藏、取消隱藏或固定多個會話。 -
原地重命名
無需彈出模態框,直接雙擊會話標題或按F2鍵即可在行內修改名稱。 -
標籤系統
爲會話打標籤,便於按標籤篩選。標籤系統獨立於文件夾結構,彌補了會話歸屬由工作目錄決定的限制。
典型用法¶
- 快速跳轉:按下
Alt + K快速打開跳轉模態框,篩選活躍和歸檔會話。 - 重命名:雙擊會話標題或按
F2鍵進行原地編輯。
注意事項¶
- 架構變更:該插件會替換側邊欄主體(
sidebar.workspacesslot),這是架構設計的要求。 - 環境依賴:依賴 Node.js 20+ 環境,且需要安裝
@deepseek-ai/cordis ^4.0.2。 - 會話歸屬:會話的歸屬由其工作目錄決定,無法通過插件跨文件夾移動會話。
生態背景¶
DeepSeek Harness 遵循“一切皆插件”的理念。此插件屬於社區插件,與 DeepSeek 官方或幻方沒有任何從屬關係。