前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”，這爲擴展系統提供了靈活性，但也意味着用戶需要自行管理各類工具。在長期使用或進行 Agent 開發時，會話數量往往迅速增加，導致側邊欄混亂、難以檢索和歸檔。dsh-session-manager 旨在解決這一痛點，爲 DSH Web 界面提供一站式的會話管理能力，無需修改 DSH 核心代碼即可運行。
插件簡介¶
dsh-session-manager 是一款本地運行的 DSH 插件，由開發者 qewregrfhnm 維護，基於 MIT 許可證開源。它爲 DSH Web 界面提供集中的會話控制，包括刪除（含回收站機制）、工作區管理、會話移動、未讀標記、導出以及全局上下文壓縮設置。
安裝¶
安裝此插件需使用 DSH CLI。安裝完成後，請重啓 dsh web 服務以確保插件生效。
dsh plugin --profile web add 'https://github.com/qewregrfhnm/dsh-session-manager/releases/download/v0.4.1/dsh-session-manager-0.4.1.tgz'
核心功能¶
該插件提供以下具體能力：
- 會話生命週期管理：支持刪除（進入回收站，保留最近 10 條）、恢復、徹底刪除以及已歸檔會話的一鍵恢復。
- 會話重命名：將修改寫入官方事件，重啓後不丟失，側邊欄即時同步。
- 數據導出：支持導出爲 Markdown（可讀對話記錄）或 JSON（無損完整事件日誌）。
- 工作區操作：支持將會話移動到其他工作區，支持拖拽排序工作區；移動操作僅修改元數據，不破壞日誌文件結構。
- 檢索與篩選：支持按標題、目錄實時搜索，以及按狀態（全部/運行中/未讀/已歸檔）篩選。
- 狀態標記：支持手動標記未讀/已讀，並與官方狀態點聯動。
- 活動統計：展示每個會話的輪次數、消息數及工具調用情況。
- 會話控制：支持繼續已歸檔會話、暫停運行中回合、在新聊天中繼續。
- 全局設置：提供全局上下文壓縮閾值設置，對所有 Agent 預設統一生效。
- 輔助功能：提供對話管理抽屜、清理子代理（孤兒）會話、打開日誌文件夾等工具。
使用方法¶
基礎操作¶
- 打開 DSH Web 界面側邊欄底部，進入 設置。
- 在左側導航中選擇 會話管理。
- 在主列表中可查看未歸檔會話，底部摺疊區包含已歸檔會話與回收站。
- 行內僅保留刪除按鈕，其他操作（如繼續、暫停、重命名、導出）需點擊行內的 更多 菜單。
移動與批量操作¶
- 移動會話：直接將會話行拖拽到目標工作區標題上即可移動；也可在“更多”菜單中選擇“移動到…”進行批量操作或新建工作區。
- 工作區管理：在工作區標題上懸停，可進行置於頂部、重命名或刪除操作。
重命名與導出¶
- 在會話行的“更多”菜單中選擇 重命名，輸入新名稱並確認。
- 在“更多”菜單中選擇 導出 Markdown 或 導出 JSON，瀏覽器將自動下載對應文件。
全局設置¶
進入 設置 → 通用設置，可配置對話上下文壓縮閾值（17%–90%）。該設置對所有 Agent 預設生效，保存後即時應用。
注意事項與限制¶
- 運行中的會話：當前正在運行或已加載（live）的會話無法被刪除或移動。
- 徹底刪除殘留：已徹底刪除的會話 ID 會保留在瀏覽器
localStorage中，這屬於無害殘留，防止刷新後數據“復活”。 - 本地運行：插件完全在本地運行，不包含任何遙測、統計上報或網絡請求。
- 兼容性：該插件基於 DSH
0.1.xrc 版本開發，依賴ctx.sessionPersistence等核心服務。
結語¶
dsh-session-manager 通過提供本地化的會話管理功能，幫助開發者更高效地組織對話流。通過回收站機制和導出功能，它在保留數據安全性的同時，降低了 DSH 的使用門檻。安裝並啓用該插件後，可以顯著改善多會話場景下的操作體驗。
