dsh-retrace 0.3.0 → 0.4.2

package/lib/dynamic-client.js

@@ -43,7 +43,16 @@ return {
       var NS = "retrace";
       var ROUTE_BASE = "/api/plugins/retrace";
       var MARKER_PREFIX = "retrace";
+      var MARKER_PREFIXES = [MARKER_PREFIX, "message-editor"];
+      var LEGACY_MARKER_PREFIXES = ["message-editor"];
+      function isMarkerId(id) {
+        return typeof id === "string" && MARKER_PREFIXES.some((p) => id.startsWith(`${p}-`));
+      }
+      function isLegacyMarkerId(id) {
+        return typeof id === "string" && LEGACY_MARKER_PREFIXES.some((p) => id.startsWith(`${p}-`));
+      }
       var CONFIG_KEY = "dsh-retrace:config";
+      var LEGACY_CONFIG_KEYS = ["dsh-message-editor:config"];
       var zh = {
         "action.edit": "\u7F16\u8F91",
         "action.editAria": "\u7F16\u8F91\u8FD9\u6761\u6D88\u606F",
@@ -62,13 +71,60 @@ return {
         "marker.referenceHint": "\u70B9\u51FB\u5C55\u5F00\u67E5\u770B\u539F\u63D0\u95EE\uFF08\u4EC5\u4F5C\u5BF9\u7167\uFF0C\u4E0D\u4F1A\u8FDB\u5165\u6A21\u578B\u4E0A\u4E0B\u6587\uFF09",
         "options.title": "\u6D88\u606F\u7F16\u8F91\u63D2\u4EF6",
         "options.showOriginalInput": "\u7F16\u8F91\u540E\u663E\u793A\u539F\u63D0\u95EE\u5BF9\u7167",
-        "options.editFromScratch": "\u7F16\u8F91\u540E\u4ECE\u65B0\u5BF9\u8BDD\u5F00\u59CB\uFF08\u9690\u85CF\u6B64\u524D\u7684\u6D88\u606F\uFF09",
+        "options.editFromScratch": "\u7F16\u8F91\u540E\u4ECE\u65B0\u5BF9\u8BDD\u5F00\u59CB\uFF08\u9690\u85CF\u6B64\u524D\u7684\u6D88\u606F\uFF0C\u9ED8\u8BA4\u5173\uFF09",
+        "options.hideShadowed": "\u6309\u6807\u8BB0\u9690\u85CF\u88AB\u7F16\u8F91/\u64A4\u56DE\u7684\u6D88\u606F",
+        "options.hideShadowedDesc": "\u5F00\uFF08\u9ED8\u8BA4\uFF09\uFF1A\u64A4\u56DE/\u7F16\u8F91/\u91CD\u65B0\u751F\u6210\u6309\u6807\u8BB0\u9690\u85CF\u88AB\u66FF\u6362\u7684\u90A3\u4E00\u8F6E\u6D88\u606F\u3002\u5173\uFF1A\u6240\u6709\u6D88\u606F\u4FDD\u6301\u53EF\u89C1\uFF0C\u6807\u8BB0\u4EC5\u663E\u793A\u63D0\u793A\u4E0E\u5BF9\u7167\uFF08\u67E5\u770B\u5B8C\u6574\u5386\u53F2\u7528\uFF09\u3002\u4E00\u6B21\u64CD\u4F5C\u8981\u9690\u85CF\u8D85\u8FC7 40% \u7684\u5BF9\u8BDD\u65F6\u81EA\u52A8\u964D\u7EA7\u4E3A\u4E0D\u9690\u85CF\u3002",
         "options.versioning": "\u7248\u672C\u4E0E\u4EA7\u7269\u5FEB\u7167",
         "options.versioningDesc": "\u5F00\uFF1A\u6BCF\u6B21\u64A4\u56DE/\u7F16\u8F91\u8BB0\u5F55\u4E00\u4E2A\u7248\u672C\uFF08\u6D88\u606F\u4E0E\u89E6\u78B0\u6587\u4EF6\uFF09\uFF0C\u63D0\u4F9B\u65F6\u95F4\u7EBF\u4E0E\u4EA7\u7269\u56DE\u9000\uFF1B\u5173\uFF1A\u4EC5\u56DE\u9000\u4E0A\u4E0B\u6587\uFF0C\u4E0D\u8BB0\u5F55\u7248\u672C\u3001\u4E0D\u8FFD\u8E2A\u4EA7\u7269\uFF08\u6700\u7701\u8D44\u6E90\uFF09\u3002",
         "options.git": "\u542F\u7528 git \u96C6\u6210",
         "options.gitDesc": "\u5F00\uFF1A\u5DE5\u4F5C\u533A\u662F git \u4ED3\u5E93\u65F6\u7528 git \u8BB0\u5F55\u4E0E\u56DE\u9000\uFF08\u4E0D\u81EA\u52A8\u63D0\u4EA4\u3001\u4E0D\u52A8\u4F60\u7684\u5206\u652F\uFF09\uFF0C\u975E\u4ED3\u5E93\u53EF\u5728\u65F6\u95F4\u7EBF\u91CC\u4E00\u952E\u542F\u7528\uFF1B\u5173\uFF1A\u4E00\u5F8B\u7528\u5185\u7F6E\u5FEB\u7167\uFF08\u5B58\u4E8E ~/.dsh\uFF09\uFF0C\u4E0D\u89E6\u78B0\u5DE5\u4F5C\u533A git \u72B6\u6001\uFF0C\u529F\u80FD\u7B49\u4EF7\u3002",
         "options.retention": "\u7248\u672C\u4FDD\u7559\u4E0A\u9650",
         "options.retentionDesc": "\u6587\u4EF6\u5FEB\u7167\u53EA\u4FDD\u7559\u6700\u8FD1 N \u4E2A\u7248\u672C\uFF0C\u8D85\u51FA\u81EA\u52A8\u6E05\u7406\u6700\u65E7\u7684\uFF1B\u65F6\u95F4\u7EBF\u8BB0\u5F55\u4E0E\u5BA1\u8BA1\u75D5\u8FF9\u59CB\u7EC8\u4FDD\u7559\u3002",
+        "timeline.open": "\u65F6\u95F4\u7EBF",
+        "timeline.openAria": "\u6253\u5F00\u4F1A\u8BDD\u65F6\u95F4\u7EBF",
+        "timeline.title": "\u7248\u672C\u65F6\u95F4\u7EBF",
+        "view.retrace": "\u7248\u672C",
+        "timeline.refresh": "\u5237\u65B0",
+        "timeline.close": "\u5173\u95ED",
+        "timeline.empty": "\u8FD8\u6CA1\u6709\u7248\u672C\u3002\u64A4\u56DE / \u7F16\u8F91 / \u91CD\u65B0\u751F\u6210\u4F1A\u5728\u6B64\u8BB0\u5F55\u7248\u672C\u3002",
+        "timeline.loading": "\u52A0\u8F7D\u4E2D\u2026",
+        "timeline.error": "\u65F6\u95F4\u7EBF\u52A0\u8F7D\u5931\u8D25",
+        "timeline.kind.recall": "\u64A4\u56DE",
+        "timeline.kind.edit": "\u7F16\u8F91\u91CD\u53D1",
+        "timeline.kind.regenerate": "\u91CD\u65B0\u751F\u6210",
+        "timeline.kind.restore": "\u6062\u590D",
+        "timeline.kind.compaction": "\u538B\u7F29",
+        "timeline.kind.replace": "\u66FF\u6362",
+        "timeline.messages": "{count} \u6761\u6D88\u606F",
+        "timeline.files": "{created} \u589E / {modified} \u6539 / {deleted} \u5220",
+        "timeline.filesNone": "\u65E0\u6587\u4EF6\u53D8\u66F4",
+        "timeline.preview": "\u56DE\u9000\u9884\u89C8",
+        "timeline.previewDesc": "\u5C06\u56DE\u9000\u5230\u7248\u672C {version}\uFF08{kind}\uFF09\u3002",
+        "timeline.contextOnly": "\u4EC5\u5BF9\u8BDD",
+        "timeline.contextOnlyDesc": "\u79FB\u9664\u8BE5\u7248\u672C\u4E4B\u540E\u7684\u6D88\u606F\uFF08\u4FDD\u7559\u65E5\u5FD7\u5BA1\u8BA1\u75D5\u8FF9\uFF09",
+        "timeline.artifactsOnly": "\u4EC5\u4EA7\u7269",
+        "timeline.artifactsOnlyDesc": "\u628A\u8BE5\u7248\u672C\u89E6\u78B0\u7684\u6587\u4EF6\u6062\u590D\u5230\u5F53\u65F6\u7684\u5167\u5BB9",
+        "timeline.both": "\u4E24\u8005",
+        "timeline.bothDesc": "\u5148\u56DE\u9000\u5BF9\u8BDD\uFF0C\u518D\u56DE\u9000\u4EA7\u7269",
+        "timeline.messagesRemoved": "\u5C06\u79FB\u9664 {count} \u6761\u6D88\u606F",
+        "timeline.noChanges": "\u5F53\u524D\u5DF2\u5728\u8BE5\u7248\u672C\u72B6\u6001\uFF0C\u65E0\u53D8\u5316",
+        "timeline.artifactsList": "\u4EA7\u7269\u52A8\u4F5C\uFF08{count}\uFF09",
+        "timeline.artifact.restore": "\u6062\u590D",
+        "timeline.artifact.delete": "\u5220\u9664",
+        "timeline.artifact.skip": "\u8DF3\u8FC7",
+        "timeline.confirm": "\u786E\u8BA4\u56DE\u9000",
+        "timeline.cancel": "\u53D6\u6D88",
+        "timeline.busy": "\u56DE\u9000\u4E2D\u2026",
+        "timeline.detail": "\u8BE6\u60C5",
+        "timeline.trajectory": "\u8F68\u8FF9\u53F0\u8D26",
+        "timeline.jump": "\u8DF3\u8F6C",
+        "timeline.jumpFailed": "\u8BE5\u7248\u672C\u5728\u8F83\u8FDC\u7684\u8FC7\u53BB\uFF08\u8D85\u51FA\u81EA\u52A8\u52A0\u8F7D\u9884\u7B97\uFF09\uFF0C\u65E0\u6CD5\u76F4\u63A5\u5B9A\u4F4D\u3002\u8BF7\u5411\u4E0A\u6EDA\u52A8\u52A0\u8F7D\u66F4\u65E9\u6D88\u606F\u540E\u91CD\u8BD5\uFF1B\u6216\u7528\u300C\u8BE6\u60C5\u300D\u67E5\u770B\u8BE5\u7248\u672C\u5F53\u65F6\u7684\u4E8B\u4EF6\u539F\u6587\u3002",
+        "timeline.gitRepo": "git \u4ED3\u5E93",
+        "timeline.gitHead": "HEAD {hash}",
+        "timeline.gitDirty": "\u5DE5\u4F5C\u533A\u6709\u672A\u63D0\u4EA4\u6539\u52A8",
+        "timeline.gitInit": "\u542F\u7528 git \u7248\u672C\u7BA1\u7406",
+        "timeline.gitInitDesc": "\u5728\u5DE5\u4F5C\u533A\u6267\u884C git init\uFF08\u4EC5\u6DFB\u52A0 .gitignore \u4E0E\u4E00\u4E2A\u57FA\u7EBF\u63D0\u4EA4\uFF09\uFF0C\u7248\u672C\u56DE\u9000\u5C06\u4F18\u5148\u4F7F\u7528 git\u3002",
+        "timeline.gitInitConfirm": "\u786E\u5B9A\u8981\u521D\u59CB\u5316 git \u5417\uFF1F",
         "error.generic": "\u64CD\u4F5C\u5931\u8D25\uFF0C\u8BF7\u91CD\u8BD5",
         "error.busy": "\u8BF7\u5148\u505C\u6B62\u5F53\u524D\u56DE\u590D\u518D\u64CD\u4F5C"
       };
@@ -90,13 +146,60 @@ return {
         "marker.referenceHint": "Click to expand the original input (reference only, never sent to the model)",
         "options.title": "Message editor plugin",
         "options.showOriginalInput": "Show the original input after editing",
-        "options.editFromScratch": "Start a fresh conversation after editing (hide earlier messages)",
+        "options.editFromScratch": "Start a fresh conversation after editing (hide earlier messages, default off)",
+        "options.hideShadowed": "Hide shadowed messages per marker",
+        "options.hideShadowedDesc": "On (default): recall/edit/regenerate hide the replaced round per their markers. Off: every message stays visible; markers only show the notice and reference (use to review full history). A single op that would hide more than 40% of the conversation degrades to notice-only automatically.",
         "options.versioning": "Version & artifact snapshots",
         "options.versioningDesc": "On: every recall/edit records a version (messages and touched files) powering the timeline and artifact rollback. Off: only rewinds context \u2014 no version records, no artifact tracking (lightest).",
         "options.git": "Git integration",
         "options.gitDesc": "On: uses git to record and roll back when the workspace is a repository (never auto-commits, never touches your branches); non-repo workspaces can enable git from the timeline. Off: built-in snapshots under ~/.dsh only \u2014 the plugin never touches the workspace git state; equivalent features.",
         "options.retention": "Version retention limit",
         "options.retentionDesc": "File snapshots are kept for the most recent N versions; older ones are pruned automatically (timeline records and the audit trail are always kept).",
+        "timeline.open": "Timeline",
+        "timeline.openAria": "Open the session timeline",
+        "timeline.title": "Version timeline",
+        "view.retrace": "Versions",
+        "timeline.refresh": "Refresh",
+        "timeline.close": "Close",
+        "timeline.empty": "No versions yet. Recall / edit / regenerate record a version here.",
+        "timeline.loading": "Loading\u2026",
+        "timeline.error": "Failed to load the timeline",
+        "timeline.kind.recall": "Recall",
+        "timeline.kind.edit": "Edit & resend",
+        "timeline.kind.regenerate": "Regenerate",
+        "timeline.kind.restore": "Restore",
+        "timeline.kind.compaction": "Compaction",
+        "timeline.kind.replace": "Replace",
+        "timeline.messages": "{count} messages",
+        "timeline.files": "{created} created / {modified} modified / {deleted} deleted",
+        "timeline.filesNone": "No file changes",
+        "timeline.preview": "Rollback preview",
+        "timeline.previewDesc": "Will roll back to version {version} ({kind}).",
+        "timeline.contextOnly": "Context only",
+        "timeline.contextOnlyDesc": "Remove messages after this version (the log audit trail stays)",
+        "timeline.artifactsOnly": "Artifacts only",
+        "timeline.artifactsOnlyDesc": "Restore the files this version touched to their state at that version",
+        "timeline.both": "Both",
+        "timeline.bothDesc": "Roll back the context first, then the artifacts",
+        "timeline.messagesRemoved": "{count} messages will be removed",
+        "timeline.noChanges": "Already at this version; nothing to change",
+        "timeline.artifactsList": "Artifact actions ({count})",
+        "timeline.artifact.restore": "restore",
+        "timeline.artifact.delete": "delete",
+        "timeline.artifact.skip": "skip",
+        "timeline.confirm": "Confirm rollback",
+        "timeline.cancel": "Cancel",
+        "timeline.busy": "Rolling back\u2026",
+        "timeline.detail": "Details",
+        "timeline.trajectory": "Trajectory",
+        "timeline.jump": "Jump",
+        "timeline.jumpFailed": "This version lies too far back (beyond the auto-load budget) to locate directly. Scroll up to load earlier messages, or use Details to read the original event text of this version.",
+        "timeline.gitRepo": "git repository",
+        "timeline.gitHead": "HEAD {hash}",
+        "timeline.gitDirty": "working tree has uncommitted changes",
+        "timeline.gitInit": "Enable git versioning",
+        "timeline.gitInitDesc": "Runs git init in the workspace (adds a minimal .gitignore and a baseline commit); rollback will prefer git.",
+        "timeline.gitInitConfirm": "Initialize git in this workspace?",
         "error.generic": "Operation failed; please try again",
         "error.busy": "Stop the current reply before recalling or editing"
       };
@@ -123,14 +226,49 @@ return {
         const { versioning, git, retentionLimit } = getConfig();
         return { "x-retrace-config": JSON.stringify({ versioning, git, retentionLimit }) };
       }
-      var CONFIG_DEFAULTS = { showOriginalInput: true, editFromScratch: true, versioning: true, git: true, retentionLimit: 50 };
+      var CONFIG_VERSION = 3;
+      var CONFIG_DEFAULTS = { version: CONFIG_VERSION, showOriginalInput: true, editFromScratch: false, hideShadowed: true, versioning: true, git: true, retentionLimit: 50, prewrite: true };
       var configListeners = /* @__PURE__ */ new Set();
       var configCache = readConfig();
       var editReferences = /* @__PURE__ */ new Map();
+      function migrateConfig(parsed) {
+        const version = typeof parsed.version === "number" ? parsed.version : 1;
+        if (version >= CONFIG_VERSION) return { ...CONFIG_DEFAULTS, ...parsed };
+        return {
+          ...CONFIG_DEFAULTS,
+          ...parsed,
+          version: CONFIG_VERSION,
+          editFromScratch: CONFIG_DEFAULTS.editFromScratch,
+          hideShadowed: CONFIG_DEFAULTS.hideShadowed
+        };
+      }
       function readConfig() {
         try {
           const raw = localStorage.getItem(CONFIG_KEY);
-          return { ...CONFIG_DEFAULTS, ...raw ? JSON.parse(raw) : {} };
+          if (raw !== null) {
+            const parsed = raw ? JSON.parse(raw) : {};
+            const migrated = migrateConfig(parsed);
+            const storedVersion = typeof parsed.version === "number" ? parsed.version : 1;
+            if (storedVersion < CONFIG_VERSION) {
+              try {
+                localStorage.setItem(CONFIG_KEY, JSON.stringify(migrated));
+              } catch {
+              }
+            }
+            return migrated;
+          }
+          for (const legacyKey of LEGACY_CONFIG_KEYS) {
+            const legacyRaw = localStorage.getItem(legacyKey);
+            if (legacyRaw !== null) {
+              const migrated = migrateConfig(legacyRaw ? JSON.parse(legacyRaw) : {});
+              try {
+                localStorage.setItem(CONFIG_KEY, JSON.stringify(migrated));
+              } catch {
+              }
+              return migrated;
+            }
+          }
+          return { ...CONFIG_DEFAULTS };
         } catch {
           return { ...CONFIG_DEFAULTS };
         }
@@ -208,9 +346,11 @@ return {
         }
       };
       function markerOpFromId(id) {
-        if (id.startsWith(`${MARKER_PREFIX}-recall-`)) return "recall";
-        if (id.startsWith(`${MARKER_PREFIX}-edit-`)) return "edit";
-        if (id.startsWith(`${MARKER_PREFIX}-regenerate-`)) return "regenerate";
+        for (const p of MARKER_PREFIXES) {
+          if (id.startsWith(`${p}-recall-`)) return "recall";
+          if (id.startsWith(`${p}-edit-`)) return "edit";
+          if (id.startsWith(`${p}-regenerate-`)) return "regenerate";
+        }
         return "edit";
       }
       var recallMarkerDefinition = {
@@ -219,16 +359,22 @@ return {
         match: (event) => {
           if (event.type !== "assistant/message" || !isReplacementSurfaceEvent(event)) return null;
           const id = event.data?.message?.id;
-          if (typeof id !== "string" || !id.startsWith(`${MARKER_PREFIX}-`)) return null;
+          if (!isMarkerId(id)) return null;
           return { id: `marker:${id}`, role: "start" };
         },
         start: (_context, match) => {
           const event = match.event;
+          const id = String(event.data.message.id);
+          const legacy = isLegacyMarkerId(id);
           return {
             seq: event.seq,
             time: event.time,
-            op: markerOpFromId(String(event.data.message.id)),
-            shadowedSeqs: Array.isArray(event.sourceEventSeqs) ? event.sourceEventSeqs.slice() : [],
+            op: markerOpFromId(id),
+            legacy,
+            // Legacy markers never hide: treat their shadowed range as empty so the
+            // notice/reference render but no row is hidden and no action row is
+            // suppressed via useShadowed.
+            shadowedSeqs: legacy ? [] : Array.isArray(event.sourceEventSeqs) ? event.sourceEventSeqs.slice() : [],
             targetSeq: event.data?.editor?.targetSeq,
             text: event.data?.editor?.text
           };
@@ -264,12 +410,15 @@ return {
           return false;
         });
       }
+      var SHADOW_SAFETY_RATIO = 0.4;
       function useHiddenKeys(useSession, shadowedSeqs) {
         return useSession((snapshot) => {
           if (!Array.isArray(shadowedSeqs) || shadowedSeqs.length === 0) return null;
           const hidden = new Set(shadowedSeqs);
           const keys = [];
+          let rowCount = 0;
           for (const node of snapshot.chat.nodes.values()) {
+            if (typeof node.anchorSeq === "number") rowCount += 1;
             if (node.kind === "recall-marker") continue;
             if (node.kind === "turn-tail") {
               const closingSeq = node.data?.closing?.finalNode?.seq;
@@ -283,6 +432,7 @@ return {
             }
             if (typeof node.anchorSeq === "number" && hidden.has(node.anchorSeq)) keys.push(node.key);
           }
+          if (keys.length > 0 && rowCount > 0 && keys.length / rowCount > SHADOW_SAFETY_RATIO) return null;
           return keys.length === 0 ? null : keys;
         });
       }
@@ -483,9 +633,9 @@ return {
         ]);
       }
       function RecallMarkerRow({ node, useSession, t }) {
-        const { seq, op, shadowedSeqs } = node.data;
+        const { seq, op, shadowedSeqs, legacy } = node.data;
         const dismissed = useMarkerDismissed(useSession, seq, op);
-        const hiddenKeys = useHiddenKeys(useSession, shadowedSeqs);
+        const hiddenKeys = legacy || !getConfig().hideShadowed ? null : useHiddenKeys(useSession, shadowedSeqs);
         const css = hiddenKeys === null ? null : hiddenKeys.map((key) => `[data-chat-anchor-key=${JSON.stringify(key)}]{display:none!important}`).join("");
         const count = Array.isArray(shadowedSeqs) ? shadowedSeqs.length : 0;
         const label = op === "recall" ? count > 1 ? t("marker.recallMany", { count }) : t("marker.recallOne") : op === "regenerate" ? t("marker.regenerate") : t("marker.edit");
@@ -522,6 +672,7 @@ return {
             }),
             (0, import_react.createElement)("span", null, t("options.editFromScratch"))
           ]),
+          optionRow("hideShadowed", "options.hideShadowed", "options.hideShadowedDesc"),
           optionRow("versioning", "options.versioning", "options.versioningDesc"),
           optionRow("git", "options.git", "options.gitDesc"),
           (0, import_react.createElement)("div", { key: "retention", className: "dsh-rt-option dsh-rt-option-number" }, [
@@ -584,6 +735,44 @@ return {
       .dsh-rt-retention-input{width:64px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-elevated);border:1px solid var(--dsw-alias-border-l2);border-radius:6px;padding:2px 6px;font:inherit;font-size:13px;outline:none;margin-top:1px}
       .dsh-rt-retention-input:focus{box-shadow:0 0 0 2px var(--dsw-alias-state-business-primary)}
       .dsh-rt-option input{accent-color:var(--dsw-alias-state-business-primary)}
+      /* ---- P1 timeline (conversation view tab) ---- */
+      .dsh-rt-view{box-sizing:border-box;display:flex;flex-direction:column;gap:6px;height:100%;min-height:0;padding:12px 16px 0}
+      .dsh-rt-timeline-head{display:flex;align-items:center;gap:8px;flex:none}
+      .dsh-rt-timeline-title{color:var(--dsw-alias-label-primary);font-size:13px;font-weight:600;line-height:20px;flex:1}
+      .dsh-rt-timeline-git{display:flex;align-items:center;gap:6px;flex:none;border:1px dashed var(--dsw-alias-border-l2);border-radius:8px;padding:4px 8px}
+      .dsh-rt-timeline-git-text{color:var(--dsw-alias-label-caption);font-size:11px;line-height:16px}
+      .dsh-rt-timeline-list{overflow-y:auto;flex:1;min-height:0;position:relative;--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2)}
+      .dsh-rt-timeline-empty{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px;padding:12px 4px;text-align:center}
+      .dsh-rt-version{position:absolute;left:0;right:0;height:60px;box-sizing:border-box;display:flex;align-items:flex-start;gap:8px;border:1px solid transparent;border-radius:10px;padding:6px 8px}
+      .dsh-rt-version:hover{background:var(--dsw-alias-interactive-bg-hover);border-color:var(--dsw-alias-border-l2)}
+      .dsh-rt-version-kind{flex:none;width:22px;height:22px;display:inline-flex;justify-content:center;align-items:center;border-radius:6px;background:var(--dsw-alias-fill-l2);color:var(--dsw-alias-label-secondary);font-size:12px;margin-top:1px}
+      .dsh-rt-version-kind-restore{background:var(--dsw-alias-state-success-bg);color:var(--dsw-alias-state-success-primary)}
+      .dsh-rt-version-kind-compaction{background:var(--dsw-alias-fill-l2);color:var(--dsw-alias-label-caption)}
+      .dsh-rt-version-body{flex:1;min-width:0;display:flex;flex-direction:column;gap:2px}
+      .dsh-rt-version-line{display:flex;align-items:center;gap:8px;min-width:0;white-space:nowrap}
+      .dsh-rt-version-kind-label{color:var(--dsw-alias-label-primary);font-size:12px;font-weight:600;line-height:16px}
+      .dsh-rt-version-time,.dsh-rt-version-msgs{color:var(--dsw-alias-label-tertiary);font-size:11px;line-height:16px}
+      .dsh-rt-version-files{color:var(--dsw-alias-label-caption);font-size:11px;line-height:16px;overflow:hidden;text-overflow:ellipsis}
+      .dsh-rt-version-text{color:var(--dsw-alias-label-secondary);font-size:11px;line-height:15px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+      .dsh-rt-version-actions{flex:none;display:inline-flex;gap:4px;opacity:0;transition:opacity .1s}
+      .dsh-rt-version:hover .dsh-rt-version-actions{opacity:1}
+      .dsh-rt-chip-danger{color:var(--dsw-alias-state-error-primary)}
+      .dsh-rt-chip-danger:hover{color:var(--dsw-alias-state-error-primary)}
+      .dsh-rt-modal{position:absolute;inset:0;z-index:130;display:flex;flex-direction:column;gap:8px;box-sizing:border-box;border-radius:12px;background:var(--dsw-specific-menu);padding:10px;box-shadow:var(--dsw-shadow-lv3)}
+      .dsh-rt-modal-title{display:flex;align-items:center;gap:8px;color:var(--dsw-alias-label-primary);font-size:13px;font-weight:600;line-height:20px}
+      .dsh-rt-modal-sub{color:var(--dsw-alias-label-tertiary);font-size:11px;font-weight:400}
+      .dsh-rt-modal-body{display:flex;flex-direction:column;gap:6px;overflow-y:auto;min-height:0}
+      .dsh-rt-modal-line{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}
+      .dsh-rt-modal-files{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:2px;max-height:160px;overflow-y:auto}
+      .dsh-rt-modal-files li{display:flex;gap:8px;font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary)}
+      .dsh-rt-art-restore{color:var(--dsw-alias-state-success-primary);flex:none}
+      .dsh-rt-art-delete{color:var(--dsw-alias-state-error-primary);flex:none}
+      .dsh-rt-art-skip{color:var(--dsw-alias-label-caption);flex:none}
+      .dsh-rt-art-path{font-family:var(--dsw-font-mono);min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+      .dsh-rt-modal-scope{display:flex;flex-direction:column;gap:4px}
+      .dsh-rt-modal-buttons{display:flex;justify-content:flex-end;gap:8px;flex:none}
+      .dsh-rt-confirm{background:var(--dsw-alias-state-error-primary)}
+      .dsh-rt-modal-json{margin:0;overflow:auto;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-elevated);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:8px;font-family:var(--dsw-font-mono);font-size:11px;line-height:15px;white-space:pre-wrap;word-break:break-all}
       `;
       function ensureStyle() {
         if (typeof document === "undefined") return () => {
@@ -599,10 +788,273 @@ return {
           tag.remove();
         };
       }
+      var KIND_ICONS = { recall: "\u21A9", edit: "\u270E", regenerate: "\u21BB", restore: "\u27F2", compaction: "\u25A4", replace: "\u21C4" };
+      function kindLabel(kind, t) {
+        return t(`timeline.kind.${kind}`) || kind;
+      }
+      function timeLabel(ms) {
+        const date = new Date(ms);
+        return `${date.getMonth() + 1}-${date.getDate()} ${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
+      }
+      function timelineGet(path) {
+        return fetch(`${ROUTE_BASE}${path}`, { headers: retraceConfigHeaders() }).then((res) => {
+          if (res.status < 200 || res.status >= 300) throw new Error(`HTTP ${res.status}`);
+          return res.json();
+        });
+      }
+      function fileCountLabel(counts, t) {
+        const total = (counts?.created ?? 0) + (counts?.modified ?? 0) + (counts?.deleted ?? 0);
+        if (total === 0) return t("timeline.filesNone");
+        return t("timeline.files", {
+          created: counts.created ?? 0,
+          modified: counts.modified ?? 0,
+          deleted: counts.deleted ?? 0
+        });
+      }
+      function RetraceView({ sessionId, useProjection, t, actions, store }) {
+        const [versions, setVersions] = (0, import_react.useState)(null);
+        const [loading, setLoading] = (0, import_react.useState)(false);
+        const [error, setError] = (0, import_react.useState)(null);
+        const [git, setGit] = (0, import_react.useState)(null);
+        const [gitBusy, setGitBusy] = (0, import_react.useState)(false);
+        const [preview, setPreview] = (0, import_react.useState)(null);
+        const [previewScope, setPreviewScope] = (0, import_react.useState)("both");
+        const [rollbackBusy, setRollbackBusy] = (0, import_react.useState)(false);
+        const [scrollTop, setScrollTop] = (0, import_react.useState)(0);
+        const projected = typeof useProjection === "function" ? useProjection("retrace/versions") : void 0;
+        (0, import_react.useEffect)(() => {
+          if (projected && Array.isArray(projected.versions)) setVersions(projected.versions);
+        }, [projected]);
+        const refresh = () => {
+          setLoading(true);
+          setError(null);
+          timelineGet(`/versions?sessionId=${encodeURIComponent(sessionId)}`).then((result) => {
+            if (!result || result.ok !== true) throw new Error(result?.error?.message ?? "versions failed");
+            setVersions(result.value?.versions ?? []);
+          }).catch((cause) => setError(cause?.message ?? "timeline error")).finally(() => setLoading(false));
+        };
+        const refreshGit = () => {
+          if (getConfig().git !== true) return;
+          timelineGet(`/git/status?sessionId=${encodeURIComponent(sessionId)}`).then((result) => setGit(result?.ok === true ? result.value : null)).catch(() => setGit(null));
+        };
+        (0, import_react.useEffect)(() => {
+          if (projected === void 0) refresh();
+          refreshGit();
+        }, []);
+        const JUMP_PAGE_BUDGET = 24;
+        const jump = async (boundarySeq) => {
+          actions?.setView?.("chat");
+          const target = store;
+          if (!target || typeof target.loadOlder !== "function" || typeof target.getSnapshot !== "function") return;
+          const keyOfSeq = (seq) => {
+            const nodes = target.getSnapshot()?.chat?.nodes;
+            if (!nodes) return null;
+            for (const node of nodes.values()) {
+              if (typeof node.anchorSeq === "number" && node.anchorSeq === seq) return node.key;
+            }
+            return null;
+          };
+          let key = keyOfSeq(boundarySeq);
+          let pages = 0;
+          while (key === null && pages < JUMP_PAGE_BUDGET && target.hasMore) {
+            const before = target.getSnapshot()?.chat?.nodes?.size ?? 0;
+            await target.loadOlder();
+            const after = target.getSnapshot()?.chat?.nodes?.size ?? 0;
+            pages += 1;
+            if (after === before) break;
+            key = keyOfSeq(boundarySeq);
+          }
+          if (key === null) {
+            await new Promise((resolve) => setTimeout(resolve, 60));
+            key = keyOfSeq(boundarySeq);
+          }
+          if (key === null) {
+            console.warn(`[dsh-retrace] jump target seq ${boundarySeq} not reached within ${JUMP_PAGE_BUDGET} pages`);
+            return;
+          }
+          const el = await waitForElement(`[data-chat-anchor-key=${JSON.stringify(key)}]`, 90);
+          if (el === null) return;
+          el.scrollIntoView({ behavior: "smooth", block: "center" });
+          flashKey(key);
+        };
+        function waitForElement(selector, frames) {
+          return new Promise((resolve) => {
+            let remaining = frames;
+            const probe = () => {
+              const el = document.querySelector(selector);
+              if (el !== null) return resolve(el);
+              if (remaining-- <= 0) return resolve(null);
+              requestAnimationFrame(probe);
+            };
+            requestAnimationFrame(probe);
+          });
+        }
+        function flashKey(key) {
+          const id = `dsh-rt-jump-${key.replace(/[^a-z0-9]/gi, "-")}`;
+          if (document.querySelector(`style[data-plugin-css="${id}"]`)) return;
+          const tag = document.createElement("style");
+          tag.dataset.pluginCss = id;
+          tag.textContent = `[data-chat-anchor-key=${JSON.stringify(key)}]{animation:dsh-rt-flash 1.6s ease-out 2}@keyframes dsh-rt-flash{0%,100%{background:transparent}30%,70%{background:var(--dsw-alias-state-business-primary)}55%{background:color-mix(in srgb,var(--dsw-alias-state-business-primary) 30%,transparent)}}`;
+          document.head.appendChild(tag);
+          setTimeout(() => tag.remove(), 3400);
+        }
+        const requestPreview = (record) => {
+          setPreviewScope("both");
+          setPreview({ versionId: record.versionId, kind: record.kind, boundarySeq: record.boundarySeq, data: null, error: null });
+          callOp("rollback/preview", { sessionId, versionId: record.versionId, scope: "both" }).then((result) => {
+            setPreview((prev) => prev && prev.versionId === record.versionId ? { ...prev, data: result?.ok === true ? result.value : null, error: result?.ok === true ? null : result?.error?.message ?? null } : prev);
+          });
+        };
+        const confirmRollback = () => {
+          if (!preview) return;
+          setRollbackBusy(true);
+          callOp("rollback", { sessionId, versionId: preview.versionId, scope: previewScope }).then((result) => {
+            setRollbackBusy(false);
+            if (!result || result.ok !== true) {
+              setPreview((prev) => prev && { ...prev, error: result?.error?.message ?? "rollback failed" });
+              return;
+            }
+            setPreview(null);
+            if (projected === void 0) refresh();
+            refreshGit();
+          });
+        };
+        const initGit = () => {
+          if (!window.confirm(t("timeline.gitInitConfirm"))) return;
+          setGitBusy(true);
+          callOp("git/init", { sessionId }).then((result) => {
+            setGitBusy(false);
+            refreshGit();
+          });
+        };
+        const ROW_H = 64;
+        const list = versions ?? [];
+        const visible = list.slice(Math.max(0, Math.floor(scrollTop / ROW_H) - 2), Math.min(list.length, Math.ceil(scrollTop / ROW_H) + Math.ceil(640 / ROW_H) + 2));
+        return (0, import_react.createElement)("div", { className: "dsh-rt-view" }, [
+          (0, import_react.createElement)("div", { key: "head", className: "dsh-rt-timeline-head" }, [
+            (0, import_react.createElement)("span", { key: "title", className: "dsh-rt-timeline-title" }, t("timeline.title")),
+            (0, import_react.createElement)("button", {
+              key: "refresh",
+              type: "button",
+              className: "dsh-rt-chip",
+              onClick: refresh
+            }, t("timeline.refresh"))
+          ]),
+          git !== null && git !== void 0 && (0, import_react.createElement)("div", { key: "git", className: "dsh-rt-timeline-git" }, [
+            git.headHash ? [
+              (0, import_react.createElement)("span", { key: "r", className: "dsh-rt-timeline-git-text" }, `${t("timeline.gitRepo")} \xB7 ${t("timeline.gitHead", { hash: git.headHash.slice(0, 8) })}${git.dirty ? ` \xB7 ${t("timeline.gitDirty")}` : ""}`)
+            ] : (0, import_react.createElement)("button", {
+              key: "init",
+              type: "button",
+              className: "dsh-rt-chip",
+              disabled: gitBusy,
+              onClick: initGit,
+              title: t("timeline.gitInitDesc")
+            }, t("timeline.gitInit"))
+          ]),
+          error !== null && (0, import_react.createElement)("div", { key: "error", className: "dsh-rt-error" }, error),
+          loading && (0, import_react.createElement)("div", { key: "loading", className: "dsh-rt-timeline-empty" }, t("timeline.loading")),
+          !loading && list.length === 0 && (0, import_react.createElement)("div", { key: "empty", className: "dsh-rt-timeline-empty" }, t("timeline.empty")),
+          list.length > 0 && (0, import_react.createElement)("div", {
+            key: "list",
+            className: "dsh-rt-timeline-list",
+            onScroll: (event) => setScrollTop(event.target.scrollTop)
+          }, [
+            (0, import_react.createElement)("div", { key: "spacer", style: { height: `${list.length * ROW_H}px`, position: "relative" } }, [
+              visible.map((record) => (0, import_react.createElement)(VersionRow, {
+                key: record.versionId,
+                record,
+                t,
+                top: list.indexOf(record) * ROW_H,
+                onPreview: () => requestPreview(record),
+                onTrajectory: () => actions?.setView?.("trajectory"),
+                onJump: () => jump(record.boundarySeq)
+              }))
+            ])
+          ]),
+          preview && (0, import_react.createElement)(PreviewBox, {
+            key: "preview",
+            preview,
+            scope: previewScope,
+            setScope: setPreviewScope,
+            busy: rollbackBusy,
+            t,
+            onConfirm: confirmRollback,
+            onCancel: () => setPreview(null)
+          })
+        ]);
+      }
+      function VersionRow({ record, top, t, onPreview, onTrajectory, onJump }) {
+        return (0, import_react.createElement)("div", { className: "dsh-rt-version", style: { top: `${top}px` } }, [
+          (0, import_react.createElement)("span", { key: "kind", className: `dsh-rt-version-kind dsh-rt-version-kind-${record.kind}`, title: kindLabel(record.kind, t) }, KIND_ICONS[record.kind] ?? "\u2022"),
+          (0, import_react.createElement)("div", { key: "body", className: "dsh-rt-version-body" }, [
+            (0, import_react.createElement)("div", { key: "line1", className: "dsh-rt-version-line" }, [
+              (0, import_react.createElement)("span", { key: "kind", className: "dsh-rt-version-kind-label" }, kindLabel(record.kind, t)),
+              (0, import_react.createElement)("span", { key: "time", className: "dsh-rt-version-time" }, timeLabel(record.createdAt)),
+              (0, import_react.createElement)("span", { key: "msgs", className: "dsh-rt-version-msgs" }, t("timeline.messages", { count: record.messageCount })),
+              (0, import_react.createElement)("span", { key: "files", className: "dsh-rt-version-files" }, fileCountLabel(record.fileCounts, t))
+            ]),
+            record.markerText ? (0, import_react.createElement)("div", { key: "text", className: "dsh-rt-version-text" }, record.markerText.length > 120 ? `${record.markerText.slice(0, 120)}\u2026` : record.markerText) : null
+          ]),
+          (0, import_react.createElement)("span", { key: "actions", className: "dsh-rt-version-actions" }, [
+            (0, import_react.createElement)("button", { key: "jump", type: "button", className: "dsh-rt-chip", onClick: onJump }, t("timeline.jump")),
+            (0, import_react.createElement)("button", { key: "trajectory", type: "button", className: "dsh-rt-chip", onClick: onTrajectory, title: t("timeline.trajectory") }, t("timeline.trajectory")),
+            (0, import_react.createElement)("button", { key: "preview", type: "button", className: "dsh-rt-chip dsh-rt-chip-danger", onClick: onPreview }, t("timeline.preview"))
+          ])
+        ]);
+      }
+      function PreviewBox({ preview, scope, setScope, busy, t, onConfirm, onCancel }) {
+        const data = preview.data;
+        const scopes = [
+          ["context", "timeline.contextOnly", "timeline.contextOnlyDesc"],
+          ["artifacts", "timeline.artifactsOnly", "timeline.artifactsOnlyDesc"],
+          ["both", "timeline.both", "timeline.bothDesc"]
+        ];
+        return (0, import_react.createElement)("div", { className: "dsh-rt-modal" }, [
+          (0, import_react.createElement)("div", { key: "title", className: "dsh-rt-modal-title" }, [
+            t("timeline.preview"),
+            (0, import_react.createElement)("span", { key: "ver", className: "dsh-rt-modal-sub" }, t("timeline.previewDesc", { version: preview.versionId, kind: kindLabel(preview.kind, t) }))
+          ]),
+          preview.error && (0, import_react.createElement)("div", { key: "err", className: "dsh-rt-error" }, preview.error),
+          data === null && !preview.error && (0, import_react.createElement)("div", { key: "wait", className: "dsh-rt-timeline-empty" }, t("timeline.loading")),
+          data && (0, import_react.createElement)("div", { key: "body", className: "dsh-rt-modal-body" }, [
+            (0, import_react.createElement)(
+              "div",
+              { key: "ctx", className: "dsh-rt-modal-line" },
+              data.context?.messages > 0 ? t("timeline.messagesRemoved", { count: data.context.messages }) : t("timeline.noChanges")
+            ),
+            (0, import_react.createElement)("div", { key: "art", className: "dsh-rt-modal-line" }, t("timeline.artifactsList", { count: data.artifacts?.rows?.length ?? 0 })),
+            (0, import_react.createElement)("ul", { key: "files", className: "dsh-rt-modal-files" }, (data.artifacts?.rows ?? []).slice(0, 12).map((row) => (0, import_react.createElement)("li", { key: row.path }, [
+              (0, import_react.createElement)(
+                "span",
+                { key: "a", className: `dsh-rt-art-${row.action}` },
+                row.action === "skip" ? `${t("timeline.artifact.skip")} (${row.reason ?? ""})` : row.action === "delete" ? t("timeline.artifact.delete") : t("timeline.artifact.restore")
+              ),
+              (0, import_react.createElement)("span", { key: "p", className: "dsh-rt-art-path" }, row.path)
+            ]))),
+            (0, import_react.createElement)("div", { key: "scope", className: "dsh-rt-modal-scope" }, scopes.map(([value, labelKey, descKey]) => (0, import_react.createElement)("label", { key: value, className: "dsh-rt-option" }, [
+              (0, import_react.createElement)("input", { type: "radio", name: "rt-scope", checked: scope === value, onChange: () => setScope(value) }),
+              (0, import_react.createElement)("span", { className: "dsh-rt-option-text" }, [
+                (0, import_react.createElement)("span", { className: "dsh-rt-option-label" }, t(labelKey)),
+                (0, import_react.createElement)("span", { className: "dsh-rt-option-desc" }, t(descKey))
+              ])
+            ])))
+          ]),
+          (0, import_react.createElement)("div", { key: "buttons", className: "dsh-rt-modal-buttons" }, [
+            (0, import_react.createElement)("button", { key: "cancel", type: "button", className: "dsh-rt-editor-cancel", disabled: busy, onClick: onCancel }, t("timeline.cancel")),
+            (0, import_react.createElement)(
+              "button",
+              { key: "confirm", type: "button", className: "dsh-rt-editor-send dsh-rt-confirm", disabled: busy || preview.error !== null, onClick: onConfirm },
+              busy ? t("timeline.busy") : t("timeline.confirm")
+            )
+          ])
+        ]);
+      }
       function apply(ctx) {
         const disposeStyle = ensureStyle();
         ctx.effect(() => () => disposeStyle(), "dsh-retrace: styles");
         ctx.effect(() => ctx.locale.register(NS, { zh, en }), "dsh-retrace: dictionaries");
+        const t = ctx.locale.bind(NS);
         const conversationEvents = ctx.get("conversationEvents");
         if (conversationEvents) {
           conversationEvents.register(userActionsDefinition);
@@ -630,6 +1082,17 @@ return {
           key: "recall-marker",
           locale: NS
         }, RecallMarkerRow));
+        ctx.slots.inject("conversation.view", () => ctx.slots.register({
+          name: "conversation.view",
+          id: "retrace",
+          order: 20,
+          locale: NS,
+          label: () => t("view.retrace"),
+          inject: (sessionId, actions) => ({
+            actions,
+            store: ctx.get?.("sessions")?.binding?.(sessionId)?.session
+          })
+        }, RetraceView));
         ctx.slots.inject("settings.general.item", () => ctx.slots.register({
           name: "settings.general.item",
           id: "retrace",