会话标题索引gtaifu/dsh-title-index

dsh-title-index

EN — 一个为 DeepSeek Harness Web GUI 的会话标题查询提供加速的即插即用插件。它用一个子类替换官方的 session-query-sqlite 行,该子类从以 (sessionId, mtimeMs, size) 为键的磁盘索引提供 readTitleSnapshots,而不是在每次 @ 提及按键时解压并重放每个会话日志。官方引擎的其他一切行为都保持不变。在真实的 114 会话语料上:top-50 @ 菜单标题从 约 9.7 秒降至约 0.3 秒,且结果逐字段一致。

为 dsh Web 端会话标题读取加磁盘索引的插件。

问题

Web 输入框的 @ 会话候选(dsh-session-reference)为给出每个候选的“最新标题”,会对每个持久化会话完整解压并逐行解析 session.jsonl.zstd 来折叠标题(sessionQuery.readTitleSnapshots)。会话一多,每次按键都要扫几十上百份日志;而解析结果 LRU 只缓存 5 个,重复查询同样慢。

方案

本插件通过 cordis.patch.yml 禁用官方 session-query-sqlite 行并插入同服务的新行(session-query-title-index,注入名 dsh-title-index),继承官方 SqliteSessionQueryEngine,只 override readTitleSnapshots:

- 磁盘索引(默认 /title-index.json)以 (sessionId, mtimeMs, size) 为失效键;
- 命中 → 直接返回缓存的标题快照(毫秒级);
- 未命中(新会话/日志有追加)→ 走官方折叠,并把结果连同折叠后的文件 stat 写回索引;
- 活动中的(live)会话、官方读取失败、索引损坏,全部原样回退官方路径,行为不会劣化。

其余方法(listSessions、readSurface、搜索、lineage、授权语义)全部保持官方实现。标题被标题生成插件重写时日志文件 mtime 变化,缓存自动失效。

为什么是“禁用 + 插入”而不是改行名? dsh 的补丁机制(applyEntryPatches)允许修改已有行的 config/disabled,但不允许修改 name;而两个引擎类发布的服务名都固定为 sessionQuery,消费者按服务名注入,因此换行对它们完全透明。

实测(114 个会话,约 60MB zstd 日志)

| 场景 | 官方引擎 | 本插件 |
|---|---|---|
| @ 菜单 top-50 标题读取 | ~9.7 s(全量折叠) | 0.30 s |
| 全量 114 会话标题读取 | ~8.5–9.7 s | 0.34 s |
| 单会话 | ~0.5 s | ~0 s |
| 结果与官方逐字段等价 | — | 109 对全等,0 差异 |

冷启动一次约 8–9 s(仅发生在索引缺失或格式升级后);正在写入的会话每次追加都会失效重折叠,追加间歇由索引承接。

安装(web profile)

1. 在 profile 的 package.json 中添加依赖与 bundle(dsh.profile.bundles 中必须排在 @deepseek-ai/dsh-web-app 之后,保证补丁在官方行定义之后生效):

{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-title-index" // ← 排在 web-app 之后
]
}
},
"dependencies": {
"dsh-title-index": "github:gtaifu/dsh-title-index"
}
}

2. 重新安装 profile 依赖:

dsh plugin --profile web install

3. 重启 dsh web。首次冷启动会全量折叠一次以填充索引;可用下面的预热命令提前完成。

配置(接管行的 config)

| Key | 默认值 | 说明 |
|---|---|---|
| path / openAt / 其余官方键 | 官方默认 | 原样转发给官方引擎;web 部署沿用 :memory: + never |
| root | "" | 持久化会话根目录;空值时插件完全惰性(等价官方引擎) |
| indexPath | /../title-index.json | 索引文件位置 |

补丁内置的默认配置:

- insert:
- id: session-query-title-index
name: 'dsh-title-index'
config:
path: ':memory:'
openAt: never
root: !!js dshHomePath('sessions')

基准与预热

node /node_modules/dsh-title-index/lib/bench.mjs
对照官方引擎计时 + 逐字段等价校验(索引写入临时文件,结束即删)

$env:DSH_TITLE_INDEX_PROD = "1"; node /node_modules/dsh-title-index/lib/bench.mjs
预热生产索引文件(DSH_HOME\title-index.json),重启后第一次 @ 即为热查询
环境变量：DSH_TITLE_INDEX_ROOT 覆盖语料根目录；DSH_HOME 缺省回退到 ~/.dsh。

兼容性

- 依赖官方引擎的内部行为：@deepseek-ai/dsh-session-query-sqlite@^0.1.1-rc.2、@deepseek-ai/schemastery@^3.18.1（peerDependencies，由 dsh 安装目录解析，无需另装）；
- Node ≥ 22（与 dsh 自身要求一致）；
- 索引文件带格式版本号（INDEX_FORMAT_VERSION），未来条目结构变化时会自动丢弃重建。

License

MIT