dsh-recall-plugin 2.6.0 → 2.6.2

package/CHANGELOG.md

@@ -2,7 +2,28 @@
 
 本文件格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循语义化版本。
 
-## [Unreleased]
+## [2.6.2] - 2026-11-03
+
+### 修复
+
+- **Windows 保留设备名不再反复触发快照跳过提示（issue #32）**：`nul`、`aux`、`con`、`prn`、`com1`…、`lpt1`… 及其扩展名和上标数字变体在 `git add` 前默认排除，覆盖任意子目录；规则仅适用于 Windows，不进入构建产物 root 判定，POSIX 合法同名文件不受影响。这些路径保持「不恢复、不删除」的既有回退语义。
+- **0 字节 `nul` 等路径的失败提示不再静默丢失**：`SNAP_SKIP` 同时识别 Git 的 `unable to index file 'X'` 与 `unable to add 'X' to index`，PowerShell 与 bash 模板均已覆盖。
+
+## [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.en.md

@@ -77,6 +77,7 @@ Boundaries accepted by design and edge cases not yet covered — worth checking
 - Recall cannot be initiated while an agent is running in the target workspace (by design — stop the agent first).
 - Supports Windows (PowerShell 5.1/7 + git CLI) and Linux/macOS (bash + git CLI). Windows is thoroughly verified on real machines; Linux has been fully tested on WSL2 (Ubuntu 26.04, bash 5.3 + git 2.53), including Chinese paths, home fallback, session cleanup, and gc; the macOS side is written to be bash 3.2 compatible but has not been tested on real hardware yet.
 - Nested git repositories inside the workspace (subdirectories with their own `.git`) cannot be indexed: the snapshot proceeds for everything else (fail-open, with a notice listing the skipped paths), but their contents do not participate in recalls.
+- Windows reserved device names (such as `nul`, `aux`, `con`, and `com1`, including extension forms) cannot be indexed by Git and are excluded from snapshots and recalls by default. These paths are left untouched and do not generate repeated skip notices. This exclusion applies only to Windows.
 - **Directory reparse points** in the workspace (junctions / directory symlinks) are not snapshotted by default: the subtree they point at is not indexed, so its contents do not participate in recalls. This is required on Windows, where git for Windows treats a junction as an ordinary directory and a self-referencing one inflates the index up to Windows' 31-reparse-point path limit (a two-file workspace measured 64 index entries); on POSIX a symlink still enters the snapshot (git records it as a `120000` entry and never recurses). To deliberately snapshot a **benign** junction (pointing outside the workspace, non-self-referencing), append `!path/` (e.g. `!ext-link/`) in the exclusion settings — user rules take effect after machine-generated ones; **never do this for a self-referencing junction** (the explosion vector).
 - Extreme cases like filenames containing newlines/TAB are beyond the diff list's parsing capability (negligible probability).
 - **Interplay with dsh-routing-suite (progressive tool-disclosure router)**: if you also run its router-standard preset, a recall forks a new session via `sessions.fork`, which resets the router's stage to its default (the tool surface temporarily narrows). Symptoms, root cause and the fix are documented in [docs/routing-interplay.md](docs/routing-interplay.md) (Chinese).
@@ -201,7 +202,7 @@ The most common questions and their troubleshooting paths; for the full set of d
 
 **No "↶ Recall" button next to a message?** Check in order of likelihood: (1) the DSH process wasn't restarted after installing — restart it and hard-refresh (Ctrl+Shift+R); (2) git CLI isn't on PATH — a notice shows at the top of the page; (3) the message predates the plugin — snapshots are only created when a message is sent; (4) snapshots are disabled for that workspace — it sits under a directory-form exclusion (e.g. opened inside `dist/`), exceeded the `maxWorkspaceBytes` / `scanBudgetMs` guardrails, or the pre-snapshot size scan itself failed (`git ls-files` error; the reason is in "Recent errors" and it retries after 10 minutes) — recent messages carry a recovery notice (raise the limit or extend the exclusion list and it recovers automatically).
 
-**Some files weren't restored by a recall?** They weren't in the snapshot: larger than `maxFileBytes` (8MB by default), matched by the exclusion list, or inside a nested git repository / a win32 reparse point (see "Known Limitations"). The confirmation panel's file list before a recall is the exact rollback scope — trust it.
+**Some files weren't restored by a recall?** They weren't in the snapshot: larger than `maxFileBytes` (8MB by default), matched by the exclusion list (including Windows reserved device names), or inside a nested git repository / a win32 reparse point (see "Known Limitations"). The confirmation panel's file list before a recall is the exact rollback scope — trust it.
 
 **Snapshots eating too much disk?** Open "Settings → Plugin Config → Recall Plugin → Snapshot Manager" to see per-workspace usage, run "gc now", or delete by workspace / session / single snapshot; longer-term, lower `maxSnapshotsPerWorkspace`, set `retentionDays`, or add big directories to the exclusion list.
 

package/README.md

@@ -74,6 +74,7 @@
 - 目标工作区的 agent 正在运行时无法发起撤回（防护设计，先停止 agent 再撤回）。
 - 支持 Windows（PowerShell 5.1/7 + git CLI）与 Linux/macOS（bash + git CLI）。Windows 真机验证充分；Linux 已在 WSL2（Ubuntu 26.04，bash 5.3 + git 2.53）实测全流程（含中文路径、home 降级、会话清理、gc）；macOS 侧脚本按 bash 3.2 兼容编写，尚未真机实测。
 - 工作区内嵌套的其他 git 仓库（子目录自带 `.git`）无法索引：其余部分快照照常（fail-open，页面会提示跳过了哪些路径），但其内容不参与回退。
+- Windows 保留设备名（如 `nul`、`aux`、`con`、`com1`，含扩展名形式）无法由 Git 索引，默认不参与快照与回退；这些路径保持原样，也不会反复产生跳过提示。此排除仅适用于 Windows。
 - 工作区内的**目录重解析点**（junction / 目录符号链接）默认不参与快照：它们指向的子树不会被索引，因此那部分内容不参与回退。win32 上这是必需的——git for Windows 把 junction 当普通目录递归，自引用 junction 会让索引膨胀到 Windows 的 31 层重解析点上限（实测 2 个文件的工作区产出 64 条索引）；POSIX 侧符号链接照常进快照（git 记成 `120000` 条目，不递归进目标）。确需把某个**良性** junction（指向工作区外、非自引用）纳入快照时，可在排除配置里追加 `!路径/`（如 `!ext-link/`）反选恢复——用户排除行在机器生成行之后生效；**切勿对自引用 junction 使用**（爆炸根因）。
 - 文件名含换行/TAB 的极端情形超出 diff 清单的解析能力（概率可忽略）。
 - **与 dsh-routing-suite（渐进式工具披露路由）的交互**：同时启用其 router-standard 预设时，撤回经 `sessions.fork` 出新会话会把路由阶段重置为默认（工具面临时收窄）。现象、成因与解决方案见 [docs/routing-interplay.md](docs/routing-interplay.md)。
@@ -161,6 +162,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` 显式锁定。见下方「界面语言」 |
@@ -198,7 +200,7 @@ peerDependencies 按 minor 版本线开窗，与 `dsh.compatibility.dshReleases`
 
 **消息旁没有「↶ 撤回」按钮？** 按概率排查：① 装完没重启 DSH 进程——重启后硬刷新页面（Ctrl+Shift+R）；② git CLI 不在 PATH——页面顶部会有安装提示；③ 该消息发送于插件启用之前——快照只在消息发送时创建，历史消息无快照；④ 该工作区被停用快照——工作区开在 `dist/`、`target/` 这类命中基础排除表目录形态的位置，或超出 `maxWorkspaceBytes` / `scanBudgetMs` 护栏，或快照前的范围统计本身失败（`git ls-files` 报错，原因见「最近错误」，10 分钟后自动重试）；最近消息上会给出恢复提示（调大上限或补充排除表后自动恢复）。
 
-**撤回后个别文件没有恢复？** 该文件不在快照里：超过 `maxFileBytes`（默认 8MB）、命中排除表，或位于嵌套 git 仓库 / win32 目录重解析点内（见「已知限制」）。撤回前确认面板的清单就是实际回退范围，以它为准。
+**撤回后个别文件没有恢复？** 该文件不在快照里：超过 `maxFileBytes`（默认 8MB）、命中排除表（含 Windows 保留设备名），或位于嵌套 git 仓库 / win32 目录重解析点内（见「已知限制」）。撤回前确认面板的清单就是实际回退范围，以它为准。
 
 **快照占用磁盘太多？** 打开「设置 → 插件配置 → 撤回插件 → 快照管理」查看各工作区占用，可「立即 gc」或按工作区 / 会话 / 单条分级删除；长期可压低 `maxSnapshotsPerWorkspace`、设置 `retentionDays`，或把大目录补进排除表。
 

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

@@ -246,7 +246,7 @@ function snapshotScript(root, store, gitExe, messageId, base) {
     "addrc=0",
     'add_log=$("$git" --git-dir="$g" --work-tree="$root" add -A --ignore-errors "${pa_args[@]}" 2>&1) || addrc=$?',
     `if [ "$addrc" -ge 2 ]; then printf '%s\\n' "$add_log" >&2; exit "$addrc"; fi`,
-    `printf '%s\\n' "$add_log" | sed -n "s/^error: unable to index file '\\(.*\\)'$/\\1/p" | sort -u | while IFS= read -r sk; do`,
+    `printf '%s\\n' "$add_log" | sed -n -e "s/^error: unable to index file '\\(.*\\)'$/\\1/p" -e "s/^error: unable to add '\\(.*\\)' to index$/\\1/p" | sort -u | while IFS= read -r sk; do`,
     // 循环体用 if/fi 而非 && 列表：&& 列表条件为假时整条管道退出码为 1，
     // set -e 会把脚本杀掉（if 语句天然豁免）
     `  if [ -n "$sk" ]; then printf 'SNAP_SKIP %s\\n' "$sk"; fi`,
@@ -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

@@ -5,6 +5,32 @@ const UTF8_PRELUDE = "$OutputEncoding = [Text.UTF8Encoding]::new($false)\ntry {
 const MAX_FILE_BYTES = 8388608;
 const STALE_LOCK_MIN = 5;
 const HEARTBEAT_TTL_S = 900;
+const WIN_RESERVED_EXCLUDES = [
+  "nul",
+  "nul.*",
+  "aux",
+  "aux.*",
+  "con",
+  "con.*",
+  "prn",
+  "prn.*",
+  "com[1-9]",
+  "com[1-9].*",
+  "lpt[1-9]",
+  "lpt[1-9].*",
+  "com\xB9",
+  "com\xB9.*",
+  "com\xB2",
+  "com\xB2.*",
+  "com\xB3",
+  "com\xB3.*",
+  "lpt\xB9",
+  "lpt\xB9.*",
+  "lpt\xB2",
+  "lpt\xB2.*",
+  "lpt\xB3",
+  "lpt\xB3.*"
+];
 const FIDELITY_ATTRS = "* -text -filter -ident -export-ignore -export-subst -working-tree-encoding";
 function stripBom(text) {
   return text.replace(/^\uFEFF/, "");
@@ -180,7 +206,8 @@ function limitScanBlock(maxBytes, fileMaxBytes, budgetMs) {
   ].join("\n");
 }
 function excludeSyncBlock(excludeFile, base) {
-  const baseList = (Array.isArray(base) && base.length ? base : [".git", "node_modules/", ".dsh-recall-snapshots/", "dsh-recall-snapshots/"]).map(psq).join(",");
+  const configuredBase = Array.isArray(base) && base.length ? base : [".git", "node_modules/", ".dsh-recall-snapshots/", "dsh-recall-snapshots/"];
+  const baseList = [...configuredBase, ...WIN_RESERVED_EXCLUDES].map(psq).join(",");
   return [
     "$exFile = " + psq(excludeFile),
     "$userPats = @()",
@@ -317,14 +344,14 @@ function snapshotScript(root, store, gitExe, messageId, base) {
     // native stderr 包装成 ErrorRecord，EAP=Stop 下直接抛 NativeCommandError，
     // 而 PS 5.1 的 SilentlyContinue 会把合并流里的记录整个丢弃（实测 LOG
     // 为空）——Continue 是两个版本下唯一都能拿到 stderr 文本的取值。捕获
-    // 后按 "unable to index file 'X'" 提取被跳过的路径，以 SNAP_SKIP 行
-    // 回传 JS 侧做用户可见提示。
+    // 后按 "unable to index file 'X'" / "unable to add 'X' to index" 提取
+    // 被跳过的路径，以 SNAP_SKIP 行回传 JS 侧做用户可见提示。
     "$ErrorActionPreference = 'Continue'",
     '$addLog = (@(& $git --git-dir=$g --work-tree=$root add -A --ignore-errors @paArgs 2>&1) | ForEach-Object { [string]$_ }) -join "`n"',
     "$addRc = $LASTEXITCODE",
     "$ErrorActionPreference = 'Stop'",
     'if ($addRc -ge 2) { throw ("git add fatal (exit " + $addRc + "): " + $addLog) }',
-    `foreach ($m in [regex]::Matches($addLog, "unable to index file '([^']+)'") ) { Write-Output ('SNAP_SKIP ' + $m.Groups[1].Value) }`,
+    `foreach ($m in [regex]::Matches($addLog, "unable to (?:index file|add) '([^']+)'") ) { Write-Output ('SNAP_SKIP ' + $m.Groups[1].Value) }`,
     dropGitlinksBlock(),
     // 兜底：旧 git 走裸 add 时大文件仍会被重新索引，这里按清单再清一次；
     // pathspec 生效时它是空操作（清单条目本就不在 index）
@@ -675,6 +702,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 +721,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.2",
   "description": "在 DSH 中撤回自己发过的消息：工作区文件与对话历史一起回到那条消息发出之前，消息的文本与附件自动放回输入框，改完即可重发。文件走独立影子 git 快照（不碰项目自身的 git），对话走官方 sessions.fork，原会话归档可找回。",
   "icon": "assets/icon.svg",
   "type": "module",