dsh-recall-plugin 2.6.0 → 2.6.1

package/CHANGELOG.md

@@ -2,7 +2,21 @@
 
 本文件格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循语义化版本。
 
-## [Unreleased]
+## [2.6.1] - 2026-10-31
+
+### 新增
+
+- **「只回退消息」模式（`messageOnly`，默认关闭，issue #31）**：开启后每条用户消息仍登记撤回记录（撤回按钮与对话回退照常），但不再执行文件快照——大仓（gitignore 过滤后仍上千文件 / 上 GB）不必为每条消息写一次全量对象。按消息生效：`index.json` 只给这类条目记 `files: false`，开启前拍的旧快照仍可完整回退文件；确认面板对这类消息隐藏「回退文件与对话」单选，快照管理树标「仅消息」。代价是这类记录没有 tag，索引损坏被隔离后撤回按钮无法从 tag 重建。
+
+### 修复
+
+- **磁盘枚举失败不再表现成「没有快照」**：此前快照管理读不到磁盘时会静默返回空列表，界面只剩一棵空树，用户以为快照都没了（issue #30 报告的现场就是这样）。现在失败原因进「最近错误」，列表 / 按工作区或会话批量删除 / 全部删除回 `DUMP_FAILED`，卡片显示可重试的错误条；「全部删除」也不再用「已删除 0 条」掩盖枚举失败。
+- **建过仓但从没拍过快照的空仓不再永久占盘**：dump 脚本为每个 store 增发 `STATE` 段（`present` / `absent` / `quarantined` / `foreign`），「立即 gc」据此把「有 store 布局但从未生成索引」的空壳整目录回收；损坏隔离现场（`index.json.corrupt-*`）、旧版脚本输出与非本插件的目录一律保留。
+
+### 文档
+
+- 新增 [plan-dump-visible-and-empty-reclaim.md](docs/plans/completed/plan-dump-visible-and-empty-reclaim.md)：两条遗留的问题、判据表与测试清单；AGENTS 已知坑补 I46，compat-audit 补 I46 详情。
+- 新增 [plan-message-only-mode.md](docs/plans/completed/plan-message-only-mode.md)：只回退消息的问题、判据、边界与实施记录；smoke checklist 第十一节与 records 同日批次（M1〜M6 实弹）。
 
 ## [2.6.0] - 2026-10-30
 

package/README.md

@@ -161,6 +161,7 @@ peerDependencies 按 minor 版本线开窗，与 `dsh.compatibility.dshReleases`
 | `baseExcludes` | `.git`、`node_modules/`、`.dsh-recall-snapshots/`、`dsh-recall-snapshots/`、`target/`、`dist/`、`build/`、`out/`、`coverage/`、`.next/`、`.nuxt/`、`.output/`、`.cache/`、`.gradle/`、`*.exe`、`*.dll`、`*.pdb`、`*.so`、`*.dylib`、`*.msi`、`*.zip`、`*.7z`、`*.rar`、`*.tar`、`*.tar.gz`、`*.iso` | 基础排除表（gitignore 语法，优先级低于 exclude.txt）；被排除的大目录整棵子树不进快照扫描。其中「目录形态」项（如 `target/`）另有一层含义：**工作区根自身的路径段命中时，该工作区不启用快照**——在构建产物目录里开会话时排除表本来就管不到它自己（模式是相对该 root 的），这类目录也没有回退价值；删掉对应项即恢复 |
 | `refillDraft` | true | 撤回后把被撤回的消息（文本与附件）回填到输入框 |
 | `snapshotEnabled` | true | 快照总开关（关闭只冻结新建，已有快照仍可撤回） |
+| `messageOnly` | false | 只回退消息：每条用户消息仍登记撤回记录（按钮与对话回退照常），但不写文件快照——适合 gitignore 过滤后仍上 GB 的超大工作区。按消息生效：开启前的旧快照仍可完整回退文件；这类条目在快照管理里标「仅消息」，删除后不可从 tag 恢复 |
 | `archiveOriginal` | true | 撤回后归档原会话（关闭后原会话保留在会话列表中） |
 | `editSubmitsImmediately` | true | 「编辑并重发」提交后自动发出改后的消息；关闭则只回填输入框，由你按回车发送 |
 | `locale` | auto | 界面语言：`auto` 跟随系统（`navigator.language` 以 `zh` 开头用中文，否则英文）、`zh` / `en` 显式锁定。见下方「界面语言」 |

package/lib/client.js

@@ -218,6 +218,10 @@
     // 对齐；此前复用 ex-note 左对齐正文样式，空列表区显得是「缺了一行」而非
     // 一个状态
     ".dsh-recall-empty{color:var(--dsw-alias-label-tertiary);font-size:13px;line-height:1.5;text-align:center;padding:24px 0}",
+    // 列表读取失败条（issue #30 遗留项）：error 前景 + 换行不裁切，右侧带重试 chip。
+    // 与空态区分开——「没有快照」和「读不到快照」在用户眼里必须是两件事
+    ".dsh-recall-list-error{display:flex;gap:8px;align-items:flex-start;padding:8px 10px;border-radius:8px;background:var(--dsw-alias-interactive-bg-hover-danger);color:var(--dsw-alias-state-error-primary);font-size:12px;line-height:1.5}",
+    ".dsh-recall-list-error-text{flex:1;min-width:0;word-break:break-word}",
     ".dsh-recall-ex-status-success{color:var(--dsw-alias-state-success-primary)}",
     // V6 健康徽章（git 可用性）：pill 配色直接复用官方状态行配对——成功用
     // success-tertiary 底、失败用 interactive-bg-hover-danger 底（error 无
@@ -242,6 +246,8 @@
     ".dsh-recall-tree-label{flex:1;min-width:0;display:flex;gap:8px;align-items:baseline;font-size:12px;line-height:1.5;overflow:hidden}",
     ".dsh-recall-tree-name{flex:none;font-weight:600;color:var(--dsw-alias-label-secondary)}",
     ".dsh-recall-tree-title{min-width:0;color:var(--dsw-alias-label-primary);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}",
+    // issue #31：仅消息条目的静态标记——与 ex-chip 同丸形，但非按钮、无 hover
+    ".dsh-recall-tree-tag{flex:none;border-radius:999px;corner-shape:round;padding:0 8px;font-size:11px;line-height:1.6;color:var(--dsw-alias-label-tertiary);background:var(--dsw-alias-bg-module-platform);white-space:nowrap}",
     // tabular-nums：树 meta 列（「3 会话 / 28 快照」「v2/3」）多行纵向扫描时
     // 数字等宽，个位对齐不跳动
     ".dsh-recall-tree-meta{flex:none;font-size:12px;line-height:1.5;color:var(--dsw-alias-label-tertiary);white-space:nowrap;font-variant-numeric:tabular-nums}",
@@ -425,6 +431,7 @@
     "tree.family.title": "\u7248\u672C\u5BB6\u65CF\uFF1A{chain}",
     "tree.switch": "\u5207\u6362",
     "tree.switch.title": "\u5207\u6362\u5230\u8BE5\u7248\u672C\u4F1A\u8BDD",
+    "tree.messageOnly": "\u4EC5\u6D88\u606F",
     "tree.delete.snapshot.title": "\u5220\u9664\u8BE5\u5FEB\u7167\uFF08tag \u4E0E\u7D22\u5F15\u6761\u76EE\uFF09",
     "tree.delete.snapshot.confirm": "\u786E\u8BA4\u5220\u9664\u8BE5\u5FEB\u7167\uFF1F\u6B64\u64CD\u4F5C\u4E0D\u53EF\u6062\u590D\u3002",
     "tree.delete.session.title": "\u5220\u9664\u8BE5\u4F1A\u8BDD\u5168\u90E8\u5FEB\u7167",
@@ -438,6 +445,8 @@
     "recall.truncated.files": "\u2026\u4EC5\u663E\u793A\u524D {shown} \u6761\uFF0C\u5171 {total} \u4E2A\u6587\u4EF6\u5C06\u53D8\u66F4",
     "recall.truncated.chat": "\u2026\u4EC5\u663E\u793A\u524D {shown} \u6761\uFF0C\u5171 {total} \u5904\u5DEE\u5F02",
     "recall.confirm.sessionOnly": "\u9879\u76EE\u6587\u4EF6\u4FDD\u6301\u5F53\u524D\u72B6\u6001\uFF0C\u4E0D\u4F1A\u88AB\u56DE\u9000\u6216\u5220\u9664\uFF1B\u5BF9\u8BDD\u56DE\u9000\u5230\u8BE5\u6D88\u606F\u4E4B\u524D\u3002",
+    "recall.confirm.messageOnly": "\u8FD9\u6761\u6D88\u606F\u53EA\u6709\u5BF9\u8BDD\u56DE\u9000\uFF1A\u4E0D\u4F1A\u6539\u52A8\u9879\u76EE\u6587\u4EF6\uFF0C\u5BF9\u8BDD\u56DE\u9000\u5230\u8BE5\u6D88\u606F\u4E4B\u524D\u3002",
+    "recall.confirm.noEffect": "\u8BE5\u6D88\u606F\u6CA1\u6709\u6587\u4EF6\u5FEB\u7167\uFF0C\u4E14\u662F\u4F1A\u8BDD\u7B2C\u4E00\u6761\u6D88\u606F\uFF0C\u4E4B\u524D\u6CA1\u6709\u53EF\u56DE\u9000\u7684\u5BF9\u8BDD\u3002",
     "recall.confirm.rollbackAt": "\u5C06\u9879\u76EE\u6062\u590D\u5230 {time} \u53D1\u9001\u8BE5\u6D88\u606F\u65F6\u7684\u72B6\u6001\u3002",
     "recall.confirm.rollbackNoTime": "\u5C06\u9879\u76EE\u6062\u590D\u5230\u53D1\u9001\u8BE5\u6D88\u606F\u65F6\u7684\u72B6\u6001\u3002",
     "recall.confirm.files": "\u5171 {total} \u4E2A\u6587\u4EF6\u5C06\u53D8\u66F4{summary}\u3002\u6B64\u64CD\u4F5C\u4F1A\u8986\u76D6\u5F53\u524D\u6587\u4EF6\u5185\u5BB9\uFF1B\u56DE\u9000\u524D\u4F1A\u81EA\u52A8\u4FDD\u5B58\u4E00\u4EFD\u5F53\u524D\u72B6\u6001\u7684\u5B89\u5168\u5FEB\u7167\uFF08\u4E0D\u542B\u5728\u4E0B\u65B9\u6E05\u5355\u5185\uFF09\u3002",
@@ -511,6 +520,7 @@
     "notice.buildRoot": "\u5F53\u524D\u5DE5\u4F5C\u533A\u4F4D\u4E8E\u6784\u5EFA\u4EA7\u7269\u76EE\u5F55\uFF08\u8DEF\u5F84\u6BB5 {seg}\uFF09\uFF0C\u5DF2\u8DF3\u8FC7\u9879\u76EE\u5FEB\u7167\uFF1B\u5982\u9700\u5728\u6B64\u76EE\u5F55\u4F7F\u7528\u64A4\u56DE\uFF0C\u8BF7\u5728\u63D2\u4EF6\u8BBE\u7F6E\u91CC\u4ECE\u300C\u57FA\u7840\u6392\u9664\u8868\u300D\u79FB\u9664\u8BE5\u9879\u3002",
     // ---- 错误码文案（host 静态 message 的本地化副本；动态细节码不在表内）----
     "err.STALE": "\u9884\u89C8\u540E\u9879\u76EE\u6587\u4EF6\u53D1\u751F\u4E86\u53D8\u5316\uFF0C\u8BF7\u91CD\u65B0\u9884\u89C8\u786E\u8BA4",
+    "err.DUMP_FAILED": "\u8BFB\u53D6\u78C1\u76D8\u5FEB\u7167\u5931\u8D25\uFF0C\u5217\u8868\u4E0E\u6279\u91CF\u5220\u9664\u6682\u4E0D\u53EF\u7528\uFF1B\u8BF7\u67E5\u770B\u300C\u6700\u8FD1\u9519\u8BEF\u300D\u540E\u91CD\u8BD5",
     "err.AGENT_BUSY": "Agent \u6B63\u5728\u8FD0\u884C\u4E2D\uFF0C\u8BF7\u5148\u505C\u6B62\u540E\u518D\u64A4\u56DE",
     "err.NO_SNAPSHOT": "\u8BE5\u6D88\u606F\u6CA1\u6709\u53EF\u7528\u7684\u9879\u76EE\u5FEB\u7167",
     "err.NO_STORE": "\u5FEB\u7167\u5B58\u50A8\u4E0D\u53EF\u7528",
@@ -553,6 +563,7 @@
     "manage.search.placeholder": "\u641C\u7D22\u5DE5\u4F5C\u533A / \u4F1A\u8BDD\u6807\u9898 / \u6D88\u606F\u5185\u5BB9 / ID",
     "manage.search.aria": "\u641C\u7D22\u5FEB\u7167",
     "manage.empty": "\u5728\u4EFB\u610F\u5DE5\u4F5C\u533A\u53D1\u9001\u4E00\u6761\u6D88\u606F\u540E\uFF0C\u8FD9\u91CC\u4F1A\u51FA\u73B0\u5FEB\u7167\u3002",
+    "manage.loadFailed": "\u8BFB\u53D6\u78C1\u76D8\u5FEB\u7167\u5931\u8D25",
     "manage.emptyFiltered": "\u65E0\u5339\u914D\u5FEB\u7167",
     "manage.errors.title": "\u6700\u8FD1\u9519\u8BEF ({n})",
     "manage.errors.collapse": "\u6536\u8D77",
@@ -571,6 +582,8 @@
     "config.group.ui": "\u754C\u9762",
     "config.snapshotEnabled.label": "\u542F\u7528\u5FEB\u7167",
     "config.snapshotEnabled.hint": "\u5173\u95ED\u540E\u4E0D\u518D\u65B0\u5EFA\u5FEB\u7167\uFF1B\u5DF2\u6709\u5FEB\u7167\u4ECD\u53EF\u64A4\u56DE",
+    "config.messageOnly.label": "\u53EA\u56DE\u9000\u6D88\u606F",
+    "config.messageOnly.hint": "\u6BCF\u6761\u6D88\u606F\u53EA\u767B\u8BB0\u64A4\u56DE\u8BB0\u5F55\uFF0C\u4E0D\u5199\u6587\u4EF6\u5FEB\u7167\uFF08\u8D85\u5927\u5DE5\u4F5C\u533A\u7701\u65F6\u7701\u76D8\uFF09\uFF1B\u5DF2\u6709\u5FEB\u7167\u4ECD\u53EF\u56DE\u9000\u6587\u4EF6",
     "config.refillDraft.label": "\u56DE\u586B\u8F93\u5165\u6846",
     "config.refillDraft.hint": "\u64A4\u56DE\u540E\u628A\u6D88\u606F\u6587\u672C\u56DE\u586B\u8F93\u5165\u6846\uFF0C\u4FBF\u4E8E\u6539\u5B8C\u91CD\u53D1",
     "config.archiveOriginal.label": "\u5F52\u6863\u539F\u4F1A\u8BDD",
@@ -683,6 +696,7 @@
     "tree.family.title": "Version family: {chain}",
     "tree.switch": "Switch",
     "tree.switch.title": "Switch to this version session",
+    "tree.messageOnly": "Messages only",
     "tree.delete.snapshot.title": "Delete this snapshot (tag and index entry)",
     "tree.delete.snapshot.confirm": "Delete this snapshot? This cannot be undone.",
     "tree.delete.session.title": "Delete all snapshots of this session",
@@ -696,6 +710,8 @@
     "recall.truncated.files": "\u2026showing the first {shown} of {total} files to change",
     "recall.truncated.chat": "\u2026showing the first {shown} of {total} differences",
     "recall.confirm.sessionOnly": "Project files stay as they are \u2014 nothing is reverted or deleted; only the chat rewinds to before this message.",
+    "recall.confirm.messageOnly": "This message only rewinds the chat: project files are untouched, and the chat goes back to before this message.",
+    "recall.confirm.noEffect": "This message has no file snapshot, and as the first message of the session there is no earlier chat to rewind to.",
     "recall.confirm.rollbackAt": "Restore the project to its state at {time}, when this message was sent.",
     "recall.confirm.rollbackNoTime": "Restore the project to its state when this message was sent.",
     // 句首空格是有意的：本句与 recall.confirm.rollbackAt 拼接成一段（前句以句点
@@ -769,6 +785,7 @@
     "notice.buildRoot": 'This workspace is a build-artifact directory (path segment {seg}), so project snapshots are skipped; to use recall here, remove that entry from "Base excludes" in the plugin settings.',
     // ---- 错误码文案 ----
     "err.STALE": "Project files changed after the preview; preview again to confirm",
+    "err.DUMP_FAILED": 'Could not read snapshots from disk; the list and bulk delete are unavailable. Check "Recent errors" and retry',
     "err.AGENT_BUSY": "The agent is running; stop it before recalling",
     "err.NO_SNAPSHOT": "No project snapshot is available for this message",
     "err.NO_STORE": "Snapshot storage is unavailable",
@@ -811,6 +828,7 @@
     "manage.search.placeholder": "Search workspace / session title / message / ID",
     "manage.search.aria": "Search snapshots",
     "manage.empty": "Send a message in any workspace and its snapshot will appear here.",
+    "manage.loadFailed": "Could not read snapshots from disk",
     "manage.emptyFiltered": "No matching snapshots",
     "manage.errors.title": "Recent errors ({n})",
     "manage.errors.collapse": "Collapse",
@@ -829,6 +847,8 @@
     "config.group.ui": "Interface",
     "config.snapshotEnabled.label": "Enable snapshots",
     "config.snapshotEnabled.hint": "When off, no new snapshots are created; existing ones can still be recalled",
+    "config.messageOnly.label": "Messages only",
+    "config.messageOnly.hint": "Register recall records without writing file snapshots (saves time and disk in huge workspaces); existing snapshots can still roll back files",
     "config.refillDraft.label": "Refill input box",
     "config.refillDraft.hint": "Put the message text back into the input box after a recall, so you can edit and resend",
     "config.archiveOriginal.label": "Archive original session",
@@ -1890,7 +1910,7 @@
     writeIds(rootId, next);
   }
 
-  // src/client/recall-node.ts
+  // src/client/message-blocks.ts
   function attachmentRefsFromBlocks(blocks) {
     const refs = [];
     for (const block of blocks) {
@@ -1903,6 +1923,18 @@
     }
     return refs;
   }
+  function projectMessageBlocks(blocks) {
+    return {
+      text: blocks.filter((b) => b && b.type === "text" && typeof b.text === "string").map((b) => b.text).join(""),
+      // 官方契约：images 传 image 块数组（{attachment}），官方内部取
+      // image.attachment.attachmentId —— 不是裸 attachment 对象
+      images: blocks.filter((b) => b && b.type === "image" && b.attachment).map((b) => ({ attachment: b.attachment })),
+      // file 块（文档/表格等非图片附件）：官方渲染成文件卡片（图标 + 文件名 +
+      // 扩展名/大小）——自绘路径必须复刻，否则它落进 rest 的 JSON 兜底
+      files: blocks.filter((b) => b && b.type === "file"),
+      rest: blocks.filter((b) => !b || !(b.type === "text" && typeof b.text === "string") && !(b.type === "image" && b.attachment) && b.type !== "file")
+    };
+  }
   function fileExtOf(name) {
     const dot = name.lastIndexOf(".");
     const raw = dot > 0 && dot < name.length - 1 ? name.slice(dot + 1) : "";
@@ -1923,6 +1955,8 @@
     const name = ref && typeof ref === "object" && typeof ref.name === "string" && ref.name !== "" ? ref.name : t("file.unnamed");
     return { name, ext: fileExtOf(name), size: fileCardSizeText(ref && typeof ref === "object" ? ref.bytes : void 0) };
   }
+
+  // src/client/diff-kinds.ts
   var KIND_INFO = {
     modified: { labelKey: "kind.modified", cls: "modified" },
     restored: { labelKey: "kind.restored", cls: "restored" },
@@ -1938,6 +1972,8 @@
     }
     return parts.join(" \xB7 ");
   }
+
+  // src/client/recall-node.ts
   function buildRecallNode(React, util, ctx, sessionsSvc, workspacesSvc, uiWorkspaceSvc) {
     const { api, ensureInit, showThrottledToast, writeClipboard, clockText: clockText2, pluginConfig, messageFor, t } = util;
     const { EditIcon, EditPanel } = buildEditFlow(React, t);
@@ -2007,7 +2043,9 @@
           );
         });
         const canRevertChat = typeof recall.cutSeq === "number";
-        const sessionOnly = canRevertChat && scope === "session-only";
+        const noFiles = recall.files === false;
+        const sessionOnly = noFiles || canRevertChat && scope === "session-only";
+        const noEffect = noFiles && !canRevertChat;
         if (recall.truncated) {
           rows.push(React.createElement(
             "div",
@@ -2027,11 +2065,11 @@
           React.createElement("div", { className: "dsh-recall-panel-title" }, t("recall.confirm.title")),
           sessionOnly ? (
             // session-only：零文件改动即无不可逆操作缺口——安全快照预告随之隐藏
-            //（不打安全快照），主说明换成模式语义
+            //（不打安全快照），主说明换成模式语义；仅消息条目另给专属说明
             React.createElement(
               "div",
               { className: "dsh-recall-panel-note" },
-              t("recall.confirm.sessionOnly")
+              t(noFiles ? "recall.confirm.messageOnly" : "recall.confirm.sessionOnly")
             )
           ) : React.createElement(
             "div",
@@ -2053,9 +2091,10 @@
             )
           ) : null,
           changes.length > 0 ? React.createElement("div", { className: "dsh-recall-list" }, ...rows) : null,
-          canRevertChat ? (
+          canRevertChat && !noFiles ? (
             // 模式二选一（原生 radio，键盘方向键可达）：临场选择不设全局配置项；
-            // 默认 both 与现状一致，面板每次打开都复位到默认起点
+            // 默认 both 与现状一致，面板每次打开都复位到默认起点。仅消息条目
+            // 没有可选项（没有文件树），整组隐藏
             React.createElement(
               "div",
               { className: "dsh-recall-scope", role: "radiogroup", "aria-label": t("recall.scope.aria") },
@@ -2073,22 +2112,28 @@
               )
             )
           ) : null,
+          noEffect ? (
+            // 仅消息 + 首条消息：文件无快照、对话无更早切点，提交只会空转
+            React.createElement("div", { className: "dsh-recall-panel-note", key: "no-effect" }, t("recall.confirm.noEffect"))
+          ) : null,
           React.createElement(
             "div",
             { className: "dsh-recall-panel-actions" },
             React.createElement("button", { type: "button", className: "dsh-recall-btn", onClick: closePanel }, t("common.cancel")),
-            React.createElement("button", { type: "button", className: "dsh-recall-btn dsh-recall-btn-danger", onClick: executeRecall }, t(sessionOnly ? "recall.confirm.submit.sessionOnly" : "recall.confirm.submit.both"))
+            React.createElement("button", { type: "button", className: "dsh-recall-btn dsh-recall-btn-danger", disabled: noEffect, onClick: executeRecall }, t(sessionOnly ? "recall.confirm.submit.sessionOnly" : "recall.confirm.submit.both"))
           )
         );
       }
       if (recall.stage === "executing") {
+        const active = recall.scope || scope;
         return React.createElement(
           "div",
           { className: "dsh-recall-panel" },
-          React.createElement("div", { className: "dsh-recall-panel-title" }, t(scope === "session-only" ? "recall.executing.sessionOnly" : "recall.executing.both"))
+          React.createElement("div", { className: "dsh-recall-panel-title" }, t(active === "session-only" ? "recall.executing.sessionOnly" : "recall.executing.both"))
         );
       }
       if (recall.stage === "done") {
+        const active = recall.scope || scope;
         return React.createElement(
           "div",
           { className: "dsh-recall-panel" },
@@ -2096,7 +2141,7 @@
           React.createElement(
             "div",
             { className: "dsh-recall-panel-note" },
-            scope === "session-only" ? (
+            active === "session-only" ? (
               // session-only 文案矩阵：文件侧零改动是确定事实，失败时也只描述对话侧
               recall.chatReverted ? t("recall.done.sessionOnly.ok") : t("recall.done.sessionOnly.fail", { error: recall.chatError || t("common.unknownReason") })
             ) : recall.chatReverted ? t("recall.done.both.ok") : t("recall.done.both.partial") + (recall.chatError ? t("recall.done.both.failChat", { error: recall.chatError }) : "")
@@ -2145,10 +2190,7 @@
       const data = node && node.data ? node.data : {};
       const messageId = node ? String(node.id || node.key || "") : "";
       const blocks = Array.isArray(data.content) ? data.content : [];
-      const text2 = 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 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 { text: text2, images: imageBlocks, files: fileBlocks, rest } = projectMessageBlocks(blocks);
       const attachmentRefs = attachmentRefsFromBlocks(blocks);
       activeSession.id = String(sessionId || "");
       const [copied, setCopied] = React.useState(false);
@@ -2475,7 +2517,9 @@
             truncated: Boolean(res.truncated),
             treeId: res.treeId || null,
             time: res.time || null,
-            cutSeq: typeof res.cutSeq === "number" ? res.cutSeq : null
+            cutSeq: typeof res.cutSeq === "number" ? res.cutSeq : null,
+            // issue #31：仅消息条目没有文件树（老 Host 无该字段 → 按 true）
+            files: res.files !== false
           });
         }).catch((error) => {
           setRecall({ stage: "error", message: String(error) });
@@ -2486,7 +2530,7 @@
         const isEdit = editText !== null;
         if (!isEdit && recall.stage !== "confirm") return;
         const changes = recall.stage === "confirm" ? recall.changes || [] : [];
-        const activeScope = overrides && overrides.scope === "session-only" ? "session-only" : overrides && overrides.scope === "both" ? "both" : scope;
+        const activeScope = overrides && overrides.scope === "session-only" ? "session-only" : overrides && overrides.scope === "both" ? "both" : recall.stage === "confirm" && recall.files === false ? "session-only" : scope;
         const previewCut = overrides && overrides.cutSeq !== void 0 ? overrides.cutSeq : recall.stage === "confirm" && typeof recall.cutSeq === "number" ? recall.cutSeq : null;
         const setStage = (stage) => {
           if (!isEdit) {
@@ -2505,7 +2549,7 @@
         const baseFiles = wantAttachments ? preloadAttachmentFiles(sessionId, refsForFiles) : null;
         const inlineFiles = overrides && overrides.editFiles ? overrides.editFiles : null;
         const attachmentFiles = baseFiles !== null && inlineFiles !== null ? Promise.all([baseFiles, inlineFiles]).then(([base, extra]) => base.concat(extra)) : baseFiles !== null ? baseFiles : inlineFiles;
-        setStage({ stage: "executing", changes });
+        setStage({ stage: "executing", changes, scope: activeScope });
         api("execute", { messageId, sessionId, previewTotal, previewTreeId: previewTreeId || void 0, scope: activeScope, previewAt: Date.now() }).then(async (res) => {
           if (!res || !res.ok) {
             if (res && res.code === "STALE") {
@@ -2526,7 +2570,8 @@
                   truncated: Boolean(res2.truncated),
                   treeId: res2.treeId || null,
                   time: res2.time || null,
-                  cutSeq: typeof res2.cutSeq === "number" ? res2.cutSeq : null
+                  cutSeq: typeof res2.cutSeq === "number" ? res2.cutSeq : null,
+                  files: res2.files !== false
                 });
               }).catch((error) => {
                 setStage({ stage: "error", message: String(error) });
@@ -2592,7 +2637,7 @@
               fillDraft(fillTarget, text2, attachmentFiles);
               if (fileBlocks.length > 0) showThrottledToast(t("toast.fileAttachRefill"));
             }
-            setRecall({ stage: "done", count: typeof res.count === "number" ? res.count : changes.length, chatReverted, chatError });
+            setRecall({ stage: "done", count: typeof res.count === "number" ? res.count : changes.length, chatReverted, chatError, scope: activeScope });
           }
           if (chatError === "") {
             api("notify", buildRecallNotify(notifyBase, {
@@ -2776,6 +2821,8 @@
               baseExcludes: Array.isArray(v.baseExcludes) ? v.baseExcludes.join("\n") : "",
               refillDraft: v.refillDraft !== false,
               snapshotEnabled: v.snapshotEnabled !== false,
+              // issue #31：老 Host 无该字段 → 按默认 false（现状）处理
+              messageOnly: v.messageOnly === true,
               archiveOriginal: v.archiveOriginal !== false,
               // issue #26：老 Host 的 values 无该字段时按默认 true（与 util 同口径）
               editSubmitsImmediately: v.editSubmitsImmediately !== false,
@@ -2803,7 +2850,7 @@
       function save() {
         if (state.busy || !draft || !baseline) return;
         const patch = {};
-        for (const key of ["gcSnaps", "gcHours", "maxFileBytes", "maxWorkspaceBytes", "scanBudgetMs", "snapshotBudgetMs", "maxSnapshotsPerWorkspace", "baseExcludes", "refillDraft", "snapshotEnabled", "archiveOriginal", "editSubmitsImmediately", "retentionDays", "locale"]) {
+        for (const key of ["gcSnaps", "gcHours", "maxFileBytes", "maxWorkspaceBytes", "scanBudgetMs", "snapshotBudgetMs", "maxSnapshotsPerWorkspace", "baseExcludes", "refillDraft", "snapshotEnabled", "messageOnly", "archiveOriginal", "editSubmitsImmediately", "retentionDays", "locale"]) {
           const value = draft[key];
           if (value !== void 0 && value !== baseline[key]) patch[key] = value;
         }
@@ -2870,6 +2917,7 @@
         }
         if (patch.refillDraft !== void 0) clean.refillDraft = Boolean(patch.refillDraft);
         if (patch.snapshotEnabled !== void 0) clean.snapshotEnabled = Boolean(patch.snapshotEnabled);
+        if (patch.messageOnly !== void 0) clean.messageOnly = Boolean(patch.messageOnly);
         if (patch.archiveOriginal !== void 0) clean.archiveOriginal = Boolean(patch.archiveOriginal);
         if (patch.editSubmitsImmediately !== void 0) clean.editSubmitsImmediately = Boolean(patch.editSubmitsImmediately);
         if (patch.retentionDays !== void 0) {
@@ -3027,6 +3075,8 @@
           // 不重复加标题。
           React.createElement("div", { className: "dsh-recall-cfg-group" }, t("config.group.snapshot")),
           boolRow("snapshotEnabled", t("config.snapshotEnabled.label"), t("config.snapshotEnabled.hint")),
+          // issue #31：只回退消息——紧挨总开关，语义上是「快照写什么」的下一层
+          boolRow("messageOnly", t("config.messageOnly.label"), t("config.messageOnly.hint")),
           boolRow("refillDraft", t("config.refillDraft.label"), t("config.refillDraft.hint")),
           boolRow("archiveOriginal", t("config.archiveOriginal.label"), t("config.archiveOriginal.hint")),
           boolRow("editSubmitsImmediately", t("config.editSubmitsImmediately.label"), t("config.editSubmitsImmediately.hint")),
@@ -3287,7 +3337,7 @@
     return result;
   }
   function buildSnapshotManager(React, util, sessionsSvc, workspacesSvc, uiWorkspaceSvc) {
-    const { api, clockText: clockText2, sizeText: sizeText2, buildTree: buildTree2, t } = util;
+    const { api, clockText: clockText2, sizeText: sizeText2, buildTree: buildTree2, messageFor, t } = util;
     function DeleteButton(props) {
       return React.createElement("button", {
         type: "button",
@@ -3326,6 +3376,7 @@
     }
     function ManageCard() {
       const [items, setItems] = React.useState(null);
+      const [listError, setListError] = React.useState(null);
       const [usage, setUsage] = React.useState(null);
       const [errors, setErrors] = React.useState(null);
       const [state, setState] = React.useState({ busy: false, message: "", error: false });
@@ -3369,6 +3420,7 @@
         const useLimit = overLimit || limit;
         api("manage", { op: "list", limit: useLimit }).then((res) => {
           if (res && res.ok) {
+            setListError(null);
             setItems(res.items || []);
             setTotal(typeof res.total === "number" ? res.total : (res.items || []).length);
             fetchTitles(res.items || []);
@@ -3384,6 +3436,10 @@
               }).catch(() => {
               });
             }
+          } else if (res) {
+            setListError(messageFor(res, t("manage.loadFailed")));
+            setItems([]);
+            setTotal(0);
           }
           api("manage", { op: "lineage" }).then((res2) => {
             if (res2 && res2.ok && Array.isArray(res2.lineage)) setLineage(res2.lineage);
@@ -3519,6 +3575,8 @@
               "span",
               { className: "dsh-recall-tree-label" },
               React.createElement("span", { className: "dsh-recall-tree-title" }, label),
+              // issue #31：仅消息条目没有文件树，标出来——否则用户会以为这条能回退文件
+              it.files === false ? React.createElement("span", { className: "dsh-recall-tree-tag", key: "message-only" }, t("tree.messageOnly")) : null,
               // 删除紧贴本条消息摘要（而非行尾）：按行扫读时动作落在「看的那一行」，
               // 不必横跳到右侧同列按钮再回读行号
               React.createElement(DeleteButton, {
@@ -3696,6 +3754,13 @@
             onChange: (e) => setQuery(e.target.value)
           })
         ),
+        // 读取失败提示：role=alert 让读屏立即播报；「重试」复用 refresh，不新造入口
+        listError ? React.createElement(
+          "div",
+          { key: "list-error", className: "dsh-recall-list-error", role: "alert" },
+          React.createElement("span", { className: "dsh-recall-list-error-text" }, listError),
+          React.createElement("button", { type: "button", className: "dsh-recall-ex-chip", onClick: () => refresh() }, t("common.retry"))
+        ) : null,
         // V3 加载骨架：items===null 表示首查未回——用 5 条 pulse 灰条占位替代
         // 打开快照管理时的一段空白；aria-hidden 纯装饰不打扰读屏
         items === null ? React.createElement(

package/lib/config.js

@@ -47,6 +47,10 @@ const Config = Schema.object({
   baseExcludes: withVolatile(Schema.array(Schema.string()).default(BASE_EXCLUDES).description("\u57FA\u7840\u6392\u9664\u8868\uFF08gitignore \u8BED\u6CD5\uFF0C\u4F18\u5148\u7EA7\u4F4E\u4E8E exclude.txt\uFF09")),
   refillDraft: withVolatile(Schema.boolean().default(true).description("\u64A4\u56DE\u540E\u628A\u88AB\u64A4\u56DE\u7684\u6D88\u606F\uFF08\u6587\u672C\u4E0E\u9644\u4EF6\uFF09\u56DE\u586B\u5230\u8F93\u5165\u6846")),
   snapshotEnabled: withVolatile(Schema.boolean().default(true).description("\u542F\u7528\u6D88\u606F\u5FEB\u7167\uFF08\u5173\u95ED\u540E\u4E0D\u518D\u65B0\u5EFA\uFF0C\u5DF2\u6709\u5FEB\u7167\u4ECD\u53EF\u64A4\u56DE\uFF09")),
+  // issue #31：超大工作区（gitignore 过滤后仍上 GB）每条消息写一次全量对象
+  // 成本过高。开启后仍登记撤回记录（按钮与对话回退照常），但跳过文件快照；
+  // 按条落 files:false，老条目仍可完整回退文件
+  messageOnly: withVolatile(Schema.boolean().default(false).description("\u53EA\u56DE\u9000\u6D88\u606F\uFF1A\u6BCF\u6761\u6D88\u606F\u53EA\u767B\u8BB0\u64A4\u56DE\u8BB0\u5F55\uFF0C\u4E0D\u5199\u6587\u4EF6\u5FEB\u7167\uFF08\u9002\u5408\u8D85\u5927\u5DE5\u4F5C\u533A\uFF09")),
   archiveOriginal: withVolatile(Schema.boolean().default(true).description("\u64A4\u56DE\u540E\u5F52\u6863\u539F\u4F1A\u8BDD\uFF08\u5173\u95ED\u540E\u539F\u4F1A\u8BDD\u4FDD\u7559\u5728\u5217\u8868\u4E2D\uFF09")),
   // issue #26：编辑提交后自动发出改后的文本。关闭则退化为「只回填输入框」，
   // 给「只想改稿、不立刻发」的用户留一条与撤回回填一致的出口
@@ -137,6 +141,7 @@ const DEFAULTS = {
   baseExcludes: BASE_EXCLUDES,
   refillDraft: true,
   snapshotEnabled: true,
+  messageOnly: false,
   archiveOriginal: true,
   editSubmitsImmediately: true,
   retentionDays: 0,
@@ -160,12 +165,13 @@ function createConfig(raw) {
   const baseExcludes = Array.isArray(cfg.baseExcludes) && cfg.baseExcludes.length ? cfg.baseExcludes.filter((p) => typeof p === "string" && p.trim()) : BASE_EXCLUDES;
   const refillDraft = typeof cfg.refillDraft === "boolean" ? cfg.refillDraft : true;
   const snapshotEnabled = typeof cfg.snapshotEnabled === "boolean" ? cfg.snapshotEnabled : true;
+  const messageOnly = cfg.messageOnly === true;
   const archiveOriginal = typeof cfg.archiveOriginal === "boolean" ? cfg.archiveOriginal : true;
   const editSubmitsImmediately = cfg.editSubmitsImmediately !== false;
   const rawDays = typeof cfg.retentionDays === "number" ? cfg.retentionDays : parseInt(String(cfg.retentionDays == null ? "" : cfg.retentionDays), 10);
   const retentionDays = Number.isFinite(rawDays) ? Math.max(0, rawDays) : 0;
   const locale = cfg.locale === "zh" || cfg.locale === "en" ? cfg.locale : "auto";
-  return { gcSnaps, gcHours, maxFileBytes, maxWorkspaceBytes, scanBudgetMs, snapshotBudgetMs, maxSnapshotsPerWorkspace, baseExcludes, refillDraft, snapshotEnabled, archiveOriginal, editSubmitsImmediately, retentionDays, locale };
+  return { gcSnaps, gcHours, maxFileBytes, maxWorkspaceBytes, scanBudgetMs, snapshotBudgetMs, maxSnapshotsPerWorkspace, baseExcludes, refillDraft, snapshotEnabled, messageOnly, archiveOriginal, editSubmitsImmediately, retentionDays, locale };
 }
 export {
   Config,

package/lib/dump-parse.js

@@ -31,7 +31,7 @@ function parseStoresDump(text) {
   for (const line of String(text).split(/\r?\n/)) {
     if (line.indexOf("==DIR ") === 0) {
       flush();
-      cur = { dir: line.slice(6).trim(), root: null, entries: null, lineage: null };
+      cur = { dir: line.slice(6).trim(), root: null, entries: null, lineage: null, indexState: "unknown" };
       inIndex = false;
       inLineage = false;
       indexLines = [];
@@ -39,6 +39,11 @@ function parseStoresDump(text) {
       continue;
     }
     if (!cur) continue;
+    if (line.indexOf("STATE ") === 0) {
+      const v = line.slice(6).trim();
+      if (v === "present" || v === "absent" || v === "quarantined" || v === "foreign") cur.indexState = v;
+      continue;
+    }
     if (line.indexOf("ROOT ") === 0) {
       const v = line.slice(5).trim();
       cur.root = v || null;

package/lib/errors.js

@@ -16,6 +16,7 @@ const RECALL_PARTIAL_DELETE = "PARTIAL_DELETE";
 const RECALL_UNKNOWN_OP = "UNKNOWN_OP";
 const RECALL_FORMAT_BLOCKED = "FORMAT_BLOCKED";
 const RECALL_UNKNOWN_ENDPOINT = "UNKNOWN_ENDPOINT";
+const RECALL_DUMP_FAILED = "DUMP_FAILED";
 const RECALL_INDEX_CORRUPT = "INDEX_CORRUPT";
 const ALL_CODES = Object.freeze([
   RECALL_STALE,
@@ -36,6 +37,7 @@ const ALL_CODES = Object.freeze([
   RECALL_UNKNOWN_OP,
   RECALL_FORMAT_BLOCKED,
   RECALL_UNKNOWN_ENDPOINT,
+  RECALL_DUMP_FAILED,
   RECALL_INDEX_CORRUPT
 ]);
 export {
@@ -43,6 +45,7 @@ export {
   RECALL_AGENT_BUSY,
   RECALL_BAD_TYPE,
   RECALL_BODY_TOO_LARGE,
+  RECALL_DUMP_FAILED,
   RECALL_EMPTY_PATCH,
   RECALL_ERROR,
   RECALL_FORMAT_BLOCKED,

package/lib/index.js

@@ -154,13 +154,20 @@ function apply(ctx, config) {
       const text = rt.scripts.stripBom(await rt.runShell(rt.scripts.storesDumpScript(container || "", extras), { timeoutMs: 12e4, stdoutMaxBytes: 8388608 }));
       return parseStoresDump(text);
     } catch (error) {
-      console.error("recall stores dump failed:", String(error && error.stack || error));
-      return /* @__PURE__ */ new Map();
+      const detail = String(error && error.stack || error);
+      console.error("recall stores dump failed:", detail);
+      rt.recordError("recall stores dump failed: " + detail);
+      throw error instanceof Error ? error : new Error(String(error));
     }
   }
   async function locateSnapshotOnDisk(id) {
     if (!id) return null;
-    const dump = await dumpStores();
+    let dump;
+    try {
+      dump = await dumpStores();
+    } catch (error) {
+      return null;
+    }
     const hints = /* @__PURE__ */ new Map();
     for (const [root, st] of state.stores.entries()) {
       if (st && st.dir) hints.set(st.dir, root);

package/lib/maintenance.js

@@ -205,7 +205,9 @@ function createMaintenance(ctx, rt, snaps, config, deps = {}) {
     let removed = 0;
     for (const [dir, info] of disk) {
       if (!dir || !info) continue;
-      if (!Array.isArray(info.entries) || info.entries.length) continue;
+      const emptyIndex = Array.isArray(info.entries) && info.entries.length === 0;
+      const neverCaptured = info.entries === null && info.indexState === "absent";
+      if (!emptyIndex && !neverCaptured) continue;
       if (memorySnapshotCount(dir, info.root) > 0) continue;
       const store = rt.storeFromDir(dir, false);
       try {

package/lib/routes-core.js

@@ -38,6 +38,8 @@ function createRoutesCore(deps) {
         time: snap ? snap.time : null,
         id,
         ...feedback,
+        // issue #31：按钮照常出现，但界面要知道这条没有文件树（隐藏范围单选）
+        files: snap ? snap.files !== false : void 0,
         // A4：段名与中文 notice 并存下发（client 优先段名本地取词，见 init 同处注释）
         notice: artifactSeg ? buildRootNotice(artifactSeg) : void 0,
         artifactSeg: artifactSeg || void 0
@@ -52,14 +54,15 @@ function createRoutesCore(deps) {
       if (result === null) return { ok: false, code: E.RECALL_NO_SNAPSHOT, message: "\u8BE5\u6D88\u606F\u6CA1\u6709\u53EF\u7528\u7684\u9879\u76EE\u5FEB\u7167" };
       const snap2 = state.snapshots.get(id);
       const cutSeq = await snaps.resolveCutSeq(sessionId, id);
-      return { ok: true, changes: result.changes, total: result.total, truncated: result.truncated, treeId: result.treeId || null, time: snap2 ? snap2.time : null, root: snap2 ? snap2.root : null, cutSeq };
+      return { ok: true, changes: result.changes, total: result.total, truncated: result.truncated, treeId: result.treeId || null, time: snap2 ? snap2.time : null, root: snap2 ? snap2.root : null, cutSeq, files: snap2 ? snap2.files !== false : void 0 };
     },
     "execute": async (args) => {
       const id = args && args.messageId ? String(args.messageId) : "";
       const sessionId = args && args.sessionId ? String(args.sessionId) : null;
-      const scope = args && args.scope === "session-only" ? "session-only" : "both";
+      const entry = state.snapshots.get(id);
+      const scope = args && args.scope === "session-only" || entry !== void 0 && entry.files === false ? "session-only" : "both";
       if (scope === "session-only") {
-        const snap = state.snapshots.get(id);
+        const snap = entry;
         if (!snap) return { ok: false, code: E.RECALL_NO_SNAPSHOT, message: "\u8BE5\u6D88\u606F\u6CA1\u6709\u53EF\u7528\u7684\u9879\u76EE\u5FEB\u7167" };
         if (agentBusy(sessionId, snap.root)) return { ok: false, code: E.RECALL_AGENT_BUSY, message: "Agent \u6B63\u5728\u8FD0\u884C\u4E2D\uFF0C\u8BF7\u5148\u505C\u6B62\u540E\u518D\u64A4\u56DE" };
         const cutSeq2 = await snaps.resolveCutSeq(sessionId, id);

package/lib/routes-manage.js

@@ -29,6 +29,9 @@ function createRoutesManage(deps) {
     E
   } = deps;
   const { sessionTitles, messageTexts, liveTitleFast, liveMessageTextFast } = sessionInfo;
+  function dumpFailed() {
+    return { ok: false, code: E.RECALL_DUMP_FAILED, message: "\u8BFB\u53D6\u78C1\u76D8\u5FEB\u7167\u5931\u8D25\uFF0C\u5217\u8868\u4E0E\u6279\u91CF\u5220\u9664\u4E0D\u53EF\u7528\uFF1B\u8BF7\u67E5\u770B\u300C\u6700\u8FD1\u9519\u8BEF\u300D\u4E2D\u7684\u539F\u56E0\u540E\u91CD\u8BD5" };
+  }
   async function buildListItems() {
     const allItems = [];
     const dump = await dumpStores();
@@ -37,7 +40,7 @@ function createRoutesManage(deps) {
       if (st && st.dir) hints.set(st.dir, root);
     }
     const byId = /* @__PURE__ */ new Map();
-    function push(id, time, root, sessionId) {
+    function push(id, time, root, sessionId, files) {
       if (!id || typeof id !== "string") return;
       if (isSafetySnapshotId(id)) return;
       const old = byId.get(id);
@@ -52,6 +55,7 @@ function createRoutesManage(deps) {
         };
         const liveText = liveMessageTextFast(sessionId || "", id);
         if (liveText) rec.messageText = liveText;
+        if (files === false) rec.files = false;
         byId.set(id, rec);
         allItems.push(rec);
         return;
@@ -69,16 +73,17 @@ function createRoutesManage(deps) {
         if (t) old.messageText = t;
       }
       if (!old.time && time) old.time = time;
+      if (files === false) old.files = false;
     }
     for (const [dir, info] of dump) {
       const baseRoot = info.root || hints.get(dir) || null;
       for (const e of info.entries || []) {
         if (!e || typeof e.id !== "string") continue;
-        push(e.id, e.time, baseRoot || typeof e.root === "string" && e.root || null, e.sessionId);
+        push(e.id, e.time, baseRoot || typeof e.root === "string" && e.root || null, e.sessionId, e.files);
       }
     }
     for (const [id, s] of state.snapshots.entries()) {
-      push(id, s.time, s.root, s.sessionId);
+      push(id, s.time, s.root, s.sessionId, s.files);
     }
     allItems.sort((a, b) => (b.time || 0) - (a.time || 0));
     return allItems;
@@ -289,6 +294,8 @@ function createRoutesManage(deps) {
           baseExcludes: cfg.baseExcludes.slice(),
           refillDraft: cfg.refillDraft,
           snapshotEnabled: cfg.snapshotEnabled,
+          // issue #31：只回退消息（不写文件快照）
+          messageOnly: cfg.messageOnly,
           archiveOriginal: cfg.archiveOriginal,
           editSubmitsImmediately: cfg.editSubmitsImmediately,
           retentionDays: cfg.retentionDays,
@@ -328,6 +335,7 @@ function createRoutesManage(deps) {
       }
       if (patch.refillDraft !== void 0) clean.refillDraft = Boolean(patch.refillDraft);
       if (patch.snapshotEnabled !== void 0) clean.snapshotEnabled = Boolean(patch.snapshotEnabled);
+      if (patch.messageOnly !== void 0) clean.messageOnly = Boolean(patch.messageOnly);
       if (patch.archiveOriginal !== void 0) clean.archiveOriginal = Boolean(patch.archiveOriginal);
       if (patch.editSubmitsImmediately !== void 0) clean.editSubmitsImmediately = Boolean(patch.editSubmitsImmediately);
       if (patch.retentionDays !== void 0) {
@@ -377,7 +385,12 @@ function createRoutesManage(deps) {
           if (stale) refreshListCacheInBackground();
           return { ok: true, items: listCache.items.slice(0, safeLimit), total: listCache.items.length, stale };
         }
-        const allItems = await buildListItems();
+        let allItems;
+        try {
+          allItems = await buildListItems();
+        } catch (error) {
+          return dumpFailed();
+        }
         listCache.at = Date.now();
         listCache.items = allItems;
         listCache.stale = false;
@@ -495,15 +508,25 @@ function createRoutesManage(deps) {
         const id = args && args.messageId ? String(args.messageId) : "";
         if (scope === "workspace") {
           if (!root) return { ok: false, code: E.RECALL_NO_ROOT, message: "\u7F3A\u5C11\u5DE5\u4F5C\u533A\u8DEF\u5F84" };
-          const deleted = await deleteSnapshotsByFilter((rec) => rec.root === root, sessionId);
+          let deleted;
+          try {
+            deleted = await deleteSnapshotsByFilter((rec) => rec.root === root, sessionId);
+          } catch (error) {
+            return dumpFailed();
+          }
           return { ok: true, deleted };
         }
         if (scope === "session") {
           if (!targetSessionId) return { ok: false, code: E.RECALL_NO_SESSION, message: "\u7F3A\u5C11\u4F1A\u8BDD ID" };
-          const deleted = await deleteSnapshotsByFilter(
-            (rec) => rec.sessionId === targetSessionId && (!root || rec.root === root),
-            sessionId
-          );
+          let deleted;
+          try {
+            deleted = await deleteSnapshotsByFilter(
+              (rec) => rec.sessionId === targetSessionId && (!root || rec.root === root),
+              sessionId
+            );
+          } catch (error) {
+            return dumpFailed();
+          }
           return { ok: true, deleted };
         }
         let snap = state.snapshots.get(id) || null;
@@ -547,7 +570,12 @@ function createRoutesManage(deps) {
         return { ok: true };
       }
       if (op === "deleteAll") {
-        const result = await deleteAllSnapshots();
+        let result;
+        try {
+          result = await deleteAllSnapshots();
+        } catch (error) {
+          return dumpFailed();
+        }
         if (result.failed > 0) {
           return {
             ok: false,

package/lib/scripts.posix.js

@@ -535,6 +535,18 @@ function storesDumpScript(container, extraDirs) {
     'for d in "${dirs[@]}"; do',
     '  [ -d "$d" ] || continue',
     '  echo "==DIR $d"',
+    // STATE 供空仓回收判定（present/absent/quarantined/foreign）：判据留在
+    // 脚本侧是因为只有这里能看文件系统——absent 表示「从没拍过快照的真仓」
+    // （git/ 或 root.txt 在），foreign 表示不是我们的目录，两者不能混。
+    '  if [ -f "$d/index.json" ]; then',
+    "    echo 'STATE present'",
+    '  elif ls "$d"/index.json.corrupt-* >/dev/null 2>&1; then',
+    "    echo 'STATE quarantined'",
+    '  elif [ -d "$d/git" ] || [ -f "$d/root.txt" ]; then',
+    "    echo 'STATE absent'",
+    "  else",
+    "    echo 'STATE foreign'",
+    "  fi",
     '  if [ -f "$d/root.txt" ]; then',
     `    printf "ROOT %s\\n" "$(cat "$d/root.txt" 2>/dev/null | tr -d '\\r\\n')"`,
     "  else",

package/lib/scripts.pwsh.js

@@ -675,6 +675,14 @@ function storesDumpScript(container, extraDirs) {
     "  if (-not $d) { continue }",
     "  if (-not (Test-Path -LiteralPath $d -PathType Container)) { continue }",
     '  Write-Output ("==DIR " + $d)',
+    // STATE 供空仓回收判定（present/absent/quarantined/foreign）：判据留在脚本侧
+    // 是因为只有这里能看文件系统——absent 是「从没拍过快照的真仓」，foreign 是
+    // 别人的目录，两者必须分开（否则会删掉不是我们的东西）。
+    "  $ix = Join-Path $d 'index.json'",
+    "  if (Test-Path -LiteralPath $ix -PathType Leaf) { Write-Output 'STATE present' }",
+    "  elseif (@(Get-ChildItem -LiteralPath $d -Filter 'index.json.corrupt-*' -ErrorAction SilentlyContinue).Count -gt 0) { Write-Output 'STATE quarantined' }",
+    "  elseif ((Test-Path -LiteralPath (Join-Path $d 'git') -PathType Container) -or (Test-Path -LiteralPath (Join-Path $d 'root.txt') -PathType Leaf)) { Write-Output 'STATE absent' }",
+    "  else { Write-Output 'STATE foreign' }",
     "  $rt = Join-Path $d 'root.txt'",
     "  if (Test-Path -LiteralPath $rt -PathType Leaf) {",
     "    $rv = (Get-Content -LiteralPath $rt -Raw -Encoding UTF8 -ErrorAction SilentlyContinue)",
@@ -686,7 +694,6 @@ function storesDumpScript(container, extraDirs) {
     "    Write-Output 'ROOT '",
     "  }",
     "  Write-Output 'INDEXBEGIN'",
-    "  $ix = Join-Path $d 'index.json'",
     "  if (Test-Path -LiteralPath $ix -PathType Leaf) {",
     "    $j = Get-Content -LiteralPath $ix -Raw -Encoding UTF8 -ErrorAction SilentlyContinue",
     "    if ($j) { Write-Output $j.TrimEnd() }",

package/lib/snapshots.js

@@ -269,6 +269,7 @@ function createSnapshots(ctx, rt, config) {
     await stampStoreFormat(store, verdict);
     const entries = Array.from(state.snapshots.entries()).filter(([, s]) => s.root === root).map(([id, s]) => {
       const rec = { id, time: s.time, root: s.root, sessionId: s.sessionId };
+      if (s.files === false) rec.files = false;
       const fb = state.snapFeedback.get(id);
       if (fb && (fb.failed || Array.isArray(fb.skipped) && fb.skipped.length)) rec.feedback = fb;
       return rec;
@@ -320,11 +321,13 @@ function createSnapshots(ctx, rt, config) {
         invalid++;
         continue;
       }
-      state.snapshots.set(entry.id, {
+      const info = {
         root,
         time: typeof entry.time === "number" ? entry.time : Date.now(),
         sessionId: entry.sessionId || sessionId || ""
-      });
+      };
+      if (entry.files === false) info.files = false;
+      state.snapshots.set(entry.id, info);
       const fb = entry.feedback;
       if (fb && typeof fb === "object") {
         const rec = {};
@@ -422,9 +425,27 @@ function createSnapshots(ctx, rt, config) {
       rt.recordError("recall rebuildOrphans failed: " + String(error));
     }
   }
+  async function captureMessageOnly(root, sessionId, messageId, time) {
+    let store = await rt.resolveStore(root);
+    store = await rt.tryUpgradeToHome(root);
+    if (!await guardStoreFormat(store)) return;
+    const g = await rt.ensureGit(root, store);
+    if (!g.ok) {
+      setFeedback(messageId, { failed: true, ...buildFeedbackError(g.error || "\u672A\u77E5\u539F\u56E0") });
+      return;
+    }
+    await loadIndex(root, sessionId);
+    state.snapshots.set(String(messageId), { root, time: time || Date.now(), sessionId, files: false });
+    await saveIndex(root, sessionId);
+    setFeedback(messageId, { skipped: [] });
+  }
   async function captureSnapshot(sessionId, messageId, time) {
     const root = await rt.resolveRoot(sessionId);
     if (!root) return;
+    if (config.messageOnly) {
+      await captureMessageOnly(root, sessionId, messageId, time);
+      return;
+    }
     const fused = snapFailures.get(root);
     if (fused && Date.now() < fused.skipUntil) return;
     const limited = snapLimits.get(root);
@@ -519,6 +540,7 @@ function createSnapshots(ctx, rt, config) {
   async function diffFor(messageId) {
     const snap = state.snapshots.get(String(messageId));
     if (!snap) return null;
+    if (snap.files === false) return { changes: [], total: 0, truncated: false, treeId: null };
     const store = state.stores.get(snap.root);
     if (!store) return null;
     const text = S.stripBom(await rt.runShell(S.diffScript(snap.root, store, state.gitExe || "", "snap-" + messageId, BASE(), MAX_CHANGES), { timeoutMs: 6e5, stdoutMaxBytes: 8388608 }));

package/package.json

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