dsh-rewind-plugin 0.16.0 → 0.17.0

package/README.en.md

@@ -72,11 +72,14 @@ then install the new one.
 
 ## Snapshot management
 
-Snapshots (the before-write backups) are stored under `<dsh home>/rewind-snapshots/`
+**Snapshot backups** are on by default: they power file restore and can be
+switched off in this plugin's configuration card. When off, no new snapshots
+are created; file changes made while off cannot be restored. Snapshots (the
+before-write backups) are stored under `<dsh home>/rewind-snapshots/`
 (the default is `~/.dsh/rewind-snapshots/`). For the **same session**, the plugin
 deduplicates snapshots by content and keeps the newest 100 anchor groups.
 **Deleting that directory manually** only clears the file backups (chat rewinds are
-unaffected) and the plugin rebuilds them automatically.
+unaffected); the plugin can rebuild them automatically.
 
 A **global auto-cleanup** (off by default) removes the snapshot directories of
 long-inactive sessions, leaving the active session and chat log untouched. Configure
@@ -85,7 +88,7 @@ auto-cleanup switch and the idle-day cutoff), or use the
 `/snapshot-auto-cleanup` command to **view, configure, and run** it. See:
 [Snapshot cleanup](docs/snapshot-auto-cleanup.md).
 
-<img src="assets/screenshots/cleanup-setting.png" alt="Plugin configuration card: auto cleanup and idle time (days)" width="600">
+<img src="assets/screenshots/plugin-setting.png" alt="Plugin configuration card: snapshot backups and auto cleanup" width="600">
 
 ## Uninstall
 
@@ -150,7 +153,7 @@ This plugin deliberately stays lightweight and focused on one thing — "convers
 ## Compatibility
 
 - Node.js `^22.19.0 || >=24.0.0`.
-- Compatibility definition, verification method, and version alignment: see [docs/compat/audit.md](docs/compat/audit.md); supported DSH versions are declared by `package.json` `peerDependencies`.
+- Compatibility definition, verification method, and version alignment: see [docs/compat/audit.md](docs/compat/audit.md); supported DSH versions are declared by `package.json` `engines.dsh`.
 
 > [!WARNING]
 > This project and DeepSeek Harness are both in developer preview. Pin exact
@@ -169,7 +172,6 @@ withdrew should consume the stable, locale-independent helpers exported from
 1. **Exported logs are complete** — a rewind only removes messages from the model context and the view; the exported session log (`/export`) still contains **withdrawn messages**. This plugin cannot alter exports.
 2. **Lightweight file rewind has a cost** — in specific cases not all changes can be rewound. Consistent with Claude Code. See: [File-rewind tracking boundary](docs/compat/tracking-boundary.md).
 3. **The turn-rail shows rewound turns** — the right-side rail added in DSH `v0.1.2` keeps ticks for withdrawn messages, and hovering shows the withdrawn text. Only a display difference; no functional impact.
-4. **Old rewind markers are no longer compatible** — DSH `v0.1.3` rejects the rewind markers from the old plugin (≤ 0.8.0). Later versions resolve this and provide an in-session update. See the [update guide](docs/rewind-fix.md).
 
 > [!NOTE]
 > Browser diagnostics are available; see [Browser diagnostics](docs/compat/diagnostics.md).

package/README.md

@@ -69,11 +69,11 @@ dsh plugin --profile <name> add dsh-rewind-plugin@<版本>
 
 ## 存储管理
 
-快照（写前备份）存储于 `<dsh home>/rewind-snapshots/`（默认 `~/.dsh/rewind-snapshots/`）。插件对**同一会话**的快照做内容去重并保留最近 100 组锚点；**手动删除该目录**仅清除文件备份（对话回退不受影响），插件会自动重建。
+**快照备份**（默认开启）：用于文件还原；可在本插件的配置卡片中关闭。关闭后不再创建新的快照，关闭期间的文件改动无法还原。快照存储于 `<dsh home>/rewind-snapshots/`（默认 `~/.dsh/rewind-snapshots/`）。手动删除该目录仅清除文件备份（对话回退不受影响），插件可自动重建。
 
-另提供**全局自动清理**（默认关闭）：把长期不活跃的会话快照整目录移除，不影响活动会话与对话日志。可在**插件**页本插件的配置卡片查看与配置（自动清理开关、失活天数），也可用 `/snapshot-auto-cleanup` 命令查看、设置和运行。详见：[快照自动清理](docs/snapshot-auto-cleanup.zh.md)。
+**全局自动清理**（默认关闭）：把长期不活跃的会话快照整目录移除，不影响活动会话与对话日志。可在配置卡片查看与配置（自动清理开关、失活天数），也可用 `/snapshot-auto-cleanup` 命令查看、设置和运行。详见：[快照自动清理](docs/snapshot-auto-cleanup.zh.md)。
 
-<img src="assets/screenshots/cleanup-setting.png" alt="插件配置卡片：自动清理与不活跃时间（天）" width="600">
+<img src="assets/screenshots/plugin-setting.png" alt="插件配置卡片：快照备份与自动清理" width="600">
 
 ## 卸载
 
@@ -137,7 +137,7 @@ rm <dsh home>/snapshot-cleanup-last-sweep.json
 ## 兼容性
 
 - Node.js `^22.19.0 || >=24.0.0`。
-- 兼容性定义、验证方法与版本对齐详见 [docs/compat/audit.md](docs/compat/audit.md)；支持的 DSH 版本由 `package.json` 的 `peerDependencies` 声明。
+- 兼容性定义、验证方法与版本对齐详见 [docs/compat/audit.md](docs/compat/audit.md)；支持的 DSH 版本由 `package.json` 的 `engines.dsh` 声明。
 
 > [!WARNING]
 > 本项目与 DeepSeek Harness 均处于开发者预览阶段。可复现环境请 pin 精确版本，
@@ -153,7 +153,6 @@ rm <dsh home>/snapshot-cleanup-last-sweep.json
 1. **导出的日志是完整内容**——回退只是把消息从模型上下文和视图中移除，`/export` 导出的会话日志包含**已撤回的消息**。本插件无法改动导出。
 2. **轻量文件回退存在代价**——特定情况可能无法回退所有修改。行为与 Claude Code 一致。详见：[文件回退的追踪边界](docs/compat/tracking-boundary.zh.md)。
 3. **导轨显示已回退轮次**——DSH `v0.1.2` 新增右侧导轨，为已撤回消息保留刻度，悬浮显示已撤回正文。仅显示差异，无功能影响。
-4. **旧回退标记不再兼容**——DSH `v0.1.3` 拒绝旧版插件（≤ 0.8.0）的回退标记。后续版本已解决，并提供会话更新功能。详见：[更新指南](docs/rewind-fix.zh.md)。
 
 > [!NOTE]
 > 本插件提供浏览器端诊断输出；详见 [浏览器诊断](docs/compat/diagnostics.zh.md)。

package/SECURITY.md

@@ -26,10 +26,11 @@ re-verify the host's own authority boundaries.
 
 ## Mutation gates
 
-The plugin **automatically captures** before-backups of tracked mutations, but
-**never automatically applies** one. A workspace restore happens only through
-an explicit user-invoked `/rewind-plugin @<seq> both` (the per-message ↶ button or the
-command channel), and only when all of the following hold:
+When `fileCheckpointingEnabled` is on, the plugin **automatically captures**
+before-backups of tracked mutations, but **never automatically applies** one.
+A workspace restore happens only through an explicit user-invoked
+`/rewind-plugin @<seq> both` (the per-message ↶ button or the command channel),
+and only when all of the following hold:
 
 1. **A validated target**: `planRewind` accepts only a `user/message` seq that
    is currently on the session surface (`parseRewindTarget` → `RewindPlan`).

package/lib/client.js

@@ -99,6 +99,9 @@ function hasFileImpact(text) {
   if (match !== null) return Number(match[1]) > 0;
   return false;
 }
+function hasBackupDisabled(text) {
+  return text !== void 0 && /(?:^|\n)backup=off(?:\n|$)/.test(text);
+}
 function isPreviewCommand(command) {
   return (command.args ?? "").includes("preview");
 }
@@ -307,6 +310,7 @@ var CLASS = {
   popoverOptionLabel: "dsh-rewind-popover-option-label",
   popoverOptionHint: "dsh-rewind-popover-option-hint",
   popoverImpact: "dsh-rewind-popover-impact",
+  popoverNote: "dsh-rewind-popover-note",
   popoverActions: "dsh-rewind-popover-actions",
   popoverPrimary: "dsh-rewind-popover-primary",
   popoverGhost: "dsh-rewind-popover-ghost",
@@ -417,6 +421,12 @@ var STYLE = `
   max-height: 160px;
   overflow: auto;
 }
+.dsh-rewind-popover-note {
+  margin-top: 6px;
+  font-size: 11px;
+  line-height: 15px;
+  color: var(--dsw-alias-label-tertiary);
+}
 .dsh-rewind-popover-actions {
   display: flex;
   justify-content: flex-end;
@@ -466,16 +476,17 @@ var STYLE = `
   pointer-events: none;
 }
 
-/* ---- Snapshot-cleanup configuration form ---- */
-/* The Plugins page draws the bundle's title, icon, crumb, description, and the
-   shared settings form frame (labels, save, read-only and failure lines); this
-   styles only the one control the card owns: the auto-cleanup toggle row. */
-.dsh-rewind-cleanup-permission {
+/* ---- Plugin configuration form ---- */
+/* Only the card's own controls: the two switch rows, their hints, and the divider. */
+.dsh-rewind-settings-divider {
+  border-top: 1px solid var(--dsw-alias-border-l2);
+}
+.dsh-rewind-settings-section {
   display: grid;
   gap: 6px;
   padding: 12px 0;
 }
-.dsh-rewind-cleanup-toggle-row {
+.dsh-rewind-settings-toggle-row {
   display: flex;
   align-items: flex-start;
   justify-content: space-between;
@@ -484,11 +495,11 @@ var STYLE = `
   line-height: 1.5;
   color: var(--dsw-alias-label-primary);
 }
-.dsh-rewind-cleanup-toggle-label {
+.dsh-rewind-settings-toggle-label {
   flex: 1;
   min-width: 0;
 }
-.dsh-rewind-cleanup-hint {
+.dsh-rewind-settings-hint {
   margin: 0;
   font-size: 12px;
   line-height: 1.5;
@@ -676,7 +687,13 @@ function renderImpactStep(root, opts, back, cached) {
           ...restores.map((path) => t("popover.impact.restore", { path })),
           ...deletes.map((path) => t("popover.impact.delete", { path }))
         ];
-        impact.textContent = lines.join("\n");
+        if (hasBackupDisabled(outcome.text)) {
+          const list = document.createElement("div");
+          list.textContent = lines.join("\n");
+          impact.replaceChildren(list, el("div", CLASS.popoverNote, t("popover.backupDisabled")));
+        } else {
+          impact.textContent = lines.join("\n");
+        }
       }
     }
     confirm.disabled = false;
@@ -1368,9 +1385,9 @@ function createRewindBridge(deps) {
 }
 
 // src/client/build-info.ts
-var PLUGIN_VERSION = true ? "0.16.0" : "dev";
+var PLUGIN_VERSION = true ? "0.17.0" : "dev";
 var PLUGIN_PACKAGE = "dsh-rewind-plugin";
-var BUILD_HASH = true ? "c6cfbc55" : "dev";
+var BUILD_HASH = true ? "bae5081f" : "dev";
 
 // src/client/locales.ts
 var zh = {
@@ -1390,6 +1407,7 @@ var zh = {
   "popover.both.hint": "\u5BF9\u8BDD\u56DE\u9000\u5E76\u8FD8\u539F\u5DE5\u4F5C\u533A\u6587\u4EF6",
   "popover.checking": "\u6B63\u5728\u68C0\u67E5\u6587\u4EF6\u53D8\u66F4\u2026",
   "popover.noChanges": "\u6B64\u6D88\u606F\u4E4B\u540E\u6CA1\u6709\u53EF\u8FD8\u539F\u7684\u6587\u4EF6\u53D8\u66F4\uFF0C\u4EC5\u53EF\u56DE\u9000\u5BF9\u8BDD",
+  "popover.backupDisabled": "\u5FEB\u7167\u5907\u4EFD\u5DF2\u5173\u95ED\uFF0C\u8FD8\u539F\u53EF\u80FD\u4E0D\u5145\u5206",
   "popover.cancel": "\u53D6\u6D88",
   "popover.impact.loading": "\u6B63\u5728\u83B7\u53D6\u5F71\u54CD\u6E05\u5355\u2026",
   "popover.impact.failed": "\u65E0\u6CD5\u83B7\u53D6\u5F71\u54CD\u6E05\u5355\uFF1A{message}",
@@ -1398,11 +1416,14 @@ var zh = {
   "popover.impact.delete": "\u5220\u9664 {path}",
   "popover.confirm": "\u786E\u8BA4\u56DE\u9000",
   "popover.back": "\u8FD4\u56DE",
+  "backup.title": "\u5FEB\u7167\u5907\u4EFD",
+  "backup.on": "\u5F00\u542F\u540E\u81EA\u52A8\u521B\u5EFA\u6587\u4EF6\u5FEB\u7167\uFF0C\u7528\u4E8E\u6587\u4EF6\u8FD8\u539F\u3002",
+  "backup.off": "\u5173\u95ED\u540E\u4E0D\u518D\u521B\u5EFA\u6587\u4EF6\u5FEB\u7167\uFF1B\u5173\u95ED\u671F\u95F4\u7684\u6587\u4EF6\u6539\u52A8\u65E0\u6CD5\u8FD8\u539F\u3002",
   "cleanup.auto": "\u81EA\u52A8\u6E05\u7406",
-  "cleanup.auto.on": "\u5F00\u542F\u540E\u6309\u4E0D\u6D3B\u8DC3\u5929\u6570\u81EA\u52A8\u6E05\u7406\u8FC7\u671F\u4F1A\u8BDD\u5FEB\u7167",
-  "cleanup.auto.off": "\u5173\u95ED\u540E\u4FDD\u7559\u5168\u90E8\u5FEB\u7167\uFF0C\u4E0D\u81EA\u52A8\u6E05\u7406",
+  "cleanup.auto.on": "\u5F00\u542F\u540E\u6309\u4E0D\u6D3B\u8DC3\u5929\u6570\u81EA\u52A8\u6E05\u7406\u8FC7\u671F\u4F1A\u8BDD\u5FEB\u7167\u3002",
+  "cleanup.auto.off": "\u5173\u95ED\u540E\u4E0D\u4F1A\u81EA\u52A8\u6E05\u7406\u5FEB\u7167\u3002",
   "cleanup.maxAge": "\u4E0D\u6D3B\u8DC3\u65F6\u95F4\uFF08\u5929\uFF09",
-  "cleanup.maxAge.hint": "\u8D85\u8FC7\u8BE5\u5929\u6570\u672A\u6D3B\u52A8\u7684\u4F1A\u8BDD\u5FEB\u7167\u4F1A\u88AB\u6E05\u7406",
+  "cleanup.maxAge.hint": "\u8D85\u8FC7\u8BE5\u5929\u6570\u672A\u6D3B\u52A8\u7684\u4F1A\u8BDD\u5FEB\u7167\u4F1A\u88AB\u6E05\u7406\u3002",
   "cleanup.invalid": "\u8BF7\u586B\u6B63\u6574\u6570\uFF1B\u7559\u7A7A\u8868\u793A\u4F7F\u7528\u9ED8\u8BA4\u503C",
   "cleanup.overridden": "\u5DF2\u8986\u76D6",
   "cleanup.reset": "\u6062\u590D\u9ED8\u8BA4",
@@ -1429,6 +1450,7 @@ var en = {
   "popover.both.hint": "Cut the context and restore workspace files",
   "popover.checking": "Checking for file changes\u2026",
   "popover.noChanges": "No tracked file changes after this message; conversation-only rewind",
+  "popover.backupDisabled": "Snapshots off; the restore may be incomplete",
   "popover.cancel": "Cancel",
   "popover.impact.loading": "Fetching impact list\u2026",
   "popover.impact.failed": "Could not fetch the impact list: {message}",
@@ -1437,11 +1459,14 @@ var en = {
   "popover.impact.delete": "Delete {path}",
   "popover.confirm": "Confirm rewind",
   "popover.back": "Back",
+  "backup.title": "Snapshot backups",
+  "backup.on": "When on, file snapshots are created automatically for file restore.",
+  "backup.off": "When off, no file snapshots are created; file changes made while off cannot be restored.",
   "cleanup.auto": "Auto cleanup",
-  "cleanup.auto.on": "When enabled, session snapshots idle past the cutoff are cleaned automatically",
-  "cleanup.auto.off": "When disabled, all snapshot backups are kept; nothing is cleaned automatically.",
+  "cleanup.auto.on": "When enabled, session snapshots idle past the cutoff are cleaned automatically.",
+  "cleanup.auto.off": "When off, snapshots are not cleaned automatically.",
   "cleanup.maxAge": "Idle time (days)",
-  "cleanup.maxAge.hint": "Snapshot backups of sessions idle longer than this many days are cleaned",
+  "cleanup.maxAge.hint": "Snapshot backups of sessions idle longer than this many days are cleaned.",
   "cleanup.invalid": "Enter a positive integer, or leave blank to use the default",
   "cleanup.overridden": "Overridden",
   "cleanup.reset": "Reset to default",
@@ -1455,7 +1480,7 @@ var en = {
 // src/client/settings-card.tsx
 var import_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 var import_jsx_runtime2 = require("react/jsx-runtime");
-var CLEANUP_ENTRY_ID = "dsh-rewind-plugin";
+var SETTINGS_ENTRY_ID = "dsh-rewind-plugin";
 var DEFAULT_MAX_AGE_DAYS = 30;
 function autoCleanupEnabledField() {
   return {
@@ -1464,6 +1489,13 @@ function autoCleanupEnabledField() {
     parse: (text) => ({ kind: "set", value: text === "true" })
   };
 }
+function fileCheckpointingEnabledField() {
+  return {
+    field: "fileCheckpointingEnabled",
+    format: (value) => String(value !== false),
+    parse: (text) => text === "true" ? { kind: "clear" } : { kind: "set", value: false }
+  };
+}
 function formLabels(t) {
   return {
     unavailable: t("cleanup.unavailable"),
@@ -1473,8 +1505,9 @@ function formLabels(t) {
     saving: t("cleanup.saving")
   };
 }
-function cleanupForm(scope) {
+function settingsForm(scope) {
   const form = new import_dsh_client_ui_primitives.SettingsFormModel(scope, [
+    fileCheckpointingEnabledField(),
     autoCleanupEnabledField(),
     (0, import_dsh_client_ui_primitives.settingsNumberField)("autoCleanupMaxAgeDays")
   ]);
@@ -1482,17 +1515,19 @@ function cleanupForm(scope) {
     form,
     store: form.bind(() => ({
       ...form.shell(),
+      checkpointingEnabled: form.field("fileCheckpointingEnabled"),
       enabled: form.field("autoCleanupEnabled"),
       maxAgeDays: form.field("autoCleanupMaxAgeDays")
     }))
   };
 }
-function SettingsCleanupCard(props) {
-  const { t, useCleanupCard } = props;
-  const state = useCleanupCard((snapshot) => snapshot);
+function SettingsCard(props) {
+  const { t, useSettingsCard } = props;
+  const state = useSettingsCard((snapshot) => snapshot);
   if (props.view === "summary") return null;
   const disabled = !state.writable || state.saving;
-  const enabled = state.enabled.text === "true";
+  const checkpointing = state.checkpointingEnabled.text === "true";
+  const cleanupEnabled = state.enabled.text === "true";
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
     import_dsh_client_ui_primitives.SettingsForm,
     {
@@ -1501,13 +1536,31 @@ function SettingsCleanupCard(props) {
       onSave: props.save,
       onDiscard: props.discard,
       children: [
-        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dsh-rewind-cleanup-permission", children: [
-          /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dsh-rewind-cleanup-toggle-row", children: [
-            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dsh-rewind-cleanup-toggle-label", children: t("cleanup.auto") }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dsh-rewind-settings-section", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dsh-rewind-settings-toggle-row", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dsh-rewind-settings-toggle-label", children: t("backup.title") }),
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+              import_dsh_client_ui_primitives.Switch,
+              {
+                checked: checkpointing,
+                label: t("backup.title"),
+                disabled,
+                onChange: (next) => {
+                  props.edit("fileCheckpointingEnabled", String(next));
+                }
+              }
+            )
+          ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: "dsh-rewind-settings-hint", children: t(checkpointing ? "backup.on" : "backup.off") })
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("div", { className: "dsh-rewind-settings-divider" }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dsh-rewind-settings-section", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { className: "dsh-rewind-settings-toggle-row", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { className: "dsh-rewind-settings-toggle-label", children: t("cleanup.auto") }),
             /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
               import_dsh_client_ui_primitives.Switch,
               {
-                checked: enabled,
+                checked: cleanupEnabled,
                 label: t("cleanup.auto"),
                 disabled,
                 onChange: (next) => {
@@ -1516,9 +1569,9 @@ function SettingsCleanupCard(props) {
               }
             )
           ] }),
-          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: "dsh-rewind-cleanup-hint", children: t(enabled ? "cleanup.auto.on" : "cleanup.auto.off") })
+          /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { className: "dsh-rewind-settings-hint", children: t(cleanupEnabled ? "cleanup.auto.on" : "cleanup.auto.off") })
         ] }),
-        enabled ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+        cleanupEnabled ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
           import_dsh_client_ui_primitives.SettingsValueField,
           {
             id: "dsh-rewind-cleanup-maxage",
@@ -1668,20 +1721,20 @@ function apply(ctx) {
       createRewindBridge({ sessionOf, chatOf, isMainViewSession, watchChat, setComposerText, restoreImages, t, subscribeLocale })
     ));
     try {
-      const { store, form } = cleanupForm(
-        ctx.configForms.get(CLEANUP_ENTRY_ID)
+      const { store, form } = settingsForm(
+        ctx.configForms.get(SETTINGS_ENTRY_ID)
       );
       ctx.effect(() => () => {
         form.dispose();
-      }, "dsh-rewind cleanup form");
+      }, "dsh-rewind settings form");
       yield slots.inject("plugins.bundle.config", () => slots.register(
         {
           name: "plugins.bundle.config",
           key: PLUGIN_PACKAGE,
           locale: NS2,
-          inject: () => ({ hooks: { cleanupCard: store }, ...form.actions() })
+          inject: () => ({ hooks: { settingsCard: store }, ...form.actions() })
         },
-        SettingsCleanupCard
+        SettingsCard
       ));
     } catch (error) {
       rewindLog.error("settings", "settings card register failed", error);

package/lib/index.js

@@ -14,6 +14,7 @@ var en = {
   "plan.restore": "restore {path}",
   "plan.delete": "delete {path}",
   "plan.noChanges": "No restorable changes after the target.",
+  "plan.backupOff": "Snapshot backups are off; this restore may be incomplete.",
   "plan.skip": "  not restored: {path} ({reason})",
   "skipReason.oversized": "over the {limit} backup limit, so the recorded state predates untracked edits",
   "uncovered.header": "{count} tracked file(s) exceed the {limit} backup limit and are not covered:",
@@ -30,6 +31,7 @@ var en = {
   "delete.count": "deleted {count} file(s)",
   "skip.count": "skipped {count} path(s)",
   "noRestorable": "; no restorable write-class changes after the target",
+  "backupOff": "snapshot backups are off, so the restore may be incomplete",
   "storeUnsupported": "file restore unavailable: these snapshots use a newer store format (v{version}) than this plugin understands; nothing was changed. Update the plugin or clear this session's snapshots.",
   "success": "Withdrawn seq {targetSeq} and everything after it (conversation returned to earlier){restore}.",
   "noUserMessages": "This session has no rewindable user messages yet.",
@@ -65,6 +67,7 @@ var zh = {
   "plan.restore": "\u8FD8\u539F {path}",
   "plan.delete": "\u5220\u9664 {path}",
   "plan.noChanges": "\u76EE\u6807\u4E4B\u540E\u6CA1\u6709\u9700\u8981\u8FD8\u539F\u7684\u53D8\u66F4\u3002",
+  "plan.backupOff": "\u5FEB\u7167\u5907\u4EFD\u5DF2\u5173\u95ED\uFF1B\u672C\u6B21\u8FD8\u539F\u53EF\u80FD\u4E0D\u5145\u5206\u3002",
   "plan.skip": "  \u672A\u8FD8\u539F\uFF1A{path}\uFF08{reason}\uFF09",
   "skipReason.oversized": "\u5DF2\u8D85\u8FC7 {limit} \u7684\u5907\u4EFD\u4E0A\u9650\uFF0C\u8BB0\u5F55\u7684\u72B6\u6001\u65E9\u4E8E\u672A\u88AB\u8DDF\u8E2A\u7684\u4FEE\u6539",
   "uncovered.header": "{count} \u4E2A\u5DF2\u8DDF\u8E2A\u6587\u4EF6\u8D85\u8FC7 {limit} \u7684\u5907\u4EFD\u4E0A\u9650\uFF0C\u672A\u7EB3\u5165\u8BB0\u5F55\uFF1A",
@@ -81,6 +84,7 @@ var zh = {
   "delete.count": "\u5220\u9664 {count} \u4E2A\u6587\u4EF6",
   "skip.count": "\u8DF3\u8FC7 {count} \u4E2A\u8DEF\u5F84",
   "noRestorable": "\uFF1B\u76EE\u6807\u4E4B\u540E\u6CA1\u6709\u53EF\u8FD8\u539F\u7684\u5199\u7C7B\u53D8\u66F4",
+  "backupOff": "\u5FEB\u7167\u5907\u4EFD\u5DF2\u5173\u95ED\uFF0C\u8FD8\u539F\u53EF\u80FD\u4E0D\u5145\u5206",
   "storeUnsupported": "\u6587\u4EF6\u8FD8\u539F\u4E0D\u53EF\u7528\uFF1A\u8FD9\u4E9B\u5FEB\u7167\u4F7F\u7528\u4E86\u6BD4\u672C\u63D2\u4EF6\u66F4\u65B0\u7684\u5B58\u50A8\u683C\u5F0F\uFF08v{version}\uFF09\uFF1B\u5DE5\u4F5C\u533A\u672A\u505A\u4EFB\u4F55\u6539\u52A8\u3002\u8BF7\u66F4\u65B0\u63D2\u4EF6\uFF0C\u6216\u6E05\u9664\u8BE5\u4F1A\u8BDD\u7684\u5FEB\u7167\u3002",
   "success": "\u5DF2\u64A4\u56DE seq {targetSeq} \u53CA\u4E4B\u540E\u5185\u5BB9\uFF08\u5BF9\u8BDD\u5DF2\u56DE\u5230\u6B64\u524D\uFF09{restore}\u3002",
   "noUserMessages": "\u5F53\u524D\u4F1A\u8BDD\u8FD8\u6CA1\u6709\u53EF\u56DE\u9000\u7684\u7528\u6237\u6D88\u606F\u3002",
@@ -2315,6 +2319,7 @@ function shouldRunAutoSweep(lastAtMs, nowMs, intervalMs = AUTO_SWEEP_INTERVAL_MS
 var name = "dsh-rewind";
 var inject = ["commands", "tools", "settings"];
 var ENGINE_COMMAND = "rewind-plugin";
+var DEFAULT_FILE_CHECKPOINTING_ENABLED = true;
 var Config = z.object({
   snapshotDir: z.string().required(false),
   dshHome: z.string().required(false),
@@ -2322,9 +2327,13 @@ var Config = z.object({
   maxFileBytes: z.number().step(1).min(0).default(DEFAULT_MAX_FILE_BYTES),
   maxAnchorGroups: z.number().step(1).min(1).default(MAX_ANCHOR_GROUPS),
   autoSweepIntervalMs: z.number().step(1).min(1).default(AUTO_SWEEP_INTERVAL_MS),
+  fileCheckpointingEnabled: z.boolean().default(DEFAULT_FILE_CHECKPOINTING_ENABLED).volatile(),
   autoCleanupEnabled: z.boolean().default(DEFAULT_CLEANUP_CONFIG.enabled).volatile(),
   autoCleanupMaxAgeDays: z.number().step(1).min(1).default(DEFAULT_CLEANUP_CONFIG.maxAgeDays).volatile()
 });
+function isFileCheckpointingEnabled(config) {
+  return config?.fileCheckpointingEnabled?.get() !== false;
+}
 var TRACKED_TOOLS = /* @__PURE__ */ new Set(["write", "edit"]);
 function isSubagentSession(session) {
   const header = session.header;
@@ -2428,11 +2437,15 @@ async function captureBefore(fs, workingDirectory, store, exec, pending) {
   }
   pending.set(key, { path: target.displayPath, backup });
 }
-async function commitEntry(store, pending, anchorCache, trackedBySession, exec, result) {
+async function commitEntry(store, pending, anchorCache, trackedBySession, exec, result, checkpointingEnabled) {
   const key = `${exec.agent?.id ?? "anon"}:${exec.callId}`;
   const capture = pending.get(key);
   if (capture === void 0) return;
   pending.delete(key);
+  if (!checkpointingEnabled) {
+    await discardCapture(capture);
+    return;
+  }
   if (result.isError) {
     await discardCapture(capture);
     return;
@@ -2476,7 +2489,7 @@ function formatBytes(bytes) {
   if (bytes >= 1024) return `${Math.round(bytes / 1024)} KiB`;
   return `${bytes} B`;
 }
-function formatPlan(plan, files, uncovered = [], maxFileBytes = 0) {
+function formatPlan(plan, files, uncovered = [], maxFileBytes = 0, checkpointingEnabled = true) {
   const lines = [
     t("plan.rewinding", { targetSeq: plan.targetSeq, count: plan.shadowedSeqs.length })
   ];
@@ -2493,10 +2506,12 @@ function formatPlan(plan, files, uncovered = [], maxFileBytes = 0) {
     for (const file of uncovered.slice(0, 5)) lines.push(`  ${file.path}`);
     if (uncovered.length > 5) lines.push("  \u2026");
   }
+  if (!checkpointingEnabled) lines.push(t("plan.backupOff"));
   lines.push(`impact=${files.length}`);
   for (const file of files) {
     lines.push(`${file.action}:${file.path}`);
   }
+  if (!checkpointingEnabled) lines.push("backup=off");
   return lines.join("\n");
 }
 function resolveOrError(events, surface, raw) {
@@ -2567,7 +2582,7 @@ function dropPendingSteering(agent) {
     agent.inbox.remove(message.id);
   }
 }
-async function executeRewind(ctx, store, fs, invocation, rawTarget, mode, inflight) {
+async function executeRewind(ctx, store, fs, invocation, rawTarget, mode, inflight, checkpointingEnabled) {
   const { agent } = invocation;
   const sessionId = agent.session.id;
   if (inflight.has(sessionId)) {
@@ -2626,6 +2641,7 @@ async function executeRewind(ctx, store, fs, invocation, rawTarget, mode, inflig
           const skippedLines = renderSkipped(outcome, capped, store.fileCapBytes);
           if (skippedLines !== "") parts.push(skippedLines);
         }
+        if (!checkpointingEnabled) parts.push(t("backupOff"));
         restore = parts.length > 0 ? `${t("sep.clause")}${parts.join(t("sep.list"))}` : t("noRestorable");
         restore += renderFailures(outcome.failed);
       }
@@ -2651,7 +2667,7 @@ function rewindErrorResult(error) {
   }
   throw error;
 }
-async function handleRewind(ctx, store, fs, invocation, inflight) {
+async function handleRewind(ctx, store, fs, invocation, inflight, checkpointingEnabled) {
   const session = invocation.agent.session;
   const input = invocation.rawInput.trim();
   if (input === "") {
@@ -2659,7 +2675,7 @@ async function handleRewind(ctx, store, fs, invocation, inflight) {
     if (candidates.length === 0) {
       return { kind: "error", text: t("noUserMessages") };
     }
-    return executeRewind(ctx, store, fs, invocation, `@${candidates[0].seq}`, "chat", inflight);
+    return executeRewind(ctx, store, fs, invocation, `@${candidates[0].seq}`, "chat", inflight, checkpointingEnabled);
   }
   const parts = input.split(/\s+/);
   if (parts[0] === "preview") {
@@ -2679,7 +2695,7 @@ async function handleRewind(ctx, store, fs, invocation, inflight) {
       return { kind: "error", text: t("storeUnsupported", { version: await store.readStoreVersion(session.id) ?? 0 }) };
     }
     const uncovered = await store.uncoveredPaths(session.id).catch(() => []);
-    return { kind: "success", text: formatPlan(plan, impacts, uncovered, store.fileCapBytes) };
+    return { kind: "success", text: formatPlan(plan, impacts, uncovered, store.fileCapBytes, checkpointingEnabled) };
   }
   if (parts[0] === "__candidates") {
     const candidates = listRewindCandidates(session.snapshotEvents(), session.surface.nodes);
@@ -2691,7 +2707,7 @@ async function handleRewind(ctx, store, fs, invocation, inflight) {
     return { kind: "error", text: t("engine.rejected") };
   }
   if (mode === void 0) return { kind: "error", text: t("engine.rejected") };
-  return executeRewind(ctx, store, fs, invocation, target, mode, inflight);
+  return executeRewind(ctx, store, fs, invocation, target, mode, inflight, checkpointingEnabled);
 }
 var autoSweepChecked = false;
 async function maybeRunAutoCleanup(ctx, store, sessionId, dshHome, sweepIntervalMs, signal) {
@@ -2825,7 +2841,7 @@ var INCLUDE_ENTRY_PREFIX = "include:";
 function rewindConfigKey(ctx) {
   return ctx.fiber?.entry?.id;
 }
-function cleanupConfigKey(entryId) {
+function profileEntryKey(entryId) {
   if (entryId === void 0) return void 0;
   return entryId.startsWith(INCLUDE_ENTRY_PREFIX) ? entryId.slice(INCLUDE_ENTRY_PREFIX.length) : entryId;
 }
@@ -2847,7 +2863,7 @@ function apply(ctx, config) {
     maxFileBytes: config?.maxFileBytes,
     maxAnchorGroups: config?.maxAnchorGroups
   });
-  const configKey = cleanupConfigKey(rewindConfigKey(ctx));
+  const configKey = profileEntryKey(rewindConfigKey(ctx));
   if (config !== void 0 && configKey !== void 0) {
     const writer = {
       entryId: configKey,
@@ -2872,10 +2888,10 @@ function apply(ctx, config) {
       return handler(invocation);
     };
     const rewindHandler = withHostLocale(
-      (invocation) => handleRewind(ctx, store, fsService, invocation, inflight)
+      (invocation) => handleRewind(ctx, store, fsService, invocation, inflight, isFileCheckpointingEnabled(config))
     );
     const engineHandler = withHostLocale(
-      (invocation) => invocation.rawInput.trim() === "" ? Promise.resolve({ kind: "error", text: t("engine.rejected") }) : handleRewind(ctx, store, fsService, invocation, inflight)
+      (invocation) => invocation.rawInput.trim() === "" ? Promise.resolve({ kind: "error", text: t("engine.rejected") }) : handleRewind(ctx, store, fsService, invocation, inflight, isFileCheckpointingEnabled(config))
     );
     try {
       yield ctx.commands.register({
@@ -2948,6 +2964,7 @@ function apply(ctx, config) {
         if (lifecycle.signal.aborted) return;
         const sessionId = session.id;
         void maybeRunAutoCleanup(ctx, store, sessionId, dshHome, config?.autoSweepIntervalMs, lifecycle.signal);
+        if (!isFileCheckpointingEnabled(config)) return;
         let tracked = trackedBySession.get(sessionId);
         if (tracked === void 0) {
           tracked = await store.trackedPaths(sessionId);
@@ -2970,7 +2987,9 @@ function apply(ctx, config) {
     }, "dsh-rewind fs capture");
     scope.on("tools/execute", async (exec, next) => {
       try {
-        await captureBefore(fs, workingDirectory, store, exec, pending);
+        if (isFileCheckpointingEnabled(config)) {
+          await captureBefore(fs, workingDirectory, store, exec, pending);
+        }
       } catch (error) {
         ctx.logger.warn(`[dsh-rewind] before-capture failed for ${exec.name}: ${error instanceof Error ? error.message : String(error)}`);
       }
@@ -2982,7 +3001,7 @@ function apply(ctx, config) {
         if (session !== void 0 && !isSubagentSession(session)) {
           void maybeRunAutoCleanup(ctx, store, session.id, dshHome, config?.autoSweepIntervalMs, lifecycle.signal);
         }
-        await commitEntry(store, pending, anchorCache, trackedBySession, exec, result);
+        await commitEntry(store, pending, anchorCache, trackedBySession, exec, result, isFileCheckpointingEnabled(config));
       } catch (error) {
         ctx.logger.warn(`[dsh-rewind] checkpoint commit failed for ${exec.name}: ${error instanceof Error ? error.message : String(error)}`);
       }
@@ -2999,10 +3018,11 @@ function apply(ctx, config) {
 }
 export {
   Config,
+  DEFAULT_FILE_CHECKPOINTING_ENABLED,
   ENGINE_COMMAND,
   SnapshotStore,
   apply,
-  cleanupConfigKey,
   inject,
-  name
+  name,
+  profileEntryKey
 };

package/lib/types/client/hidden.d.ts

@@ -144,6 +144,8 @@ export declare function isExecutedRewindCommand(node: CommandNode, seq: number):
  * always-show so a working option is never hidden on a failed probe.
  */
 export declare function hasFileImpact(text: string | undefined): boolean;
+/** Whether the preview reports that new file checkpoints are disabled. */
+export declare function hasBackupDisabled(text: string | undefined): boolean;
 /**
  * True when an engine command node is the internal candidate-list probe
  * (`__candidates`) the popupSelect runs to fetch the FULL candidate

package/lib/types/client/locales.d.ts

@@ -17,6 +17,7 @@ export declare const zh: {
     'popover.both.hint': string;
     'popover.checking': string;
     'popover.noChanges': string;
+    'popover.backupDisabled': string;
     'popover.cancel': string;
     'popover.impact.loading': string;
     'popover.impact.failed': string;
@@ -25,6 +26,9 @@ export declare const zh: {
     'popover.impact.delete': string;
     'popover.confirm': string;
     'popover.back': string;
+    'backup.title': string;
+    'backup.on': string;
+    'backup.off': string;
     'cleanup.auto': string;
     'cleanup.auto.on': string;
     'cleanup.auto.off': string;
@@ -65,6 +69,7 @@ export declare const en: {
     'popover.both.hint': string;
     'popover.checking': string;
     'popover.noChanges': string;
+    'popover.backupDisabled': string;
     'popover.cancel': string;
     'popover.impact.loading': string;
     'popover.impact.failed': string;
@@ -73,6 +78,9 @@ export declare const en: {
     'popover.impact.delete': string;
     'popover.confirm': string;
     'popover.back': string;
+    'backup.title': string;
+    'backup.on': string;
+    'backup.off': string;
     'cleanup.auto': string;
     'cleanup.auto.on': string;
     'cleanup.auto.off': string;

package/lib/types/client/settings-card.d.ts

@@ -1,7 +1,7 @@
 /**
- * This bundle's configuration form for the snapshot-cleanup policy, rendered
- * on its Plugins-page card (`plugins.bundle.config`, keyed by the package
- * name).
+ * This bundle's configuration form for the file-checkpointing and snapshot
+ * cleanup switches, rendered on its Plugins-page card (`plugins.bundle.config`,
+ * keyed by the package name).
  *
  * The staging model, the field controls, and the form frame are the harness's
  * own (`SettingsFormModel` + `SettingsValueField` + `SettingsForm`); the one
@@ -31,28 +31,30 @@ export declare const CARD_LOCALE_NS = "rewind";
  * The plugin entry whose form this is: the bundle's package name, which is the
  * profile entry id the host addresses the configuration by.
  */
-export declare const CLEANUP_ENTRY_ID = "dsh-rewind-plugin";
+export declare const SETTINGS_ENTRY_ID = "dsh-rewind-plugin";
 /** The default max age; an empty numeric draft means "use this". */
 export declare const DEFAULT_MAX_AGE_DAYS = 30;
-/** The two editable knobs, exactly as the entry's configuration document names them. */
-export interface CleanupPolicy {
+/** The editable knobs, exactly as the entry's configuration document names them. */
+export interface SettingsPolicy {
+    readonly fileCheckpointingEnabled: boolean;
     readonly autoCleanupEnabled: boolean;
     readonly autoCleanupMaxAgeDays: number;
 }
 /**
  * One form snapshot as this card reads it: the shared form frame's own state
- * (`SettingsFormShell`) plus the two field drafts.
+ * (`SettingsFormShell`) plus the three field drafts.
  */
-export interface CleanupCardSnapshot extends SettingsFormShell {
+export interface SettingsCardSnapshot extends SettingsFormShell {
+    readonly checkpointingEnabled: SettingsFieldState;
     readonly enabled: SettingsFieldState;
     readonly maxAgeDays: SettingsFieldState;
 }
 /**
  * The bound snapshot store the slot renderer rebinds as the card's
- * `useCleanupCard` selector hook.
+ * `useSettingsCard` selector hook.
  */
-export interface SettingsCleanupStore {
-    getSnapshot(): CleanupCardSnapshot;
+export interface SettingsCardStore {
+    getSnapshot(): SettingsCardSnapshot;
     subscribe(listener: () => void): () => void;
 }
 /**
@@ -60,7 +62,7 @@ export interface SettingsCleanupStore {
  * `SettingsFormScope` read/write face, declared structurally so the card never
  * couples to an internal declaration file's path.
  */
-export interface CleanupFormScope<T> {
+export interface SettingsFormScope<T> {
     getSnapshot(): {
         readonly status: 'loading' | 'ready' | 'unavailable';
         readonly value: T | undefined;
@@ -84,22 +86,22 @@ export interface CleanupFormScope<T> {
  * runtime owner share (`view`), the locale `t` seat, and the injected face with
  * its `hooks` compartment rebound as a `use<Name>` selector hook.
  */
-export type SettingsCleanupCardProps = PropsRuntime<'plugins.bundle.config'> & PropsLocale<typeof CARD_LOCALE_NS> & InjectFace<SettingsCleanupFace>;
+export type SettingsCardProps = PropsRuntime<'plugins.bundle.config'> & PropsLocale<typeof CARD_LOCALE_NS> & InjectFace<SettingsCardFace>;
 /**
  * Every dictionary key this card reads: the switch row, the day field, and the
  * five labels the shared form frame renders.
  */
-export type CleanupLabelKey = 'cleanup.auto' | 'cleanup.auto.on' | 'cleanup.auto.off' | 'cleanup.maxAge' | 'cleanup.maxAge.hint' | 'cleanup.overridden' | 'cleanup.reset' | 'cleanup.invalid' | 'cleanup.unavailable' | 'cleanup.readonly' | 'cleanup.saveFailed' | 'cleanup.save' | 'cleanup.saving';
+export type SettingsLabelKey = 'backup.title' | 'backup.on' | 'backup.off' | 'cleanup.auto' | 'cleanup.auto.on' | 'cleanup.auto.off' | 'cleanup.maxAge' | 'cleanup.maxAge.hint' | 'cleanup.overridden' | 'cleanup.reset' | 'cleanup.invalid' | 'cleanup.unavailable' | 'cleanup.readonly' | 'cleanup.saveFailed' | 'cleanup.save' | 'cleanup.saving';
 /** The form frame's copy, read from this plugin's dictionary. */
-export declare function formLabels(t: (key: CleanupLabelKey) => string): SettingsFormLabels;
+export declare function formLabels(t: (key: SettingsLabelKey) => string): SettingsFormLabels;
 /**
  * Build the staged form over one entry's configuration.
  * @param scope - the shared per-entry configuration form.
  * @returns the model plus the card's bound read hook.
  */
-export declare function cleanupForm(scope: CleanupFormScope<CleanupPolicy>): {
-    form: SettingsFormModel<CleanupPolicy>;
-    store: import("@deepseek-ai/dsh-client-store").SnapshotStore<CleanupCardSnapshot>;
+export declare function settingsForm(scope: SettingsFormScope<SettingsPolicy>): {
+    form: SettingsFormModel<SettingsPolicy>;
+    store: import("@deepseek-ai/dsh-client-store").SnapshotStore<SettingsCardSnapshot>;
 };
 /**
  * The bundle's configuration form; `summary` renders nothing (the page only
@@ -107,10 +109,10 @@ export declare function cleanupForm(scope: CleanupFormScope<CleanupPolicy>): {
  * @param props - the view, the card's read hook, locale seat, and form actions.
  * @returns the form element, or null for the summary view.
  */
-export declare function SettingsCleanupCard(props: SettingsCleanupCardProps): import("react").JSX.Element | null;
+export declare function SettingsCard(props: SettingsCardProps): import("react").JSX.Element | null;
 /** The face the slot registration injects into the card. */
-export interface SettingsCleanupFace extends SettingsFormActions {
+export interface SettingsCardFace extends SettingsFormActions {
     readonly hooks: {
-        readonly cleanupCard: SettingsCleanupStore;
+        readonly settingsCard: SettingsCardStore;
     };
 }

package/lib/types/client/styles.d.ts

@@ -15,6 +15,7 @@ export declare const CLASS: {
     readonly popoverOptionLabel: 'dsh-rewind-popover-option-label';
     readonly popoverOptionHint: 'dsh-rewind-popover-option-hint';
     readonly popoverImpact: 'dsh-rewind-popover-impact';
+    readonly popoverNote: 'dsh-rewind-popover-note';
     readonly popoverActions: 'dsh-rewind-popover-actions';
     readonly popoverPrimary: 'dsh-rewind-popover-primary';
     readonly popoverGhost: 'dsh-rewind-popover-ghost';
@@ -31,4 +32,4 @@ export declare const CLASS: {
  */
 export declare const REWIND_ICON_SVG: string;
 /** One injected stylesheet (scoped under `.dsh-rewind-*`). */
-export declare const STYLE = "\n.dsh-rewind-btn {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  /* The neighbouring action buttons scale by this delta too. */\n  width: calc(28px + var(--dsh-content-font-delta, 0px));\n  height: calc(28px + var(--dsh-content-font-delta, 0px));\n  padding: 6px;\n  border: none;\n  border-radius: var(--dsw-radius-sm, 8px);\n  background: transparent;\n  color: var(--dsw-alias-label-tertiary);\n  cursor: pointer;\n}\n.dsh-rewind-btn svg {\n  width: calc(15px + var(--dsh-content-font-delta, 0px));\n  height: calc(15px + var(--dsh-content-font-delta, 0px));\n}\n.dsh-rewind-btn:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-secondary);\n}\n\n.dsh-rewind-popover {\n  position: fixed;\n  z-index: 1000;\n  width: 288px;\n  padding: 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 12px;\n  background: var(--dsw-specific-menu, var(--dsw-alias-bg-layer-3));\n  box-shadow: var(--dsw-shadow-lv3);\n  font-size: 14px;\n  line-height: 20px;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-popover-title {\n  font-size: 14px;\n  font-weight: 600;\n  line-height: 20px;\n}\n.dsh-rewind-popover-target {\n  margin: 4px 0 10px;\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-tertiary);\n  word-break: break-all;\n}\n.dsh-rewind-popover-option {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  width: 100%;\n  margin: 0 0 6px;\n  padding: 8px 10px;\n  border: 1px solid transparent;\n  border-radius: 8px;\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  text-align: left;\n  cursor: pointer;\n}\n.dsh-rewind-popover-option:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n/* Arrow navigation moves real focus, so the focused row carries the pointer's\n   fill and the browser ring is suppressed: in dark mode the UA two-tone ring\n   draws its dark half against the filled row and reads as a residue edge (the\n   harness Menu suppresses it the same way). */\n.dsh-rewind-popover-option:focus-visible:not(:disabled) {\n  background: var(--dsw-alias-interactive-bg-hover);\n  outline: none;\n}\n.dsh-rewind-popover-option:disabled {\n  opacity: 0.5;\n  cursor: default;\n}\n.dsh-rewind-popover-option-label {\n  font-weight: 500;\n}\n.dsh-rewind-popover-option-hint {\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-popover-impact {\n  margin: 4px 0 10px;\n  padding: 8px 10px;\n  border-radius: 8px;\n  background: var(--dsw-alias-interactive-bg-hover);\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-secondary);\n  white-space: pre-wrap;\n  max-height: 160px;\n  overflow: auto;\n}\n.dsh-rewind-popover-actions {\n  display: flex;\n  justify-content: flex-end;\n  gap: 8px;\n}\n.dsh-rewind-popover-primary,\n.dsh-rewind-popover-ghost {\n  padding: 5px 12px;\n  border: none;\n  border-radius: 8px;\n  font: inherit;\n  font-size: 13px;\n  line-height: 18px;\n  cursor: pointer;\n}\n.dsh-rewind-popover-primary {\n  background: var(--dsw-alias-button-primary-fill);\n  color: var(--dsw-alias-label-primary-foreground);\n}\n.dsh-rewind-popover-primary:hover:not(:disabled) {\n  background: var(--dsw-alias-button-primary-hover);\n}\n.dsh-rewind-popover-primary:disabled {\n  opacity: 0.5;\n  cursor: default;\n}\n.dsh-rewind-popover-ghost {\n  background: transparent;\n  color: var(--dsw-alias-label-secondary);\n}\n.dsh-rewind-popover-ghost:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.dsh-rewind-guard-hint {\n  position: fixed;\n  z-index: 1000;\n  max-width: min(440px, calc(100vw - 24px));\n  padding: 8px 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 10px;\n  background: var(--dsw-specific-menu, var(--dsw-alias-bg-layer-3));\n  box-shadow: var(--dsw-shadow-lv3);\n  font-size: 13px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-primary);\n  pointer-events: none;\n}\n\n/* ---- Snapshot-cleanup configuration form ---- */\n/* The Plugins page draws the bundle's title, icon, crumb, description, and the\n   shared settings form frame (labels, save, read-only and failure lines); this\n   styles only the one control the card owns: the auto-cleanup toggle row. */\n.dsh-rewind-cleanup-permission {\n  display: grid;\n  gap: 6px;\n  padding: 12px 0;\n}\n.dsh-rewind-cleanup-toggle-row {\n  display: flex;\n  align-items: flex-start;\n  justify-content: space-between;\n  gap: 16px;\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-cleanup-toggle-label {\n  flex: 1;\n  min-width: 0;\n}\n.dsh-rewind-cleanup-hint {\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary);\n}\n";
+export declare const STYLE = "\n.dsh-rewind-btn {\n  display: inline-flex;\n  align-items: center;\n  justify-content: center;\n  /* The neighbouring action buttons scale by this delta too. */\n  width: calc(28px + var(--dsh-content-font-delta, 0px));\n  height: calc(28px + var(--dsh-content-font-delta, 0px));\n  padding: 6px;\n  border: none;\n  border-radius: var(--dsw-radius-sm, 8px);\n  background: transparent;\n  color: var(--dsw-alias-label-tertiary);\n  cursor: pointer;\n}\n.dsh-rewind-btn svg {\n  width: calc(15px + var(--dsh-content-font-delta, 0px));\n  height: calc(15px + var(--dsh-content-font-delta, 0px));\n}\n.dsh-rewind-btn:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n  color: var(--dsw-alias-label-secondary);\n}\n\n.dsh-rewind-popover {\n  position: fixed;\n  z-index: 1000;\n  width: 288px;\n  padding: 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 12px;\n  background: var(--dsw-specific-menu, var(--dsw-alias-bg-layer-3));\n  box-shadow: var(--dsw-shadow-lv3);\n  font-size: 14px;\n  line-height: 20px;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-popover-title {\n  font-size: 14px;\n  font-weight: 600;\n  line-height: 20px;\n}\n.dsh-rewind-popover-target {\n  margin: 4px 0 10px;\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-tertiary);\n  word-break: break-all;\n}\n.dsh-rewind-popover-option {\n  display: flex;\n  flex-direction: column;\n  gap: 2px;\n  width: 100%;\n  margin: 0 0 6px;\n  padding: 8px 10px;\n  border: 1px solid transparent;\n  border-radius: 8px;\n  background: transparent;\n  color: inherit;\n  font: inherit;\n  text-align: left;\n  cursor: pointer;\n}\n.dsh-rewind-popover-option:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n/* Arrow navigation moves real focus, so the focused row carries the pointer's\n   fill and the browser ring is suppressed: in dark mode the UA two-tone ring\n   draws its dark half against the filled row and reads as a residue edge (the\n   harness Menu suppresses it the same way). */\n.dsh-rewind-popover-option:focus-visible:not(:disabled) {\n  background: var(--dsw-alias-interactive-bg-hover);\n  outline: none;\n}\n.dsh-rewind-popover-option:disabled {\n  opacity: 0.5;\n  cursor: default;\n}\n.dsh-rewind-popover-option-label {\n  font-weight: 500;\n}\n.dsh-rewind-popover-option-hint {\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-popover-impact {\n  margin: 4px 0 10px;\n  padding: 8px 10px;\n  border-radius: 8px;\n  background: var(--dsw-alias-interactive-bg-hover);\n  font-size: 12px;\n  line-height: 16px;\n  color: var(--dsw-alias-label-secondary);\n  white-space: pre-wrap;\n  max-height: 160px;\n  overflow: auto;\n}\n.dsh-rewind-popover-note {\n  margin-top: 6px;\n  font-size: 11px;\n  line-height: 15px;\n  color: var(--dsw-alias-label-tertiary);\n}\n.dsh-rewind-popover-actions {\n  display: flex;\n  justify-content: flex-end;\n  gap: 8px;\n}\n.dsh-rewind-popover-primary,\n.dsh-rewind-popover-ghost {\n  padding: 5px 12px;\n  border: none;\n  border-radius: 8px;\n  font: inherit;\n  font-size: 13px;\n  line-height: 18px;\n  cursor: pointer;\n}\n.dsh-rewind-popover-primary {\n  background: var(--dsw-alias-button-primary-fill);\n  color: var(--dsw-alias-label-primary-foreground);\n}\n.dsh-rewind-popover-primary:hover:not(:disabled) {\n  background: var(--dsw-alias-button-primary-hover);\n}\n.dsh-rewind-popover-primary:disabled {\n  opacity: 0.5;\n  cursor: default;\n}\n.dsh-rewind-popover-ghost {\n  background: transparent;\n  color: var(--dsw-alias-label-secondary);\n}\n.dsh-rewind-popover-ghost:hover {\n  background: var(--dsw-alias-interactive-bg-hover);\n}\n\n.dsh-rewind-guard-hint {\n  position: fixed;\n  z-index: 1000;\n  max-width: min(440px, calc(100vw - 24px));\n  padding: 8px 12px;\n  border: 1px solid var(--dsw-alias-border-l2);\n  border-radius: 10px;\n  background: var(--dsw-specific-menu, var(--dsw-alias-bg-layer-3));\n  box-shadow: var(--dsw-shadow-lv3);\n  font-size: 13px;\n  line-height: 18px;\n  color: var(--dsw-alias-label-primary);\n  pointer-events: none;\n}\n\n/* ---- Plugin configuration form ---- */\n/* Only the card's own controls: the two switch rows, their hints, and the divider. */\n.dsh-rewind-settings-divider {\n  border-top: 1px solid var(--dsw-alias-border-l2);\n}\n.dsh-rewind-settings-section {\n  display: grid;\n  gap: 6px;\n  padding: 12px 0;\n}\n.dsh-rewind-settings-toggle-row {\n  display: flex;\n  align-items: flex-start;\n  justify-content: space-between;\n  gap: 16px;\n  font-size: 13px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-primary);\n}\n.dsh-rewind-settings-toggle-label {\n  flex: 1;\n  min-width: 0;\n}\n.dsh-rewind-settings-hint {\n  margin: 0;\n  font-size: 12px;\n  line-height: 1.5;\n  color: var(--dsw-alias-label-tertiary);\n}\n";

package/lib/types/index.d.ts

@@ -8,8 +8,9 @@
  * target with itself, cutting only the model-visible surface
  * (`docs/architecture.md`).
  *
- * File restore (mode `both`) follows Claude Code's checkpointing: the plugin
- * backs up each tracked write-class edit BEFORE it happens (at the
+ * File restore (mode `both`) follows Claude Code's checkpointing: unless
+ * `fileCheckpointingEnabled` is off, the plugin backs up each tracked
+ * write-class edit BEFORE it happens (at the
  * `tools/execute` around-dispatch stage, so an approval short-circuit cannot
  * skip the capture and a denied call never records), commits the backup under
  * the turn's anchor message seq at `tools/post-execute`, and a rewind to
@@ -22,7 +23,7 @@
  *
  * @module dsh-rewind
  */
-import type { Context } from '@deepseek-ai/cordis';
+import type { Context, Volatile } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import { type CleanupSettings } from './snapshot-cleanup.ts';
 export { SnapshotStore } from './snapshot.ts';
@@ -50,18 +51,22 @@ export interface RewindConfig {
     /** Automatic snapshot-sweep cadence in ms. Default {@link AUTO_SWEEP_INTERVAL_MS}. */
     readonly autoSweepIntervalMs?: number;
 }
+/** The default for {@link FileCheckpointingSettings.fileCheckpointingEnabled}. */
+export declare const DEFAULT_FILE_CHECKPOINTING_ENABLED = true;
 /**
- * The plugin's full configuration: the ordinary store options plus the
- * user-editable cleanup policy. The two policy fields are `.volatile()`, so the
- * host resolves them into live references before `apply` and the Plugins page
- * exposes exactly them.
- *
- * The policy fields are named for WHAT they gate (the automatic sweep; the
- * `/snapshot-auto-cleanup` command's manual `run` ignores the switch), because
- * this entry's own `disabled:` flag sits beside them in the same document and a
- * bare `enabled` reads like the plugin switch.
+ * The live file-checkpointing switch (Claude Code's
+ * `fileCheckpointingEnabled`): whether NEW before-backups may be recorded.
+ */
+export interface FileCheckpointingSettings {
+    readonly fileCheckpointingEnabled: Volatile<boolean>;
+}
+/**
+ * The plugin's full configuration: store options plus the three user-editable
+ * policy fields. `.volatile()` resolves them into live references for the
+ * Plugins page; the names say what they gate, because a bare `enabled` would
+ * read like the entry's own `disabled:` flag.
  */
-export interface Config extends RewindConfig, CleanupSettings {
+export interface Config extends RewindConfig, CleanupSettings, FileCheckpointingSettings {
 }
 /** The `Config` schema the host resolves and projects as this entry's form. */
 export declare const Config: z<Schemastery.ObjectS<NoInfer<{
@@ -71,6 +76,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     maxFileBytes: z<number, number, "defined">;
     maxAnchorGroups: z<number, number, "defined">;
     autoSweepIntervalMs: z<number, number, "defined">;
+    fileCheckpointingEnabled: z<boolean, boolean, "volatile-defined">;
     autoCleanupEnabled: z<boolean, boolean, "volatile-defined">;
     autoCleanupMaxAgeDays: z<number, number, "volatile-defined">;
 }>>, Schemastery.ObjectT<NoInfer<{
@@ -80,6 +86,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
     maxFileBytes: z<number, number, "defined">;
     maxAnchorGroups: z<number, number, "defined">;
     autoSweepIntervalMs: z<number, number, "defined">;
+    fileCheckpointingEnabled: z<boolean, boolean, "volatile-defined">;
     autoCleanupEnabled: z<boolean, boolean, "volatile-defined">;
     autoCleanupMaxAgeDays: z<number, number, "volatile-defined">;
 }>>, "plain">;
@@ -92,7 +99,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
  * @param entryId - this fiber's Loader entry id, when it has one.
  * @returns the configuration key, or undefined without an entry.
  */
-export declare function cleanupConfigKey(entryId: string | undefined): string | undefined;
+export declare function profileEntryKey(entryId: string | undefined): string | undefined;
 /**
  * Register the `/rewind` command and the checkpoint pipeline (before-capture
  * at `tools/execute`, disk commit at `tools/post-execute`).
@@ -113,6 +120,7 @@ export declare function cleanupConfigKey(entryId: string | undefined): string |
  *
  * @param ctx - context carrying `commands`, `tools`, and an optional `fs`.
  * @param config - resolved plugin config: the store options (`snapshotDir`,
- *  `dshHome`, `dedup`) plus the live cleanup policy (`enabled`, `maxAgeDays`).
+ *  `dshHome`, `dedup`) plus the live policy (`fileCheckpointingEnabled`, cleanup
+ *  `enabled`/`maxAgeDays`).
  */
 export declare function apply(ctx: Context, config?: Config): void;

package/lib/types/locales.d.ts

@@ -50,6 +50,7 @@ export declare const en: {
     'plan.restore': string;
     'plan.delete': string;
     'plan.noChanges': string;
+    'plan.backupOff': string;
     'plan.skip': string;
     'skipReason.oversized': string;
     'uncovered.header': string;
@@ -66,6 +67,7 @@ export declare const en: {
     'delete.count': string;
     'skip.count': string;
     noRestorable: string;
+    backupOff: string;
     storeUnsupported: string;
     success: string;
     noUserMessages: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-rewind-plugin",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "In-window conversation rewind with workspace file restore · 同窗口内对话回退并可还原工作区文件",
   "icon": "./assets/icon.svg",
   "keywords": [
@@ -147,42 +147,42 @@
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.5",
     "@deepseek-ai/cosmokit": "1.8.6",
-    "@deepseek-ai/dsh-agent": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-api-session-controller": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-attachment": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-client-connection": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-client-locale": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-client-store": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-commands": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-input-trigger": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-plugin-manager": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-session": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-command-compact": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-commands": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-compaction": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-compaction-basic": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-compaction-image-offload": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-fs": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-goal": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-home-paths": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-llm": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-plan-mode": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-sandbox": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-scope": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-session": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-session-stats": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-session-title": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-settings": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-token-meter": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-tools": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-user-questions": "0.2.1-rc.1",
-    "@deepseek-ai/dsh-working-directory": "0.2.1-rc.1",
+    "@deepseek-ai/dsh-agent": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-attachment": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-commands": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-input-trigger": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-command-compact": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-commands": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-compaction": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-compaction-basic": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-compaction-image-offload": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-fs": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-goal": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-home-paths": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-plan-mode": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-sandbox": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-scope": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session-stats": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session-title": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-settings": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-token-meter": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-user-questions": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-working-directory": "0.2.1-rc.2",
     "@deepseek-ai/schemastery": "3.18.5",
     "@types/node": "^24.0.0",
     "@types/react": "^18.3.31",