dsh-title-index
为 DeepSeek Harness Web GUI 提供基于磁盘索引的会话标题查找：从以（mtime、size）为键的索引中提供 @-提及标题快照，而不是在每次按键时重新处理每个会话日志。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:gtaifu/dsh-title-index#b2d22846fdfd24dd9c10ee43fa1d5767ddf98a2eTitle Index 以 dsh-title-index 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →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) 为失效键;其余方法(listSessions、readSurface、搜索、lineage、授权语义)全部保持官方实现。标题被标题生成插件重写时日志文件 mtime 变化,缓存自动失效。
为什么是"禁用 + 插入"而不是改行名? dsh 的补丁机制(
applyEntryPatches)允许修改已有行的config/disabled,但不允许修改name;而两个引擎类发布的服务名都固定为sessionQuery,消费者按服务名注入,因此换行对它们完全透明。
| 场景 | 官方引擎 | 本插件 |
|---|---|---|
@ 菜单 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(仅发生在索引缺失或格式升级后);正在写入的会话每次追加都会失效重折叠,追加间歇由索引承接。
在 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。首次冷启动会全量折叠一次以填充索引;可用下面的预热命令提前完成。
| 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 安装目录解析,无需另装);INDEX_FORMAT_VERSION),未来条目结构变化时会自动丢弃重建。