codex-overleaf-link 2.4.1 → 2.5.0

package/extension/src/shared/agentTranscript.js

@@ -372,6 +372,7 @@
         status: 'running',
         streamKey: getCodexStreamKey(method, params),
         streamRole: method === 'item/agentMessage/delta' ? 'assistant' : 'reasoning',
+        streamPhase: params.phase || '',
         appendText: true
       };
     }
@@ -412,12 +413,13 @@
       };
     }
     if (method === 'warning' || method === 'guardianWarning' || method === 'configWarning') {
-      const title = cleanVisibleText(params.message || params.warning || '');
+      const title = cleanVisibleText(params.message || params.warning || params.summary || '');
+      if (!title) return technicalOnly(event, locale);
       return {
         kind: 'activity',
         visible: true,
-        title: title || textFor(locale, 'Codex 返回了一条运行提示。', 'Codex returned a runtime notice.'),
-        status: 'running',
+        title,
+        status: event.status === 'failed' ? 'failed' : method === 'guardianWarning' ? 'warning' : 'info',
         technicalDetail: normalizeRawEvent(event)
       };
     }
@@ -459,6 +461,7 @@
           status,
           streamKey: getItemStreamKey('agent', item),
           streamRole: 'assistant',
+          streamPhase: item.phase || '',
           replaceText: true
         };
       }
@@ -500,6 +503,10 @@
         status,
         detail: {
           command: item.command,
+          itemId: item.id,
+          threadId: event.detail?.params?.threadId,
+          turnId: event.detail?.params?.turnId,
+          commandActions: item.commandActions,
           output: item.aggregatedOutput,
           exitCode: item.exitCode
         }
@@ -863,6 +870,11 @@
         : textFor(locale, '本轮没有可撤销的写入', 'this run has no reversible writes');
     }
 
+    if (input.saveVerification && input.saveVerification.state !== 'not_checked') {
+      report.saveState = input.saveVerification.state === 'verified_saved'
+        ? textFor(locale, '已确认保存', 'Saved')
+        : textFor(locale, '待确认，可检查保存状态', 'Pending confirmation; check save status');
+    }
     const failed = input.status === 'failed' || input.status === 'blocked';
     return {
       title: textFor(locale, '本轮完成报告', 'Task report'),
@@ -946,6 +958,7 @@
       });
     }
 
+    if (report.saveState) meta.push({ key: 'saveState', label: textFor(locale, '保存', 'Save'), value: report.saveState });
     return { conclusion, body: bodySections.join('\n\n'), meta };
   }
 
@@ -976,6 +989,7 @@
     if (nextStep) {
       sections.push(textFor(locale, `下一步：${nextStep}`, `Next: ${nextStep}`));
     }
+    if (report.saveState) sections.push(textFor(locale, `保存：${report.saveState}`, `Save: ${report.saveState}`));
     return sections.join('\n\n');
   }
 
@@ -1045,7 +1059,7 @@
     if (input.mode === 'ask' || input.status === '只问不改') {
       return textFor(locale, '这轮是只问不改。', 'This run was Ask mode.');
     }
-    if (input.status === 'rejected') {
+    if (input.status === 'cancelled' || input.status === 'rejected') {
       return textFor(locale, '你取消了这轮修改。', 'You cancelled this change.');
     }
     return '';

package/extension/src/shared/auditRecords.js

@@ -75,6 +75,7 @@
       mirror: summarizeMirror(input.mirror),
       auditLogs: summarizeAuditLogList(input.auditLogs),
       run: summarizeRun(input.run),
+      ...(Array.isArray(input.recentRuns) ? { recentRuns: input.recentRuns.slice(0, 8).map(summarizeRun) } : {}),
       governance: summarizeGovernance(input.governance),
       projectIdHash: hashString(stringField(input.projectId))
     };
@@ -272,9 +273,22 @@
   }
 
   function summarizeRun(run = {}) {
+    run = run && typeof run === 'object' && !Array.isArray(run) ? run : {};
+    const captures = Array.isArray(run.trackedChangeCaptures) ? run.trackedChangeCaptures : [];
     return removeEmptySummaryFields({
       id: redactSecretLikeText(stringField(run.id)),
       status: redactSecretLikeText(stringField(run.status)),
+      startedAt: redactSecretLikeText(stringField(run.startedAt)),
+      finishedAt: redactSecretLikeText(stringField(run.finishedAt)),
+      requireReviewing: typeof run.executionSnapshot?.requireReviewing === 'boolean'
+        ? run.executionSnapshot.requireReviewing : undefined,
+      trackedChangeStatus: diagnosticToken(run.trackedChangeStatus),
+      undoStatus: diagnosticToken(run.undoStatus),
+      appliedOperationCount: Array.isArray(run.appliedOperations) ? run.appliedOperations.length : undefined,
+      undoTrackedChangeCount: Array.isArray(run.undoTrackedChanges) ? run.undoTrackedChanges.length : undefined,
+      captureCount: Array.isArray(run.trackedChangeCaptures) ? captures.length : undefined,
+      capturesTruncated: captures.length > 20 ? true : undefined,
+      trackedChangeCaptures: captures.slice(0, 20).map(summarizeTrackedCapture),
       errorCode: redactSecretLikeText(stringField(run.errorCode)),
       errorCategory: categorizeError(run.errorCode || run.message || run.error),
       events: (Array.isArray(run.events) ? run.events : []).map(event => removeEmptyFields({
@@ -287,6 +301,63 @@
     });
   }
 
+  // Export only proof metadata, never document text, prompts, labels or raw IDs.
+  function diagnosticToken(value) {
+    const text = redactSecretLikeText(stringField(value));
+    return /^[a-z][a-z0-9_]{0,79}$/.test(text) ? text : undefined;
+  }
+
+  function diagnosticNumbers(value, keys) {
+    const source = value && typeof value === 'object' ? value : {};
+    const result = {};
+    for (const key of keys) {
+      if (Number.isSafeInteger(source[key]) && source[key] >= 0) result[key] = source[key];
+    }
+    return result;
+  }
+
+  function diagnosticFingerprint(value) {
+    return typeof value === 'string' && /^\d{1,16}:[a-f0-9]{1,8}:[a-f0-9]{1,8}$/.test(value)
+      ? value : undefined;
+  }
+
+  function summarizeTrackedCapture(value) {
+    const capture = value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+    const before = Array.isArray(capture.before) ? capture.before : [];
+    const refs = Array.isArray(capture.refs) ? capture.refs : [];
+    const ranges = Array.isArray(capture.ranges) ? capture.ranges : [];
+    const diagnostics = capture.diagnostics || {};
+    const refSummary = ref => removeEmptySummaryFields({
+      idHash: stringField(ref?.id) ? hashString(ref.id) : undefined,
+      kind: diagnosticToken(ref?.kind),
+      ...diagnosticNumbers(ref, ['from', 'to', 'textLength']),
+      textHash: diagnosticFingerprint(ref?.textHash)
+    });
+    return removeEmptySummaryFields({
+      pathHash: stringField(capture.path) ? hashString(capture.path) : undefined,
+      nativeDocIdHash: stringField(capture.nativeDocId) ? hashString(capture.nativeDocId) : undefined,
+      state: diagnosticToken(capture.state), reason: diagnosticToken(capture.reason),
+      source: diagnosticToken(capture.source),
+      ...diagnosticNumbers(capture, ['startedAt', 'expiresAt']),
+      expectedFingerprint: diagnosticFingerprint(capture.expected),
+      beforeCount: before.length, refCount: refs.length, rangeCount: ranges.length,
+      truncated: before.length > 1200 || refs.length > 1200 || ranges.length > 1000 ? true : undefined,
+      before: before.slice(0, 1200).map(refSummary),
+      refs: refs.slice(0, 1200).map(refSummary),
+      ranges: ranges.slice(0, 1000).map(range => removeEmptySummaryFields({
+        ...diagnosticNumbers(range, ['from', 'to', 'start', 'end', 'removedLength']),
+        removedHash: diagnosticFingerprint(range?.removedHash)
+      })),
+      diagnostics: removeEmptySummaryFields({
+        ...diagnosticNumbers(diagnostics, ['beforeCount', 'afterCount', 'capturedCount',
+          'filteredCount', 'polls', 'elapsedMs', 'waitMs']),
+        reason: diagnosticToken(diagnostics.reason),
+        source: diagnosticToken(diagnostics.source),
+        sourceReason: diagnosticToken(diagnostics.sourceReason)
+      })
+    });
+  }
+
   function summarizeGovernance(rules = {}) {
     return {
       readonlyPatternCount: Array.isArray(rules.readonlyPatterns) ? rules.readonlyPatterns.length : 0,

package/extension/src/shared/changeHistoryModel.js

@@ -0,0 +1,94 @@
+(function initChangeHistoryModel(root, factory) {
+  if (typeof module === 'object' && module.exports) {
+    module.exports = factory(require('./settlementFacts'), require('./sessionState'));
+  } else root.CodexOverleafModuleRegistry.define('ChangeHistoryModel', ['SettlementFacts', 'SessionState'], factory);
+})(typeof globalThis !== 'undefined' ? globalThis : window, function changeHistoryModelFactory(SettlementFacts, SessionState) {
+  'use strict';
+  const array = value => Array.isArray(value) ? value : [];
+  const text = value => typeof value === 'string' ? value : '';
+  const opaque = value => /^\[.*(?:omitted|redacted|chars=\d+|hash=).*?\]$/i.test(text(value).trim());
+
+  function project(records, options = {}) {
+    const { projectId, accountScopeId } = options;
+    if (!projectId || !accountScopeId) return [];
+    const sanitize = options.sanitizeText || text;
+    const safe = value => text(sanitize(text(value))).trim();
+    const sessions = new Map();
+    const live = new Map();
+    for (const session of array(options.storedSessions)) {
+      if (session?.projectId === projectId && session.accountScopeId === accountScopeId) sessions.set(session.id, session);
+    }
+    // In-memory sessions already passed the runtime's account/project hydrate
+    // boundary. Their review state is newer than the persisted audit snapshot.
+    for (const session of array(options.sessions)) {
+      if (!session?.id) continue;
+      const prior = sessions.get(session.id);
+      const runs = new Map(array(prior?.runs).map(run => [run.id, run]));
+      const current = session.id === options.activeSessionId ? array(options.activeRuns) : array(session.runs);
+      for (const run of current) if (run?.id) runs.set(run.id, run);
+      sessions.set(session.id, { ...prior, ...session, runs: [...runs.values()] });
+      live.set(session.id, new Set(current.filter(run => run?.id && (!run.runProjectId || run.runProjectId === projectId)).map(run => run.id)));
+    }
+    function path(value) {
+      const raw = text(value).replace(/\\/g, '/').replace(/^\.\//, '');
+      if (/(^|\/)\.codex-overleaf-(subagents|attachments)(\/|$)/.test(raw)) return '';
+      const result = safe(raw);
+      if (!result || /^\[.*\]$/.test(result)) return '';
+      return result.slice(0, 320);
+    }
+    const seen = new Set();
+    return array(records).filter(record => record?.projectId === projectId
+      && (!record.accountScopeId || record.accountScopeId === accountScopeId)
+      && sessions.has(record.sessionId))
+      .slice().sort((a, b) => String(b.createdAt || '').localeCompare(String(a.createdAt || '')))
+      .filter(record => {
+        const key = JSON.stringify([record.sessionId, record.turnId || record.id]);
+        if (seen.has(key)) return false;
+        seen.add(key); return true;
+      }).slice(0, 50).map(record => {
+        const session = sessions.get(record.sessionId);
+        const candidate = array(session.runs).find(run => run.id === record.turnId);
+        const run = candidate && (!candidate.runProjectId || candidate.runProjectId === projectId) ? candidate : null;
+        const facts = SettlementFacts.compactSettlementFacts(run?.settlement || run?.settlementFacts || {});
+        const projection = run ? SettlementFacts.projectRunSettlement(run) : null;
+        const applied = array(record.appliedFiles).filter(file => path(typeof file === 'string' ? file : file?.path));
+        const review = text(run?.trackedChangeStatus);
+        const hasWrites = applied.length > 0 || run?.changedDocument === true
+          || ['changed', 'possibly-changed'].includes(facts.documentEffect)
+          || ['pending', 'accepted', 'rejected', 'needs_review'].includes(review)
+          || run?.undoStatus === 'applied';
+        let files = applied.slice();
+        files.push(...facts.fileSettlements.filter(file => ['complete', 'partial'].includes(file.applied)
+          || ['changed', 'possibly-changed'].includes(file.documentEffect)));
+        if (!files.length && hasWrites) files = array(record.changedFiles);
+        const paths = [...new Set(files.flatMap(file => typeof file === 'string'
+          ? [path(file)] : [path(file?.path), path(file?.destinationPath)]).filter(Boolean))];
+        const unsafeSave = record.saveVerification?.ok === false
+          || ['failed', 'unavailable'].includes(record.saveVerification?.state);
+        let status;
+        if (review === 'accepted') status = 'accepted';
+        else if (review === 'rejected' || run?.undoStatus === 'applied') status = 'undone';
+        else if (review === 'needs_review' || projection?.terminalState === 'needs_review'
+          || facts.documentEffect === 'possibly-changed'
+          || ['partial', 'needs-review'].includes(facts.evidence.settled)
+          || hasWrites && (unsafeSave || ['failed', 'interrupted', 'needs_review_after_navigation'].includes(run?.status))) status = 'attention';
+        else if (run?.status === 'running' || record.resultStatus === 'draft' && !record.completedAt) status = 'running';
+        else if (review === 'pending') status = 'pending';
+        else if (!hasWrites) status = 'unchanged';
+        else status = run ? 'written' : 'unknown';
+        const suppliedSummary = safe(run?.safeTaskSummary || '');
+        const summary = suppliedSummary && !opaque(suppliedSummary)
+          ? SessionState.computeSafeTaskSummary(suppliedSummary) : '';
+        // Audit promptSummary deliberately stores a privacy marker. Never
+        // recover it, render it, or turn it into an apparent task summary.
+        return {
+          key: JSON.stringify([record.sessionId, record.turnId || record.id]),
+          projectId, accountScopeId, sessionId: record.sessionId, turnId: record.turnId,
+          createdAt: text(record.createdAt), paths, hasWrites, status, summary,
+          operation: paths.length === 1 ? text(files[0]?.type) : '',
+          canJump: Boolean(run && live.get(record.sessionId)?.has(record.turnId))
+        };
+      });
+  }
+  return { project };
+});

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.1';
+  const BUILD_TARGET_VERSION = '2.5.0';
   const DEFAULT_CHROME_EXTENSION_ID = 'illdpneeeopfffmiepaejglgmhpmdhdc';
   const REQUIRED_CAPABILITIES = Object.freeze([
     'bridgePing',

package/extension/src/shared/compileAdapter.js

@@ -163,7 +163,49 @@
     return result;
   }
 
+  function buildPostWriteCompileSummary({ result = null, logResult = null, error = null } = {}) {
+    const logAvailable = logResult?.ok === true;
+    const errors = logAvailable && Array.isArray(logResult.errors)
+      ? logResult.errors.slice(0, 5).map(formatCompileDiagnosticForSummary)
+      : [];
+    const warnings = logAvailable && Array.isArray(logResult.warnings)
+      ? logResult.warnings.slice(0, 5).map(formatCompileDiagnosticForSummary)
+      : [];
+    if (error) {
+      return {
+        status: 'failed',
+        reason: error?.message || 'Post-write compile failed.',
+        errors,
+        warnings,
+        logAvailable
+      };
+    }
+    if (!result?.ok) {
+      return {
+        status: 'failed',
+        reason: result?.reason || 'Post-write compile did not succeed.',
+        errors,
+        warnings,
+        logAvailable
+      };
+    }
+    return {
+      status: result.compile?.status || 'triggered',
+      reason: result.reason || '',
+      errors,
+      warnings,
+      logAvailable
+    };
+  }
+
+  function formatCompileDiagnosticForSummary(value) {
+    const text = String(value || '').replace(/\s+/g, ' ').trim();
+    return text.length > 180 ? `${text.slice(0, 179)}...` : text;
+  }
+
   return {
+    buildPostWriteCompileSummary,
+    formatCompileDiagnosticForSummary,
     COMPILABLE_EXTENSIONS,
     MAX_LOG_BYTES,
     extractErrorBlocks,

package/extension/src/shared/failureReasons.js

@@ -158,6 +158,26 @@
       fallbackUserMessage: 'Create/delete/rename/move did not appear in the file tree as expected.',
       fallbackNextAction: 'Inspect the file tree and retry if needed.'
     },
+    source_zip_unavailable: {
+      stage: 'preflight', severity: 'blocked', defaultRetryable: true,
+      fallbackUserMessage: 'The project could not be checked before uploading this file.',
+      fallbackNextAction: 'Retry sync; only missing files will be uploaded.'
+    },
+    file_upload_unconfirmed: {
+      stage: 'verify', severity: 'warning', defaultRetryable: true,
+      fallbackUserMessage: 'The file was submitted, but its saved content is not yet confirmed.',
+      fallbackNextAction: 'Check the file before retrying; matching content will not be uploaded twice.'
+    },
+    subagent_unfinished_output: {
+      stage: 'preflight', severity: 'blocked', defaultRetryable: false,
+      fallbackUserMessage: 'A subagent stopped before finishing this file; the main agent must review and adopt it.',
+      fallbackNextAction: 'Have the main agent complete and adopt the pending file.'
+    },
+    subagent_unauthorized_edit: {
+      stage: 'preflight', severity: 'blocked', defaultRetryable: false,
+      fallbackUserMessage: 'A file changed outside the subagent ownership boundary and was not synced.',
+      fallbackNextAction: 'Review the ownership violation; it cannot be cleared through output adoption.'
+    },
     partial_write_needs_review: {
       stage: 'verify', severity: 'warning', defaultRetryable: false,
       fallbackUserMessage: 'Some operations wrote, some were skipped.',

package/extension/src/shared/globalPreferences.js

@@ -112,7 +112,7 @@
       try {
         const url = new URL(sender?.tab?.url || '');
         allowed = sender.id === chromeApi.runtime.id && url.protocol === 'https:'
-          && ['overleaf.com', 'www.overleaf.com'].includes(url.hostname)
+          && ['overleaf.com', 'www.overleaf.com', 'cn.overleaf.com'].includes(url.hostname)
           && /^\/project(?:\/|$)/.test(url.pathname);
       } catch (_error) { /* reject unrelated contexts */ }
       if (!allowed) {

package/extension/src/shared/i18n.js

@@ -150,10 +150,10 @@
       undoTrackedTitle: 'Reject this run\'s Overleaf tracked changes?',
       undoNativeTitle: 'Undo this run\'s Overleaf writes?',
       undoTrackedMessage: 'This will use Overleaf Reject to undo {files}.\n\nIt will not rewrite files with text patches. If the extension cannot verify the matching tracked changes, it will stop and let you handle them in Overleaf review tools.',
-      undoNativeMessage: 'This will use Overleaf Undo to roll back {files}.\n\nBefore running, Codex verifies the current content still matches this run\'s written content. If you edited it afterward, Codex stops to avoid undoing your new changes.',
+    undoNativeMessage: 'Undo this run\'s changes in {files}.',
       undoTrackedConfirm: 'Reject this run',
       undoTrackedStarted: 'Starting rejection of this run\'s Overleaf tracked changes',
-      undoNativeStarted: 'Starting Overleaf native undo for this run',
+    undoNativeStarted: 'Undoing this run\'s changes',
       undoTrackedResult: 'Undo result: rejected {applied} tracked change(s), skipped {skipped}',
       undoNativeResult: 'Undo result: undone {applied} file(s), skipped {skipped}',
       undoSwitchedEditing: 'Switched to Editing for undo and left Editing active afterward.',
@@ -272,6 +272,24 @@
       personalizationHelp: 'Style, terminology, and LaTeX conventions Codex should follow in this project.',
       settingsSaved: 'Saved',
       appearanceTitle: 'Appearance',
+      settingsWorkbenchTitle: 'Settings',
+      settingsWorkbenchSubtitle: 'Preferences, project rules, and local tools.',
+      settingsWorkbenchGeneral: 'General & appearance',
+      settingsWorkbenchModels: 'Models & connections',
+      settingsWorkbenchContext: 'Project context',
+      settingsWorkbenchInstructions: 'Instructions & skills',
+      settingsWorkbenchProtection: 'Protection & privacy',
+      settingsWorkbenchHistory: 'History & storage',
+      settingsWorkbenchAll: 'All settings',
+      settingsWorkbenchFilter: 'Filter settings by scope',
+      settingsWorkbenchCategories: 'Settings categories',
+      settingsWorkbenchProjectFilter: 'Show only settings that apply to this project.',
+      settingsWorkbenchOpenProject: 'Open a project to configure its settings.',
+      settingsWorkbenchClose: 'Close settings',
+      settingsWorkbenchEnableSkills: 'Enable Overleaf skills',
+      settingsWorkbenchSkillsHelp: 'Turn off all skills without changing individual selections.',
+      settingsWorkbenchSkillsList: 'Available skills',
+      settingsWorkbenchProviderOpenFailed: 'Could not open provider settings.',
       themeLabel: 'Theme',
       themeDark: 'Dark',
       themeLight: 'Light',
@@ -300,22 +318,30 @@
       runsTruncatedNote: 'Showing the most recent 20 runs — older runs were trimmed.',
       eventsTruncatedNote: 'Earlier steps of this run were trimmed.',
       newSessionTooltip: 'Start a fresh conversation — the current session\u2019s context will not carry over',
-      storageTitle: 'History & storage',
+      storageTitle: 'Local data',
+      storageSavedData: 'Saved conversations & records',
       softwareUpdatesTitle: 'Software updates',
       softwareUpdatesHelp: 'Automatically checks signed stable releases for the Extension and Native Host.',
       checkForUpdates: 'Check for updates',
       providerSettingsTitle: 'Model providers',
       providerSettingsExperimental: 'Third-party experimental',
-      providerSettingsHelp: 'Configure experimental third-party model APIs. Compatibility varies by provider and gateway.',
+      providerSettingsHelp: 'Manage model API connections.',
       providerSettingsConfigure: 'Configure',
       providerSettingsBuiltin: 'Built-in Codex is active',
       providerSettingsLoading: 'Checking current project provider…',
-      storageUsageLoading: 'Calculating usage\u2026',
-      storageClearAll: 'Clear all history\u2026',
-      storageClearAllHelp: 'Removes every stored session, run and audit record for all projects. Project settings and rules are kept.',
+      storageUsageLoading: 'Loading saved history\u2026',
+      storageClearAll: 'Clear local history\u2026',
+      storageClearAllHelp: 'Clearing removes local conversations, change records and their undo information for all projects. Overleaf files, project settings and rules stay unchanged.',
       runTurnNavLabel: 'Jump to a turn\u2026',
-      historyTitle: 'Change history',
-      historyHelp: 'What Codex wrote to this project, per run. Filter by file name or task text.',
+      historyTitle: 'File changes',
+      historyHelp: 'Review file changes from the latest 50 recorded runs and open the matching conversation.',
+      historyStatusLabel: 'Change status',
+      historyStatusAll: 'All statuses',
+      historyStatusPending: 'Pending review',
+      historyStatusAccepted: 'Accepted',
+      historyStatusUndone: 'Undone',
+      historyStatusAttention: 'Needs attention',
+      historyStatusWritten: 'Written',
       runSearchPlaceholder: 'Search this session\u2019s runs\u2026',
       undoFileSelectTitle: 'Undo which files?',
       undoFileSelectConfirm: 'Undo selected',
@@ -335,8 +361,8 @@
       speedLabel: 'Speed',
       requireReviewing: 'Track',
       requireReviewingTitle: 'When enabled, Codex checks or switches Overleaf Reviewing/Track Changes before writing. Deletes still require confirmation.',
-      autoCompile: 'Compile',
-      autoCompileTitle: 'After Codex writes, click Overleaf Recompile and record the compile result for this task. Ask mode will not trigger it.',
+      autoCompile: 'Auto compile',
+      autoCompileTitle: 'Automatically recompile in Overleaf after Codex writes and record the result. Toggling this setting does not compile immediately. Ask mode does not trigger compilation.',
       experimentalOtWarmMirror: 'OT warm mirror',
       experimentalOtWarmMirrorShort: 'OT',
       experimentalOtWarmMirrorTitle: 'Read-only local text warming. File scope and freshness are checked before reuse; normal project reading remains the fallback.',
@@ -376,7 +402,15 @@
       queuedInputPaused: 'Queue paused',
       queuedInputGuiding: 'Sending guidance',
       queuedInputExecuting: 'Running',
-      queuedInputGuide: 'Guide',
+      queuedInputGuide: 'Steer now',
+      queuedInputUpNext: 'Up next · sends after this run',
+      queuedInputUpNextMany: 'Up next · sends in order after this run',
+      queuedInputSteering: 'Steering the current turn…',
+      queuedInputMore: '{count} more queued',
+      queuedInputShowLess: 'Show less',
+      queuedInputEdit: 'Edit in the composer',
+      queuedInputEditBlocked: 'Send or clear the current draft before editing a queued message.',
+      queuedInputGuideHint: 'Steer is available once the current tool step finishes.',
       queuedInputGuideTitle: 'Send this message into the active Codex turn now.',
       queuedInputGuideUnavailable: 'The active turn is not ready for guidance yet.',
       queuedInputGuideFailed: 'Guidance could not be delivered. The message remains queued.',
@@ -717,10 +751,10 @@
       undoTrackedTitle: '拒绝本轮 Overleaf 留痕改动？',
       undoNativeTitle: '撤销本轮 Overleaf 写入？',
       undoTrackedMessage: '将通过 Overleaf 自己的 Reject/拒绝功能撤销 {files}。\n\n这不会用文本补丁重写文件；如果插件不能确认对应留痕记录，会停止并让你在 Overleaf 审阅面板手动处理。',
-      undoNativeMessage: '将通过 Overleaf 自己的 Undo/撤销功能回退 {files}。\n\n执行前会确认当前内容仍是本轮写入后的内容；如果你已经手动改过，Codex 会停止，避免撤掉你的新修改。',
+    undoNativeMessage: '撤销本轮在 {files} 中的改动。',
       undoTrackedConfirm: '拒绝本轮改动',
       undoTrackedStarted: '开始拒绝本轮 Overleaf 留痕改动',
-      undoNativeStarted: '开始用 Overleaf 原生撤销回退本轮写入',
+    undoNativeStarted: '正在撤销本轮改动',
       undoTrackedResult: '撤销结果：已拒绝 {applied} 条留痕，跳过 {skipped} 条',
       undoNativeResult: '撤销结果：已撤销 {applied} 个文件，跳过 {skipped} 项',
       undoSwitchedEditing: '撤销时已切到 Editing；撤销后保持 Editing。',
@@ -839,6 +873,24 @@
       personalizationHelp: 'Codex 在本项目中应遵循的风格、术语和 LaTeX 约定。',
       settingsSaved: '已保存',
       appearanceTitle: '外观',
+      settingsWorkbenchTitle: '设置',
+      settingsWorkbenchSubtitle: '偏好设置、项目规则与本地工具。',
+      settingsWorkbenchGeneral: '常规与外观',
+      settingsWorkbenchModels: '模型与连接',
+      settingsWorkbenchContext: '项目上下文',
+      settingsWorkbenchInstructions: '指令与技能',
+      settingsWorkbenchProtection: '文件保护与隐私',
+      settingsWorkbenchHistory: '历史与存储',
+      settingsWorkbenchAll: '全部设置',
+      settingsWorkbenchFilter: '按作用范围筛选设置',
+      settingsWorkbenchCategories: '设置分类',
+      settingsWorkbenchProjectFilter: '仅显示作用于当前项目的设置。',
+      settingsWorkbenchOpenProject: '进入项目后可配置项目设置。',
+      settingsWorkbenchClose: '关闭设置',
+      settingsWorkbenchEnableSkills: '启用 Overleaf 技能',
+      settingsWorkbenchSkillsHelp: '关闭总开关时，各技能的单独选择会保留。',
+      settingsWorkbenchSkillsList: '可用技能',
+      settingsWorkbenchProviderOpenFailed: '无法打开模型服务设置。',
       themeLabel: '主题',
       themeDark: '深色',
       themeLight: '浅色',
@@ -867,22 +919,30 @@
       runsTruncatedNote: '仅显示最近 20 轮——更早的轮次已精简。',
       eventsTruncatedNote: '本轮更早的步骤已精简。',
       newSessionTooltip: '开启全新对话——当前会话的上下文不会带入',
-      storageTitle: '历史与存储',
+      storageTitle: '本地数据',
+      storageSavedData: '已保存的对话与记录',
       softwareUpdatesTitle: '软件更新',
       softwareUpdatesHelp: '自动检查 Extension 与 Native Host 的签名稳定版本。',
       checkForUpdates: '检查更新',
       providerSettingsTitle: '模型服务',
       providerSettingsExperimental: '第三方实验性',
-      providerSettingsHelp: '配置实验性第三方模型 API；兼容性取决于具体模型服务与网关。',
+      providerSettingsHelp: '管理模型 API 连接。',
       providerSettingsConfigure: '配置',
       providerSettingsBuiltin: '当前使用内置 Codex',
       providerSettingsLoading: '正在读取当前项目的模型服务…',
-      storageUsageLoading: '正在计算占用…',
-      storageClearAll: '清空全部历史…',
-      storageClearAllHelp: '删除所有项目已存储的全部会话、运行与审计记录。项目设置与规则会保留。',
+      storageUsageLoading: '正在读取已保存的历史…',
+      storageClearAll: '清理本地历史…',
+      storageClearAllHelp: '清理会移除所有项目的本地对话、修改记录及撤销信息。Overleaf 文件、项目设置与规则保持不变。',
       runTurnNavLabel: '跳到某一轮…',
-      historyTitle: '变更历史',
-      historyHelp: 'Codex 每一轮写入本项目的记录。可按文件名或任务内容过滤。',
+      historyTitle: '文件修改记录',
+      historyHelp: '查看最近 50 轮的文件修改及处理状态，可跳转到对应对话。',
+      historyStatusLabel: '修改状态',
+      historyStatusAll: '所有状态',
+      historyStatusPending: '待接受',
+      historyStatusAccepted: '已接受',
+      historyStatusUndone: '已撤销',
+      historyStatusAttention: '需检查',
+      historyStatusWritten: '已写入',
       runSearchPlaceholder: '搜索本会话的轮次…',
       undoFileSelectTitle: '撤销哪些文件？',
       undoFileSelectConfirm: '撤销所选',
@@ -902,8 +962,8 @@
       speedLabel: '速度',
       requireReviewing: '留痕',
       requireReviewingTitle: '开启后，写入前会确认并尝试切到 Overleaf Reviewing/Track Changes；删除仍需确认。',
-      autoCompile: '编译',
-      autoCompileTitle: 'Codex 写入后自动点击 Overleaf Recompile，并把编译结果记录到本轮任务。只问不改时不会触发。',
+      autoCompile: '自动编译',
+      autoCompileTitle: 'Codex 写入后自动触发 Overleaf Recompile，并记录编译结果。切换此开关不会立即编译；只问不改时不触发编译。',
       experimentalOtWarmMirror: 'OT 预热镜像',
       experimentalOtWarmMirrorShort: 'OT',
       experimentalOtWarmMirrorTitle: '只读本地文本预热；复用前校验文件范围和新鲜度，常规项目读取作为回退路径。',
@@ -943,13 +1003,21 @@
       queuedInputPaused: '队列已暂停',
       queuedInputGuiding: '正在发送引导',
       queuedInputExecuting: '正在运行',
-      queuedInputGuide: '立即引导',
+      queuedInputGuide: '现在插入',
+      queuedInputUpNext: '下一条 · 本轮结束后发送',
+      queuedInputUpNextMany: '接下来 · 本轮结束后依次发送',
+      queuedInputSteering: '正在插入当前回合…',
+      queuedInputMore: '还有 {count} 条待发送',
+      queuedInputShowLess: '收起',
+      queuedInputEdit: '拉回输入框编辑',
+      queuedInputEditBlocked: '请先发送或清空当前输入框里的内容，再编辑排队消息。',
+      queuedInputGuideHint: '当前工具步骤结束后才能插入。',
       queuedInputGuideTitle: '立即把这条消息发送到当前 Codex turn。',
       queuedInputGuideUnavailable: '当前 turn 尚未进入可引导状态。',
       queuedInputGuideFailed: '引导消息未送达，消息已保留在队列中。',
       queuedInputGuided: '后续引导已发送到当前 Codex turn。',
       queuedInputAdded: '后续任务已排队，将在当前任务完整结束后执行。',
-      queuedInputResume: '恢复队列',
+      queuedInputResume: '继续',
       queuedInputRemove: '删除',
       queuedInputAttachmentsUnsupported: '当前排队消息支持文本和 @context；请先移除二进制附件。',
       queuedInputError_empty_input: '请先输入后续任务。',

package/extension/src/shared/managedUpdateProjection.js

@@ -13,6 +13,7 @@
     'up_to_date',
     'checking',
     'update_available',
+    'manual_install_required',
     'downloading',
     'staged',
     'waiting_for_idle',
@@ -27,7 +28,7 @@
 
   const PHASE_TIMEOUTS = Object.freeze({
     checking: 60 * 1000,
-    downloading: 2 * 60 * 1000,
+    downloading: 6 * 60 * 1000,
     applying: 90 * 1000,
     awaiting_health: 2 * 60 * 1000,
     rolling_back: 60 * 1000
@@ -75,9 +76,11 @@
   const TRANSITIONS = Object.freeze({
     idle: Object.freeze(['checking']),
     up_to_date: Object.freeze(['checking', 'idle']),
-    checking: Object.freeze(['idle', 'up_to_date', 'update_available', 'failed']),
+    checking: Object.freeze(['idle', 'up_to_date', 'update_available', 'manual_install_required', 'failed']),
+    // Only a reinstall resolves it; leave by checking again or going idle.
+    manual_install_required: Object.freeze(['checking', 'idle', 'update_available', 'failed']),
     update_available: Object.freeze(['checking', 'downloading', 'deferred', 'failed']),
-    downloading: Object.freeze(['staged', 'failed']),
+    downloading: Object.freeze(['staged', 'failed', 'update_available', 'idle']),
     staged: Object.freeze(['waiting_for_idle', 'applying', 'update_available', 'deferred', 'failed']),
     waiting_for_idle: Object.freeze(['applying', 'update_available', 'deferred', 'failed']),
     applying: Object.freeze(['staged', 'awaiting_health', 'rolling_back', 'failed']),

package/extension/src/shared/pageRpcContract.js

@@ -5,21 +5,27 @@
 })(typeof window !== 'undefined' ? window : (typeof globalThis !== 'undefined' ? globalThis : this), function () {
   'use strict';
 
-  var REVISION = '2026-09-14-native-text-upload-v28';
+  var REVISION = '2026-09-27-writing-style-references-v33';
   var METHODS = freezeCatalog({
     initializeCapability: entry('bridge.initialize', 'control', 'none', 'default', false, 'none'),
     probe: entry('bridge.probe', 'read', 'none', 'default', false, 'safe'),
     cancelActiveWrite: entry('write.cancel', 'control', 'none', 'default', false, 'idempotent'),
     getProjectSnapshot: entry('snapshot.read', 'read', 'none', 'snapshot', true, 'safe'),
     getProjectFileList: entry('snapshot.list', 'read', 'none', 'file_list', true, 'safe'),
+    listReferenceProjects: entry('reference.list', 'read', 'none', 'file_list', false, 'safe'),
+    getReferenceProjectSnapshot: entry('reference.read', 'read', 'none', 'snapshot', false, 'safe'),
+    cancelReferenceRead: entry('reference.cancel', 'control', 'none', 'default', false, 'idempotent'),
     invalidateProjectSnapshot: entry('snapshot.invalidate', 'cache', 'none', 'default', false, 'idempotent'),
     createCheckpoint: entry('checkpoint.create', 'page_state', 'none', 'default', false, 'no_retry'),
     ensureReviewing: entry('reviewing.enable', 'page_state', 'optional', 'default', true, 'idempotent'),
     ensureEditing: entry('reviewing.disable', 'page_state', 'optional', 'default', true, 'idempotent'),
     applyOperations: entry('document.write', 'document', 'required', 'writeback', true, 'no_retry'),
+    getWritebackReceipt: entry('writeback.receipt', 'read', 'required', 'default', true, 'safe'),
+    getSelectionContext: entry('editor.selection', 'read', 'required', 'default', true, 'safe'),
     binaryUploadBegin: entry('asset.stage', 'cache', 'required', 'default', false, 'no_retry'),
     binaryUploadAppend: entry('asset.stage', 'cache', 'none', 'writeback', true, 'no_retry'),
     binaryUploadCommit: entry('asset.write', 'document', 'required', 'writeback', true, 'no_retry'),
+    binaryUploadStatus: entry('asset.receipt', 'read', 'required', 'default', true, 'safe'),
     binaryUploadAbort: entry('asset.stage', 'cache', 'none', 'default', false, 'idempotent'),
     jumpToPosition: entry('editor.navigate', 'navigation', 'required', 'default', false, 'idempotent'),
     reconcileTrackedChangeCapture: entry('tracked_changes.read', 'read', 'required', 'default', false, 'safe'),