dsh-recall-plugin 2.3.13 → 2.3.14

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 本文件格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循语义化版本。
 
+## [2.3.14] - 2026-09-11
+
+### 修复
+
+- **撤回 fork 出的子会话内，撤回预览对任何消息都误报「该消息是本会话中第一条用户消息」**：`resolveCutSeq` 冷读取走 `sessionQuery.readSession`，官方实现内部却用 `Session.create(events, header, inheritedEventCount)` 做回放校验——快照模式要求 seeded 头的 `inheritedEventCount` 恰等于 `log.length`（「seeded session constructor seed must equal its inherited prefix」），而读取面交给它的是全量逻辑日志（`snapshotEvents()` 无参＝继承前缀＋自身事件；冷读返回完整存储日志），两者必然不等，`readSession` 对任何 seeded 会话（本插件每次撤回 fork 出的子会话即此类）直接抛错；此前的 `catch` 把异常静默折成 null，与「真首条」不可分——于是子会话里点**任何**消息，面板都显示「该消息是本会话中第一条用户消息，无法回退对话；确认后仅回退项目文件」。修复：`resolveCutSeq` 增加降级链——`readSession` 抛错、或消息根本没出现在它给的事件里（读取面缺继承前缀的版本差异）时，改用 `sessionQuery.observeSession`（经 `Session.fromRestore` 恢复，restore 模式无该约束）读取全量逻辑日志；租约以 `Symbol.dispose` 显式释放（prepared 缓存项靠它减引用，漏释放会卡淘汰）；只有「消息在、其前无 turn/end」才是可信的“首条”，两跳都失败才落到 null。`scanCutSeq` 拆出 `scanCutSeqDetail`（cut + found）供降级判断；契约补 `observeSession` 与 `SessionObservationLease`（可选——旧版 dsh 无此 API 时维持原行为）。**真机复验**（dsh web 0.1.5-rc.2 + POST `/api/recall/preview`）：修前子会话 6 条消息 cutSeq 全 null、父会话正常；修后子会话 156/43/62/88/197、真首条（你好）仍 null、父会话不变。新增 `tests/unit/snapshots-cutseq.test.js`（6 例），compat-audit 新增 I33。插件功能、客户端与其余行为零变化。
+
 ## [2.3.13] - 2026-09-11
 
 ### 修复

package/lib/snapshots.js

@@ -52,7 +52,7 @@ function parseDiffOutput(text, isWin, maxChanges) {
   const changes = all.slice(0, maxChanges);
   return { changes, total: finalTotal, truncated: finalTotal > changes.length, treeId };
 }
-function scanCutSeq(events, messageId) {
+function scanCutSeqDetail(events, messageId) {
   let anchor = -1;
   for (let i = 0; i < events.length; i++) {
     const e = events[i];
@@ -61,12 +61,21 @@ function scanCutSeq(events, messageId) {
       break;
     }
   }
-  if (anchor < 0) return null;
+  if (anchor < 0) return { cut: null, found: false };
   for (let i = anchor - 1; i >= 0; i--) {
     const e = events[i];
-    if (e && e.type === "turn/end" && typeof e.seq === "number") return e.seq;
+    if (e && e.type === "turn/end" && typeof e.seq === "number") return { cut: e.seq, found: true };
   }
-  return null;
+  return { cut: null, found: true };
+}
+function scanCutSeq(events, messageId) {
+  return scanCutSeqDetail(events, messageId).cut;
+}
+function disposeLease(lease) {
+  const disposeSymbol = Symbol.dispose;
+  if (!disposeSymbol || lease === null || typeof lease !== "object") return;
+  const dispose = lease[disposeSymbol];
+  if (typeof dispose === "function") dispose.call(lease);
 }
 async function rescueRollback(deps, opts) {
   const { root, store, safetyId, safetyOk, rollbackError } = opts;
@@ -374,11 +383,26 @@ function createSnapshots(ctx, rt, config) {
     } else {
       const query = ctx.get("sessionQuery");
       if (query) {
+        let fallback = false;
         try {
           const log = await query.readSession(sessionId);
-          result = scanCutSeq(Array.isArray(log && log.events) ? log.events : [], messageId);
+          const detail = scanCutSeqDetail(Array.isArray(log && log.events) ? log.events : [], messageId);
+          result = detail.cut;
+          fallback = !detail.found;
         } catch (error) {
-          result = null;
+          fallback = true;
+        }
+        if (fallback && typeof query.observeSession === "function") {
+          try {
+            const lease = await query.observeSession(sessionId);
+            try {
+              result = scanCutSeq(lease && Array.isArray(lease.events) ? lease.events : [], messageId);
+            } finally {
+              disposeLease(lease);
+            }
+          } catch (error) {
+            result = null;
+          }
         }
       }
     }
@@ -396,5 +420,6 @@ export {
   parseTagsWithTime,
   parseTreeId,
   rescueRollback,
-  scanCutSeq
+  scanCutSeq,
+  scanCutSeqDetail
 };

package/package.json

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