codex-overleaf-link 2.5.0 → 2.6.0

package/extension/src/pageBridge.js

@@ -63,6 +63,7 @@
     window
   });
   snapshotRouter = requirePageModule('CodexOverleafSnapshotRouter').create({
+    getActiveEditorIdentity,
     normalizePath: normalizeSafeProjectPath,
     readActiveEditorText,
     treeOperations,
@@ -72,16 +73,22 @@
   const textFileCreator = requirePageModule('CodexOverleafTextFileCreator').create({
     window, document, treeOperations, snapshotRouter,
     collectElements, ensureEditing, ensureReviewing, readActiveEditorText, readWriteCancellationSequence,
+    findUpgradeModal: () => window.CodexOverleafReviewing.findUpgradeModal(document),
     uploadHelpers: requirePageModule('CodexOverleafBinaryAssetUploader')
   });
   binaryAssetUploader = requirePageModule('CodexOverleafBinaryAssetUploader').create({
     prepareUploadParent: textFileCreator.prepareUploadParent,
+    cleanupCreatedDirectories: textFileCreator.cleanupCreatedDirectories,
+    isUploadParentCurrent: textFileCreator.isUploadParentCurrent,
     findFolderNode: textFileCreator.findFolderNode,
     document,
     snapshotRouter,
     treeOperations,
     window
   });
+  const fileMover = requirePageModule('CodexOverleafFileMover').create({
+    window, document, treeOperations, snapshotRouter, textFileCreator, normalizeSafeProjectPath
+  });
   writeGuard = requirePageModule('CodexOverleafWriteGuard').create({
     document,
     treeOperations,
@@ -102,6 +109,7 @@
     beginTextCreateBatch: textFileCreator.beginCreateBatch,
     finishTextCreateBatch: textFileCreator.finishCreateBatch,
     deleteTextFile: textFileCreator.deleteFile,
+    moveFile: fileMover.moveFile,
     activeEditorIdentityChanged,
     clickNode,
     collectElements,
@@ -221,7 +229,8 @@
 
   const pageRpcHandlers = {
     probe,
-    cancelActiveWrite() {
+    cancelActiveWrite(params = {}) {
+      if (params.reviewOwnerToken) return { ok: true, cancelled: requirePageModule('CodexOverleafReviewContext').cancelOwner(params.reviewOwnerToken) };
       const sequence = bumpWriteCancellationSequence();
       textFileCreator.cancelVerifications();
       snapshotRouter.cancelWritebackReads();
@@ -391,6 +400,11 @@
       fallbackUserMessage: 'Target file is active but the editor was not ready before timeout.',
       fallbackNextAction: 'Wait for Overleaf to finish loading, then retry.'
     },
+    reviewing_unavailable: {
+      stage: 'reviewing', severity: 'blocked', defaultRetryable: false,
+      fallbackUserMessage: "Track Changes is unavailable for this project. It depends on the project owner's Overleaf plan.",
+      fallbackNextAction: 'Turn off Track in the composer to write without tracked changes. Codex still records each change so you can undo it.'
+    },
     reviewing_state_unknown: {
       stage: 'reviewing', severity: 'blocked', defaultRetryable: true,
       fallbackUserMessage: 'Codex could not determine whether Reviewing/Track Changes is enabled.',
@@ -480,6 +494,8 @@
       findFileTreeManager,
       findHistoryObject,
       findReviewingActivationControl,
+      findUpgradeModal: () => window.CodexOverleafReviewing.findUpgradeModal(document),
+      reviewingConfirmed: isReviewingConfirmedForWrite(getReviewingState()),
       getCodeMirrorEditorView,
       getDeepActiveElement,
       isInsideCodexPanel,
@@ -489,7 +505,7 @@
 
   async function ensureReviewing(params = {}) {
     const initial = getReviewingState(params);
-    if (isReviewingConfirmedForWrite(initial)) {
+    if (isReviewingConfirmedForWrite(initial) && !window.CodexOverleafReviewing.findUpgradeModal(document)) {
       return {
         ok: true,
         activated: false,
@@ -498,6 +514,7 @@
     }
 
     const switched = await toggleReviewingMode(true, params);
+    if (switched.code === 'reviewing_unavailable') return { ...switched, reason: switched.failure.userMessage };
     if (switched.ok) {
       return {
         ok: true,
@@ -545,6 +562,7 @@
     }
 
     const switched = await toggleReviewingMode(false, params);
+    if (switched.code === 'reviewing_unavailable') return { ...switched, reason: switched.failure.userMessage };
     if (switched.ok) {
       return {
         ok: true,
@@ -690,7 +708,14 @@
     if (to - from > 20000) return { ok: false, code: 'selection_too_large' };
     const source = editorState.doc.toString();
     const text = source.slice(from, to);
-    const digest = await window.crypto.subtle.digest('SHA-256', new TextEncoder().encode(source));
+    // UTF-8 replaces isolated surrogates; exclude them so flank hashes prove exact UTF-16 text.
+    if (/[\uD800-\uDFFF]/u.test(source) || /[\uD800-\uDFFF]/u.test(text)) return { ok: false, code: 'selection_unavailable' };
+    const hashText = async value => Array.from(new Uint8Array(
+      await window.crypto.subtle.digest('SHA-256', new TextEncoder().encode(value))
+    ), byte => byte.toString(16).padStart(2, '0')).join('');
+    const [documentHash, prefixHash, suffixHash] = await Promise.all([
+      hashText(source), hashText(source.slice(0, from)), hashText(source.slice(to))
+    ]);
     if (getProjectId() !== projectId || getActiveFilePath() !== path || getCodeMirrorEditorView() !== view
       || view.state.doc !== editorState.doc || view.state.selection.main.from !== from || view.state.selection.main.to !== to) {
       return { ok: false, code: 'selection_changed' };
@@ -698,7 +723,8 @@
     const captured = { projectId, path, from, to, text,
       lineStart: editorState.doc.lineAt(from).number,
       lineEnd: editorState.doc.lineAt(Math.max(from, to - 1)).number,
-      documentHash: Array.from(new Uint8Array(digest), byte => byte.toString(16).padStart(2, '0')).join(''),
+      documentHash,
+      rebaseEvidence: { v: 1, documentLength: source.length, prefixHash, suffixHash },
       capturedAt: new Date().toISOString() };
     let anchor = null;
     try {
@@ -727,9 +753,16 @@
       const activeFileMatches = getActiveFilePath() === filePath;
       const text = readActiveEditorText();
       lastText = text;
+      const currentEditorIdentity = getActiveEditorIdentity();
+      // A file-tree click can reconfigure or blur the old editor before the
+      // target document loads. A new view/state alone does not prove a switch.
+      const documentChanged = currentEditorIdentity?.type === 'codemirror-view'
+        && previousEditorIdentity?.type === 'codemirror-view'
+        ? currentEditorIdentity.doc !== previousEditorIdentity.doc
+        : Boolean(currentEditorIdentity) && activeEditorIdentityChanged(previousEditorIdentity);
       if (activeFileMatches
         && window.CodexOverleafProjectFiles.isUsableProjectFileContent(text)
-        && activeEditorIdentityChanged(previousEditorIdentity)) {
+        && documentChanged) {
         return {
           ok: true,
           text
@@ -855,6 +888,7 @@
     }
 
     const switched = await toggleReviewingMode(enabled, params);
+    if (switched.code === 'reviewing_unavailable') return { ...switched, reason: switched.failure.userMessage };
     if (switched.ok) {
       return {
         ok: true,
@@ -901,67 +935,23 @@
   }
 
   async function toggleReviewingMode(enabled, params = {}) {
-    const attemptedNodes = uniqueNodes([
-      findReviewingActivationControl(),
-      findReviewingModeMenuControl()
-    ].filter(Boolean));
-
-    for (const control of attemptedNodes) {
-      clickNode(control);
-      let after = await waitForReviewingEnabled(enabled, {
-        ...params,
-        waitMs: Math.min(resolveWaitMs(params), 180)
-      });
-      if (isReviewingTargetStateConfirmed(enabled, after)) {
-        return {
-          ok: true,
-          attempted: true,
-          reviewing: after.reviewing
-        };
+    const sequence = readWriteCancellationSequence();
+    const assertCurrent = () => {
+      if (sequence !== readWriteCancellationSequence()) {
+        throw Object.assign(new Error('Writeback was cancelled.'), { code: 'codex_cancelled' });
       }
-
-      const modeOption = findReviewingModeOption(enabled, { requireMenuOption: true });
-      if (modeOption) {
-        clickNode(modeOption);
-        after = await waitForReviewingEnabled(enabled, params);
-        if (isReviewingTargetStateConfirmed(enabled, after)) {
-          return {
-            ok: true,
-            attempted: true,
-            reviewing: after.reviewing
-          };
-        }
+      if (params.runProjectId && writeGuard.getEditorProjectIdPageSide(params.runProjectId) !== params.runProjectId) {
+        throw Object.assign(new Error('The active project changed.'), { code: 'aborted_project_changed' });
       }
-    }
-
-    const visibleModeOption = findReviewingModeOption(enabled, { requireMenuOption: true });
-    if (visibleModeOption) {
-      clickNode(visibleModeOption);
-      const after = await waitForReviewingEnabled(enabled, params);
-      return {
-        ok: isReviewingTargetStateConfirmed(enabled, after),
-        attempted: true,
-        reviewing: after.reviewing
-      };
-    }
-
-    const after = getReviewingState(params);
-    return {
-      ok: false,
-      attempted: attemptedNodes.length > 0,
-      reviewing: after.reviewing
     };
-  }
-
-  async function waitForReviewingEnabled(enabled, params = {}) {
-    const waitMs = resolveWaitMs(params);
-    const deadline = Date.now() + Math.max(0, waitMs);
-    let current = getReviewingState(params);
-    while (!isReviewingTargetStateConfirmed(enabled, current) && Date.now() < deadline) {
-      await delay(120);
-      current = getReviewingState(params);
-    }
-    return current;
+    return window.CodexOverleafReviewing.toggleMode(enabled, params, {
+      document, assertCurrent, delay,
+      getState: () => getReviewingState(params), isConfirmed: isReviewingTargetStateConfirmed,
+      click: clickNode,
+      findControls: () => findReviewingModeControls(enabled),
+      findOption: value => findReviewingModeOption(value, { requireMenuOption: true }),
+      buildFailure: buildPageBridgeFailure
+    });
   }
 
   function resolveWaitMs(params = {}) {
@@ -1093,7 +1083,72 @@
     return String(value || '').replace(/\s+/g, ' ').trim();
   }
 
+  function isReviewingModeNodeAvailable(node) {
+    if (!node || node.ownerDocument !== document || !node.isConnected || node.disabled
+      || node.getAttribute?.('aria-disabled') === 'true' || !node.getClientRects?.().length) return false;
+    for (let ancestor = node; ancestor; ancestor = ancestor.parentElement || ancestor.getRootNode?.().host) {
+      if (isInsideCodexPanel(ancestor) || ancestor.closest?.(
+        '.review-panel, .review-panel-container, .review-panel-header-slot, .review-sidebar, #review-panel, [data-testid="review-panel"]'
+      ) || ancestor.hidden || ancestor.getAttribute?.('aria-hidden') === 'true' || ancestor.hasAttribute?.('inert')) return false;
+      const style = window.getComputedStyle?.(ancestor);
+      if (style?.display === 'none' || style?.visibility === 'hidden' || style?.visibility === 'collapse'
+        || style?.opacity === '0') return false;
+    }
+    return true;
+  }
+
+  function findReviewingToolbarControl() {
+    return Array.from(document.querySelectorAll(
+      '.toolbar-editor .review-mode-switcher > .review-mode-switcher-toggle-button'
+    )).find(isReviewingModeNodeAvailable) || null;
+  }
+
+  function findReviewingModeControls(enabled) {
+    const toolbarControl = findReviewingToolbarControl();
+    return toolbarControl ? [toolbarControl]
+      : [findReviewingActivationControl(enabled), findReviewingModeMenuControl()];
+  }
+
+  function findReviewingToolbarMenu(control) {
+    const controlledIds = (control.getAttribute('aria-controls') || '').split(/\s+/).filter(Boolean);
+    for (const id of controlledIds) {
+      const menu = document.getElementById(id);
+      if (isReviewingModeNodeAvailable(menu)) return menu;
+    }
+    if (control.getAttribute('aria-expanded') !== 'true') return null;
+    const selector = '[role="menu"], [role="listbox"], .dropdown-menu';
+    // Current Overleaf keeps the menu beside the toggle, inside this switcher.
+    const localMenu = Array.from(control.parentElement?.querySelectorAll(selector) || [])
+      .find(node => node.closest('.review-mode-switcher') === control.parentElement && isReviewingModeNodeAvailable(node));
+    if (localMenu) return localMenu;
+    // A portalled menu must still name this switch, rather than an unrelated dropdown.
+    return control.id ? Array.from(document.querySelectorAll(selector)).find(node =>
+      (node.getAttribute('aria-labelledby') || '').split(/\s+/).includes(control.id)
+      && isReviewingModeNodeAvailable(node)) || null : null;
+  }
+
+  function isReviewingToolbarModeOption(node, enabled) {
+    const mode = enabled ? 'reviewing' : 'editing';
+    const values = [node.value, node.getAttribute('value'), node.getAttribute('data-value'),
+      node.getAttribute('label'), node.getAttribute('aria-label'), ...String(node.className || '').split(/\s+/)];
+    if (values.some(value => normalizeReviewingSignalText(value).toLowerCase() === mode)) return true;
+    // Read a label separately from icon text and the option's explanatory subtitle.
+    return [node, ...node.querySelectorAll('*')].some(label => {
+      if (label.closest('[aria-hidden="true"]')) return false;
+      const directText = Array.from(label.childNodes).filter(child => child.nodeType === 3)
+        .map(child => child.textContent).join(' ');
+      return [label.textContent, directText].some(value => normalizeReviewingSignalText(value).toLowerCase() === mode);
+    });
+  }
+
   function findReviewingModeOption(enabled, options = {}) {
+    const toolbarControl = findReviewingToolbarControl();
+    if (toolbarControl) {
+      const menu = findReviewingToolbarMenu(toolbarControl);
+      return Array.from(menu?.querySelectorAll(
+        '[role="menuitem"], [role="menuitemradio"], [role="option"], .dropdown-item, button, a, option'
+      ) || []).find(node => isReviewingModeNodeAvailable(node) && isReviewingToolbarModeOption(node, enabled)) || null;
+    }
     const candidates = collectReviewingModeOptionNodes()
       .filter(node => isReviewingModeOptionCandidate(node, enabled, options))
       .sort((left, right) => scoreReviewingModeOption(right, enabled) - scoreReviewingModeOption(left, enabled));
@@ -1129,7 +1184,7 @@
   }
 
   function isReviewingModeMenuControlCandidate(node) {
-    if (!node || node.disabled || node.getAttribute?.('aria-disabled') === 'true') {
+    if (!isReviewingModeNodeAvailable(node) || isMenuLikeModeOption(node)) {
       return false;
     }
     const text = readNodeSignalText(node);
@@ -1182,7 +1237,7 @@
   }
 
   function isReviewingModeOptionCandidate(node, enabled, options = {}) {
-    if (!node || node.disabled || node.getAttribute?.('aria-disabled') === 'true') {
+    if (!isReviewingModeNodeAvailable(node)) {
       return false;
     }
     if (options.requireMenuOption && !isMenuLikeModeOption(node)) {
@@ -1228,10 +1283,10 @@
       && !/\bsyntax highlighting\b/i.test(text);
   }
 
-  function findReviewingActivationControl() {
+  function findReviewingActivationControl(enabled = true) {
     const nodes = collectReviewingControlNodes();
     const candidates = nodes
-      .filter(node => isReviewingActivationCandidate(node))
+      .filter(node => isReviewingActivationCandidate(node, enabled))
       .sort((left, right) => scoreReviewingControl(right) - scoreReviewingControl(left));
     return candidates[0] || null;
   }
@@ -1255,10 +1310,12 @@
     ]).slice(0, 1500);
   }
 
-  function isReviewingActivationCandidate(node) {
-    if (!node || node.disabled || node.getAttribute?.('aria-disabled') === 'true') {
+  function isReviewingActivationCandidate(node, enabled) {
+    if (!isReviewingModeNodeAvailable(node) || isMenuLikeModeOption(node)) {
       return false;
     }
+    // A standalone Reviewing command enables tracking; it cannot open Editing.
+    if (!enabled && !node.getAttribute?.('aria-haspopup') && !node.hasAttribute?.('aria-expanded')) return false;
     const text = readNodeSignalText(node);
     return /\breviewing\b|\btrack(?:ed)? changes?\b|\bsuggest(?:ing|ions?)\b/i.test(text)
       && !/\breview panel\b/i.test(text);

package/extension/src/popup.js

@@ -1,10 +1,17 @@
 (function initPopup() {
   'use strict';
 
+  // Keep only copy produced by this popup eligible for a language refresh.
+  const popupCopyPairs = new Map();
+  let newSiteCopyNodes = [];
+
   const popupScriptUrl = document.currentScript?.src || chrome.runtime.getURL('src/popup.js');
   ensureMinimalPopupShell();
   const CodexOverleafCompatibility = window.CodexOverleafCompatibility;
-  const DEFAULT_INSTALL_COMMAND = CodexOverleafCompatibility?.buildInstallCommand?.(
+  const isManagedInstall = chrome.runtime.getManifest()?.background?.service_worker === 'bootstrap/background.js'
+    || window.__CODEX_OVERLEAF_RUNTIME_PREFIX__ === 'runtime/';
+  let installIdentity = { managed: isManagedInstall };
+  const DEFAULT_INSTALL_COMMAND = isManagedInstall ? '' : CodexOverleafCompatibility?.buildInstallCommand?.(
     undefined,
     undefined,
     getCurrentExtensionId()
@@ -71,6 +78,7 @@
   });
 
   copyInstallCommand.addEventListener('click', async () => {
+    if (!currentInstallCommand) return;
     copyInstallCommand.disabled = true;
     copyFeedback.hidden = true;
     try {
@@ -81,7 +89,7 @@
       copyFeedback.textContent = utx('Copy failed. Select the command above to copy it.', '复制失败，可选中上方命令复制。');
       copyFeedback.hidden = false;
     } finally {
-      copyInstallCommand.disabled = false;
+      copyInstallCommand.disabled = !currentInstallCommand;
     }
   });
 
@@ -157,6 +165,7 @@
       const granted = await chrome.permissions.request({ origins: missing }).catch(() => false);
       if (granted) section.remove();
     });
+    newSiteCopyNodes = [title, detail, button];
     section.append(title, detail, button);
     document.getElementById('popup-shell')?.append(section);
   }
@@ -172,10 +181,10 @@
     connectionDetails.setAttribute('aria-label', utx('Version details', '版本信息'));
     connectionToggle.title = utx('Show or hide version details', '展开或收起版本信息');
     copyInstallCommand.textContent = utx('Copy install command', '复制安装命令');
+    [status, copyFeedback, ...newSiteCopyNodes].forEach(refreshPopupCopy);
     if (lastCompatibility) {
       setVersionStatus(lastCompatibility);
-      if (!nativeInstall.hidden) nativeStatusMessage.textContent = getNativeStatusMessage(
-        lastCompatibility.status, getCompatibilityClassification(lastCompatibility));
+      if (!nativeInstall.hidden) showNativeInstallGuide(lastCompatibility);
     }
   }
 
@@ -217,6 +226,7 @@
   }
 
   async function checkNativeHost() {
+    await readInstallIdentity();
     try {
       const response = await chrome.runtime.sendMessage({
         type: 'codex-overleaf/native-request',
@@ -244,11 +254,29 @@
     }
   }
 
+  async function readInstallIdentity() {
+    if (!isManagedInstall) return;
+    try {
+      const response = await fetch(chrome.runtime.getURL('.codex-overleaf-managed-extension.json'));
+      const marker = response.ok ? await response.json() : null;
+      if (marker?.managedBy === 'codex-overleaf-link' && marker.kind === 'extension'
+        && marker.installIdentity?.extensionId === getCurrentExtensionId()) {
+        installIdentity = { ...marker.installIdentity, managed: true };
+      }
+    } catch (_) { /* Older markers cannot prove the original root or browser. */ }
+  }
+
   function showNativeInstallGuide(compatibility = {}) {
     nativeInstall.hidden = false;
     currentInstallCommand = getCompatibilityUpdateCommand(compatibility);
     installCommand.textContent = currentInstallCommand;
-    nativeStatusMessage.textContent = getNativeStatusMessage(compatibility.status, getCompatibilityClassification(compatibility));
+    copyInstallCommand.disabled = !currentInstallCommand;
+    nativeStatusMessage.textContent = !currentInstallCommand && isManagedInstall
+      ? utx('Repair this Managed installation using its original managed root, browser and extension ID. Rerun the original install-managed command with those parameters.',
+        '修复此托管安装需要原管理根目录、浏览器和扩展 ID。请使用这些原参数重新运行 install-managed 安装命令。')
+      : getNativeStatusMessage(compatibility.status, getCompatibilityClassification(compatibility))
+        + ((compatibility.native?.platform || installIdentity.platform) === 'win32' && isManagedInstall
+          ? utx(' Run the command in PowerShell.', ' 请在 PowerShell 中运行该命令。') : '');
   }
 
   function evaluateNativeCompatibility(response) {
@@ -303,7 +331,8 @@
       version: CodexOverleafCompatibility?.BUILD_TARGET_VERSION ||
         chrome.runtime.getManifest?.().version ||
         '',
-      extensionId: getCurrentExtensionId()
+      extensionId: getCurrentExtensionId(),
+      ...(isManagedInstall ? { installIdentity } : {})
     };
   }
 
@@ -331,8 +360,9 @@
     return CodexOverleafCompatibility?.buildInstallCommand?.(
       compatibility.recommendedVersion || CodexOverleafCompatibility.BUILD_TARGET_VERSION,
       compatibility.native?.platform || compatibility.platform,
-      getCurrentExtensionId()
-    ) || compatibility.updateCommand || compatibility.installCommand || DEFAULT_INSTALL_COMMAND;
+      getCurrentExtensionId(),
+      installIdentity
+    ) || (isManagedInstall ? '' : compatibility.updateCommand || compatibility.installCommand || DEFAULT_INSTALL_COMMAND);
   }
 
   function getStatusIconText(classification) {
@@ -558,7 +588,7 @@ async function sendConsentAction(action) {
       const summary = document.createElement('summary');
       summary.textContent = utx('Technical details', '技术详情');
       const code = document.createElement('code');
-      code.textContent = [state.code, state.message].filter(Boolean).join(': ');
+      code.textContent = [state.code, formatUpdateFailure(state)].filter(Boolean).join(': ');
       details.append(summary, code);
       card.append(details);
     }
@@ -668,12 +698,26 @@ async function sendConsentAction(action) {
       awaiting_health: [utx('Checking updated components', '正在检查更新后的组件'), latest, utx('Restarting and checking both components', '正在重启并检查两个组件')],
       committed: [utx('Update complete', '更新完成'), latest || current, utx('Extension and Native Host are healthy.', '扩展与 Native Host 均运行正常。')],
       rolled_back: [utx('Previous version restored', '已恢复上一版本'), current, utx('Health check failed, so the previous coordinated pair was restored.', '健康检查失败，已恢复上一组协调版本。')],
-      failed: [utx('Update could not continue', '更新无法继续'), latest, state.message || utx('Check the details and retry.', '请查看详情后重试。')]
+      failed: [utx('Update could not continue', '更新无法继续'), latest, formatUpdateFailure(state) || utx('Check the details and retry.', '请查看详情后重试。')]
     };
     const value = map[state.state] || map.idle;
     return { title: value[0], version: value[1], detail: value[2], phase: value[2] };
   }
 
+  function formatUpdateFailure(state = {}) {
+    const code = String(state.code || '');
+    if (code === 'update_recovery_pending') return utx('The update result is being checked. Recovery has not been confirmed.', '正在确认更新结果，恢复状态尚未确认。');
+    if (['update_bootstrap_health_timeout', 'update_bootstrap_reload_failed'].includes(code)) return utx('The updated startup components did not finish restarting and confirming. Check recovery before retrying.', '更新后的启动组件未能完成重启和确认，请先检查恢复状态。');
+    if (['update_bootstrap_source_mismatch', 'update_bootstrap_source_version_mismatch'].includes(code)) return utx('The installed startup files do not match a supported update source. Restore the previous version in Settings, or reinstall once.', '已安装的启动文件与支持的升级来源不一致。请在设置中恢复到上一版本，或重新安装一次。');
+    if (['update_bootstrap_record_missing', 'update_bootstrap_record_invalid', 'update_bootstrap_backup_mismatch', 'update_bootstrap_already_restoring'].includes(code)) return utx('The startup recovery material could not be confirmed. The update result remains unconfirmed.', '尚未确认启动组件的恢复材料有效，更新结果仍待确认。');
+    if (['update_bootstrap_confirmation_pending', 'update_bootstrap_native_restart_required'].includes(code)) return utx('Waiting for the updated startup components and Native Host to finish restarting and confirming.', '正在等待更新后的启动组件和本机服务完成重启及确认。');
+    if (code === 'update_bootstrap_monitor_unavailable') return utx('The update recovery monitor could not start. Check recovery before retrying.', '更新恢复监护程序未能启动，请先检查恢复状态。');
+    if (['update_bootstrap_transaction_mismatch', 'update_bootstrap_transaction_invalid'].includes(code)) return utx('The startup update transaction could not be matched. Check recovery before retrying.', '未能匹配启动组件的更新事务，请先检查恢复状态。');
+    if (code.startsWith('update_bootstrap_')) return utx('The startup update package or installed files could not be verified. Check recovery before retrying.', '无法验证启动组件更新包或已安装文件，请先检查恢复状态。');
+    if (['update_health_failed', 'update_request_failed', 'update_failed'].includes(code)) return utx('The updated components could not be confirmed. Check recovery before retrying.', '尚未确认更新后的组件正常，请先检查恢复状态。');
+    return state.message || '';
+  }
+
   function formatBlocker(blocker) {
     const labels = {
       unsaved: utx('Overleaf has not confirmed that this document is saved.', 'Overleaf 尚未确认当前文档已保存。'),
@@ -688,7 +732,15 @@ async function sendConsentAction(action) {
     return labels[blocker] || utx('Waiting until every Overleaf tab is saved and idle.', '正在等待所有 Overleaf 标签页完成保存并进入空闲状态。');
   }
 
+  function refreshPopupCopy(element) {
+    const pair = popupCopyPairs.get(element?.textContent);
+    if (pair) element.textContent = utx(...pair);
+  }
+
   function utx(english, chinese) {
+    const pair = [english, chinese];
+    popupCopyPairs.set(english, pair);
+    popupCopyPairs.set(chinese, pair);
     const locale = document.documentElement?.lang || 'en';
     return /^zh\b/i.test(locale) ? chinese : english;
   }