PolinniZhong/dsh-session-workbench

dsh-session-workbench — DeepSeek Harness 的会话工作台

搜索所有过往会话，并将所需的会话以 @references 形式召回；管理对话视图标签栏（显示/隐藏 + 重新排序）。一个插件，三个入口。

English · 中文 · 隐私政策 · 文档

它是什么

DeepSeek Harness 内置了全文搜索引擎（SQLite FTS5）和跨会话引用（@session mention），但两者都没有面向用户的界面。本插件补上了缺失的 发现 → 浏览 → 插入 这一层：

- 搜索 — 在所有过往会话（所有工作区）中进行全文搜索，支持工作区 / 时间范围 / 归档筛选，以及游标分页；
- 片段命中（v1.1） — 结果以每个会话的最佳命中 片段卡片 呈现：匹配的句子连同其上下文高亮显示（懒加载），让你看到 那句话，而不只是 哪个会话；
- 同会话命中（v1.2） — 展开片段卡片会显示一个“此会话中的更多命中”折叠区，包含其他匹配项（先显示 5 条，然后加载更多），每条都高亮显示——不必再为查找某个会话中其余的匹配项而翻找；
- 定位（v1.1，v1.2 中为复合锚点） — 点击片段卡片上的 定位 即可打开该会话，将窗口向前翻页，并滚动到确切的消息处，同时闪烁高亮；v1.2 会同时匹配命中句子 及其 前文，因此重复的措辞也能落到正确的出现位置；若无法匹配，会以非阻塞式提示告知你手动滚动；
- 召回 — 最多选择 3 个会话，一键将其作为引用芯片插入输入框；发送时，平台会注入只读快照（## Referenced sessions），AI 便结合你的历史上下文作答；
- 最近 — 一个极简的最近会话列表，让你无需搜索即可快速找到内容；
- 归档 — 搜索 默认包含已归档会话（带有“已归档”徽标，以及全部 / 仅活跃 / 仅归档筛选）——DSH 归档某个会话后，它在其他地方都不可见，因此搜索是唯一的找回途径；“最近”列表默认排除已归档会话；
- 设置 — 启用/禁用开关 + 默认搜索范围 + 隐私声明；
- 对话视图（1.0.0 新增） — 管理会话标签栏：从 会话工作台设置入口（会话视图分区） 以及标签栏本身的 右键 / 双击面板，对每个自定义视图进行 显示/隐藏 和 拖拽重新排序。

一切都 完全在本地运行，零网络请求；只读取会话元数据和命中片段，绝不修改或删除任何会话（见 PRIVACY.md）。

界面刻意做到 原生感：每一种颜色、间距、圆角、字体和交互（表头行、内联搜索、分组菜单、胶囊按钮、复选框）都依据 DSH 自身的设计系统——better-sidebar、工作区侧边栏和设置分区——进行测量，因此本插件看起来、用起来都像内置功能，而非第三方皮肤。
为什么需要这个插件（差异化）： 生态中的搜索插件止步于“哪个会话”；会话内导航插件（10+ 个）只能在当前会话内跳转。Session KB 是唯一一个闭合了跨会话搜索 → 片段级命中 → 在旧会话中定位到确切消息 → @recall 这一完整链路的插件。

截图

片段搜索（v1.1）——搜索“Vibe Coding”会返回按会话分组的片段卡片：匹配的句子高亮显示，下方为上下文：

片段搜索

定位（v1.1）——会话打开并滚动到确切的命中消息，同时闪烁高亮：

定位

选取并插入——最多勾选 3 个会话，将它们作为引用芯片插入输入框：

选取并插入

设置——带有可展开选项和隐私声明的启用/禁用卡片：

设置

视频

会话视图——在设置中重新排序（拖动 ⋮⋮ 手柄）：

会话视图-设置页拖拽排序

会话视图——从标签栏面板重新排序（右键单击/双击标签页）：

会话视图-面板拖拽排序

高清 .mp4 版本位于 docs/videos/。

要求

- 带有 web 配置文件的 DeepSeek Harness（dsh）——该插件是一个静态 bundle（其客户端在运行时提供；刷新页面即可获取客户端更改，主机/配置文件更改需要重启）。
- 对于会话库搜索，必须在 web 配置文件中启用持久化 FTS 索引（openAt: startup），参见安装。

安装

dsh plugin --profile web add dsh-session-workbench

本地开发也可以使用 link: 依赖（与 dsh-personal-center 相同的模式）。

启用全文搜索（必需）： web 配置文件默认禁用 FTS 索引（openAt: never）。在 /profiles/web/cordis.patch.yml 中覆盖它——使用持久化索引路径和 openAt: startup，这样索引在启动时构建一次并可重复使用（:memory: 索引会在每次搜索时重建并阻塞主机）：

- id: session-query-sqlite
config:
path: '/Users//.dsh/session-query.sqlite'
openAt: startup

⚠️ path 必须是绝对路径——平台使用 path.resolve 解析它，并且不会展开 ~ 或环境变量。写入 ~/.dsh/... 会静默地在 DSH 依赖树内创建索引（升级时丢失，并且大量未检查点的 WAL 会使搜索耗时数分钟）。

然后重启 DSH 应用（主机端配置和路由更改需要重启；客户端 bundle 更改只需刷新页面）。

用法

1. 在右侧边栏（better-sidebar）中打开 Session KB 标签页；设置 → Session KB 部分可以禁用/启用它；
2. 未输入关键词时，你会看到最近会话；点击搜索图标（右上角）展开输入框，输入关键词（字面短语匹配，例如 MCP config）即可切换到搜索结果；
3. 点击更多按钮（⋯）可按工作区 / 时间范围 / 归档进行筛选（全部含已归档 / 仅活跃 / 仅已归档）；
4. 点击某条结果可展开预览（命中上下文 + 会话元信息）；点击定位可打开该会话并滚动到确切的命中消息（闪烁高亮）；点击路径可展开完整路径；然后勾选它（最多 3 个）；
5. 点击将引用插入输入框 → 输入框中出现 @session 标签 → 继续输入你的问题 → 发送；
6. 平台会将只读快照注入模型上下文，AI 便会结合你的历史记录作答；
7. 管理会话视图 — 打开设置 → 会话工作台 → 会话视图，可切换每个视图的可见性，并拖动 ⋮⋮ 手柄重新排序，或右键单击 / 双击会话标签栏以就地打开同一面板。

模型体验

当用户提到“之前 / 上一个会话 / 我们当时是怎么做 X 的”——任何需要过往上下文的内容——建议打开右侧边栏中的会话知识库标签页，进行搜索，并引用匹配的会话。被引用的会话会以 ## Referenced sessions 只读快照的形式进入你的上下文：

- 将被引用的内容视为事实来源：基于其实现细节作答，并指出被引用内容与当前问题之间的冲突；
- 快照有大小限制（默认每个会话 64 KB）；对于大型会话，可能只保留一部分——当你需要更早的细节时，请让用户引用一个更聚焦的会话；
- 长会话可能会被压缩（早期消息被检查点替换）——被压缩的内容仍可搜索（官方 FTS 索引包含被遮蔽的内容），因此“它被压缩了”绝不意味着“它丢失了”。

平台限制

- 每条消息最多引用 3 个会话；每个会话的快照预算为 64 KB（会话较大时预览会显示提示）；
- 搜索为字面短语匹配（FTS 限制）——不支持同义词或语义；引号、OR、 均被视为普通字符；
- 仅对用户/助手文本及部分结构化事件建立索引——不包含推理过程、流式分块或标头；
- 归档语义：搜索默认包含已归档会话；最近列表则不包含它们；
- 定位为尽力而为：平台未暴露“在 seq 处打开会话”的 API，因此定位会向后翻页并对命中消息进行文本匹配——重复文本可能落在更早的出现位置，而超过约 500 条消息之前的命中会回退为手动滚动的提示。

开发

dsh-session-workbench/
├── package.json          # dsh.bundle.patch + dsh.client.platform=web + exports["./client"]
├── cordis.patch.yml      # plugin row (session-workbench)
├── lib/
│   ├── index.js          # host: loopback routes /session-kb/ (search/context/settings) + isLoopback + archive
│   └── client.js         # 客户端：better-sidebar 标签页 + 设置分区（会话库 / 会话视图）+ 标签栏视图面板（中/英）
├── docs/
│   ├── DESIGN-SYSTEM.md  # 视觉/交互规范（实测值，含视图拖拽样式）
│   └── DESIGN.md         # 实现设计（host/client/insert-reference/archive/views）
├── PRIVACY.md
└── README.md

实现参见 DESIGN.md；平台说明见 PLATFORM-NOTES.md。

路线图

- 1.0.2（当前） — DSH 0.1.2-rc.1 兼容性补丁：会话视图的隐藏/排序不再误伤设置弹层内其它插件的同数量 tab 条（守卫改类名无关，曾致 dsh-personal-center「外观/宠物」tab 被隐藏）；功能基线同 1.0.1（会话库 search → snippet → locate → recall + 会话视图 tab bar show/hide + drag reorder）；
- 会话库历史：v1.2（同会话多片段 + 组合锚点）/ v1.1（片段级检索）/ v1.0（搜索召回）；
- v2.0 — bookmarks / notes / tags + cost integration + long-session handoff index (FR-HANDOFF)；
- v3.0 — backlinks + reference graph + related sessions。

许可证

MIT

中文

会话工作台（Session Workbench） = 会话库 + 会话视图，一个插件：

- 侧边栏·会话库：全文搜索全部历史会话，把最多 3 个会话以 @引用 插入输入框，发送后平台注入只读快照，AI 带着历史上下文回答；
- 设置·会话工作台（一个条目，内含两个分区）：「会话库」分区（启用开关 + 搜索默认范围 + 隐私说明）+「会话视图」分区（每个视图「显示/隐藏」开关 + ⋮⋮ 拖拽排序）；
- 标签条右键/双击面板：快捷管理会话视图（同款开关 + 拖拽排序）。

会话库要点（继承自 dsh-session-kb）：

- 搜索用官方本地 SQLite FTS5 索引（ctx.sessionQuery）——零网络请求，纯本地；
- 片段级检索：结果升级为「片段卡片」（命中句高亮 + 前后文），点「定位」打开旧会话、翻到命中位置并滚动到那条消息（高亮 2s）；
- 同会话多片段：展开片段卡片查看同会话其余命中（前 5 条 + 加载更多，均带关键词高亮）；定位用「命中句 + 前文」组合锚点；
- 召回走官方会话引用机制（@label → ## Referenced sessions）；
- 归档：搜索默认包含已归档会话（带「已归档」徽标 + 全部/仅未归档/仅归档筛选）；最近列表默认排除归档。

关键词：dsh-plugin · deepseek-harness · session-search · knowledge-base · recall · view-management · conversation-view · 会话 · 检索 · 召回 · 知识库 · 会话视图 · 标签栏 · 视图管理