前言¶
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 用户提供了跨会话检索与上下文召回的闭环能力，适合需要频繁回溯历史对话的开发者与研究员。
