dsh-recall-plugin 1.5.0 → 1.5.1

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 本文件格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循语义化版本。
 
+## [1.5.1] - 2026-08-18
+
+### 修复
+
+- 设置页冷启动优化：`exclude-get` 首次遍历工作区、逐文件 shell 读改为并行 + 30s 结果缓存（保存后失效），二次打开设置页不再重复付出首访代价。
+- 冷会话标题/消息文本补齐引入通用并发限制器（`runLimited`，同时最多 4 个）：首次大量冷数据时 `readSession` 整日志解压不再全量并发压垮磁盘/CPU。
+- 启动预热叠加 `sessionQuery.listSessions()` 冷元数据：冷启动时 `ctx.sessions.list()` 常为空（惰性载入），此前设置页首次打开仍要现场建 store，现开机即预热全部历史工作区。
+- Client 侧 `usage`/`status` 补数据延后到 `list` 返回后异步执行：首屏先渲染树形内容，磁盘占用与错误日志随后补齐；`list` 失败时仍尝试补这两个数据，避免整卡全空。
+
+### 变更
+
+- Client 侧 `titles` 请求的 sessionIds 去重（`Set` 去重 + 过滤空值）。
+
 ## [1.5.0] - 2026-08-18
 
 ### 新增

package/README.md

@@ -27,9 +27,6 @@
 
  ![设置页](docs/screenshots/settings-exclude-2.png) 
 
-- 设置页 · 快照管理（树形：工作区 → 会话 → 快照，叶子显示消息内容）
-
-> 树形快照管理界面截图待补充（当前版本已实现该功能，截图可后续更新）。
 
 ## 功能亮点
 

package/lib/client.js

@@ -639,15 +639,28 @@ window.__ModuleLoader__.load({
                 fetchTitles(res.items || [])
                 fetchMessages(res.items || [])
               }
-            }).catch(() => {})
-            if (sessionId) {
-              api('manage', { op: 'usage', sessionId }).then((res) => {
-                if (res && res.ok) setUsage(res.bytes || 0)
+              // 列表返回后再补 usage/status：首次冷启动时磁盘占用和错误日志
+              // 都各要一条 shell，和 list 并发会抢资源拖慢首屏；延后到列表
+              // 渲染后，用户先看到树形内容，占用再异步补上。
+              if (sessionId) {
+                api('manage', { op: 'usage', sessionId }).then((res) => {
+                  if (res && res.ok) setUsage(res.bytes || 0)
+                }).catch(() => {})
+              }
+              api('status', {}).then((res) => {
+                if (res && res.ok) setErrors(res.errors || [])
               }).catch(() => {})
-            }
-            api('status', {}).then((res) => {
-              if (res && res.ok) setErrors(res.errors || [])
-            }).catch(() => {})
+            }).catch(() => {
+              // list 失败时仍尝试补 usage/status，避免整卡全空
+              if (sessionId) {
+                api('manage', { op: 'usage', sessionId }).then((res) => {
+                  if (res && res.ok) setUsage(res.bytes || 0)
+                }).catch(() => {})
+              }
+              api('status', {}).then((res) => {
+                if (res && res.ok) setErrors(res.errors || [])
+              }).catch(() => {})
+            })
           }
 
           React.useEffect(() => { refresh() }, [sessionId])

package/lib/index.js

@@ -51,6 +51,9 @@ export function apply(ctx, config) {
   // 也不是零成本（1 条 shell + 若干日志解压）。设置页打开、删除后刷新
   // 都会重拉，30s 缓存让二次打开即时；delete 与新快照落地时失效。
   let listCache = { at: 0, payload: null }
+  // 排除配置枚举缓存（30s）：exclude-get 首次要遍历工作区、逐文件 shell 读，
+  // 设置页反复打开时不该每次重算；exclude-set 成功写入后立即失效。
+  let excludeCache = { at: 0, payload: null }
 
   // 会话标题缓存（apply 级跨请求共享）：冷会话标题要 readSession 整日志
   // 解压 + 重放校验（大日志 10 秒级），绝不能挡列表首屏——list 只查
@@ -138,7 +141,9 @@ export function apply(ctx, config) {
       if (cwd) roots.add(cwd)
     }
     const byFile = new Map()
-    for (const root of roots) {
+    // 并行解析全部 root：冷启动时每个 root 首次 resolveStore 可能触发 shell
+    // 建目录/写 root.txt，串行会随工作区数量线性变慢；Promise.all 让它们并发。
+    await Promise.all(Array.from(roots).map(async (root) => {
       try {
         const store = await rt.resolveStore(root)
         if (store && !byFile.has(store.excludeFile)) byFile.set(store.excludeFile, { store, roots: [] })
@@ -146,7 +151,7 @@ export function apply(ctx, config) {
       } catch (error) {
         /* 单个根解析失败只影响它自己，不拖垮整个列表 */
       }
-    }
+    }))
     // 磁盘兜底：冷启动时会话注册表为空（惰性载入），但 home 容器目录可能
     // 早已存在（历史快照）。容器在 ⇒ 共享 exclude.txt 可编辑（哪怕从未
     // 写过、内容为空）；容器不在 ⇒ 全新安装，让设置页显示引导文案。
@@ -278,6 +283,21 @@ export function apply(ctx, config) {
     return run
   }
 
+  // 通用并发限制器：冷会话标题/消息文本补齐会 readSession 整日志解压，
+  // 首次大量冷数据时全量 Promise.all 会同时压垮磁盘/CPU。限制同时最多
+  // CONCURRENCY 个任务，剩余排队执行；这是纯内存调度，不依赖额外依赖。
+  async function runLimited(tasks, concurrency) {
+    const limit = concurrency > 0 ? concurrency : 4
+    let index = 0
+    const workers = Array.from({ length: Math.min(limit, tasks.length) }, async () => {
+      while (index < tasks.length) {
+        const task = tasks[index++]
+        await task()
+      }
+    })
+    await Promise.all(workers)
+  }
+
   // 收集全量快照记录（内存 + 磁盘 dump 并集），供树形管理的按工作区/
   // 会话批量删除使用。返回 Map<消息ID, {id, root, sessionId, time}>；
   // 磁盘条目缺 root 时按 store 的 root.txt/内存映射补全（与 manage list
@@ -443,14 +463,19 @@ export function apply(ctx, config) {
       // 设置页「撤回设置」标签的配置读取。不支持平台照常短路：Client
       // 显示不可用提示而不是空白表单，与 init 的 notice 语义对齐。
       if (!supported) return { ok: false, unsupported: true }
+      // 30s 结果缓存：首次进入要并行 resolveStore + 逐文件 shell 读，
+      // 二次打开/切标签不应重复付出这份代价；exclude-set 写入后失效。
+      if (excludeCache.payload && Date.now() - excludeCache.at < 30000) return excludeCache.payload
       const byFile = await listExcludeFiles()
-      const files = []
-      for (const [path, info] of byFile) {
+      // 并行读取各 exclude 文件内容：每个文件一条 shell，串行会放大延迟
+      const files = await Promise.all(Array.from(byFile.entries()).map(async ([path, info]) => {
         let content = ''
         try { content = await snaps.readExclude(info.store) } catch (error) { content = '' }
-        files.push({ path, home: Boolean(info.store.home), roots: info.roots, content })
-      }
-      return { ok: true, files }
+        return { path, home: Boolean(info.store.home), roots: info.roots, content }
+      }))
+      const payload = { ok: true, files }
+      excludeCache = { at: Date.now(), payload }
+      return payload
     },
 
     'exclude-set': async (args) => {
@@ -463,6 +488,8 @@ export function apply(ctx, config) {
       const info = byFile.get(path)
       if (!info) return { ok: false, code: 'UNKNOWN_PATH', message: '未知的排除文件路径' }
       await snaps.writeExclude(info.store, content)
+      // 写入后立即失效：设置页保存后刷新必须看到最新内容
+      excludeCache.payload = null
       return { ok: true }
     },
 
@@ -542,10 +569,14 @@ export function apply(ctx, config) {
         // 重放校验，大日志 10 秒级——独立于列表让首屏即时。并发交给
         // sessionQuery 自带的 inspect 并发闸，这里全量并行发车。
         if (!supported) return { ok: false, unsupported: true }
-        const ids = Array.isArray(args && args.sessionIds) ? args.sessionIds.map(String).slice(0, 100) : []
+        const ids = Array.from(new Set(
+          (Array.isArray(args && args.sessionIds) ? args.sessionIds.map(String) : []).filter(Boolean)
+        )).slice(0, 100)
         const out = {}
-        await Promise.all(ids.map(async (sid) => {
-          if (!sid || out[sid] !== undefined) return
+        // 并发限 4：冷标题 readSession 是重 IO，全量并发会把首次设置页
+        // 的 shell/日志解压都挤在一起；限制后列表本身不受影响，标题渐进补齐。
+        await runLimited(ids.map((sid) => async () => {
+          if (out[sid] !== undefined) return
           let title = liveTitleFast(sid)
           if (title === null) {
             const query = ctx.get('sessionQuery')
@@ -558,7 +589,7 @@ export function apply(ctx, config) {
           }
           sessionTitles.set(sid, title)
           out[sid] = title
-        }))
+        }), 4)
         return { ok: true, titles: out }
       }
       if (op === 'messages') {
@@ -576,7 +607,7 @@ export function apply(ctx, config) {
           bySession.get(sid).push(mid)
         }
         const texts = {}
-        await Promise.all(Array.from(bySession.entries()).map(async ([sid, mids]) => {
+        await runLimited(Array.from(bySession.entries()).map(([sid, mids]) => async () => {
           // 该会话所有消息都已缓存（含 null）时，不必 readSession 冷读
           const allCached = mids.every((mid) => messageTexts.has(String(sid) + '\u0000' + String(mid)))
           let log = null
@@ -604,7 +635,7 @@ export function apply(ctx, config) {
             messageTexts.set(key, text)
             texts[mid] = text
           }
-        }))
+        }), 4)
         return { ok: true, messageTexts: texts }
       }
       if (op === 'usage') {
@@ -730,16 +761,33 @@ export function apply(ctx, config) {
   // 启动预热：所有已存在工作区解析存储、重建索引与孤儿快照，
   // 并清理旧版项目内 blobs 目录（home 可用时）。
   // 不触发维护（gc/清理）：开机预热应尽量轻，重活等第一条消息再按节流来。
-  for (const session of ctx.sessions.list()) {
-    const cwd = session && session.header && session.header.cwd
-    if (!cwd) continue
-    const sessionId = session.id
-    Promise.resolve(rt.resolveStore(cwd))
-      .then(() => rt.tryUpgradeToHome(cwd))
-      .then((store) => rt.ensureGit(cwd, store))
-      .then(() => snaps.loadIndex(cwd, sessionId))
-      .then(() => snaps.rebuildOrphans(cwd, sessionId))
-      .then(() => rt.cleanupLegacy(cwd))
-      .catch(() => {})
-  }
+  // 冷启动时 ctx.sessions.list() 常为空（惰性载入），必须叠加
+  // sessionQuery.listSessions() 冷元数据，否则设置页首次打开仍要现场建 store。
+  // apply 不是 async，这里用 IIFE 把冷元数据扫描包成异步任务。
+  ;(async () => {
+    const warmupRoots = new Map()
+    for (const session of ctx.sessions.list()) {
+      const cwd = session && session.header && session.header.cwd
+      if (cwd && !warmupRoots.has(cwd)) warmupRoots.set(cwd, session.id)
+    }
+    const querySvc = ctx.get('sessionQuery')
+    if (querySvc && typeof querySvc.listSessions === 'function') {
+      try {
+        const records = await querySvc.listSessions()
+        for (const record of records || []) {
+          const cwd = record && record.header && record.header.cwd
+          if (cwd && !warmupRoots.has(cwd)) warmupRoots.set(cwd, record.id || null)
+        }
+      } catch (error) { /* 冷元数据不可用则退回 live 注册表 */ }
+    }
+    for (const [cwd, sessionId] of warmupRoots) {
+      Promise.resolve(rt.resolveStore(cwd))
+        .then(() => rt.tryUpgradeToHome(cwd))
+        .then((store) => rt.ensureGit(cwd, store))
+        .then(() => snaps.loadIndex(cwd, sessionId))
+        .then(() => snaps.rebuildOrphans(cwd, sessionId))
+        .then(() => rt.cleanupLegacy(cwd))
+        .catch(() => {})
+    }
+  })()
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-recall-plugin",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "DSH 消息撤回插件：在用户消息气泡旁加「撤回」按钮，把项目文件（独立影子 git 仓库快照）与对话历史（官方 fork）一并回退到该消息发送之前。",
   "type": "module",
   "repository": {