会话全文搜索 Augl-l/dsh-session-search

DSH 会话搜索

在 DSH 桌面应用里，按消息粒度搜索每一个会话。

全文搜索所有历史会话。中文单字和关键词都能搜；结果按对话轮次紧凑排列，支持跳转和高亮。所有数据都留在本地 SQLite 索引里——不联网，不上传。

功能

- 侧边栏面板 + 标题栏快捷入口——侧边栏有放大镜入口，会话标题旁边还有一个紧凑的「搜索历史」按钮。
- 搜索每一个会话——跨所有工作区做消息级全文搜索。中文单字、词语、Markdown 源码和 LaTeX 公式都能搜。
- 紧凑的轮次行——每个对话轮次一行，微信风格：标题 + 轮次编号 + 日期，一条高亮摘要，外加一个展开按钮显示其余命中。首屏返回 5 个轮次；「查看全部」就地扩展到 200 个。
- 相关性优先排序——用户/助手文本按 BM25 相关性排序，再叠加关键词位置、来源类型和指数衰减的时效性。随时在相关性和最新之间切换。
- 跳转与高亮——点击结果会打开会话，滚动到对应轮次，命中内容藏在折叠的工具调用或推理块里时自动展开，并在聊天中高亮匹配项。
- 纯本地索引——首次使用时自动构建 SQLite FTS5（trigram）索引，增量保持更新，并自动压缩。22k 条消息约占 40 MB；会话日志本身从不修改。
- 健壮性——索引损坏会自动重建；单个会话读不出来不会中断构建；宿主服务缺失只会禁用面板，不影响应用。

环境要求

- DSH 桌面版 0.2.1-rc.3（已测试）。
- 宿主服务 webServer、sessionPersistence / sessionQuery，以及 Node 的 node:sqlite。
缺少其中任何一项时，插件仍会加载，面板会说明哪项不可用。

安装

从仓库 release 下载 .tgz，然后任选一种：

插件管理器

1. 打开 DSH → Plugins → Add → Local path。
2. 选择 .tgz（如果你的插件管理器只接受文件夹，就选解压后的目录）。
3. 重启 DSH，或等待热重载。

命令行

dsh plugin --profile desktop add ./dsh-session-search-1.1.1.tgz

启用后，从侧边栏打开 Session search。首次打开会在后台构建索引并显示进度；已建好索引的内容在此期间就能搜。

使用

- 输入关键词，按 Enter。中文单字也能搜。
- 来源过滤——默认只搜你和助手。需要时再打开工具、推理或系统；索引里本来就有这些内容，只是默认被过滤掉。
- 排序——相关性（默认）或最新。
- 查看全部——首屏显示 5 个轮次；底部按钮把同一结果集扩展到 200 个轮次，不重新执行查询。
- 点击某一行 —— 打开来源会话并跳到那一轮，同时高亮匹配处。如果命中位置在折叠的工具调用或推理块里，插件会先展开它。如果聊天界面确实渲染不出命中内容（注入的系统上下文、被截断的工具卡片），会弹出提示告诉你，而不是高亮到错误的位置。
- 状态会记住 —— 查询、筛选、排序、展开的行和滚动位置，在跳进对话再回来之后都还在。

工作原理

session logs ──> Host indexer ──> SQLite (messages + FTS5 trigram)
│
HTTP /.dsh-session-search/*
│
Client panel (Cordis slots)

- 宿主端通过 sessionPersistence / sessionQuery 读取会话事件，把它们折叠成可搜索的消息，存进 ~/.dsh/storages/session-search.sqlite。
- FTS 索引只覆盖对话文本（用户 + 助手）。启用工具、推理、系统这几类来源时，用 LIKE 搜索，这样索引能小一个数量级。
- 客户端是普通的 Cordis 客户端插件：一个 sidebar.panellist 条目、一个用同一 id 作键的 main 面板，外加一个 conversation.header.leading 快捷入口。它通过上面那些同源 HTTP 路由和宿主通信。
- 索引是派生数据：随时可以删掉，也可以在面板里用 Rebuild index 重建。

隐私

- 一切都在本地。插件不会把任何消息内容发到别处。
- 索引会存消息文本（能搜索就靠这个）。把 ~/.dsh/storages/session-search.sqlite 当作敏感文件；想删掉索引就直接删它。
- 会话日志以只读方式打开，从不修改。

已知限制

- 很旧的会话日志格式可能被宿主拒绝；面板会显示跳过了多少个会话。
- 搜索工具 / 推理 / 系统会慢一些（大约 60–80 ms），因为它走子串扫描，不用 trigram 索引。
- 有些命中没法高亮，因为聊天界面渲染不出来：注入的系统上下文、只显示截断摘要的工具卡片、被当前显示模式隐藏的推理。插件会定位到那一轮并给出说明。
- 在很大的会话里跳到旧的一轮，可能要等几秒，因为聊天在加载历史。
- 跳转 / 高亮集成依赖 DSH 聊天的 DOM 约定；已在 0.2.1-rc.3 上测试，其他版本可能需要更新。

开发

index.js host half: indexer + HTTP routes
client.js client half: sidebar panel, result list, jump/highlight
cordis.patch.yml
package.json

构建可安装的包：

pnpm pack

快速检查：

node --check index.js
node --check client.js

许可证

MIT —— 见 LICENSE。