dsh-recall-plugin 2.5.3 → 2.6.1

package/CHANGELOG.md

@@ -2,7 +2,39 @@
 
 本文件格式遵循 [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
+
+### 新增
+
+- **任务队列按工作区隔离**：快照/preview/回退/删除/gc 原先共用一条全局串行链，一个工作区的慢快照会把**所有会话**的撤回按钮一起堵住。现在同一工作区仍然串行（都在写同一个 git index），不同工作区并行；跨工作区的批量删除与全局 gc 用「等这些工作区的链尾全部落地」保证互斥。win32 下路径大小写归一，避免同一仓库拿到两把锁。
+- **单次快照时限可配置（`snapshotBudgetMs`，默认 3 分钟）**：整条快照脚本（扫描 + `add` + 写索引/打 tag）的兜底超时从硬编码 600 秒改为配置项，设置卡片按秒展示；`0` 表示不限制。
+
+### 修复
+
+- **Linux/macOS 上快照管理、批量删除/全部删除与「立即 gc」全部不可用**（[issue #30](https://github.com/limbo947/dsh-recall-plugin/issues/30)，POSIX dump 脚本的两个缺陷）：① 建仓后还没拍过快照的**空仓**没有 `index.json`/`lineage.json`，裸 `cat` 在 `set -e` 下让整条 dump 退出 1，磁盘上的仓一个都枚举不到；② 这两个文件落盘时没有尾换行，`cat` 后紧跟的段尾标记被粘到内容行尾，解析器按整行匹配永远收不到段尾——**即使文件齐全，每个仓也被解析成「无索引」**（报告者的临时处置只修了 ①，树依然是空的）。现在两处改为「缺席放行 + 内容后补一个换行」，逐仓隔离语义不变，存量数据无需迁移。
+- **设置页 exclude 编辑器可能回显垃圾字节**（同一类行边界缺陷）：`exclude.txt` 字节数为 3 的倍数时 base64 没有 `=` padding，粘在尾部的段尾标记会被一起解码；回显后再保存即污染文件。
+- **dump 脚本的测试从「字符串断言」升级为「真跑一遍」**：新增 [tests/unit/stores-dump-script.test.js](tests/unit/stores-dump-script.test.js)，在 bash 里执行生成的脚本并校验解析结果（CI 的 ubuntu 必然执行，win32 认 Git Bash）。此前只断言脚本文本与解析器行为，这两个只在执行期暴露的缺陷因此全绿漏过。
+
+### 文档
+
+- 新增 [plan-stores-dump-posix.md](docs/plans/completed/plan-stores-dump-posix.md)：issue #30 的双缺陷分析、实测矩阵与防回归设计；含「不采纳 warmup 落 `index.json = []`」「不采纳脚本保持 fail-fast」的依据，以及两条遗留（dump 失败对用户不可见、空仓无法回收）。
+- 新增 [plan-queue-and-budget.md](docs/plans/completed/plan-queue-and-budget.md)：含 web 新会话 cwd 的官方归属核查（`startSession` 取 `workspaceId ?? 当前 ?? 最近`、全链不传 cwd、无配置项/钩子可改写）——该项为官方行为，插件不改代码，只在 README 使用注意与 AGENTS 已知坑里写明。
 
 ## [2.5.3] - 2026-10-30
 

package/README.en.md

@@ -158,6 +158,7 @@ All options can be edited visually in the "**Settings → Plugin Config → Reca
 | `maxFileBytes` | 8388608 (8MB) | Files larger than this are neither snapshotted nor touched by recalls; they are filtered out *before* `git add` from a path list, so no objects are written (older git falls back to add-then-remove) |
 | `maxWorkspaceBytes` | 268435456 (256MB) | Total snapshot-eligible file size per workspace, measured exactly as `git add` sees it (`.gitignore`, `.git/info/exclude` and the global excludesFile all apply). Exceeding it **disables snapshots for that workspace** (no truncation — a truncated snapshot would make rollback delete the skipped files) and shows a notice on recent messages; raise the limit or add exclusions to recover automatically. 0 = unlimited |
 | `scanBudgetMs` | 10000 (10s) | Time budget for measuring the snapshot-eligible total. Exceeding it skips the snapshot with a notice (guards against pathological directories stalling startup). 0 = unlimited |
+| `snapshotBudgetMs` | 180000 (3 min) | Total time for one snapshot from scan to write; exceeding it aborts the snapshot and records it under "Recent errors". 0 = unlimited |
 | `maxSnapshotsPerWorkspace` | 500 | Maximum snapshots kept per workspace; oldest pruned beyond the cap. 0 = unlimited |
 | `retentionDays` | 0 | Keep snapshots for this many days; older ones are deleted. 0 = disabled (works independently of the cap) |
 | `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` | Base exclusion list (gitignore syntax, lower priority than exclude.txt); excluded large directories are skipped as whole subtrees during snapshot scans. Directory-form entries (e.g. `target/`) mean one more thing: **when a path segment of the workspace root itself matches, snapshots are disabled for that workspace** — patterns are relative to the root, so they can never exclude the root itself (i.e. a session opened inside a build-output directory), and such directories have no rollback value anyway; remove the entry to re-enable |

package/README.md

@@ -155,11 +155,13 @@ peerDependencies 按 minor 版本线开窗，与 `dsh.compatibility.dshReleases`
 | `maxFileBytes` | 8388608（8MB） | 超过该大小的文件不进快照、不被回退触碰；在 `git add` 之前就按清单剔除，不写对象（旧 git 退回「先加后剔」） |
 | `maxWorkspaceBytes` | 268435456（256MB） | 单工作区可纳入快照的文件总量上限，口径与 `git add` 一致（`.gitignore`、`.git/info/exclude`、全局 excludesFile 都算数）。超过时**停用该工作区快照**（不截断——截断快照回退时会误删未纳入的文件），并在最近消息上提示；调大该值或补充排除表后自动恢复；0 = 不限制 |
 | `scanBudgetMs` | 10000（10 秒） | 快照前统计纳入总量的时间预算。超过时停用本次快照并提示（防病态大目录拖死启动）；0 = 不限制 |
+| `snapshotBudgetMs` | 180000（3 分钟） | 单次快照从扫描到写入的总时限，超时即中止本次快照并记入「最近错误」；0 = 不限制 |
 | `maxSnapshotsPerWorkspace` | 500 | 每个工作区保留的最大快照数，超限自动删除最旧的；0 = 不限制 |
 | `retentionDays` | 0 | 按天数保留快照，超期自动删除；0 = 不启用（与条数上限各自独立生效） |
 | `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",
@@ -592,6 +605,9 @@
     "config.scanBudgetMs.label": "\u626B\u63CF\u65F6\u95F4\u9884\u7B97",
     "config.scanBudgetMs.hint": "\u5FEB\u7167\u524D\u7EDF\u8BA1\u7EB3\u5165\u603B\u91CF\u8D85\u8FC7\u8BE5\u65F6\u957F\u5373\u505C\u7528\u672C\u6B21\u5FEB\u7167\uFF1B0 \u8868\u793A\u4E0D\u9650\u5236",
     "config.scanBudgetMs.suffix": "\u79D2",
+    "config.snapshotBudgetMs.label": "\u5355\u6B21\u5FEB\u7167\u65F6\u9650",
+    "config.snapshotBudgetMs.hint": "\u5355\u6B21\u5FEB\u7167\u4ECE\u626B\u63CF\u5230\u5199\u5165\u7684\u603B\u65F6\u9650\uFF0C\u8D85\u65F6\u5373\u4E2D\u6B62\u672C\u6B21\u5FEB\u7167\u5E76\u8BB0\u5165\u6700\u8FD1\u9519\u8BEF\uFF1B0 \u8868\u793A\u4E0D\u9650\u5236",
+    "config.snapshotBudgetMs.suffix": "\u79D2",
     "config.maxSnapshotsPerWorkspace.label": "\u5FEB\u7167\u603B\u91CF\u4E0A\u9650",
     "config.maxSnapshotsPerWorkspace.hint": "\u6BCF\u5DE5\u4F5C\u533A\u4FDD\u7559\u7684\u6700\u5927\u5FEB\u7167\u6570\uFF0C\u8D85\u9650\u5220\u9664\u6700\u65E7\u7684\uFF1B0 \u8868\u793A\u4E0D\u9650\u5236",
     "config.maxSnapshotsPerWorkspace.suffix": "\u6761",
@@ -624,6 +640,7 @@
     "config.err.maxFileBytes": "\u6587\u4EF6\u5927\u5C0F\u4E0A\u9650\u81F3\u5C11 0.01 MB",
     "config.err.maxWorkspaceBytes": "\u5DE5\u4F5C\u533A\u603B\u91CF\u4E0A\u9650\u5FC5\u987B\u662F >= 0 \u7684\u6570\u5B57\uFF080 \u8868\u793A\u4E0D\u9650\u5236\uFF09",
     "config.err.scanBudgetMs": "\u626B\u63CF\u65F6\u95F4\u9884\u7B97\u5FC5\u987B\u662F >= 0 \u7684\u6570\u5B57\uFF080 \u8868\u793A\u4E0D\u9650\u5236\uFF09",
+    "config.err.snapshotBudgetMs": "\u5355\u6B21\u5FEB\u7167\u65F6\u9650\u5FC5\u987B\u662F >= 0 \u7684\u6570\u5B57\uFF080 \u8868\u793A\u4E0D\u9650\u5236\uFF09",
     "config.err.maxSnapshots": "\u5FEB\u7167\u603B\u91CF\u4E0A\u9650\u5FC5\u987B\u662F >= 0 \u7684\u6574\u6570\uFF080 \u8868\u793A\u4E0D\u9650\u5236\uFF09",
     "config.err.retentionDays": "\u4FDD\u7559\u5929\u6570\u5FC5\u987B\u662F >= 0 \u7684\u6574\u6570\uFF080 \u8868\u793A\u4E0D\u542F\u7528\uFF09",
     "config.err.locale": "\u754C\u9762\u8BED\u8A00\u5FC5\u987B\u662F auto / zh / en \u4E4B\u4E00",
@@ -679,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",
@@ -692,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 拼接成一段（前句以句点
@@ -765,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",
@@ -807,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",
@@ -825,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",
@@ -846,6 +870,9 @@
     "config.scanBudgetMs.label": "Scan time budget",
     "config.scanBudgetMs.hint": "Skip this snapshot when measuring the snapshot-eligible total exceeds this duration; 0 means unlimited",
     "config.scanBudgetMs.suffix": "s",
+    "config.snapshotBudgetMs.label": "Snapshot time limit",
+    "config.snapshotBudgetMs.hint": "Total time for one snapshot from scan to write; exceeding it aborts the snapshot and records it under recent errors; 0 means unlimited",
+    "config.snapshotBudgetMs.suffix": "s",
     "config.maxSnapshotsPerWorkspace.label": "Snapshot count limit",
     "config.maxSnapshotsPerWorkspace.hint": "Maximum snapshots kept per workspace; the oldest are deleted beyond it; 0 means unlimited",
     "config.maxSnapshotsPerWorkspace.suffix": "snapshots",
@@ -878,6 +905,7 @@
     "config.err.maxFileBytes": "The file size limit must be at least 0.01 MB",
     "config.err.maxWorkspaceBytes": "The workspace total limit must be a number >= 0 (0 means unlimited)",
     "config.err.scanBudgetMs": "The scan time budget must be a number >= 0 (0 means unlimited)",
+    "config.err.snapshotBudgetMs": "The snapshot time limit must be a number >= 0 (0 means unlimited)",
     "config.err.maxSnapshots": "The snapshot count limit must be an integer >= 0 (0 means unlimited)",
     "config.err.retentionDays": "Retention days must be an integer >= 0 (0 disables it)",
     "config.err.locale": "Language must be one of auto / zh / en",
@@ -1882,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) {
@@ -1895,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) : "";
@@ -1915,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" },
@@ -1930,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);
@@ -1999,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",
@@ -2019,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",
@@ -2045,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") },
@@ -2065,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" },
@@ -2088,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 }) : "")
@@ -2137,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);
@@ -2467,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) });
@@ -2478,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) {
@@ -2497,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") {
@@ -2518,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) });
@@ -2584,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, {
@@ -2762,10 +2815,14 @@
               maxWorkspaceBytes: bytesToMb2(v.maxWorkspaceBytes),
               // 扫描预算持久化为毫秒、展示为秒（整数）；0 表示不限制，原样显示 0
               scanBudgetMs: String(v.scanBudgetMs == null ? "" : Math.round(Number(v.scanBudgetMs) / 1e3)),
+              // issue #29：单次快照总时限，同样按秒展示
+              snapshotBudgetMs: String(v.snapshotBudgetMs == null ? "" : Math.round(Number(v.snapshotBudgetMs) / 1e3)),
               maxSnapshotsPerWorkspace: String(v.maxSnapshotsPerWorkspace == null ? "" : v.maxSnapshotsPerWorkspace),
               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,
@@ -2793,7 +2850,7 @@
       function save() {
         if (state.busy || !draft || !baseline) return;
         const patch = {};
-        for (const key of ["gcSnaps", "gcHours", "maxFileBytes", "maxWorkspaceBytes", "scanBudgetMs", "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;
         }
@@ -2842,6 +2899,14 @@
           }
           clean.scanBudgetMs = Math.round(s * 1e3);
         }
+        if (patch.snapshotBudgetMs !== void 0) {
+          const s = Number(patch.snapshotBudgetMs);
+          if (!Number.isFinite(s) || s < 0) {
+            setState({ busy: false, message: t("config.err.snapshotBudgetMs"), error: true });
+            return;
+          }
+          clean.snapshotBudgetMs = Math.round(s * 1e3);
+        }
         if (patch.maxSnapshotsPerWorkspace !== void 0) {
           const n = parseInt(String(patch.maxSnapshotsPerWorkspace), 10);
           if (!Number.isFinite(n) || n < 0) {
@@ -2852,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) {
@@ -3009,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")),
@@ -3021,6 +3089,8 @@
           // issue #24 护栏：单文件上限之外的两道闸（总量 + 扫描耗时），0 = 不限制
           numRow("maxWorkspaceBytes", t("config.maxWorkspaceBytes.label"), t("config.maxWorkspaceBytes.hint"), { suffixKey: "config.maxWorkspaceBytes.suffix", min: 0, step: 16 }),
           numRow("scanBudgetMs", t("config.scanBudgetMs.label"), t("config.scanBudgetMs.hint"), { suffixKey: "config.scanBudgetMs.suffix", min: 0, step: 1 }),
+          // issue #29：扫描阶段之外还有 add/写索引——单次快照的总时限兜底
+          numRow("snapshotBudgetMs", t("config.snapshotBudgetMs.label"), t("config.snapshotBudgetMs.hint"), { suffixKey: "config.snapshotBudgetMs.suffix", min: 0, step: 30 }),
           numRow("maxSnapshotsPerWorkspace", t("config.maxSnapshotsPerWorkspace.label"), t("config.maxSnapshotsPerWorkspace.hint"), { suffixKey: "config.maxSnapshotsPerWorkspace.suffix", min: 0, step: 1 }),
           numRow("retentionDays", t("config.retentionDays.label"), t("config.retentionDays.hint"), { suffixKey: "config.retentionDays.suffix", min: 0, step: 1 }),
           React.createElement("div", { className: "dsh-recall-cfg-group" }, t("config.group.ui")),
@@ -3267,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",
@@ -3306,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 });
@@ -3349,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 || []);
@@ -3364,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);
@@ -3499,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, {
@@ -3676,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

@@ -40,10 +40,17 @@ const Config = Schema.object({
   // 截断快照回退时，未纳入的文件会命中回退脚本的「当前有、目标无」删除侧。
   maxWorkspaceBytes: withVolatile(Schema.number().default(268435456).description("\u5355\u5DE5\u4F5C\u533A\u53EF\u7EB3\u5165\u5FEB\u7167\u7684\u6587\u4EF6\u603B\u91CF\u4E0A\u9650\uFF0C\u53E3\u5F84\u4E0E git add \u4E00\u81F4\uFF08\u542B .gitignore\uFF09\uFF0C\u8D85\u8FC7\u5373\u505C\u7528\u8BE5\u5DE5\u4F5C\u533A\u5FEB\u7167\uFF1B0 \u8868\u793A\u4E0D\u9650\u5236")),
   scanBudgetMs: withVolatile(Schema.number().default(1e4).description("\u5FEB\u7167\u524D\u7EDF\u8BA1\u7EB3\u5165\u603B\u91CF\u7684\u65F6\u95F4\u9884\u7B97\uFF0C\u8D85\u65F6\u5373\u505C\u7528\u672C\u6B21\u5FEB\u7167\uFF1B0 \u8868\u793A\u4E0D\u9650\u5236")),
+  // issue #29：scanBudgetMs 只约束「统计阶段」，真正的耗时与写盘在 add。
+  // 这条是整条快照脚本的兜底时限——慢盘或病态工作区上它才是把队列拖住的一段。
+  snapshotBudgetMs: withVolatile(Schema.number().default(18e4).description("\u5355\u6B21\u5FEB\u7167\u7684\u603B\u65F6\u9650\uFF08\u6BEB\u79D2\uFF0C\u542B\u626B\u63CF\u4E0E\u5199\u5165\uFF09\uFF0C\u8D85\u65F6\u5373\u4E2D\u6B62\u672C\u6B21\u5FEB\u7167\u5E76\u8BB0\u5F55\uFF1B0 \u8868\u793A\u4E0D\u9650\u5236")),
   maxSnapshotsPerWorkspace: withVolatile(Schema.number().default(500).description("\u6BCF\u4E2A\u5DE5\u4F5C\u533A\u4FDD\u7559\u7684\u6700\u5927\u5FEB\u7167\u6570\uFF0C\u8D85\u9650\u5220\u9664\u6700\u65E7\u7684")),
   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：编辑提交后自动发出改后的文本。关闭则退化为「只回填输入框」，
   // 给「只想改稿、不立刻发」的用户留一条与撤回回填一致的出口
@@ -129,10 +136,12 @@ const DEFAULTS = {
   maxFileBytes: 8388608,
   maxWorkspaceBytes: 268435456,
   scanBudgetMs: 1e4,
+  snapshotBudgetMs: 18e4,
   maxSnapshotsPerWorkspace: 500,
   baseExcludes: BASE_EXCLUDES,
   refillDraft: true,
   snapshotEnabled: true,
+  messageOnly: false,
   archiveOriginal: true,
   editSubmitsImmediately: true,
   retentionDays: 0,
@@ -150,17 +159,19 @@ function createConfig(raw) {
   const maxFileBytes = pickNumber(cfg.maxFileBytes, 8388608, 1024);
   const maxWorkspaceBytes = pickNumber(cfg.maxWorkspaceBytes, 268435456, 0);
   const scanBudgetMs = pickNumber(cfg.scanBudgetMs, 1e4, 0);
+  const snapshotBudgetMs = pickNumber(cfg.snapshotBudgetMs, 18e4, 0);
   const rawMax = typeof cfg.maxSnapshotsPerWorkspace === "number" ? cfg.maxSnapshotsPerWorkspace : parseInt(String(cfg.maxSnapshotsPerWorkspace == null ? "" : cfg.maxSnapshotsPerWorkspace), 10);
   const maxSnapshotsPerWorkspace = Number.isFinite(rawMax) ? Math.max(0, rawMax) : 500;
   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, 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

@@ -9,6 +9,7 @@ import { createRoutesCore } from "./routes-core.js";
 import { createRoutesManage } from "./routes-manage.js";
 import { createIntentJournal } from "./intent-journal.js";
 import { createEnsureRootReady } from "./root-ready.js";
+import { createQueues } from "./queues.js";
 import * as dshSettings from "@deepseek-ai/dsh-settings";
 import * as E from "./errors.js";
 const name = "dsh-recall-plugin";
@@ -55,12 +56,7 @@ function apply(ctx, config) {
     if (text === E.RECALL_BODY_TOO_LARGE) return { ok: false, code: E.RECALL_BODY_TOO_LARGE, message: "\u8BF7\u6C42\u4F53\u8D85\u8FC7 1MB \u4E0A\u9650" };
     return { ok: false, code: E.RECALL_ERROR, message: text };
   }
-  function enqueue(task) {
-    const run = state.queue.then(task);
-    state.queue = run.catch(() => {
-    });
-    return run;
-  }
+  const queues = createQueues(process.platform === "win32");
   async function runLimited(tasks, concurrency) {
     const limit = concurrency > 0 ? concurrency : 4;
     let index = 0;
@@ -158,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);
@@ -246,7 +249,8 @@ function apply(ctx, config) {
     state,
     cfg,
     supported,
-    enqueue,
+    enqueueFor: queues.enqueueFor,
+    enqueueMany: queues.enqueueMany,
     agentBusy,
     runLimited,
     ensureRootReady,
@@ -314,9 +318,14 @@ function apply(ctx, config) {
     if (session && session.header && session.header.origin === "subagent") return;
     const messageId = data.id;
     const time = event.time;
-    state.queue = state.queue.then(() => cfg.snapshotEnabled ? snaps.captureSnapshot(session.id, messageId, time) : null).then(() => maint.maybeMaintain(session.id)).then(() => {
+    void (async () => {
+      const root = await rt.resolveRoot(session.id);
+      await queues.enqueueFor(root, async () => {
+        if (cfg.snapshotEnabled) await snaps.captureSnapshot(session.id, messageId, time);
+      });
+      await queues.enqueueFor(root, () => maint.maybeMaintain(session.id));
       listCache.stale = true;
-    }).catch((error) => rt.recordError("recall snapshot error: " + String(error)));
+    })().catch((error) => rt.recordError("recall snapshot error: " + String(error)));
   });
   (async () => {
     let shellReady = false;

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/queues.js

@@ -0,0 +1,30 @@
+function createQueues(isWin) {
+  const tails = /* @__PURE__ */ new Map();
+  const keyOf = (root) => {
+    const k = String(root == null ? "" : root);
+    return k !== "" && isWin ? k.toLowerCase() : k;
+  };
+  function tailFor(key) {
+    return tails.get(key) || Promise.resolve();
+  }
+  function enqueueFor(root, task) {
+    const key = keyOf(root);
+    const run = tailFor(key).then(task);
+    tails.set(key, run.catch(() => {
+    }));
+    return run;
+  }
+  function enqueueMany(roots, task) {
+    const keys = Array.from(new Set(roots.map(keyOf)));
+    if (keys.length === 0) keys.push("");
+    const run = Promise.all(keys.map(tailFor)).then(task);
+    const tail = run.catch(() => {
+    });
+    for (const key of keys) tails.set(key, tail);
+    return run;
+  }
+  return { enqueueFor, enqueueMany };
+}
+export {
+  createQueues
+};

package/lib/routes-core.js

@@ -4,7 +4,7 @@ import { buildArtifactRootSegment, buildRootNotice } from "./exclude-patterns.js
 const RECALL_EVENT_COMPLETE_HOST = "dsh-recall/complete";
 const RECALL_EVENT_FAILED_HOST = "dsh-recall/failed";
 function createRoutesCore(deps) {
-  const { rt, snaps, state, cfg, supported, enqueue, agentBusy, rescueRollback, intentJournal, ensureRootReady, emitEvent, E } = deps;
+  const { rt, snaps, state, cfg, supported, enqueueFor, agentBusy, rescueRollback, intentJournal, ensureRootReady, emitEvent, E } = deps;
   return {
     "init": async (args) => {
       if (!supported) {
@@ -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
@@ -48,25 +50,27 @@ function createRoutesCore(deps) {
       const sessionId = args && args.sessionId ? String(args.sessionId) : null;
       const snap = state.snapshots.get(id);
       if (agentBusy(sessionId, snap ? snap.root : null)) 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 result = await enqueue(() => snaps.diffFor(id));
+      const result = await enqueueFor(snap ? snap.root : null, () => snaps.diffFor(id));
       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);
         const staleQueueItemIds2 = await snaps.resolveStaleQueueItemIds(sessionId, cutSeq2);
         return { ok: true, count: 0, cutSeq: cutSeq2, staleQueueItemIds: staleQueueItemIds2 };
       }
-      const result = await enqueue(async () => {
+      const initialSnap = state.snapshots.get(id);
+      const result = await enqueueFor(initialSnap ? initialSnap.root : null, async () => {
         const snap = state.snapshots.get(id);
         if (!snap) return { ok: false, code: E.RECALL_NO_SNAPSHOT, message: "\u8BE5\u6D88\u606F\u6CA1\u6709\u53EF\u7528\u7684\u9879\u76EE\u5FEB\u7167" };
         const store = state.stores.get(snap.root);

package/lib/routes-manage.js

@@ -10,7 +10,8 @@ function createRoutesManage(deps) {
     state,
     cfg,
     supported,
-    enqueue,
+    enqueueFor,
+    enqueueMany,
     runLimited,
     listExcludeFiles,
     dumpStores,
@@ -28,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();
@@ -36,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);
@@ -51,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;
@@ -68,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;
@@ -114,7 +120,7 @@ function createRoutesManage(deps) {
       else byRoot.set(rec.root, [rec.id]);
     }
     let deleted = 0;
-    await enqueue(async () => {
+    await enqueueMany(Array.from(byRoot.keys()), async () => {
       for (const [root, rootIds] of byRoot) {
         let store = state.stores.get(root) || null;
         if (!store) {
@@ -152,7 +158,7 @@ function createRoutesManage(deps) {
     return deleted;
   }
   async function deleteAllSnapshots() {
-    return enqueue(async () => {
+    return enqueueMany(Array.from(state.stores.keys()), async () => {
       const stores = /* @__PURE__ */ new Map();
       for (const [root, store] of state.stores.entries()) {
         if (store && store.dir) stores.set(store.dir, { store, root });
@@ -282,10 +288,14 @@ function createRoutesManage(deps) {
           maxFileBytes: cfg.maxFileBytes,
           maxWorkspaceBytes: cfg.maxWorkspaceBytes,
           scanBudgetMs: cfg.scanBudgetMs,
+          // issue #29：单次快照总时限（设置卡片的「单次快照时限」）
+          snapshotBudgetMs: cfg.snapshotBudgetMs,
           maxSnapshotsPerWorkspace: cfg.maxSnapshotsPerWorkspace,
           baseExcludes: cfg.baseExcludes.slice(),
           refillDraft: cfg.refillDraft,
           snapshotEnabled: cfg.snapshotEnabled,
+          // issue #31：只回退消息（不写文件快照）
+          messageOnly: cfg.messageOnly,
           archiveOriginal: cfg.archiveOriginal,
           editSubmitsImmediately: cfg.editSubmitsImmediately,
           retentionDays: cfg.retentionDays,
@@ -325,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) {
@@ -374,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;
@@ -492,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;
@@ -526,7 +552,7 @@ function createRoutesManage(deps) {
         }
         const finalStore = store;
         const finalRoot = snapRoot;
-        await enqueue(async () => {
+        await enqueueFor(finalRoot, async () => {
           if (state.gitExe) {
             await rt.runShell(rt.scripts.purgeTagsScript(finalStore, state.gitExe, ["snap-" + id]), { timeoutMs: 12e4, stdoutMaxBytes: 4096 });
           }
@@ -544,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,
@@ -556,7 +587,7 @@ function createRoutesManage(deps) {
         return { ok: true, deleted: result.deleted, stores: result.stores };
       }
       if (op === "gc") {
-        const done = sessionId ? await enqueue(() => maint.runGc(sessionId, true)) : await enqueue(() => maint.runGcAll());
+        const done = sessionId ? await enqueueFor(await rt.resolveRoot(sessionId), () => maint.runGc(sessionId, true)) : await enqueueMany(Array.from(state.stores.keys()), () => maint.runGcAll());
         usageCache.payload = null;
         return { ok: true, gc: Boolean(done) };
       }

package/lib/scripts.posix.js

@@ -495,6 +495,10 @@ function excludeDumpScript(files) {
     lines.push(
       "printf 'EXCLBEGIN %s\\n' " + q,
       "if [ -f " + q + " ]; then base64 " + q + " 2>/dev/null | tr -d '\\n'; fi",
+      // issue #30 同族：tr -d '\n' 之后内容没有行尾，直接 echo 会把 EXCLEND 粘在
+      // base64 尾上；payload 字节数为 3 的倍数（无 '=' padding）时这截尾巴会被一起
+      // 解码成垃圾字节，回显到设置页再写回就污染 exclude.txt。
+      'printf "\\n"',
       "echo 'EXCLEND'"
     );
   }
@@ -531,16 +535,34 @@ 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",
     '    echo "ROOT "',
     "  fi",
     "  echo INDEXBEGIN",
-    '  cat "$d/index.json" 2>/dev/null',
+    // issue #30：这两个 json 是可选文件（刚建仓没拍过快照就没有），缺席必须放行——
+    // set -e 下裸 cat 会把「无文件」升级成整条 dump 失败。另外落盘内容无尾换行
+    // （writeTextViaShell = cat > file），cat 后紧接 echo 会把段尾标记粘到内容行尾，
+    // JS 侧按整行匹配 INDEXEND 就永远收不到段尾，所以内容后显式补一个换行。
+    '  cat "$d/index.json" 2>/dev/null || true',
+    '  printf "\\n"',
     "  echo INDEXEND",
     "  echo LINEAGEBEGIN",
-    '  cat "$d/lineage.json" 2>/dev/null',
+    '  cat "$d/lineage.json" 2>/dev/null || true',
+    '  printf "\\n"',
     "  echo LINEAGEEND",
     "done",
     "exit 0"

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);
@@ -441,7 +462,8 @@ function createSnapshots(ctx, rt, config) {
     await loadIndex(root, sessionId);
     const captureStartedAt = Date.now();
     try {
-      const out = await rt.runShell(S.snapshotScript(root, store, state.gitExe || "", messageId, BASE()), { timeoutMs: 6e5, stdoutMaxBytes: 65536 });
+      const budget = config.snapshotBudgetMs > 0 ? config.snapshotBudgetMs : 864e5;
+      const out = await rt.runShell(S.snapshotScript(root, store, state.gitExe || "", messageId, BASE()), { timeoutMs: budget, stdoutMaxBytes: 65536 });
       const limit = parseSnapshotLimit(out);
       if (limit) {
         markSnapshotLimited(root, limit);
@@ -518,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/lib/store.js

@@ -149,7 +149,6 @@ function createRuntime(ctx, config, deps) {
     roots: /* @__PURE__ */ new Map(),
     stores: /* @__PURE__ */ new Map(),
     snapshots: /* @__PURE__ */ new Map(),
-    queue: Promise.resolve(),
     indexLoaded: /* @__PURE__ */ new Set(),
     // PF-5 索引终态三/四档标记（rebuildOrphans 守卫的数据源）：
     // - indexHealthy：磁盘索引解析成功且在场（loadIndex 正常载入分支）——

package/package.json

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