@ 菜单的会话候选每次击键耗时约 4.8 秒:listCandidates 解压会话日志取标题,而这些标题在投影缓存里已经有了

[young1lin]

在 Web GUI 输入框里输入 @,触发菜单显示 "Loading…" 持续 4–5 秒才出现候选,而且每次击键都重新来一遍。文件搜索这半边很快,会话搜索这半边很慢。

环境

• dsh 0.1.1-rc.2(dsh web,默认 web-app 组合,Windows)
• 磁盘上约 250 个会话(zstd 日志共约 124 MB;单个最大 6.4 MB)

实测数据(对运行中的宿主直接探测 POST /api/<endpoint>):

RPC	延迟	说明
fileReferences/list	11–54 ms	有工作区索引缓存,正常
sessionReferenceResolver/candidates	每次 4500–4850 ms	无缓存;每次击键都重跑
session.list(侧边栏,同一宿主)	约 190–420 ms	已经能为全部会话返回标题

根因

SessionReferenceResolver.listCandidates(位于 packages/context/session-reference/src/index.ts)通过 ctx.sessionQuery.readTitleSnapshots(...) 解析候选标签,该调用会解压每个候选会话的完整 zstd 日志来提取标题——每次调用最多解压 candidateLimit(默认 50)个,既没有缓存也没有防抖。而侧边栏的 session.list 从投影缓存(dsh-session-projection-cache 维护的 session_projcache.json)以极低成本拿到同样的标题。也就是说,这条昂贵的路径在重算宿主早已算好的数据。

客户端还有两个加重因素:

1. ui-reference 的 candidates() 用一个 Promise.all 同时等文件 RPC 和会话 RPC,快的文件结果被慢的会话结果拖住一起出不来;
2. 输入触发管道每次击键都查询、无防抖,所以每敲一个字符就是一整轮解压。

影响

@ 菜单实际上连文件引用也没法用了——整个菜单要保持 pending 状态直到两个来源都返回(每次击键 4–5 秒)。此外这条链路上没有任何客户端超时,请求一旦丢失,菜单会永远停在 "Loading…"(在宿主重启竞态后实际观察到;另外 dsh web 重启时旧进程占着 3080 端口会报 EADDRINUSE,也和这个现象相关)。

建议的修复方案(按影响排序)

1. 标题改从投影缓存读取,不要再解压日志。 listCandidates 的标签来源应换成侧边栏同款的投影缓存/session-list 路径(session.list 证明全部会话带标题约 200 ms 可达)。仅这一项就应把端点从约 4.8 秒降到 500 ms 以内。
2. 缓存 + 失效: 按 session id 缓存标题快照(TTL 分钟级即可——标题很少变),监听 session/title 事件失效,重复击键就是零成本。
3. 客户端防抖: ui-reference(或 input-trigger 控制器)对候选查询加约 150–200 ms 防抖,让一连串击键只触发一轮 RPC 而不是 N 轮。
4. 渐进渲染: 拆开 ui-reference candidates() 里的 Promise.all,让文件组独立返回——菜单框架本来就支持分组各自的 ready 状态,文件结果立即显示,会话组自己慢慢解析。
5. 加客户端超时(比如 AbortSignal.timeout(3000)),请求丢失时该组按失败处理(菜单自动关闭),而不是永远挂在 "Loading…" 上。

第 1–2 项治延迟,第 3–4 项治体感,第 5 项治挂死。

目前的临时规避

禁用该插件(~/.dsh/cordis.patch.yml 里 - id: session-reference / disabled: true)后 @ 菜单毫秒级响应,代价是失去 @session 功能。若必须保留功能,把 candidateLimit 调小(比如 10)可按比例缩短延迟。

---

草稿里的所有数字都来自今天在你机器上的真实探测。需要我再补一版英文对照(或纯英文)的,随时说。

[PerryLink]

已修。@ 补全的候选列表不再逐键解压会话日志取标题:

• listCandidates 现在通过 ctx.sessionQuery.listSessions 取头部索引, 标题走投影快照/持久化缓存 (packages/context/session-reference/src/index.ts:203-254);
• 实现注释明确该调用位于 @ 补全的每个击键之下, 折日志读标题的开销已消除 (index.ts:241-246)。

获取修复: 更新到最新版 (npm latest=0.1.5-rc.1) 或拉取 master 重建后重测。