dsh-recall-plugin 2.3.16 → 2.3.19

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 本文件格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循语义化版本。
 
+## [2.3.19] - 2026-09-12
+
+### 修复
+
+> 本次为 2.3.17 起改动的首次 npm 发布：2.3.17 / 2.3.18 未单独发版，其全部改动随本版本一并上线。
+
+- **2.3.17 的「排队消息」自动清理在真机上从未生效**（本机 `~/.dsh/sessions` 会话日志解压实证：两次撤回的残留排队项分别在 fork 后 92 秒与 9 秒才出现移除事件——均为手动删除，自动清理的重试窗口内子会话日志无任何队列事件）。两个静默失败面，各修一半：
+  - **Client 侧重试窗口太短**：队列快照走 control 帧，`fork` 解析后还要等 `open`/staging 完成才到达——实测可晚于数秒，原 10×200ms（2 秒）窗口全部落空后静默放弃，残留卡片一直挂着。修复：扩为 30 秒长轮询（250ms 间隔，命中即停）；窗口耗尽仍无匹配时不再静默——`console.warn` 留排查痕迹，toast 提示「撤回前的一条排队消息未被自动清理，可点击该卡片右上角的删除按钮手动移除」（toast 按文本节流，同一文案 10 分钟至多一次）。
+  - **Host 侧解析只认 live 内存事件**：`resolveStaleQueueRpcIds` 此前在 `sessions.get()` 拿不到对象或其 `events` 字段缺失（版本漂移）时恒返回空数组，Client 收到空集合就什么都不做；而切点解析 `resolveCutSeq` 有磁盘降级链兜底、切点永远正常，恰好掩盖了这个缺失。修复：补齐与 `resolveCutSeq` 同款的两跳降级（`sessionQuery.readSession` → `observeSession`，后者覆盖 seeded 父会话——撤回链的父会话本身可能就是上一次撤回 fork 出的子会话；租约 `Symbol.dispose` 释放），两跳都失败才返回空数组。
+  - 顺带核验了匹配键契约：宿主队列帧构造（`queueItemsFromInbox` / `promptRpcId`）对所有 `user` 来源行透传 `source.rpcId`，seed 重放行同样携带，`placement: 'queued'` 与 `{ kind: 'remove' }` 动作均与官方 QueueDock 行为一致，无需扩展。
+
+## [2.3.18] - 2026-09-12
+
+### 修复
+
+- **用户消息里的文件块被渲染成原始 JSON**：插件覆盖了整个用户节点渲染（`conversation.chat.node` keyed 渲染器），此前只对 text/image 两类块做呈现——图片走官方 `renderMessageImages`、文本走气泡，其余块一律落进 JSON 兜底 `<pre>`。于是带文档/表格附件（`type: 'file'`）的消息（含撤回后重绘的那些）整块显示成 `{"type":"file","attachment":{…}}` 原文，而官方渲染是文件卡片。修复：新增 `fileCardInfo` 纯函数（文件名 / 扩展名徽标——大写截断 4 字符、无扩展名回退 `FILE` / 体积文本 `6.7KB` 官方风）与 `.dsh-recall-filecard*` 样式，file 块渲染成与官方 `UserStyleBubble` 同形的卡片（品牌色徽标 + 文件名单行省略 + 「MD 6.7KB」元信息），按「附件在上、文本在下」的官方布局排布，并从 JSON 兜底中剔除。新增 4 例单测。
+- **被撤回消息里的文件附件回填静默缺失**：官方 `session.attachment`（`readAttachment`）只服务图片——Host 侧按 `referencedImage` 找引用、`readImage` 取字节，file 块直接判 `ATTACHMENT_NOT_REFERENCED`；插件读不到字节就填不回输入框，此前静默跳过。修复：撤回成功后若被撤回消息含 file 块，toast 明示「文件附件无法自动回填（官方接口只支持图片回读），请重新选择文件」，不再让用户以为回填是完整的（文本与图片回填照旧）。
+
+## [2.3.17] - 2026-09-12
+
+### 修复
+
+- **撤回后输入框上方凭空多出一条「排队消息」**：官方 `sessions.fork({ atSeq })` 的切点不是「切点事件本身」，而是从该 `turn/end` 推进到**下一个 `turn/start` 之前**的整段事件——排队投递的用户消息，其 inbox 入队事件（`agent/inbox/spliced`，`target: 'next-turn'`）必然落在「上一个 `turn/end`」与「领取它的那个 `turn/start`」之间，正好被复制进子会话 seed；子会话重建 inbox 后，QueueDock 就把这条本该随撤回消失的消息显示成排队消息，与回填到输入框的内容重复（本机 `~/.dsh/sessions` 会话日志解压实证：父会话 seq 93 `turn/end` → 94 入队 → 95 `turn/start` → 96 领取后移除 → 100 `user/message` 落日志，子会话 seed 恰止于 94）。修复分两半：Host 侧新增 `scanStaleQueueRpcIds` 扫切点窗口内的 inbox 入队项、取出 `source.kind === 'user'` 项的 `rpcId`（prompt 提交身份），经 execute 响应新增的 `staleQueueRpcIds` 下发；Client 侧 fork 出子会话并 open 后 `purgeStaleQueueItems` 读 `sessions.binding(childId).session.getSnapshot().queue`，按 `placement === 'queued'` + rpcId 命中逐项调官方 `updateQueue(itemId, { kind: 'remove' })`（即 QueueDock 的「删除排队消息」）。用 rpcId 而非内容比对——撤回后新发的消息带自己的 rpcId，不会被误删。queue 快照走控制流、fork 后可能晚一两拍才到，故做 10×200ms 有界重试；拿不到 live 事件（冷会话）或服务面缺失时静默放弃（残留项仍可在 QueueDock 手动删除），不影响回填与撤回主流程。新增 `tests/unit/snapshots-queue-residue.test.js`（6 例）与 `pickStaleQueueItemIds` 3 例，`routes-stale` 补 stub 与透传断言，compat-audit 新增 I35。
+
 ## [2.3.16] - 2026-09-11
 
 ### 变更

package/lib/client.js

@@ -10,6 +10,14 @@ var CSS = [
   ".dsh-recall-stack{flex-direction:column;align-items:flex-end;gap:8px;min-width:0;max-width:min(525px,82%);display:flex}",
   ".dsh-recall-bubble{background:var(--dsw-specific-bubble);max-width:100%;color:var(--dsw-alias-label-primary);border-radius:22px;padding:10px 16px;font-size:16px;line-height:1.5;white-space:pre-wrap;word-break:break-word}",
   ".dsh-recall-json{margin:0;max-width:100%;font-size:12px;line-height:1.5;color:var(--dsw-alias-label-tertiary);white-space:pre-wrap;word-break:break-word;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;padding:8px 10px;background:var(--dsw-alias-markdown-code-block)}",
+  // 文件卡片（消息里的 file 块，非图片附件）：复刻官方 UserStyleBubble 的附件卡
+  // ——品牌色扩展名徽标 + 文件名（单行省略）+ 「MD 6.7KB」元信息行；令牌沿用
+  // 卡片体系（layer-3 底 + 发丝描边），与图片附件的「附件在上」布局并列。
+  ".dsh-recall-filecard{display:flex;align-items:center;gap:10px;max-width:100%;box-sizing:border-box;background:var(--dsw-alias-bg-layer-3);border:.5px solid var(--dsw-alias-border-l4);border-radius:12px;padding:8px 12px}",
+  ".dsh-recall-filecard-icon{flex:none;width:34px;height:34px;border-radius:8px;background:var(--dsw-alias-brand-primary);color:var(--dsw-alias-label-primary-foreground);font-size:11px;font-weight:600;line-height:1;letter-spacing:.02em;display:flex;align-items:center;justify-content:center}",
+  ".dsh-recall-filecard-body{display:flex;flex-direction:column;gap:2px;min-width:0}",
+  ".dsh-recall-filecard-name{color:var(--dsw-alias-label-primary);font-size:14px;line-height:1.4;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}",
+  ".dsh-recall-filecard-meta{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:1.4}",
   ".dsh-recall-actions{align-items:center;gap:10px;height:28px;display:flex}",
   ".dsh-recall-time{color:var(--dsw-alias-label-tertiary);white-space:nowrap;padding-right:12px;font-size:14px;line-height:1.5}",
   ".dsh-recall-action{width:28px;height:28px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:none;border-radius:28px;justify-content:center;align-items:center;padding:6px;display:inline-flex}",
@@ -398,6 +406,41 @@ function defaultAttachmentName(mediaType, index) {
   const sub = (slash >= 0 ? text.slice(slash + 1) : text).replace(/[^a-z0-9.+-]/gi, "");
   return "attachment-" + String(index + 1) + "." + (sub || "bin");
 }
+function fileExtOf(name) {
+  const dot = name.lastIndexOf(".");
+  const raw = dot > 0 && dot < name.length - 1 ? name.slice(dot + 1) : "";
+  const ext = raw.replace(/[^a-z0-9]/gi, "").toUpperCase();
+  return ext ? ext.slice(0, 4) : "FILE";
+}
+function fileCardSizeText(bytes) {
+  const n = typeof bytes === "number" && Number.isFinite(bytes) && bytes >= 0 ? bytes : NaN;
+  if (Number.isNaN(n)) return "";
+  if (n < 1024) return String(Math.round(n)) + "B";
+  if (n < 1048576) return (n / 1024).toFixed(1) + "KB";
+  if (n < 1073741824) return (n / 1048576).toFixed(1) + "MB";
+  return (n / 1073741824).toFixed(1) + "GB";
+}
+function fileCardInfo(block) {
+  if (!block || block.type !== "file") return null;
+  const ref = block.attachment;
+  const name = ref && typeof ref === "object" && typeof ref.name === "string" && ref.name !== "" ? ref.name : "\u672A\u547D\u540D\u6587\u4EF6";
+  return { name, ext: fileExtOf(name), size: fileCardSizeText(ref && typeof ref === "object" ? ref.bytes : void 0) };
+}
+function pickStaleQueueItemIds(queue, rpcIds) {
+  if (!Array.isArray(queue) || !Array.isArray(rpcIds)) return [];
+  const wanted = new Set(rpcIds.filter((id) => typeof id === "string" && id !== ""));
+  if (wanted.size === 0) return [];
+  const out = [];
+  for (const row of queue) {
+    const item = row;
+    if (!item || item.placement !== "queued") continue;
+    const id = item.id;
+    if (typeof id !== "string" || id === "") continue;
+    if (typeof item.rpcId !== "string" || !wanted.has(item.rpcId)) continue;
+    out.push(id);
+  }
+  return out;
+}
 var KIND_INFO = {
   modified: { label: "\u4FEE\u6539", cls: "modified" },
   restored: { label: "\u6062\u590D", cls: "restored" },
@@ -608,6 +651,41 @@ function buildRecallNode(React, util, ctx, sessionsSvc, workspacesSvc) {
       return out;
     })();
   }
+  function purgeStaleQueueItems(targetSessionId, rpcIds) {
+    if (!Array.isArray(rpcIds) || rpcIds.length === 0) return;
+    const deadline = Date.now() + 3e4;
+    let stopped = false;
+    const attempt = () => {
+      if (stopped) return;
+      let fired = false;
+      try {
+        const binding = sessionsSvc && typeof sessionsSvc.binding === "function" ? sessionsSvc.binding(targetSessionId) : null;
+        const face = binding && binding.session;
+        if (face && typeof face.getSnapshot === "function" && typeof face.updateQueue === "function") {
+          const snapshot = face.getSnapshot();
+          const ids = pickStaleQueueItemIds(snapshot ? snapshot.queue : null, rpcIds);
+          if (ids.length > 0) {
+            fired = true;
+            for (const itemId of ids) face.updateQueue(itemId, { kind: "remove" }).catch(() => {
+            });
+          }
+        }
+      } catch (error) {
+      }
+      if (fired) {
+        stopped = true;
+        return;
+      }
+      if (Date.now() >= deadline) {
+        stopped = true;
+        console.warn("[dsh-recall-plugin] \u6B8B\u7559\u6392\u961F\u6D88\u606F\u81EA\u52A8\u6E05\u7406\u672A\u751F\u6548\uFF0830s \u5185\u961F\u5217\u5FEB\u7167\u672A\u51FA\u73B0\u5339\u914D\u9879\uFF09\uFF1A", rpcIds);
+        showThrottledToast("\u64A4\u56DE\u524D\u7684\u4E00\u6761\u6392\u961F\u6D88\u606F\u672A\u88AB\u81EA\u52A8\u6E05\u7406\uFF0C\u53EF\u70B9\u51FB\u8BE5\u5361\u7247\u53F3\u4E0A\u89D2\u7684\u5220\u9664\u6309\u94AE\u624B\u52A8\u79FB\u9664");
+        return;
+      }
+      setTimeout(attempt, 250);
+    };
+    attempt();
+  }
   function UserRecallNode(props) {
     const node = props && props.node;
     const renderMessageImages = props && props.renderMessageImages;
@@ -617,7 +695,8 @@ function buildRecallNode(React, util, ctx, sessionsSvc, workspacesSvc) {
     const blocks = Array.isArray(data.content) ? data.content : [];
     const text = blocks.filter((b) => b && b.type === "text" && typeof b.text === "string").map((b) => b.text).join("");
     const imageBlocks = blocks.filter((b) => b && b.type === "image" && b.attachment).map((b) => ({ attachment: b.attachment }));
-    const rest = blocks.filter((b) => !b || !(b.type === "text" && typeof b.text === "string") && !(b.type === "image" && b.attachment));
+    const fileBlocks = blocks.filter((b) => b && b.type === "file");
+    const rest = blocks.filter((b) => !b || !(b.type === "text" && typeof b.text === "string") && !(b.type === "image" && b.attachment) && b.type !== "file");
     const attachmentRefs = attachmentRefsFromBlocks(blocks);
     const [copied, setCopied] = React.useState(false);
     const [hasSnapshot, setHasSnapshot] = React.useState(false);
@@ -741,6 +820,7 @@ function buildRecallNode(React, util, ctx, sessionsSvc, workspacesSvc) {
               if (typeof sessionsSvc.open === "function") sessionsSvc.open(childId);
               chatReverted = true;
               fillTarget = childId;
+              purgeStaleQueueItems(childId, res.staleQueueRpcIds);
               api("lineage-record", { childId, parentId: sessionId }).catch(() => {
               });
               if (pluginConfig.archiveOriginal && workspacesSvc && typeof workspacesSvc.archiveSession === "function") {
@@ -754,7 +834,10 @@ function buildRecallNode(React, util, ctx, sessionsSvc, workspacesSvc) {
             chatError = String(error);
           }
         }
-        if (pluginConfig.refillDraft) fillDraft(fillTarget, text, attachmentFiles);
+        if (pluginConfig.refillDraft) {
+          fillDraft(fillTarget, text, attachmentFiles);
+          if (fileBlocks.length > 0) showThrottledToast("\u88AB\u64A4\u56DE\u6D88\u606F\u91CC\u7684\u6587\u4EF6\u9644\u4EF6\u65E0\u6CD5\u81EA\u52A8\u56DE\u586B\uFF08\u5B98\u65B9\u63A5\u53E3\u53EA\u652F\u6301\u56FE\u7247\u56DE\u8BFB\uFF09\uFF0C\u8BF7\u91CD\u65B0\u9009\u62E9\u6587\u4EF6");
+        }
         setHasSnapshot(false);
         setRecall({ stage: "done", count: typeof res.count === "number" ? res.count : changes.length, chatReverted, chatError });
       }).catch((error) => {
@@ -771,6 +854,21 @@ function buildRecallNode(React, util, ctx, sessionsSvc, workspacesSvc) {
         render({ images: imageBlocks, align: "end" })
       ));
     }
+    for (let i = 0; i < fileBlocks.length; i++) {
+      const info = fileCardInfo(fileBlocks[i]);
+      if (!info) continue;
+      bubbleChildren.push(React.createElement(
+        "div",
+        { className: "dsh-recall-filecard", key: "file-" + i },
+        React.createElement("span", { className: "dsh-recall-filecard-icon" }, info.ext),
+        React.createElement(
+          "span",
+          { className: "dsh-recall-filecard-body" },
+          React.createElement("span", { className: "dsh-recall-filecard-name", title: info.name }, info.name),
+          React.createElement("span", { className: "dsh-recall-filecard-meta" }, info.size ? info.ext + " " + info.size : info.ext)
+        )
+      ));
+    }
     if (text !== "") bubbleChildren.push(React.createElement("div", { className: "dsh-recall-bubble", key: "text" }, text));
     for (let i = 0; i < rest.length; i++) {
       bubbleChildren.push(React.createElement("pre", { className: "dsh-recall-json", key: "rest-" + i }, JSON.stringify(rest[i], null, 2)));

package/lib/routes-core.js

@@ -79,7 +79,8 @@ function createRoutesCore(deps) {
       });
       if (!result.ok) return result;
       const cutSeq = await snaps.resolveCutSeq(sessionId, id);
-      return { ok: true, count: result.count, cutSeq };
+      const staleQueueRpcIds = await snaps.resolveStaleQueueRpcIds(sessionId, cutSeq);
+      return { ok: true, count: result.count, cutSeq, staleQueueRpcIds };
     },
     // 设置页排障：最近错误（Host 侧 console.error 的页面可见副本）。
     // M1-D3/D5：条目自带 count/kind（recordError 富集）——count 在服务端

package/lib/snapshots.js

@@ -71,6 +71,24 @@ function scanCutSeqDetail(events, messageId) {
 function scanCutSeq(events, messageId) {
   return scanCutSeqDetail(events, messageId).cut;
 }
+function scanStaleQueueRpcIds(events, cutSeq) {
+  if (!Array.isArray(events)) return [];
+  if (typeof cutSeq !== "number" || !Number.isFinite(cutSeq)) return [];
+  const out = [];
+  for (const e of events) {
+    if (!e || typeof e.seq !== "number" || e.seq <= cutSeq) continue;
+    if (e.type === "turn/start") break;
+    if (e.type !== "agent/inbox/spliced") continue;
+    const inserted = e.data && Array.isArray(e.data.inserted) ? e.data.inserted : [];
+    for (const item of inserted) {
+      const source = item && item.source;
+      if (!source || source.kind !== "user") continue;
+      const rpcId = source.rpcId;
+      if (typeof rpcId === "string" && rpcId !== "" && out.indexOf(rpcId) < 0) out.push(rpcId);
+    }
+  }
+  return out;
+}
 function disposeLease(lease) {
   const disposeSymbol = Symbol.dispose;
   if (!disposeSymbol || lease === null || typeof lease !== "object") return;
@@ -409,7 +427,30 @@ function createSnapshots(ctx, rt, config) {
     state.cutSeqCache.set(cacheKey, result);
     return result;
   }
-  return { saveIndex, loadIndex, readExclude, writeExclude, rebuildOrphans, captureSnapshot, diffFor, rollbackFor, resolveCutSeq, feedbackFor, loadLineage, recordLineage };
+  async function resolveStaleQueueRpcIds(sessionId, cutSeq) {
+    if (!sessionId || typeof cutSeq !== "number" || !Number.isFinite(cutSeq)) return [];
+    const live = sessions.get(sessionId);
+    if (live && Array.isArray(live.events)) return scanStaleQueueRpcIds(live.events, cutSeq);
+    const query = ctx.get("sessionQuery");
+    if (!query) return [];
+    try {
+      const log = await query.readSession(sessionId);
+      if (log && Array.isArray(log.events)) return scanStaleQueueRpcIds(log.events, cutSeq);
+    } catch (error) {
+    }
+    if (typeof query.observeSession !== "function") return [];
+    try {
+      const lease = await query.observeSession(sessionId);
+      try {
+        return lease && Array.isArray(lease.events) ? scanStaleQueueRpcIds(lease.events, cutSeq) : [];
+      } finally {
+        disposeLease(lease);
+      }
+    } catch (error) {
+      return [];
+    }
+  }
+  return { saveIndex, loadIndex, readExclude, writeExclude, rebuildOrphans, captureSnapshot, diffFor, rollbackFor, resolveCutSeq, resolveStaleQueueRpcIds, feedbackFor, loadLineage, recordLineage };
 }
 export {
   createSnapshots,
@@ -421,5 +462,6 @@ export {
   parseTreeId,
   rescueRollback,
   scanCutSeq,
-  scanCutSeqDetail
+  scanCutSeqDetail,
+  scanStaleQueueRpcIds
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-recall-plugin",
-  "version": "2.3.16",
+  "version": "2.3.19",
   "description": "在 DSH 中撤回自己发过的消息：工作区文件与对话历史一起回到那条消息发出之前，消息的文本与附件自动放回输入框，改完即可重发。文件走独立影子 git 快照（不碰项目自身的 git），对话走官方 sessions.fork，原会话归档可找回。",
   "type": "module",
   "repository": {