dsh-session-explorer

DSH Web 出树插件：会话消息级全文检索浏览器。检索具体到某一条消息（用户/助手/工具/系统注入四类），只读预览上下文，一键跳转真实会话。

Out-of-tree DSH Web plugin: message-level full-text search across sessions. Search a specific message (user / assistant / tool / system-injected), preview context read-only, and jump to the real session with one click.

功能 / Features

• 消息级全文检索 — 检索某一条具体消息：用户 / 助手 / 系统注入正文高权重，工具名、参数、错误摘要低权重。FTS5 trigram 索引支持任意子串，中文无需分词；短查询（<3 字符）自动降级为 LIKE 子串匹配。 Message-level full-text search — user / assistant / system-injected text at high weight, tool name / arguments / error summary at low weight. FTS5 trigram index supports arbitrary substrings without Chinese tokenization; queries shorter than 3 characters fall back to LIKE matching.
• 四类消息 — 用户（user）/ 助手（assistant）/ 系统注入（steering，含 plugin 注入、skill-catalog、skill-invocation、compaction 摘要等）/ 工具（tool，可检索工具名、参数与错误摘要）。 Four message kinds — user / assistant / steering (plugin-injected prompts, skill-catalog, skill-invocation, compaction summaries, …) / tool (tool name, arguments and error summary searchable).
• fork/续接会话自动去重 — DSH fork/续接会话共享父历史，同一条消息会在多个会话各存一份；搜索结果按 (seq, kind, 正文) 分组去重，优先保留标题非空、更新更晚的会话。 Deduplicated results across fork/continued sessions — fork/continuation sessions share parent history, so the same message is stored once per session; search groups by (seq, kind, text) and keeps the session with a non-empty title and the latest index time.
• 只读预览 — 命中消息 + 前后上下文窗口，焦点消息自动滚动定位到可视区中央，可一键在真实会话中打开。 Read-only preview — focused hit plus a surrounding context window; the focus message auto-scrolls to the center of the viewport, and one click opens it in the real session.
• 会话浏览器入口 — 侧栏工具区入口按钮 + conversation 列内覆盖面板（不遮挡全局）；面板右上角「返回会话」按钮关闭并回到会话。 Session browser entry — sidebar tool entry + an overlay panel inside the conversation column (no global overlay); the top-right "返回会话" (back to session) button closes the panel.
• 重建索引（增量/全量 + 健康检查） — 增量模式用 engine revision token 快速 diff（O(1) 跳过未变会话）+ 内容指纹重刷变化会话 + 清理幽灵会话；全量模式清库逐会话重建。打开重建对话框时自动执行索引库健康检查（integrity + 关键表可读性）并推荐模式。 Rebuild (incremental / full + health check) — incremental mode fast-diffs via engine revision tokens (O(1) skip), re-flushes changed sessions by content fingerprint and removes ghost sessions; full mode resets the database and rebuilds session by session. The rebuild dialog runs a health check (integrity + table readability) and recommends a mode.
• 索引状态（损坏会话分类） — 已索引 / 待同步 / 源日志损坏（无法索引）三态展示；打开面板时自动轻量同步（live 会话 + 未索引新会话），turn 结束增量同步，启动时对账。 Index status (corrupted-session classification) — indexed / stale / failed (source log corrupted, not indexable); opening the panel triggers a light sync (live + not-yet-indexed sessions), turn end syncs incrementally, and startup reconciles.

安装 / Install

从 npm 安装（推荐）：

dsh plugin --profile web add dsh-session-explorer

包页面：https://www.npmjs.com/package/dsh-session-explorer

本地构建安装：

pnpm install
pnpm pack
dsh plugin --profile web add ./dsh-session-explorer-*.tgz

安装后重启 dsh web，侧栏工具区出现「会话浏览器」入口。索引库位于 ~/.dsh/storages/session-explorer.sqlite（首次使用自动创建并索引）。

开发 / Development

pnpm install
pnpm test      # 41 个单元测试（需要 Node ≥ 22.5，依赖 node:sqlite）
pnpm build     # tsc + rolldown client bundle

架构 / Architecture

• src/protocol.ts —— RPC 契约类型（Host/Client 共享）
• src/transcript.ts —— SessionEvent 日志 → 可索引消息条目的纯折叠层（零依赖、可单测）
• src/indexer.ts —— SQLite FTS5 trigram 派生索引（host 侧，application_id + user_version 双校验、0600 权限）
• src/rpc.ts —— RPC 校验与路由
• src/index.ts —— host 装配（事件同步 + RPC + 启动对账）
• src/client/ —— 浏览器 bundle（侧栏入口 + 搜索/预览视图 + conversation 列内覆盖面板）

已知限制 / Known limitations

• 完整 tool result 正文全文检索留待 V2（当前仅工具名/参数/错误摘要进低权重字段）。
• 会话删除无引擎 API，索引删除仅支持插件自建库内清理。
• 时间线画布（@xyflow/react）存在严重渲染 bug，0.2.0 起暂时隐藏入口，修复后恢复。

License

MIT