会话工作台 PolinniZhong/dsh-session-workbench

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

搜索所有历史会话，把需要的会话以 @references 形式召回；管理会话视图的标签栏（显示/隐藏 + 排序）。一个插件，三个入口。

English · 中文 · Privacy · Docs

这是什么

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 个会话，作为引用 chip 插入输入框：

选入并插入

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

设置

视频

会话视图——在设置里拖拽排序（拖动 ⋮⋮ 手柄）：

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

会话视图——从标签栏面板拖拽排序（右键 / 双击标签）：

会话视图-面板拖拽排序

高清 .mp4 版本在 docs/videos/。

环境要求

- DeepSeek Harness（dsh），使用 web 配置档——插件是静态 bundle（客户端在运行时提供；刷新页面即可加载客户端改动，host/配置档改动需要重启）。
- 会话库搜索需要在 web 配置档里启用持久化 FTS 索引（openAt: startup），见安装。

安装

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

本地开发也可以用 link: 依赖（和 dsh-personal-center 同样的做法）。

启用全文搜索（必需）： web 配置档默认关闭 FTS 索引（openAt: never）。在 <DSH_HOME>/profiles/web/cordis.patch.yml 里覆盖它——用持久化索引路径和 openAt: startup，索引只在启动时构建一次，之后复用（:memory: 索引每次搜索都会重建，还会阻塞 host）：

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

⚠️ path 必须是绝对路径——平台用 path.resolve 解析，不会展开 ~ 或环境变量。写成 ~/.dsh/... 会悄悄把索引建在 DSH 依赖树里（升级后丢失，而且大量未 checkpoint 的 WAL 会让搜索耗时几分钟）。

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

用法

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

模型体验

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

- 把引用内容当作事实来源：回答基于其中的实现细节，并指出引用内容与当前问题之间的冲突；
- 快照有大小限制（默认每个会话 64 KB）；会话很大时只会保留一部分 —— 需要更早的细节时，请用户引用一个更聚焦的会话；
- 长会话可能被压缩（早期消息被检查点替换）—— 压缩后的内容依然可搜索（官方 FTS 索引包含被遮蔽的内容），所以「它被压缩了」绝不等于「它丢了」。

平台限制

- 每条消息最多引用 3 个会话；每个会话的快照预算为 64 KB（会话较大时预览会给出提示）；
- 搜索是字面短语匹配（FTS 的限制）—— 不支持同义词或语义；引号、OR、 都按普通字符处理；
- 只有用户 / 助手的文本和部分结构化事件会被索引 —— 不含推理、流式分块或消息头；
- 归档语义：搜索默认包含已归档会话；Recent 列表不包含；
- Locate 是尽力而为：平台没有暴露「按 seq 打开会话」的 API，所以 Locate 会向前翻页并对命中消息做文本匹配 —— 重复文本可能落到更早的一次出现，超过约 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 # client: better-sidebar tab + settings sections (会话库 / 会话视图) + tab-bar view panel (zh/en) ├── docs/ │ ├── DESIGN-SYSTEM.md # visual/interaction spec (measured values, incl. view drag styles) │ └── DESIGN.md # implementation design (host/client/insert-reference/archive/views) ├── PRIVACY.md └── README.md

实现细节见 DESIGN.md；平台相关说明见 PLATFORM-NOTES.md。

路线图

- 1.0.3（当前） — DSH 0.1.7 兼容补丁：插件设置 API 换模型（Config schema + describe/update 适配）、归档 storages 路径修正、client inject 清理；保留 ≤0.1.6 旧路径。功能基线同 1.0.2 不变（会话库 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.

License

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 · 会话 · 检索 · 召回 · 知识库 · 会话视图 · 标签栏 · 视图管理