dsh-title-index
EN — A drop-in accelerator for the DeepSeek Harness web GUI's session title lookups. It replaces the stock session-query-sqlite row with a subclass that serves readTitleSnapshots from a disk index keyed by (sessionId, mtimeMs, size), instead of decompressing and replaying every session log on each @-mention keystroke. Everything else the stock engine does is kept untouched. On a real 114-session corpus: top-50 @ menu titles went from ~9.7 s to ~0.3 s, with field-identical results.
为 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:
- 磁盘索引(默认
<DSH_HOME>/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)
-
在 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"
}
}
-
重新安装 profile 依赖:
dsh plugin --profile web install
-
重启 dsh web。首次冷启动会全量折叠一次以填充索引;可用下面的预热命令提前完成。
配置(接管行的 config)
| Key | 默认值 | 说明 |
|---|
path / openAt / 其余官方键 | 官方默认 | 原样转发给官方引擎;web 部署沿用 :memory: + never |
root | "" | 持久化会话根目录;空值时插件完全惰性(等价官方引擎) |
indexPath | <root>/../title-index.json | 索引文件位置 |
补丁内置的默认配置:
- insert:
- id: session-query-title-index
name: 'dsh-title-index'
config:
path: ':memory:'
openAt: never
root: !!js dshHomePath('sessions')
基准与预热
node <profile>/node_modules/dsh-title-index/lib/bench.mjs
# 对照官方引擎计时 + 逐字段等价校验(索引写入临时文件,结束即删)
$env:DSH_TITLE_INDEX_PROD = "1"; node <profile>/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
