codex-overleaf-link 2.4.1 → 2.5.1

package/extension/src/content/updateNotice.js

@@ -11,6 +11,8 @@
   let currentView = null;
   let mountedPanel = null;
   let actionInFlight = false;
+  let cancellationInFlight = false;
+  let actionSequence = 0;
   let listenerInstalled = false;
   let getLocale = () => '';
   let settingsRoot = null;
@@ -68,42 +70,62 @@
 
   async function handleClick(event) {
     const action = event.target?.closest?.('[data-update-notice-action]')?.dataset?.updateNoticeAction;
-    if (!action || actionInFlight) return;
+    if (!action) return;
+    if (action === 'release-notes') {
+      const version = currentView?.state?.latestVersion || '';
+      window.open('https://github.com/Ghqqqq/codex-overleaf-link/releases/tag/v' + version, '_blank', 'noopener');
+      return;
+    }
     if (action === 'copy-manual') {
       try {
         await navigator.clipboard.writeText(manualUpdateCommand(currentView?.state));
         manualCommandCopied = true;
         render();
-        setTimeout(() => {
-          manualCommandCopied = false;
-          render();
-        }, 1800);
-      } catch (_error) {
-        manualCommandCopied = false;
-      }
+        setTimeout(() => { manualCommandCopied = false; render(); }, 1800);
+      } catch (_) { manualCommandCopied = false; }
       return;
     }
+    return runUpdateAction(action);
+  }
+
+  async function runUpdateAction(action) {
+    const cancelling = action === 'cancel' || action === 'later';
+    if (cancellationInFlight || ((actionInFlight || settingsActionInFlight) && !cancelling)) return;
+    const sequence = ++actionSequence;
     actionInFlight = true;
+    settingsActionInFlight = true;
+    cancellationInFlight = cancelling;
     render();
     try {
-      currentView = await request({
+      const view = await request({
+        check: 'codex-overleaf/consent-update-check',
         install: 'codex-overleaf/consent-update-install',
         retry: 'codex-overleaf/consent-update-check',
         later: 'codex-overleaf/consent-update-later',
+        cancel: 'codex-overleaf/consent-update-cancel',
+        recover: 'codex-overleaf/consent-update-recover',
         dismiss: 'codex-overleaf/consent-update-dismiss',
         reload: 'codex-overleaf/consent-update-reload'
       }[action]);
+      if (sequence === actionSequence) currentView = view;
     } catch (error) {
-      currentView = await reconcileAfterActionError(error, {
-        action,
-        fallbackMessage: tx('Update failed.', '更新失败。')
-      });
+      if (sequence === actionSequence) {
+        const view = await reconcileAfterActionError(error, {
+          action, fallbackMessage: tx('Update action failed.', '更新操作失败。')
+        });
+        if (sequence === actionSequence) currentView = view;
+      }
     } finally {
-      actionInFlight = false;
-      render();
+      if (sequence === actionSequence) {
+        actionInFlight = false;
+        settingsActionInFlight = false;
+        cancellationInFlight = false;
+        render();
+      }
     }
   }
 
+
   async function request(type) {
     if (!type) throw new Error('Unknown update action.');
     const response = await chrome.runtime.sendMessage({ type });
@@ -164,8 +186,9 @@
     restartWatchdog = setTimeout(async () => {
       try {
         const view = await request('codex-overleaf/consent-update-get-state');
-        if (view?.state && !ACTIVE_UPDATE_STATES.has(view.state.state)) {
+        if (view?.state) {
           currentView = view;
+          if (ACTIVE_UPDATE_STATES.has(view.state.state)) scheduleRestartWatchdog();
         } else {
           currentView = buildFailedView('update_recovery_timeout', tx(
             'The update did not finish restarting. Retry or use the manual recovery command.',
@@ -206,41 +229,23 @@
     renderSettings();
   }
 
-  async function handleSettingsAction() {
-    if (settingsActionInFlight) return;
-    settingsActionInFlight = true;
-    renderSettings();
-    const stateName = currentView?.state?.state || 'idle';
-    let requestedAction = 'check';
-    try {
-      if (['reload_required', 'reload_tabs_required'].includes(stateName)) {
-        requestedAction = 'reload';
-        currentView = await request('codex-overleaf/consent-update-reload');
-      } else if (stateName === 'update_available') {
-        requestedAction = 'install';
-        currentView = await request('codex-overleaf/consent-update-install');
-      } else if (['failed', 'rolled_back'].includes(stateName)) {
-        currentView = await request('codex-overleaf/consent-update-check');
-      } else if (!ACTIVE_UPDATE_STATES.has(stateName)) {
-        currentView = await request('codex-overleaf/consent-update-check');
-      } else {
-        return;
-      }
-    } catch (error) {
-      currentView = await reconcileAfterActionError(error, {
-        action: requestedAction,
-        fallbackMessage: tx('Update check failed.', '更新检查失败。')
-      });
-    } finally {
-      settingsActionInFlight = false;
-      render();
+  function handleSettingsAction() {
+    const state = currentView?.state || {};
+    if (state.recoveryPending) return runUpdateAction('recover');
+    if (state.cancelRequested || ['checking', 'downloading', 'staged', 'waiting_for_idle'].includes(state.state)) {
+      return runUpdateAction('cancel');
     }
+    if (['reload_required', 'reload_tabs_required'].includes(state.state)) return runUpdateAction('reload');
+    if (state.state === 'update_available') return runUpdateAction('install');
+    if (!ACTIVE_UPDATE_STATES.has(state.state)) return runUpdateAction('check');
   }
 
+
   function render() {
     if (!currentView) return;
     renderSettings();
     if (!notice) return;
+    notice.setAttribute('aria-label', tx('Stable update', '稳定版更新'));
     if (!currentView.showPanel) {
       notice.hidden = true;
       notice.replaceChildren();
@@ -270,7 +275,24 @@
     detail.textContent = copy.detail;
     body.append(eyebrow, title, detail);
 
-    if (state.state === 'failed') {
+    if (state.state === 'manual_install_required') {
+      const steps = document.createElement('ol');
+      steps.className = 'codex-update-notice-steps';
+      for (const text of [
+        tx('Run this once in a terminal:', '在终端运行一次：'),
+        tx('Reload the extension in chrome://extensions, then refresh Overleaf.', '在 chrome://extensions 里重新加载扩展，再刷新 Overleaf。')
+      ]) steps.append(Object.assign(document.createElement('li'), { textContent: text }));
+      const command = document.createElement('code');
+      command.className = 'codex-update-notice-command';
+      command.textContent = manualUpdateCommand(state);
+      steps.firstElementChild.append(command);
+      const keep = document.createElement('span');
+      keep.className = 'codex-update-notice-recovery';
+      keep.textContent = tx('Sessions, settings, provider keys and project mirrors are kept.', '会话、设置、模型服务的密钥和项目镜像都会保留。');
+      body.append(steps, keep);
+    }
+
+    if (state.state === 'failed' && !state.cancelRequested && !state.recoveryPending) {
       const recovery = document.createElement('span');
       recovery.className = 'codex-update-notice-recovery';
       recovery.textContent = tx('Manual recovery:', '手动恢复：');
@@ -280,7 +302,7 @@
       body.append(recovery, command);
     }
 
-    if (!['update_available', 'failed', 'rolled_back', 'reload_required', 'reload_tabs_required'].includes(state.state)) {
+    if (!['update_available', 'manual_install_required', 'failed', 'rolled_back', 'reload_required', 'reload_tabs_required'].includes(state.state)) {
       const bar = document.createElement('div');
       bar.className = 'codex-update-notice-progress' + (progress.determinate ? '' : ' is-indeterminate');
       bar.setAttribute('role', 'progressbar');
@@ -302,7 +324,9 @@
       button.dataset.updateNoticeAction = action.id;
       button.className = action.primary ? 'is-primary' : '';
       button.textContent = action.label;
-      button.disabled = actionInFlight;
+      button.disabled = action.id === 'cancel'
+        ? cancellationInFlight || (state.cancelRequested && !state.code)
+        : actionInFlight || settingsActionInFlight;
       actions.append(button);
     }
     notice.replaceChildren(body, actions);
@@ -332,7 +356,14 @@
     let statusText = '';
     let buttonText = tx('Check for updates', '检查更新');
 
-    if (['reload_required', 'reload_tabs_required'].includes(stateName)) {
+    if (stateName === 'idle' && state.code === 'update_cooldown') {
+      const until = Number(state.cooldownUntil || 0);
+      const time = until > 0 && Number.isFinite(until) ? new Date(until).toLocaleString(getLocale() || undefined) : '';
+      statusText = tx(
+        `Update v${latestVersion} is paused after a failed installation. ${time ? `Check again after ${time}.` : 'Check again after its cooldown ends.'}`,
+        `v${latestVersion} 安装失败后已暂停更新。${time ? `请在 ${time} 后再次检查。` : '请在冷却期结束后再次检查。'}`
+      );
+    } else if (['reload_required', 'reload_tabs_required'].includes(stateName)) {
       summaryText = tx(`Installed v${latestVersion}; running extension v${currentVersion}.`, `已安装 v${latestVersion}；扩展当前运行 v${currentVersion}。`);
       statusText = getCopy(state).detail;
       buttonText = stateName === 'reload_required' ? tx('Reload extension', '重新加载扩展') : tx('Refresh Overleaf tabs', '刷新 Overleaf 标签页');
@@ -343,11 +374,14 @@
       summaryText = tx(`Stable v${latestVersion} is available.`, `稳定版本 v${latestVersion} 已可用。`);
       statusText = tx('Ready to download and verify.', '已可下载并验证。');
       buttonText = tx('Update now', '立即更新');
+    } else if (stateName === 'manual_install_required') {
+      summaryText = tx(`v${latestVersion} is available but needs a one-time reinstall.`, `v${latestVersion} 已发布，但需要重新安装一次。`);
+      statusText = manualReasonText(state) || getCopy(state).detail;
     } else if (ACTIVE_UPDATE_STATES.has(stateName)) {
       statusText = getCopy(state).detail;
       buttonText = tx('Update in progress', '更新进行中');
     } else if (stateName === 'failed' || stateName === 'rolled_back') {
-      statusText = state.message || getCopy(state).detail;
+      statusText = formatUpdateMessage(state) || getCopy(state).detail;
       buttonText = tx('Retry', '重试');
     } else if (stateName === 'committed') {
       summaryText = tx(`Current v${currentVersion}. Update completed successfully.`, `当前版本 v${currentVersion}。更新已成功完成。`);
@@ -358,11 +392,29 @@
     status.textContent = statusText;
     status.hidden = !statusText;
     button.textContent = buttonText;
-    button.disabled = settingsActionInFlight || stateName === 'checking' || ACTIVE_UPDATE_STATES.has(stateName);
+    const cancellable = state.cancelRequested || ['checking', 'downloading', 'staged', 'waiting_for_idle'].includes(stateName);
+    if (state.recoveryPending) {
+      button.textContent = tx('Check recovery', '检查恢复状态');
+      button.disabled = actionInFlight || settingsActionInFlight;
+    } else if (cancellable) {
+      button.textContent = state.cancelRequested && !state.code
+        ? tx('Cancelling…', '正在取消…')
+        : state.cancelRequested ? tx('Retry cancellation', '重试取消') : tx('Cancel update', '取消更新');
+      button.disabled = cancellationInFlight || (state.cancelRequested && !state.code);
+    } else {
+      button.disabled = actionInFlight || settingsActionInFlight || ACTIVE_UPDATE_STATES.has(stateName);
+    }
   }
 
   function visibleActions(state) {
-    if (actionInFlight) return [];
+    const value = currentView?.state || {};
+    if (value.recoveryPending) return [{ id: 'recover', label: tx('Check recovery', '检查恢复状态'), primary: true }];
+    if (value.cancelRequested || ['checking', 'downloading'].includes(state)) {
+      return [{ id: 'cancel', label: value.cancelRequested
+        ? value.code ? tx('Retry cancellation', '重试取消') : tx('Cancelling…', '正在取消…')
+        : tx('Cancel update', '取消更新'), primary: false }];
+    }
+    if (actionInFlight && !['staged', 'waiting_for_idle'].includes(state)) return [];
     if (['reload_required', 'reload_tabs_required'].includes(state)) {
       return [{ id: 'reload', label: state === 'reload_required'
         ? tx('Reload extension', '重新加载扩展') : tx('Refresh Overleaf tabs', '刷新 Overleaf 标签页'), primary: true }];
@@ -374,7 +426,14 @@
       ];
     }
     if (['staged', 'waiting_for_idle'].includes(state)) {
-      return [{ id: 'later', label: tx('Later', '稍后'), primary: false }];
+      return [{ id: 'cancel', label: tx('Cancel update', '取消更新'), primary: false }];
+    }
+    if (state === 'manual_install_required') {
+      return [
+        { id: 'later', label: tx('Later', '稍后'), primary: false },
+        { id: 'release-notes', label: tx('Release notes', '发布说明'), primary: false },
+        { id: 'copy-manual', label: manualCommandCopied ? tx('Copied', '已复制') : tx('Copy command', '复制命令'), primary: true }
+      ];
     }
     if (['failed', 'rolled_back'].includes(state)) {
       return [
@@ -390,15 +449,30 @@
 
   function getCopy(state) {
     const target = state.latestVersion ? 'v' + state.latestVersion : '';
+    if (state.cancelRequested) return {
+      eyebrow: tx('Cancelling update', '正在取消更新'), title: target,
+      detail: formatUpdateMessage(state) || tx('Stopping this update and clearing its authorization.', '正在停止本次更新并清理更新授权。')
+    };
+    if (state.recoveryPending) return {
+      eyebrow: tx('Checking update recovery', '正在确认更新恢复状态'), title: target,
+      detail: formatUpdateMessage(state) || tx('Waiting for the installed version to be confirmed.', '正在确认实际安装的版本。')
+    };
     const blocker = blockersCopy(state.blockers?.length ? state.blockers : [state.blocker]);
     return {
+      checking: { eyebrow: tx('Checking for updates', '正在检查更新'), title: target,
+        detail: tx('Reading the latest signed release.', '正在读取最新签名版本。') },
       reload_required: {
         eyebrow: tx('Installed, awaiting reload', '已安装，等待加载'), title: target,
-        detail: state.message || tx('The new files are installed. Reload the extension when Overleaf is saved and idle.', '新版文件已安装，请在 Overleaf 保存并空闲后重新加载扩展。')
+        detail: formatUpdateMessage(state) || tx('The new files are installed. Reload the extension when Overleaf is saved and idle.', '新版文件已安装，请在 Overleaf 保存并空闲后重新加载扩展。')
       },
       reload_tabs_required: {
         eyebrow: tx('Updated runtime is ready', '新版运行组件已就绪'), title: target,
-        detail: state.message || tx('Refresh the saved, idle Overleaf tabs to load the updated panel.', '刷新已保存且空闲的 Overleaf 标签页以加载新版面板。')
+        detail: formatUpdateMessage(state) || tx('Refresh the saved, idle Overleaf tabs to load the updated panel.', '刷新已保存且空闲的 Overleaf 标签页以加载新版面板。')
+      },
+      manual_install_required: {
+        eyebrow: tx('Reinstall needed for this update', '这次更新需要重新安装'),
+        title: target,
+        detail: manualReasonText(state) || tx('This release changes what Chrome lets the extension do, so Update now cannot apply it.', '这一版改动了 Chrome 授予扩展的权限，无法通过“立即更新”完成。')
       },
       update_available: {
         eyebrow: tx('Update available', '发现新版本'),
@@ -443,7 +517,7 @@
       failed: {
         eyebrow: tx('Update could not continue', '更新无法继续'),
         title: target,
-        detail: state.message || tx('Review the update details and retry.', '请查看更新详情后重试。')
+        detail: formatUpdateMessage(state) || tx('Review the update details and retry.', '请查看更新详情后重试。')
       }
     }[state.state] || { eyebrow: '', title: '', detail: '' };
   }
@@ -455,6 +529,45 @@
     return `npm exec --yes codex-overleaf-link@${version} -- install-managed`;
   }
 
+  function formatUpdateMessage(state = {}) {
+    const code = state.code || '';
+    const messages = {
+      update_phase_timeout: ['The update timed out and its download was stopped. Retry when the connection is available.', '更新超时，下载已停止。连接恢复后请重试。'],
+      update_not_applied: ['The update was stopped before installation. Retry when ready.', '更新已在安装前停止，可准备就绪后重试。'],
+      update_recovery_pending: ['The update result is being checked. Recovery has not been confirmed.', '正在确认更新结果，恢复状态尚未确认。'],
+      update_rolled_back: ['The previous version has been restored.', '已恢复上一版本。'],
+      update_not_managed: ['Run install-managed once to enable coordinated automatic updates.', '请先运行一次 install-managed，以启用扩展与本机服务的协调更新。'],
+      update_native_busy: ['Native Host is still processing a Codex task.', 'Native Host 仍在处理 Codex 任务。'],
+      update_revoke_too_late: ['The update is already being installed. Wait for its result.', '更新已进入安装，请等待结果。'],
+      update_cancel_unconfirmed: ['Update cancellation is unconfirmed. Check recovery before retrying.', '尚未确认更新已取消，请先检查恢复状态。'],
+      update_apply_unconfirmed: ['Update installation is unconfirmed. Check recovery before retrying.', '尚未确认更新安装结果，请先检查恢复状态。'],
+      update_rollback_unconfirmed: ['Restoring the previous version is unconfirmed. Check recovery before retrying.', '尚未确认旧版本已恢复，请先检查恢复状态。'],
+      update_reload_unavailable: ['No verified installed update is awaiting reload.', '当前没有已验证且等待重载的更新。'],
+      update_network_cancelled: ['The update download was cancelled.', '更新下载已取消。'],
+      update_apply_failed: ['The update could not be installed. Check recovery and retry.', '无法安装更新，请检查恢复状态后重试。']
+    };
+    if (messages[code]) return tx(...messages[code]);
+    if (['update_health_failed', 'update_request_failed', 'update_failed'].includes(code)) return tx('The updated components could not be confirmed. Check recovery before retrying.', '尚未确认更新后的组件正常，请先检查恢复状态。');
+    if (['update_bootstrap_health_timeout', 'update_bootstrap_reload_failed'].includes(code)) return tx('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 tx('The installed startup files do not match a supported update source. Check recovery before retrying.', '已安装的启动文件与支持的升级来源不一致，请先检查恢复状态。');
+    if (['update_bootstrap_record_missing', 'update_bootstrap_record_invalid', 'update_bootstrap_backup_mismatch', 'update_bootstrap_already_restoring'].includes(code)) return tx('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 tx('Waiting for the updated startup components and Native Host to finish restarting and confirming.', '正在等待更新后的启动组件和本机服务完成重启及确认。');
+    if (code === 'update_bootstrap_monitor_unavailable') return tx('The update recovery monitor could not start. Check recovery before retrying.', '更新恢复监护程序未能启动，请先检查恢复状态。');
+    if (['update_bootstrap_transaction_mismatch', 'update_bootstrap_transaction_invalid'].includes(code)) return tx('The startup update transaction could not be matched. Check recovery before retrying.', '未能匹配启动组件的更新事务，请先检查恢复状态。');
+    if (code.startsWith('update_bootstrap_')) return tx('The startup update package or installed files could not be verified. Check recovery before retrying.', '无法验证启动组件更新包或已安装文件，请先检查恢复状态。');
+    if (['update_reload_required', 'update_reload_busy'].includes(code)) {
+      const match = /^Reload is waiting for Overleaf to be saved and idle \(([^)]+)\)\.$/.exec(state.message || '');
+      if (match) return blockersCopy(match[1].split(', '));
+    }
+    if (['update_check_timeout', 'update_activation_timeout', 'update_status_timeout'].includes(code)) return tx('The update operation timed out. Check recovery or retry when the connection is available.', '更新操作超时，请检查恢复状态，或在连接恢复后重试。');
+    if (['update_candidate_missing', 'update_candidate_stale', 'update_not_staged', 'update_staged_archive_invalid', 'update_recovery_superseded'].includes(code)) return tx('No current verified update is ready. Check for updates again.', '当前没有已验证且可安装的更新，请重新检查更新。');
+    if (['update_authorization_in_progress', 'update_transaction_in_progress', 'update_transaction_locked'].includes(code)) return tx('Another update operation is in progress. Wait for it to finish.', '另一项更新操作正在进行，请等待其完成。');
+    if (['update_authorization_invalid', 'update_consent_required', 'update_consent_mismatch', 'update_transaction_mismatch', 'update_transaction_state_changed'].includes(code)) return tx('The update authorization or transaction changed. Check for updates and authorize the current candidate again.', '更新授权或事务已变化，请重新检查更新并确认当前候选版本。');
+    if (['update_archive_checksum_invalid', 'update_archive_compressed_limit', 'update_archive_duplicate_path', 'update_archive_file_count_limit', 'update_archive_file_limit', 'update_archive_invalid', 'update_archive_path_forbidden', 'update_archive_path_too_long', 'update_archive_required_file_missing', 'update_archive_total_limit', 'update_archive_truncated', 'update_archive_type_forbidden', 'update_staging_not_empty', 'update_operation_invalid', 'update_bundle_hash_invalid', 'update_bundle_name_invalid', 'update_bundle_size_invalid', 'update_manifest_artifacts_invalid', 'update_manifest_commit_invalid', 'update_manifest_invalid', 'update_manifest_manual_install_invalid', 'update_manifest_origin_mismatch', 'update_manifest_protocol_invalid', 'update_manifest_schema_unsupported', 'update_manifest_timestamp_invalid', 'update_manifest_too_large', 'update_manifest_version_invalid', 'update_signature_algorithm_unsupported', 'update_signature_invalid', 'update_signature_key_invalid', 'update_signature_key_unknown', 'update_signature_too_large', 'update_version_invalid'].includes(code)) return tx('The signed update or archive could not be verified. Check the release details and retry.', '无法验证更新签名或压缩包，请检查发布详情后重试。');
+    if (['update_github_http_error', 'update_github_response_invalid', 'update_asset_missing', 'update_asset_url_forbidden', 'update_release_asset_invalid', 'update_release_manifest_mismatch', 'update_bundle_size_mismatch', 'update_bundle_hash_mismatch', 'update_native_version_mismatch', 'update_extension_version_mismatch', 'update_runtime_manifest_invalid', 'update_runtime_asset_missing', 'update_bootstrap_manifest_invalid', 'update_managed_layout_invalid', 'update_marker_invalid', 'update_current_version_invalid', 'update_health_version_mismatch', 'update_confirmation_unexpected', 'update_rollback_unavailable'].includes(code)) return tx('The update or installed files could not be verified. Check the update details and repair or retry.', '无法验证更新或已安装文件，请检查更新详情后修复或重试。');
+    return state.message || '';
+  }
+
   function blockerCopy(value) {
     return {
       unsaved: tx('Overleaf has not confirmed that this document is saved.', 'Overleaf 尚未确认当前文档已保存。'),
@@ -475,6 +588,7 @@
       tab_unavailable: tx('An Overleaf tab is unavailable for the safety check.', '某个 Overleaf 标签页当前无法完成安全检查。'),
       idle_probe_failed: tx('The Overleaf safety check failed. Reload the affected tab and retry.', 'Overleaf 安全检查失败；请刷新受影响的标签页后重试。'),
       native_project_locked: tx('Native Host still holds a project lock.', 'Native Host 仍持有项目锁。'),
+      native_process_stop_unconfirmed: tx('A previous Codex process has not yet confirmed its exit.', '前一次 Codex 进程尚未确认退出。'),
       native_run_active: tx('Native Host is still processing a task.', 'Native Host 仍在处理任务。'),
       busy: tx('A component is still busy.', '某个组件仍处于忙碌状态。')
     }[value] || tx('Waiting until every Overleaf tab is saved and idle.', '正在等待所有 Overleaf 标签页完成保存并进入空闲状态。');
@@ -488,10 +602,19 @@
     );
   }
 
+  function manualReasonText(state = {}) {
+    if (state.code === 'prerelease_promotion_requires_manual_update') {
+      return tx('The installed release candidate has the same version number as the stable release. Reinstall to use the stable release.',
+        '已安装的候选版与稳定版使用相同版本号。请重新安装以使用稳定版。');
+    }
+    const reason = state.manualReason || {};
+    return tx(reason.en || reason.zh || '', reason.zh || reason.en || '');
+  }
+
   function tx(english, chinese) {
     const locale = String(getLocale() || document.documentElement?.lang || 'en');
     return /^zh\b/i.test(locale) ? chinese : english;
   }
 
-  return Object.freeze({ mount });
+  return Object.freeze({ mount, refreshLocale: render });
 });

package/extension/src/content/updateSafetyReceiver.js

@@ -0,0 +1,58 @@
+(function installUpdateSafetyReceiver(root) {
+  'use strict';
+  if (root.__codexOverleafUpdateSafetyReceiverInstalled) return;
+  let binding, idle, inFlight = false;
+  const blocked = () => ({ idle: false, saved: false, blockers: ['tab_probe_unavailable'] });
+  function install(next, dependencies) {
+    if (!next?.transactionId || !next.token || next.url !== location.href) return { ok: false };
+    if (binding) {
+      if (binding.transactionId !== next.transactionId || binding.targetVersion !== next.targetVersion
+        || binding.documentId !== next.documentId || binding.url !== next.url || inFlight) return { ok: false };
+      binding = Object.freeze({ ...next });
+      return { ok: true, url: location.href };
+    }
+    binding = Object.freeze({ ...next });
+    const pageWrites = new Set();
+    const visible = node => !node.hidden && node.getAttribute('aria-hidden') !== 'true' && node.getClientRects().length > 0;
+    const { UpdateIdle, PageRpcContract } = dependencies;
+    idle = UpdateIdle.create({ document, includePanelActivity: true,
+      getBusyState: () => ({ reviewAction: pageWrites.size > 0
+          || [...document.querySelectorAll('#codex-overleaf-panel [data-run-accept-confirm], #codex-overleaf-panel button:disabled')]
+            .some(node => visible(node) && (node.hasAttribute('data-run-accept-confirm') || /Accepting|接受中/.test(node.textContent)
+              || (node.hasAttribute('data-run-undo') && !/Undone|已撤销/.test(node.textContent)
+                && !/Accepted|已接受/.test(node.closest('[data-run-id]')?.querySelector('[data-run-accept]')?.textContent || '')))),
+        run: document.querySelector('#codex-overleaf-panel')?.dataset.running === 'true',
+        cancelling: document.querySelector('#codex-overleaf-panel')?.dataset.cancelling === 'true',
+        dialog: [...document.querySelectorAll('[role="dialog"], dialog[open]')].some(visible) }),
+      checkSaved: async () => {
+        const response = await chrome.runtime.sendMessage({ type: 'codex-overleaf/migration-save-probe', ...binding,
+          nonce: activeNonce });
+        return response?.ok && response.nonce === activeNonce ? response.result : { ok: false, state: 'unavailable' };
+      } });
+    root.addEventListener('message', event => {
+      if (event.source !== root || event.origin !== location.origin || typeof event.data?.id !== 'string') return;
+      const data = event.data;
+      const mutation = PageRpcContract.getMethod(data.method)?.mutation;
+      if (data.source === 'codex-overleaf/content' && ['document', 'page_state', 'navigation'].includes(mutation)) {
+        pageWrites.add(data.id); idle.noteActivity();
+      } else if (data.source === 'codex-overleaf/page' && pageWrites.delete(data.id)) idle.noteActivity();
+    });
+    chrome.runtime.onMessage.addListener((message, sender, respond) => {
+      if (message?.type !== 'codex-overleaf/migration-idle-probe') return undefined;
+      if (sender?.id !== chrome.runtime.id || sender.tab || message.token !== binding.token
+        || message.transactionId !== binding.transactionId || typeof message.nonce !== 'string'
+        || !message.nonce || location.href !== binding.url || inFlight) { respond(blocked()); return false; }
+      inFlight = true;
+      activeNonce = message.nonce;
+      idle.buildIdleProbe().then(result => respond(location.href === binding.url ? {
+        ...result, transactionId: binding.transactionId, token: binding.token, nonce: message.nonce,
+        url: location.href, targetVersion: binding.targetVersion, safetyOnly: true
+      } : blocked())).catch(() => respond(blocked())).finally(() => { inFlight = false; activeNonce = ''; });
+      return true;
+    });
+    return { ok: true, url: location.href };
+  }
+  let activeNonce = '';
+  root.CodexOverleafUpdateSafetyReceiver = Object.freeze({ install });
+  root.__codexOverleafUpdateSafetyReceiverInstalled = true;
+})(globalThis);