codex-overleaf-link 2.4.0 → 2.4.1

package/extension/src/content/runTimelineView.js

@@ -960,12 +960,12 @@
   // same executable state as `pending`.
   function configureLifecycleUndoButton(button, run) {
     const status = run.trackedChangeStatus || '';
+    const inFlight = trackedChangeInFlight.get(run.id);
     const projection = projectRunSettlement(run);
     // §7 settlement matrix: needs_review keeps BOTH controls visible AND
     // actionable. Branch placed before the terminal branches so a
     // needs_review run is never treated as terminal.
     if (status === 'needs_review') {
-      const inFlight = trackedChangeInFlight.get(run.id);
       button.hidden = false;
       button.disabled = !projection.canUndo || inFlight === 'reject' || inFlight === 'accept';
       button.textContent = tr('undoRun');
@@ -976,14 +976,14 @@
       });
       return;
     }
-    if (status === 'rejected') {
+    if (status === 'rejected' && !inFlight) {
       button.hidden = false;
       button.disabled = true;
       button.textContent = tr('undoApplied');
       button.title = tr('undoAppliedTitle');
       return;
     }
-    if (status === 'accepted') {
+    if (status === 'accepted' && !inFlight) {
       // The run was accepted — terminal. Undo stays visible but greyed so the
       // card shows both controls disabled, never removed.
       button.hidden = false;
@@ -992,11 +992,10 @@
       button.title = tr('undoRunTitle');
       return;
     }
-    if (status !== 'pending') {
+    if (status !== 'pending' && !inFlight) {
       button.hidden = true;
       return;
     }
-    const inFlight = trackedChangeInFlight.get(run.id);
     button.hidden = false;
     button.disabled = !projection.canUndo || inFlight === 'reject' || inFlight === 'accept';
     button.textContent = tr('undoRun');
@@ -1034,12 +1033,12 @@
     }
 
     const status = run.trackedChangeStatus || '';
+    const inFlight = trackedChangeInFlight.get(run.id);
     const projection = projectRunSettlement(run);
     // §7 settlement matrix: needs_review keeps BOTH controls visible AND
     // actionable. It remains an internal retryable proof state, while the
     // primary button label stays in the same executable state as `pending`.
     if (status === 'needs_review') {
-      const inFlight = trackedChangeInFlight.get(run.id);
       button.hidden = false;
       button.disabled = !projection.canAccept || inFlight === 'accept' || inFlight === 'reject';
       if (inFlight === 'accept') {
@@ -1052,14 +1051,14 @@
       wireAcceptInlineConfirm(button, run.id);
       return;
     }
-    if (status === 'accepted') {
+    if (status === 'accepted' && !inFlight) {
       button.hidden = false;
       button.disabled = true;
       button.textContent = tr('runAcceptTrackedDone');
       button.title = tr('runAcceptTrackedDoneTitle');
       return;
     }
-    if (status === 'rejected') {
+    if (status === 'rejected' && !inFlight) {
       // The run was rejected — terminal. Accept All stays visible but greyed so
       // the card shows both controls disabled, never removed.
       button.hidden = false;
@@ -1068,12 +1067,11 @@
       button.title = tr('runAcceptTrackedTitle');
       return;
     }
-    if (status !== 'pending') {
+    if (status !== 'pending' && !inFlight) {
       button.hidden = true;
       return;
     }
 
-    const inFlight = trackedChangeInFlight.get(run.id);
     button.hidden = false;
     button.disabled = !projection.canAccept || inFlight === 'accept' || inFlight === 'reject';
     if (inFlight === 'accept') {

package/extension/src/content/scopedPersistenceCoordinator.js

@@ -95,6 +95,7 @@
   }
   return Object.freeze({
     createController: createController,
-    persistPanelState: PanelState?.persistPanelState || null
+    persistPanelState: PanelState?.persistPanelState || null,
+    applyReviewTransition: PanelState?.applyReviewTransition || null
   });
 });

package/extension/src/content/scopedPersistencePanelState.js

@@ -15,6 +15,42 @@
     return JSON.parse(JSON.stringify(value));
   }
 
+  async function applyReviewTransition({ getState, runId, transition, persist }) {
+    const targets = () => Array.from(new Set([
+      ...(getState().runs || []),
+      ...(getState().sessions || []).flatMap(session => session.runs || [])
+    ])).filter(run => run.id === runId);
+    const records = targets();
+    const sessions = (getState().sessions || []).filter(session =>
+      (session.runs || []).some(run => run.id === runId));
+    if (!records.length || !sessions.length) throw reviewPersistenceError();
+    const previous = cloneSnapshot(records[0]);
+    for (const record of records) Object.assign(record, cloneSnapshot(transition));
+    for (const session of sessions) {
+      session.updatedAt = new Date(Math.max(Date.now(), (Date.parse(session.updatedAt) || 0) + 1,
+        (Date.parse(session.lastActivityAt) || 0) + 1)).toISOString();
+      session.lastActivityAt = session.updatedAt;
+    }
+    try {
+      await persist({ preserveRunActionPayload: true, reviewRunIds: [runId] });
+    } catch (error) {
+      // The remote action may have succeeded. Keep its recovery data and expose uncertainty.
+      for (const record of targets()) {
+        Object.assign(record, cloneSnapshot(previous), { trackedChangeStatus: 'needs_review' });
+        for (const field of ['settlement', 'settlementFacts']) {
+          if (!Object.prototype.hasOwnProperty.call(previous, field)) delete record[field];
+        }
+      }
+      throw error;
+    }
+  }
+
+  function reviewPersistenceError() {
+    return Object.assign(new Error('The review outcome was not durably saved. Check Overleaf before retrying.'), {
+      code: 'review_state_not_persisted'
+    });
+  }
+
   async function persistPanelState(input) {
     var state = cloneSnapshot(input.state || {});
     var compactState = cloneSnapshot(input.compactState || {});
@@ -35,6 +71,9 @@
         code: 'stale_view'
       });
     }
+    var reviewRuns = (input.reviewRunIds || []).map(id =>
+      (state.sessions || []).flatMap(session => session.runs || []).find(run => run.id === id));
+    if (reviewRuns.some(run => !run)) throw reviewPersistenceError();
     var latestPrefs = typeof Migration.loadPrefs === 'function'
       ? await Migration.loadPrefs(accountScopeId, projectId)
       : {};
@@ -94,18 +133,22 @@
           .filter(function (item) { return !queueTombstones[item?.id]; })
       }), { preserveRunActionPayload: true });
     });
-    await input.SessionPersistence.writeSessions({
+    var written = await input.SessionPersistence.writeSessions({
       Migration: Migration,
       StorageDb: StorageDb,
       projectId: projectId,
       accountScopeId: accountScopeId,
       deletedSessionIds: deletedSessionIds,
       sessionRecords: sessionRecords,
+      reviewRunIds: input.reviewRunIds,
       queueClaims: persistenceMeta.queueClaims || {},
       queueTombstones: queueTombstones,
       writerId: input.persistenceContext?.writerId || ''
     });
+    if (!reviewRuns.every(reviewRun => (written || []).some(session => (session.runs || []).some(run =>
+      run.id === reviewRun.id && run.trackedChangeStatus === reviewRun.trackedChangeStatus
+    )))) throw reviewPersistenceError();
   }
 
-  return Object.freeze({ persistPanelState: persistPanelState });
+  return Object.freeze({ persistPanelState: persistPanelState, applyReviewTransition: applyReviewTransition });
 });

package/extension/src/content/sessionPersistence.js

@@ -73,7 +73,10 @@
     const existingById = new Map(existingSessions
       .filter(record => !deleted.has(record.id))
       .map(record => [record.id, record]));
-    const writable = sessionRecords.filter(record => {
+    const mergedRecords = sessionRecords.map(record => StorageDb.mergeSessionReviewState?.(
+      record, existingById.get(record.id), options.reviewRunIds
+    ) || record);
+    const writable = mergedRecords.filter(record => {
       const existing = existingById.get(record.id);
       if (!existing) return true;
       return (Date.parse(record.updatedAt || '') || 0) >= (Date.parse(existing.updatedAt || '') || 0);

package/extension/src/content/settingsPanel.js

@@ -38,8 +38,8 @@
         <div class="codex-custom-instructions-head">
           <button type="button" data-settings-back title="Back" aria-label="Back">‹</button>
           <div>
-            <div class="codex-custom-instructions-title" data-i18n="projectSettingsTitle">Project Settings</div>
-            <div class="codex-custom-instructions-subtitle" data-i18n="projectSettingsSubtitle">Customize how Codex behaves in this and all projects.</div>
+            <div class="codex-custom-instructions-title" data-settings-title data-i18n="projectSettingsTitle">Project Settings</div>
+            <div class="codex-custom-instructions-subtitle" data-settings-subtitle data-i18n="projectSettingsSubtitle">Customize how Codex behaves in this and all projects.</div>
           </div>
         </div>
         <div class="codex-project-settings-status" data-project-settings-status></div>
@@ -304,6 +304,7 @@
     if (!root) {
       return;
     }
+    refreshSettingsScope(instance, root);
     const button = getButton(instance);
     if (button) {
       button.dataset.active = 'true';
@@ -312,6 +313,18 @@
     root.querySelector('[data-custom-instructions-input]')?.focus?.();
   }
 
+  function refreshSettingsScope(instance, root) {
+    const accountScope = instance.container?.closest?.('[data-settings-scope]')?.dataset?.settingsScope === 'account';
+    const prefix = accountScope ? 'recentProjects_settings' : 'projectSettings';
+    for (const [selector, suffix] of [['[data-settings-title]', 'Title'], ['[data-settings-subtitle]', 'Subtitle']]) {
+      const label = root.querySelector(selector);
+      if (!label) continue;
+      const key = prefix + suffix;
+      label.setAttribute('data-i18n', key);
+      label.textContent = t(instance, key);
+    }
+  }
+
   function hide(target) {
     const instance = target?._instance || target;
     const root = getRoot(instance);
@@ -346,6 +359,7 @@
     if (!root) {
       return;
     }
+    refreshSettingsScope(instance, root);
     if (Object.prototype.hasOwnProperty.call(state, 'customInstructions')) {
       const input = root.querySelector('[data-custom-instructions-input]');
       if (input) {

package/extension/src/page/saveState.js

@@ -288,5 +288,48 @@
     };
   }
 
-  root.CodexOverleafSaveState = { create };
+  async function confirmReviewWriteback({ params, result, readSnapshot, getProjectId, delay,
+    now = Date.now, timeoutMs = 45000 }) {
+    if (result?.ok !== true || result.skipped?.length) return result;
+    const expected = new Map((params.expectedFiles || [])
+      .filter(file => file?.path && typeof file.content === 'string').map(file => [file.path, file.content]));
+    for (const entry of result.applied || []) {
+      const path = entry.trackedChange?.path || entry.operation?.path;
+      if (expected.has(path) && typeof entry.result?.verifiedContent === 'string') {
+        expected.set(path, entry.result.verifiedContent);
+      }
+    }
+    const deadline = now() + Math.max(0, timeoutMs);
+    let attempts = 0;
+    if (expected.size && typeof readSnapshot === 'function') {
+      do {
+        if (!params.runProjectId || getProjectId() !== params.runProjectId) break;
+        try {
+          const snapshot = await readSnapshot({ force: true, maxAgeMs: 0,
+            zipTimeoutMs: Math.max(1, Math.min(8000, deadline - now())) });
+          attempts++;
+          if (getProjectId() !== params.runProjectId) break;
+          if (snapshot?.ok === true && Array.from(expected).every(([path, content]) =>
+            snapshot.files?.some(file => file.path === path && file.source === 'overleaf-zip'
+              && file.content === content))) {
+            return { ...result, saveVerification: { ok: true, state: 'verified_saved',
+              source: 'overleaf-zip', attempts } };
+          }
+        } catch (_error) { /* A transient download failure grants no save proof. */ }
+        if (now() >= deadline) break;
+        await delay(Math.min(300, deadline - now()));
+      } while (now() < deadline);
+    }
+    const reason = 'Undo changed the editor, but its saved server content could not be confirmed. Keep this page open and check Overleaf before retrying.';
+    return { ...result, ok: false, saveVerification: { ok: false, state: 'unknown_timeout', attempts },
+      skipped: [...(result.skipped || []), { trackedChange: { path: expected.keys().next().value || '' },
+        result: { ok: false, code: 'undo_not_verified', reason, failure: {
+          code: 'undo_not_verified', stage: 'verification', severity: 'needs_review',
+          terminalState: 'needs_review', changedDocument: true, retryable: true, userMessage: reason
+        } } }] };
+  }
+
+  const api = { create, confirmReviewWriteback };
+  root.CodexOverleafSaveState = api;
+  if (typeof module === 'object' && module.exports) module.exports = api;
 })(typeof window !== 'undefined' ? window : globalThis);

package/extension/src/page/trackedChangesLifecycle.js

@@ -1630,7 +1630,10 @@
   }
     return {
       acceptTrackedChanges,
-      rejectTrackedChanges,
+      rejectTrackedChanges: async params => {
+        const result = await rejectTrackedChanges(params);
+        return deps.confirmReviewWriteback ? deps.confirmReviewWriteback(params, result) : result;
+      },
       collectTrackedChangeRefsForPaths,
       prepareTrackedChangeCapture, getTrackedChangeCaptureStatus,
       captureTrackedWrite,

package/extension/src/page/treeOperations.js

@@ -1052,7 +1052,7 @@
       return labelPath;
     }
 
-    const textPath = normalizeProjectPathCandidate(node.textContent || '');
+    const textPath = normalizeProjectPathCandidate(readFileTreeNodeText(node));
     if (!textPath) {
       const docIdPath = resolveProjectPathFromDomDocId(node);
       const domTreePath = resolveProjectPathFromDomTree(node);
@@ -1181,7 +1181,7 @@
       node.getAttribute?.('data-name'),
       node.getAttribute?.('aria-label'),
       node.getAttribute?.('title'),
-      node.textContent || ''
+      readFileTreeNodeText(node)
     ];
     for (const value of candidates) {
       const path = normalizeProjectPathCandidate(value);
@@ -1244,21 +1244,12 @@
   }
 
   function normalizeProjectPathCandidate(value) {
-    const text = normalizeDomText(value);
+    const text = String(value || '').trim();
     if (!text || hasMultipleTextPathExtensions(text)) {
       return '';
     }
-    const candidates = [
-      stripOverleafIconAffixes(text),
-      text
-    ];
-    for (const candidate of candidates) {
-      const normalized = normalizeSafeProjectPath(candidate);
-      if (normalized && window.CodexOverleafProjectFiles.isTextProjectPath(normalized)) {
-        return normalized;
-      }
-    }
-    return '';
+    const normalized = normalizeSafeProjectPath(text);
+    return normalized && window.CodexOverleafProjectFiles.isTextProjectPath(normalized) ? normalized : '';
   }
 
   function normalizeDomText(value) {
@@ -1275,19 +1266,11 @@
     return false;
   }
 
-  function stripOverleafIconAffixes(value) {
-    let text = normalizeDomText(value);
-    for (let index = 0; index < 4; index += 1) {
-      const next = text
-        .replace(/^(?:description|article|book_5|insert_drive_file|draft|text_snippet|note|chevron_right|expand_more|folder_open|folder)+/i, '')
-        .replace(/(?:more_vert\s*Menu|more_vert|Menu)$/i, '')
-        .trim();
-      if (next === text) {
-        break;
-      }
-      text = next;
-    }
-    return text;
+  function readFileTreeNodeText(node) {
+    // Icon ligatures can be valid filename prefixes; use the actual label.
+    const names = Array.from(node.querySelectorAll?.('.item-name') || []);
+    if (names.length > 1) return '';
+    return names.length === 1 ? names[0].textContent || '' : node.textContent || '';
   }
 
   function inferPathFromTreeAncestors(node, fileName) {

package/extension/src/page/writebackRouter.js

@@ -1890,7 +1890,7 @@
       captureTrackedWrite, reconcileTrackedChangeCapture,
       waitForTrackedChangeDiff
     } = trackedChangesLifecycleModule.create({
-      window,
+      window, confirmReviewWriteback: deps.confirmReviewWriteback,
       checkWritebackRunProjectId,
       buildNoTraceUndoBlockedResult,
       buildReviewingRequiredBlockedResult,

package/extension/src/pageBridge.js

@@ -93,6 +93,9 @@
     window
   });
   writebackRouter = requirePageModule('CodexOverleafWritebackRouter').create({
+    confirmReviewWriteback: (params, result) => requirePageModule('CodexOverleafSaveState').confirmReviewWriteback({
+      params, result, getProjectId, delay, readSnapshot: options => snapshotRouter.fetchProjectZipSnapshot(options)
+    }),
     createTextFile: textFileCreator.createFile,
     deleteTextFile: textFileCreator.deleteFile,
     activeEditorIdentityChanged,

package/extension/src/shared/compatibility.js

@@ -12,7 +12,7 @@
   const MIN_NATIVE_VERSION = '1.0.0';
   const MIN_COMPATIBLE_NATIVE_VERSION = '1.0.0';
   const MIN_COMPATIBLE_EXTENSION_VERSION = '1.0.0';
-  const BUILD_TARGET_VERSION = '2.4.0';
+  const BUILD_TARGET_VERSION = '2.4.1';
   const DEFAULT_CHROME_EXTENSION_ID = 'illdpneeeopfffmiepaejglgmhpmdhdc';
   const REQUIRED_CAPABILITIES = Object.freeze([
     'bridgePing',

package/extension/src/shared/i18n.js

@@ -508,14 +508,39 @@
       failureReason_editor_project_id_unavailable_next: 'Refresh the Overleaf tab and retry; if it persists, reload the extension.',
       // Welcome-panel + write-guard: Recent-projects
       // variant copy. Spec §5.3–§5.5, §5.8, §5.10 are the source of truth.
-      recentProjects_welcome: 'Codex Overleaf Link',
-      recentProjects_welcome_subtitle: 'Open a project from the Overleaf list on the left to start.',
-      recentProjects_empty: "You haven't run any Codex sessions yet. Open a project from the Overleaf list on the left to start.",
-      recentProjects_sessions_empty: 'No sessions in this project yet',
-      recentProjects_sessions_toggle: "Show / manage this project's sessions",
-      recentProjects_sessions_action: 'View runs',
-      recentProjects_sessions_action_open: 'Hide runs',
-      recentProjects_clearProject: 'Delete all sessions for this project',
+      recentProjects_welcome: 'Continue working',
+      recentProjects_focusEyebrow: 'Last conversation',
+      recentProjects_historyHeading: 'Other recent conversations',
+      recentProjects_historyHint: 'Select to continue',
+      recentProjects_projectConversations: "View this project's conversations",
+      recentProjects_allProjects: 'All projects',
+      recentProjects_showAllConversations: 'View all {count} conversations',
+      recentProjects_unstarted: 'Not started \u00b7 {count}',
+      recentProjects_unstartedHint: 'Empty conversations are kept here, without deleting their records.',
+      recentProjects_noStarted: 'No conversation has been started yet. Empty conversations are available below.',
+      recentProjects_savedDraft: 'Saved draft, ready to continue.',
+      recentProjects_attention: 'Needs attention',
+      recentProjects_unavailableRecords: 'Records with unavailable project links',
+      recentProjects_loadingHistory: 'Loading conversations...',
+      recentProjects_loadFailed: 'Conversation history could not be read. Please retry.',
+      recentProjects_continueHint: 'Open this conversation without automatically starting a task.',
+      recentProjects_more: 'More options',
+      recentProjects_continue: 'Continue',
+      recentProjects_openProject: 'Open project',
+      recentProjects_loadingConversation: 'Loading conversation...',
+      recentProjects_noConversation: 'No saved conversation',
+      recentProjects_noRuns: 'No runs yet',
+      recentProjects_previewUnavailable: 'Conversation unavailable',
+      recentProjects_previewUnavailableHint: 'Saved conversation could not be loaded.',
+      recentProjects_conversationGone: 'This conversation is no longer available. Choose another conversation from the refreshed list.',
+      recentProjects_continueFailed: 'Could not open the conversation. Please try again.',
+      recentProjects_welcome_subtitle: 'Conversations saved in this browser',
+      recentProjects_empty: 'No conversations saved in this browser yet. Open an Overleaf project and start a Codex conversation.',
+      recentProjects_sessions_empty: 'No saved conversations in this project',
+      recentProjects_sessions_toggle: "Show or manage this project's conversations",
+      recentProjects_sessions_action: 'All conversations',
+      recentProjects_sessions_action_open: 'Hide conversations',
+      recentProjects_clearProject: 'Delete this project\'s conversations',
       recentProjects_clearProject_title: 'Delete all Codex sessions for {project}?',
       recentProjects_clearProject_message: 'This permanently deletes all {count} plugin sessions, run history, and matching plugin-local Codex thread history for {project}. It will not modify Overleaf files or global Codex history.',
       recentProjects_clearProject_confirm: 'Delete all',
@@ -531,15 +556,17 @@
       recentProjects_degraded: 'Sign in to Overleaf to see your recent Codex projects.',
       recentProjects_row_projectLinkUnavailable: 'Project link unavailable.',
       recentProjects_settings_entry: 'Settings & Diagnostics',
-      recentProjects_badge_pending: 'pending',
-      recentProjects_badge_accepted: 'accepted',
-      recentProjects_badge_rejected: 'rejected',
-      recentProjects_badge_needs_review: 'pending',
-      recentProjects_badge_running: 'running',
-      recentProjects_badge_completed: 'completed',
-      recentProjects_badge_failed: 'failed',
-      recentProjects_badge_interrupted: 'interrupted',
-      recentProjects_badge_stale: 'stale',
+      recentProjects_settingsTitle: 'General Settings',
+      recentProjects_settingsSubtitle: 'Manage Codex preferences and local history across all projects.',
+      recentProjects_badge_pending: 'Last run pending',
+      recentProjects_badge_accepted: 'Last changes accepted',
+      recentProjects_badge_rejected: 'Last changes undone',
+      recentProjects_badge_needs_review: 'Last run needs review',
+      recentProjects_badge_running: 'Last recorded as running',
+      recentProjects_badge_completed: 'Last run completed',
+      recentProjects_badge_failed: 'Last run failed',
+      recentProjects_badge_interrupted: 'Last run may have been interrupted',
+      recentProjects_badge_stale: 'Last run status unconfirmed',
       recentProjects_unnamed: 'Project \u00b7 {prefix}',
       recentProjects_zombieRunningNote: 'Marked as running, but it may be a leftover from an interrupted run.',
       recentProjects_zombieDeleteConfirm: 'This session is marked as running. If no other tab is actually running it, you can delete it anyway.',
@@ -547,9 +574,9 @@
       recentProjects_degraded_hint: 'Could not identify the Overleaf account on this page, so the project list is hidden to avoid mixing accounts. This usually resolves on a reload.',
       recentProjects_sessionsCount: '{count} session(s)',
       recentProjects_welcome_stats: '{projects} projects \u00b7 {sessions} Codex sessions',
-      recentProjects_badge_background_completed: 'completed in background',
-      recentProjects_badge_needs_review_after_navigation: 'pending',
-      recentProjects_badge_abandoned_after_navigation: 'abandoned'
+      recentProjects_badge_background_completed: 'Last run completed in background',
+      recentProjects_badge_needs_review_after_navigation: 'Last run needs review',
+      recentProjects_badge_abandoned_after_navigation: 'Last run stopped after navigation'
     },
     zh: {
       resizePanel: '拖动调整 Codex 面板宽度，双击恢复默认宽度',
@@ -1047,14 +1074,39 @@
       failureReason_editor_project_id_unavailable_next: '请刷新 Overleaf 页面后重试；如果仍然失败，请重新加载扩展。',
       // Welcome-panel + write-guard: Recent-projects
       // variant copy. 见 spec §5.3–§5.5、§5.8、§5.10。
-      recentProjects_welcome: 'Codex Overleaf Link',
-      recentProjects_welcome_subtitle: '从左侧 Overleaf 项目列表中打开任意项目即可开始。',
-      recentProjects_empty: '你还没有运行过 Codex 会话。从左侧 Overleaf 项目列表中打开任意项目即可开始。',
-      recentProjects_sessions_empty: '该项目还没有会话',
-      recentProjects_sessions_toggle: '查看/管理该项目的会话',
-      recentProjects_sessions_action: '查看会话',
-      recentProjects_sessions_action_open: '收起会话',
-      recentProjects_clearProject: '删除该项目的全部会话',
+      recentProjects_welcome: '继续工作',
+      recentProjects_focusEyebrow: '上次对话',
+      recentProjects_historyHeading: '其他最近对话',
+      recentProjects_historyHint: '点击条目继续',
+      recentProjects_projectConversations: '查看该项目的全部对话',
+      recentProjects_allProjects: '所有项目',
+      recentProjects_showAllConversations: '查看全部 {count} 段对话',
+      recentProjects_unstarted: '未开始 · {count}',
+      recentProjects_unstartedHint: '空白对话收纳在这里，记录不会被删除。',
+      recentProjects_noStarted: '尚无已开始的对话，空白对话可在下方展开。',
+      recentProjects_savedDraft: '草稿已保存，可继续补充。',
+      recentProjects_attention: '需要查看',
+      recentProjects_unavailableRecords: '项目链接不可用的记录',
+      recentProjects_loadingHistory: '正在加载对话…',
+      recentProjects_loadFailed: '暂时无法读取对话历史，请重试。',
+      recentProjects_continueHint: '仅打开这段对话，不会自动启动任务。',
+      recentProjects_more: '更多选项',
+      recentProjects_continue: '继续',
+      recentProjects_openProject: '打开项目',
+      recentProjects_loadingConversation: '正在加载对话…',
+      recentProjects_noConversation: '暂无保存的对话',
+      recentProjects_noRuns: '尚未运行任务',
+      recentProjects_previewUnavailable: '暂时无法读取对话',
+      recentProjects_previewUnavailableHint: '已保存的对话暂时无法读取。',
+      recentProjects_conversationGone: '该对话已不可用，请从更新后的列表中选择其他对话。',
+      recentProjects_continueFailed: '暂时无法打开对话，请重试。',
+      recentProjects_welcome_subtitle: '当前浏览器保存的对话',
+      recentProjects_empty: '当前浏览器还没有保存的对话。打开一个 Overleaf 项目，与 Codex 开始对话即可。',
+      recentProjects_sessions_empty: '该项目还没有保存的对话',
+      recentProjects_sessions_toggle: '查看或管理该项目的对话',
+      recentProjects_sessions_action: '全部对话',
+      recentProjects_sessions_action_open: '收起对话',
+      recentProjects_clearProject: '删除该项目的全部对话',
       recentProjects_clearProject_title: '删除 {project} 的全部 Codex 会话？',
       recentProjects_clearProject_message: '这会永久删除 {project} 的全部 {count} 个插件会话、运行历史及对应的插件本地 Codex 线程历史。不会修改 Overleaf 文件或全局 Codex 历史。',
       recentProjects_clearProject_confirm: '全部删除',
@@ -1070,15 +1122,17 @@
       recentProjects_degraded: '请登录 Overleaf 后查看你最近的 Codex 项目。',
       recentProjects_row_projectLinkUnavailable: '项目链接不可用。',
       recentProjects_settings_entry: '设置与诊断',
-      recentProjects_badge_pending: '待处理',
-      recentProjects_badge_accepted: '已接受',
-      recentProjects_badge_rejected: '已撤回',
-      recentProjects_badge_needs_review: '待处理',
-      recentProjects_badge_running: '运行中',
-      recentProjects_badge_completed: '已完成',
-      recentProjects_badge_failed: '失败',
-      recentProjects_badge_interrupted: '已中断',
-      recentProjects_badge_stale: '久未处理',
+      recentProjects_settingsTitle: '通用设置',
+      recentProjects_settingsSubtitle: '管理适用于所有项目的 Codex 偏好设置与本地历史记录。',
+      recentProjects_badge_pending: '上次运行待处理',
+      recentProjects_badge_accepted: '上次修改已接受',
+      recentProjects_badge_rejected: '上次修改已撤回',
+      recentProjects_badge_needs_review: '上次运行需要检查',
+      recentProjects_badge_running: '上次记录为运行中',
+      recentProjects_badge_completed: '上次运行已完成',
+      recentProjects_badge_failed: '上次运行失败',
+      recentProjects_badge_interrupted: '上次运行可能已中断',
+      recentProjects_badge_stale: '上次运行状态未确认',
       recentProjects_unnamed: '项目 · {prefix}',
       recentProjects_zombieRunningNote: '标记为运行中，但可能是被中断后的残留。',
       recentProjects_zombieDeleteConfirm: '该会话标记为运行中。如果确认没有其他标签页在运行它，可以直接删除。',
@@ -1086,9 +1140,9 @@
       recentProjects_degraded_hint: '无法识别本页的 Overleaf 账号，为避免账号间串数据已隐藏项目列表。通常刷新即可恢复。',
       recentProjects_sessionsCount: '{count} 个会话',
       recentProjects_welcome_stats: '{projects} 个项目 · {sessions} 个 Codex 会话',
-      recentProjects_badge_background_completed: '后台已完成',
-      recentProjects_badge_needs_review_after_navigation: '待处理',
-      recentProjects_badge_abandoned_after_navigation: '已中止'
+      recentProjects_badge_background_completed: '上次运行已在后台完成',
+      recentProjects_badge_needs_review_after_navigation: '上次运行需要检查',
+      recentProjects_badge_abandoned_after_navigation: '上次运行已在离开页面后停止'
     }
   };
 

package/extension/src/shared/storageDb.js

@@ -1343,6 +1343,7 @@
     clearStore: clearStore,
     clearAllStores: clearAllStores,
     buildSessionRecord: buildSessionRecord,
+    mergeSessionReviewState: StorageRunActions.mergeSessionReviewState,
     buildTurnRecord: buildTurnRecord,
     buildEventRecord: buildEventRecord,
     buildArtifactRecord: buildArtifactRecord,

package/extension/src/shared/storageRunActions.js

@@ -159,6 +159,49 @@
     return out;
   }
 
+  // Review terminal states are monotonic even when a later session snapshot is stale.
+  function mergeSessionReviewState(incoming, existing, reviewRunIds) {
+    if (!existing || incoming.id !== existing.id || incoming.projectId !== existing.projectId
+      || !incoming.accountScopeId || incoming.accountScopeId !== existing.accountScopeId) return incoming;
+    var terminal = run => ['accepted', 'rejected'].includes(run?.trackedChangeStatus);
+    var incomingRuns = new Map((incoming.runs || []).map(run => [run.id, run]));
+    var existingRuns = new Map((existing.runs || []).map(run => [run.id, run]));
+    var requestedIds = new Set(reviewRunIds || []);
+    var explicitReview = Array.from(requestedIds).some(id =>
+      ['accepted', 'rejected', 'needs_review'].includes(incomingRuns.get(id)?.trackedChangeStatus));
+    var newer = (Date.parse(incoming.updatedAt) || 0) >= (Date.parse(existing.updatedAt) || 0);
+    if (!newer && !explicitReview) return incoming;
+    var base = newer ? incoming : existing;
+    var fields = ['trackedChangeStatus', 'undoStatus', 'undoTrackedChanges', 'undoExpectedFiles',
+      'undoOperations', 'undoBaseFiles', 'appliedOperations', 'trackedChangeCaptures', 'settlement', 'settlementFacts'];
+    var changed = false;
+    var runs = (base.runs || []).map(function (run) {
+      var previous = existingRuns.get(run.id), candidate = incomingRuns.get(run.id);
+      // Never revive a removed run or change the first durably recorded review decision.
+      var source = terminal(previous) ? previous
+        : explicitReview && requestedIds.has(run.id) ? candidate : null;
+      if (!source || source === run) return run;
+      if (source.runProjectId && source.runProjectId !== incoming.projectId) return run;
+      var merged = { ...run };
+      for (var field of fields) {
+        if (Object.prototype.hasOwnProperty.call(source, field)) {
+          merged[field] = JSON.parse(JSON.stringify(source[field]));
+        } else {
+          delete merged[field];
+        }
+      }
+      changed = true;
+      return merged;
+    });
+    if (!changed) return base;
+    var merged = { ...base, runs };
+    if (explicitReview && !newer) {
+      merged.updatedAt = new Date(Math.max(Date.now(), Date.parse(existing.updatedAt) || 0,
+        Date.parse(incoming.updatedAt) || 0) + 1).toISOString();
+    }
+    return merged;
+  }
+
   function hashString(value) {
     var hash = 2166136261;
     var text = String(value || '');
@@ -171,6 +214,7 @@
 
   return {
     compactStructuredEventValue: compactStructuredEventValue,
+    mergeSessionReviewState: mergeSessionReviewState,
     compactRunsForStorage: compactRunsForStorage,
     compactRunActionPayload: compactRunActionPayload,
     compactProviderSnapshot: compactProviderSnapshot,