dsh-search-plus

dsh-search-plus

中文友好的会话全文搜索 + 精确跳转定位。 命中之后直接滚到那一行并闪光高亮,不用在几千条消息里翻。

---

它解决的两个真问题

1. 中文搜不到(上游 unicode61 的硬伤)

上游 session-query-sqlite 的 FTS5 索引写死 tokenize = 'unicode61',而它不切分 CJK —— 一整串连续中文被当成一个词元。实测(2026-09-20):

本插件自建 trigram 索引:trigram 支持任意子串(含单个汉字),而且 SQLite 会用该索引加速 LIKE '%…%'。所以「搜一个字」也能命中。

为什么是 trigram,而不是「CJK 逐字切分」

曾评估过一个更省空间的方案:索引/查询两侧把中文按字插空格(今天天气 → 今 天 天 气),配 unicode61。它的索引体积接近原文(预计 60–90 MB,而现在 167 MB),中文能力一样。

但它会丢掉英文子串搜索 —— sess 再也找不到 session,useCh 找不到 useChat。翻自己的历史时这类搜索很常用。

Nija 2026-09-20 拍板:保留 trigram。 拿英文子串 + 一半体积去换,不划算。167 MB 在本机(107 GB 余量)可接受。

记录在案,免得以后有人看到体积又想"优化"——这是权衡后的决定,不是疏忽。

2. 命中之后不能跳转

上游搜索只回 { sessionId, snippet },不带事件 seq —— 所以侧边栏选中结果只能"打开会话",不能定位到命中那一行。

本插件返回 seq,并由 client 半精确跳转。

---

跳转定位怎么做的(这是本插件打磨的重点)

与同生态做法的本质区别

依据(上游源码):

• chat-snapshot-builder.ts:542 —— 每个会话节点同时带 key 与 seq: node.anchorSeq
• ui-chat/src/client/contract/slots.ts:172 —— SessionStandardProps.useChat,session 作用域的客户端插件都能拿到
• ChatNodeSeat.tsx:129 —— 每行渲染 data-chat-anchor-key={routedNode.key}

完整流程

搜索命中 { sessionId, seq, snippet }
   ↓
① props.sessions.open(sessionId)           切到目标会话
② 从 useChat snapshot 找 anchorSeq ≤ seq 且最接近的节点
   ├─ 找到  → querySelector([data-chat-anchor-key="<key>"])
   │          → scrollIntoView({behavior:'smooth', block:'center'})
   │          → 加 .dsh-sp-flash 类,2.2s 后移除
   └─ 没找到 → session.loadOlder() 往前翻一页
              (翻页会更新 snapshot → effect 重入 → 回到 ②)
③ 到上限 / 无法再翻 → 提示"已打开会话,但未能自动定位,请手动翻找"

同一份 snapshot 同时承担"找目标行"和"判断是否该继续翻页",不需要额外的定时器轮询。

---

搜索语法

实现:每个词一条 LIKE ? ESCAPE '\' 子句,AND 串联、排除用 NOT LIKE;全部参数绑定,输入永远不拼进 SQL。trigram 索引会加速这些 LIKE %…%。

注:这里不用 FTS5 的 MATCH 语法 —— 那样 " * ( OR NEAR 都会变成可执行查询语法。用 LIKE 则一切都是字面数据,所见即所得。

接口

UI:会话头部「搜索+」按钮 → 面板输入即搜(220ms 防抖)→ 点击结果跳转。

---

安装

dsh plugin --profile web add /home/bubu12/dev/dsh-search-plus

dsh plugin 会自动把它追加进 dsh.profile.bundles。装完需重启 dsh web 才生效(bundle 层变更不参与 live 热重载)—— 用会话头部的「重启」按钮,或由你自己在终端跑 ~/.dsh/scripts/restart-dsh-web.sh。

首次生效后约 12 秒开始建索引(启动高峰之后再跑,避免抢占)。

验证

# 1) 索引是否建好
curl -s http://127.0.0.1:3080/api/plugins/search-plus/status

# 2) 中文单字能不能搜到(这是本插件存在的理由)
curl -s "http://127.0.0.1:3080/api/plugins/search-plus/search?q=%E7%BB%98" | head -c 400

浏览器里点「搜索+」,搜一个汉字,点结果 —— 应能直接滚到那一行并闪光。

卸载与残留

dsh plugin --profile web remove dsh-search-plus
rm -f ~/.dsh/cache/search-plus.db ~/.dsh/cache/search-plus.db-shm ~/.dsh/cache/search-plus.db-wal

装上能用、卸掉干净:不写 profile 之外的文件、不起外部进程、不修改任何上游源码或上游 bundle。

维护

• 索引陈旧:会话变了索引不会自动更新(当前版本只启动建一次)。手动重建: curl -X POST http://127.0.0.1:3080/api/plugins/search-plus/reindex (自动增量更新是下一步要补的。)
• 索引库位置:$DSH_HOME/cache/search-plus.db(派生数据,可随时删掉重建)
• 已知限制:
  • 只索引 user/message 与 assistant/message 的文本 + 工具名/参数;不索引 reasoning 之外事件的细节
  • 定位封顶 20 页;超出会降级为"已打开会话,请手动翻找"
  • 索引是全量重建,大历史下首次建库有耗时

变更记录

1.1.1 — 按消息时间排序 + 真实命中总数（2026-10-21）

• 排序改为按消息时间：ORDER BY COALESCE(d.time, d.created_at) DESC, d.seq DESC（time 为 NULL 时退回会话创建时间）。 原先按 created_at 排，常见词查询会把刚发的消息压到后面 —— 实测搜「配合」，目标消息排到第 26 位，收窄成「好好配合」反而第 1 条。
• 响应新增真实命中总数 total：服务端用同一组 WHERE 子句另跑一次 COUNT(*)；count 仍为本次返回条数（向后兼容）。 客户端显示「命中 N 条（显示前 M 条）」，不再把 60 条上限当成命中数。

验证：配合 命中 485 条、目标消息第 1 条；好好配合 2 条。

1.1.0 — 适配 DSH 0.2（2026-09-28）

背景：DSH 从 0.1.5-rc.2 升到 0.2.0-rc.2 后，本插件的跳转静默失效 —— 表现为「跳转不真实」：高光只落在当前会话已加载的窗口里，从不翻到目标位置。

根因：0.2 把 hasMore / baseSeq 收成了会话对象的 private 字段，而本插件原先的翻页判断是：

while (pages < MAX && session.hasMore && session.baseSeq > seq) await session.loadOlder()

session.hasMore 恒为 undefined ⇒ !== true 恒成立 ⇒ 每次都立刻放弃。

修复：改用 0.2 提供的一等 API ——

await session.loadThrough(seq)   // 翻页直到窗口覆盖该 seq（带 retarget 语义）

同时新增：

1.0.0 — 首个公开版（2026-09-20）

trigram 中文搜索 + anchorSeq 精确跳转定位；AGPL-3.0-or-later。

文件

致谢与出处

代码全部自研(863 行,零外部依赖),但有一处思路借鉴必须写明 —— 这是诚信底线:

• dsh-session-workbench(MIT 协议) 的 Locate 功能演示了"从搜索结果回到那条消息"的可行路径: 打开会话 → 循环 loadOlder() 翻页 → 找 DOM 锚点 → scrollIntoView + 闪光。 本插件的定位流程沿用了这条思路,但把定位依据换成了精确的 anchorSeq —— 上游 chat-snapshot-builder 让每个节点同时携带 key(DOM 锚点)与 anchorSeq(事件 seq), 于是不必依赖 DOM 文本匹配,重复内容也不会落错行(那正是文本匹配方案的固有短板)。

• 上游 DeepSeek Harness 提供了全部公开契约:ctx.sessionQuery、ctx.get('sessions')、 SessionStandardProps.useChat、[data-chat-anchor-key] 锚点、ISession.loadOlder()。 本插件不修改上游任何源码或 bundle。

协议

AGPL-3.0-or-later —— 全文见 LICENSE。

选它的理由:这是给社区用的工具,希望基于它的改进都能回流。 AGPL 第 13 条要求:把修改版作为网络服务提供时也必须公开源码(这是它区别于 GPL 的地方)。 自己内部使用、随意修改都不受限制;只有对外分发或对外提供服务时才需要开源你的改动。