前言¶
DeepSeek Harness 內置了 SQLite FTS5 全文搜索引擎和跨會話引用機制,但沒有用戶界面。dsh-session-workbench 插件填補了這一空白,提供了從發現、瀏覽到插入引用的完整工作流。
核心能力¶
該插件主要包含會話庫和會話視圖兩個部分。
會話庫¶
提供歷史會話的全文搜索與召回能力。
* 全文搜索:支持按工作區、時間範圍、歸檔狀態篩選。搜索結果以片段形式展示,命中句子會有高亮。
* 定位與高亮:點擊 Locate 可跳轉至對應會話並高亮顯示具體消息。
* 引用召回:支持在輸入框中插入引用,每次最多選擇 3 個會話。
* 歸檔支持:搜索默認包含歸檔會話,並可通過篩選器切換顯示模式。
會話視圖¶
提供 Session KB 標籤欄的顯示/隱藏與拖拽排序功能。
安裝與配置¶
安裝命令如下:
dsh plugin --profile web add dsh-session-workbench
注意:使用會話庫功能需要啓用持久化 FTS 索引。在 Web profile 配置文件中設置 openAt: startup,以確保索引在啓動時構建並複用,避免每次搜索阻塞。
典型用法¶
- 打開右側邊欄的 Session KB 標籤頁。
- 若無關鍵詞,顯示最近會話列表;輸入關鍵詞後,展開搜索框進行搜索。
- 點擊結果展開預覽,點擊 Locate 定位到具體消息。
- 勾選會話(最多 3 個),點擊 Insert references into input 插入引用。
- 管理會話視圖:在 設置 中切換可見性,或通過右鍵/雙擊標籤欄進行拖拽排序。
限制與注意事項¶
- 環境要求:僅支持 DeepSeek Harness 的 Web profile。
- 索引配置:必須啓用持久化 FTS 索引,否則搜索功能不可用。
- 引用限制:單條消息最多引用 3 個會話,每個會話快照大小限制爲 64KB。
- 搜索機制:搜索爲精確短語匹配,不支持同義詞功能。
結語¶
該插件爲 DSH 用戶提供了跨會話檢索與上下文召回的閉環能力,適合需要頻繁回溯歷史對話的開發者與研究員。