在 DeepSeek Harness (DSH) 的開發流程中，會話管理是基礎但常被忽視的一環。隨着對話量的增加，查找歷史記錄、整理工作區以及清理過期會話會變得繁瑣。dsh-chat-manager 插件通過擴展側邊欄和提供會話生命週期管理功能，解決了這一痛點。
插件介紹¶
dsh-chat-manager 是一個 DeepSeek Harness (DSH) 用戶級插件，提供統一的 Web UI 與桌面端界面。它旨在讓會話管理更直觀，支持會話的自動歸檔、刪除、恢復以及跨平臺操作。
核心功能¶
- 雙區域側邊欄：側邊欄分爲“工作區”與“聊天”兩塊。工作區保留 DSH 原生行爲；聊天區獨立管理會話，支持新建與搜索。
- 聊天文件夾自動歸檔：新會話按日期自動存入系統文檔目錄下的
DSH/年-月-日/。發出第一條消息後，插件會根據內容生成 slug 子文件夾，之後的讀寫操作均在此子文件夾內進行。 - 會話刪除功能：支持通過菜單刪除會話。操作包含二次確認，會清空日誌、工作區賬目與登記表，但會話文件夾原樣保留在磁盤上。
- 已歸檔會話管理：在設置面板的“已歸檔會話”列表中，可查看“工作區名：會話名”與最近更新時間，支持將已歸檔會話恢復或徹底刪除。
- 跨平臺支持：插件代碼共用，同時支持 Web UI (
dsh web) 與桌面端。
安裝與啓用¶
安裝前請確保 DSH 版本 >= 0.2.0-rc.2。
- 克隆倉庫並構建（Web UI 與桌面端共用代碼）：
git clone https://github.com/tvrpdfe/dsh-chat-manager.git
cd dsh-chat-manager
npm install
npm run build
- 安裝插件到 Web UI：
dsh plugin --profile web add "link:$(pwd)"
*注意：桌面端插件需在桌面端界面內通過“插件”頁面添加，CLI 不支持直接操作 `desktop` profile。*
- 重啓宿主進程並刷新頁面（Web UI 需按
Ctrl+F5）。
典型用法¶
- 新建聊天：點擊聊天區頭部的“添加聊天”按鈕。
- 刪除會話：點擊會話菜單（
⋯）→ 紅色“刪除會話”→ 確認。 - 已歸檔會話：進入設置 → 已歸檔會話。列表每行顯示工作區與會話名及時間，點擊“恢復”或“刪除”按鈕進行操作。
注意事項與依賴¶
- 環境變量：聊天根目錄默認爲系統文檔目錄，也可通過環境變量
DSH_CHAT_MANAGER_ROOT指定爲絕對路徑。 - Linux/macOS 限制：在 Linux 和 macOS 上，若嘗試刪除當前活躍的會話，操作會被拒絕。此時需重啓宿主進程後再重試。
- 搜索依賴：內容搜索功能依賴部署側的
session-query索引配置。若該索引被配置爲openAt: "never"，內容搜索將失敗並僅返回標題匹配。
