codex-overleaf-link 1.9.9 → 1.9.11

package/README.md

@@ -3,7 +3,7 @@
   <h1>Codex Overleaf Link</h1>
   <p><strong>Empower Overleaf with Codex.</strong></p>
   <p>
-    <img src="https://img.shields.io/badge/version-1.9.9-blue" alt="version">
+    <img src="https://img.shields.io/badge/version-1.9.11-blue" alt="version">
     <img src="https://img.shields.io/badge/platform-macOS%20%2F%20Windows%20%2F%20Linux-lightgrey" alt="platform">
     <img src="https://img.shields.io/badge/chrome-MV3-green" alt="chrome manifest v3">
     <img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen" alt="node version">
@@ -38,14 +38,14 @@ One command installs the managed native host **and** managed extension runtime.
 macOS / Linux:
 
 ```bash
-CODEX_OVERLEAF_REF=v1.9.9 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.9/install.sh)"
+CODEX_OVERLEAF_REF=v1.9.11 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.11/install.sh)"
 ```
 
 Windows PowerShell:
 
 ```powershell
-iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.9/install.ps1 -OutFile install.ps1
-$env:CODEX_OVERLEAF_REF='v1.9.9'
+iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.11/install.ps1 -OutFile install.ps1
+$env:CODEX_OVERLEAF_REF='v1.9.11'
 powershell -ExecutionPolicy Bypass -File install.ps1
 ```
 
@@ -56,7 +56,7 @@ Then, in the `chrome://extensions` tab the script opened: enable **Developer mod
 `npm exec` installs the same managed native host and extension runtime without keeping a source checkout. Use it if you prefer a pinned npm package.
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.9 -- install-managed
+npm exec --yes codex-overleaf-link@1.9.11 -- install-managed
 ```
 
 Then, in `chrome://extensions`, enable **Developer mode**, click **Load unpacked**, and select the managed extension path printed by the command. The Release extension zip remains available for explicitly unmanaged/manual installations.
@@ -86,9 +86,9 @@ npm installs, updates, and uninstalls the coordinated managed extension/native p
 
 | Action | Command |
 |--------|---------|
-| Install / update | `npm exec --yes codex-overleaf-link@1.9.9 -- install-managed` |
-| Diagnose | `npm exec --yes codex-overleaf-link@1.9.9 -- doctor` |
-| Uninstall | `npm exec --yes codex-overleaf-link@1.9.9 -- uninstall-managed` |
+| Install / update | `npm exec --yes codex-overleaf-link@1.9.11 -- install-managed` |
+| Diagnose | `npm exec --yes codex-overleaf-link@1.9.11 -- doctor` |
+| Uninstall | `npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-managed` |
 
 Use `--extension-id <chrome-extension-id>` only for a custom/dev unpacked extension id that differs from the official bundled id.
 
@@ -98,13 +98,13 @@ Managed installations discover signed stable updates automatically and apply the
 
 ## GitHub Release Artifacts
 
-The v1.9.9 GitHub Release contains:
+The v1.9.11 GitHub Release contains:
 
-- `codex-overleaf-link-extension-v1.9.9.zip`: loadable Chrome extension package for manual unpacked installation.
-- `codex-overleaf-native-host-v1.9.9.tar.gz`: native host runtime files used by the installer and release verification.
-- `codex-overleaf-link-1.9.9.tgz`: npm native host CLI package for pinned install, doctor, and uninstall flows.
-- `install.sh`: release-pinned macOS / Linux installer that defaults to `v1.9.9` when run directly from the release artifact.
-- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v1.9.9` when run directly from the release artifact.
+- `codex-overleaf-link-extension-v1.9.11.zip`: loadable Chrome extension package for manual unpacked installation.
+- `codex-overleaf-native-host-v1.9.11.tar.gz`: native host runtime files used by the installer and release verification.
+- `codex-overleaf-link-1.9.11.tgz`: npm native host CLI package for pinned install, doctor, and uninstall flows.
+- `install.sh`: release-pinned macOS / Linux installer that defaults to `v1.9.11` when run directly from the release artifact.
+- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v1.9.11` when run directly from the release artifact.
 - `uninstall-native-host.mjs`: native host uninstaller that removes the Chrome Native Messaging manifest, bridge executable, and runtime copy.
 - `nativeHostPlatform.js`, `manifest.js`, `runtimeInstaller.js`: helper files required by the loose uninstaller asset.
 - `SHA256SUMS` and `release-manifest.json`: checksum and artifact metadata for release verification.
@@ -115,7 +115,7 @@ The v1.9.9 GitHub Release contains:
 Remove the native host (use `--browser chromium` on Linux Chromium):
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.9 -- uninstall-managed
+npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-managed
 ```
 
 The same command works on Windows PowerShell. If you installed from a manual checkout or source installer, you can also run `npm run uninstall:native` inside the repo, use `node ~/.codex-overleaf/source/scripts/uninstall-native-host.mjs` on macOS / Linux, or use `node $env:LOCALAPPDATA\CodexOverleaf\source\scripts\uninstall-native-host.mjs` on Windows PowerShell.
@@ -150,13 +150,13 @@ Then remove the extension from `chrome://extensions`. To delete local data: on m
 Linux Chromium install or update:
 
 ```bash
-CODEX_OVERLEAF_REF=v1.9.9 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.9/install.sh)" -- --browser chromium
+CODEX_OVERLEAF_REF=v1.9.11 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v1.9.11/install.sh)" -- --browser chromium
 ```
 
 Linux Chromium uninstall:
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.9 -- uninstall-managed --browser chromium
+npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-managed --browser chromium
 ```
 
 ## Features
@@ -291,7 +291,7 @@ Composer attachments are turn-scoped Codex context. Limits are 8 attachments per
 Re-run any [native host installer](#install), reload the extension in `chrome://extensions`, then refresh the Overleaf tab. This also fixes extension/native version mismatch and native protocol mismatch.
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.9 -- install-managed
+npm exec --yes codex-overleaf-link@1.9.11 -- install-managed
 ```
 
 **The Windows popup or panel shows a Bash recovery command**
@@ -340,8 +340,8 @@ Use this matrix for release-candidate signoff and compatibility reports. Record
 | Browser/channel/version | Google Chrome channel and version. | Google Chrome channel and version. | Google Chrome channel and version. | Chromium channel/package and version. |
 | Install mode | Manual unpacked extension from GitHub Release zip or checkout. | Manual unpacked extension from GitHub Release zip or checkout. | Manual unpacked extension from GitHub Release zip or checkout. | Manual unpacked extension from GitHub Release zip or checkout; native host installed with `--browser chromium`. |
 | Extension id | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. | Bundled id `illdpneeeopfffmiepaejglgmhpmdhdc`, or actual custom id passed with `--extension-id`. |
-| Installer/update command | `npm exec --yes codex-overleaf-link@1.9.9 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.9 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.9 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.9 -- install-managed --browser chromium` |
-| Uninstall command | `npm exec --yes codex-overleaf-link@1.9.9 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.9 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.9 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.9 -- uninstall-managed --browser chromium` |
+| Installer/update command | `npm exec --yes codex-overleaf-link@1.9.11 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.11 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.11 -- install-managed` | `npm exec --yes codex-overleaf-link@1.9.11 -- install-managed --browser chromium` |
+| Uninstall command | `npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-managed --browser chromium` |
 | Manifest/registry path | `~/Library/Application Support/Google/Chrome/NativeMessagingHosts/com.codex.overleaf.json` | `HKCU\Software\Google\Chrome\NativeMessagingHosts\com.codex.overleaf` -> `%LOCALAPPDATA%\CodexOverleaf\native-host-runtime\com.codex.overleaf.json` | `~/.config/google-chrome/NativeMessagingHosts/com.codex.overleaf.json` | `~/.config/chromium/NativeMessagingHosts/com.codex.overleaf.json` |
 | Bridge/runtime/source path | Bridge `~/.codex-overleaf/codex-overleaf-bridge`; runtime `~/.codex-overleaf/native-host-runtime`; source `~/.codex-overleaf/source`. | Bridge `%LOCALAPPDATA%\CodexOverleaf\codex-overleaf-bridge.cmd`; runtime `%LOCALAPPDATA%\CodexOverleaf\native-host-runtime`; source `%LOCALAPPDATA%\CodexOverleaf\source`. | Bridge `~/.codex-overleaf/codex-overleaf-bridge`; runtime `~/.codex-overleaf/native-host-runtime`; source `~/.codex-overleaf/source`. | Bridge `~/.codex-overleaf/codex-overleaf-bridge`; runtime `~/.codex-overleaf/native-host-runtime`; source `~/.codex-overleaf/source`. |
 | Node/Git/Codex/TeX | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. | Node.js >= 20; Git; Codex CLI installed and logged in; TeX optional. |
@@ -377,7 +377,7 @@ Contributions are welcome. Please open an issue before submitting large changes
 The recommended v1.9 installation owns one stable unpacked-extension directory and a versioned native-host directory:
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.9 -- install-managed
+npm exec --yes codex-overleaf-link@1.9.11 -- install-managed
 ```
 
 Load the printed extension path once from `chrome://extensions`. Starting with the next signed stable release, Codex Overleaf Link checks GitHub Releases automatically, downloads and verifies the coordinated extension/native-host bundle, waits until every connected Overleaf tab is saved and idle, and then updates both components together. A failed health check restores the previous version automatically.
@@ -387,11 +387,11 @@ The stable updater ignores drafts and prereleases, performs no telemetry, and ca
 The legacy native-only installer remains available for source or unmanaged extension directories:
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.9 -- install-native
+npm exec --yes codex-overleaf-link@1.9.11 -- install-native
 ```
 
 Legacy native-only installations can be removed with:
 
 ```bash
-npm exec --yes codex-overleaf-link@1.9.9 -- uninstall-native
+npm exec --yes codex-overleaf-link@1.9.11 -- uninstall-native
 ```

package/extension/bootstrap/background.js

@@ -20,9 +20,11 @@ const FAST_IDLE_RETRY_BLOCKERS = new Set(['recent_user_activity', 'save_state_no
 const FAST_IDLE_RETRY_MS = 4000;
 const SLOW_IDLE_RETRY_MS = 15000;
 const IDLE_RETRY_ALARM_MINUTES = 0.5;
+const RUNTIME_RECOVERY_SETTLE_MS = 250;
 
 let idleRetryTimer = null;
 let idleApplyPromise = null;
+let managedRuntimeAssets = null;
 
 let runtimeLoadError = null;
 try {
@@ -103,6 +105,10 @@ async function registerManagedRuntime() {
   }
   const manifest = await response.json();
   validateRuntimeManifest(manifest);
+  managedRuntimeAssets = {
+    js: ['bootstrap/runtimeContext.js', ...manifest.js.map(value => 'runtime/' + value)],
+    css: manifest.css.map(value => 'runtime/' + value)
+  };
   const registered = await chrome.scripting.getRegisteredContentScripts({ ids: [RUNTIME_SCRIPT_ID] });
   if (registered.length) {
     await chrome.scripting.unregisterContentScripts({ ids: [RUNTIME_SCRIPT_ID] });
@@ -110,8 +116,8 @@ async function registerManagedRuntime() {
   await chrome.scripting.registerContentScripts([{
     id: RUNTIME_SCRIPT_ID,
     matches: manifest.matches,
-    js: ['bootstrap/runtimeContext.js', ...manifest.js.map(value => 'runtime/' + value)],
-    css: manifest.css.map(value => 'runtime/' + value),
+    js: managedRuntimeAssets.js,
+    css: managedRuntimeAssets.css,
     runAt: manifest.runAt || 'document_idle',
     persistAcrossSessions: true
   }]);
@@ -216,8 +222,10 @@ async function tryApplyStagedUpdateCore() {
   if (Number(state.postponeUntil || 0) > Date.now()) {
     return state;
   }
-  const tabs = await chrome.tabs.query({ url: OVERLEAF_EDITOR_MATCHES });
-  const probes = await Promise.all(tabs.map(tab => probeTabIdle(tab)));
+  const surfaceTabs = await chrome.tabs.query({ url: OVERLEAF_MATCHES });
+  const activeTabs = surfaceTabs.filter(tab => isEditorProjectTab(tab) && !tab.discarded && tab.status !== 'unloaded');
+  const refreshTabs = surfaceTabs.filter(tab => !tab.discarded && tab.status !== 'unloaded');
+  const probes = await Promise.all(activeTabs.map(tab => probeTabIdle(tab)));
   const nativeGate = await requestInternal({ method: 'update.canApply', params: {} }).catch(error => ({
     ok: false,
     error: { code: safeCode(error), message: safeMessage(error) }
@@ -237,7 +245,7 @@ async function tryApplyStagedUpdateCore() {
   }
 
   await clearIdleRetry();
-  await chrome.storage.local.set({ [UPDATE_RELOAD_TABS_KEY]: tabs.map(tab => tab.id).filter(Number.isInteger) });
+  await chrome.storage.local.set({ [UPDATE_RELOAD_TABS_KEY]: refreshTabs.map(tab => tab.id).filter(Number.isInteger) });
   await setUpdateState({ ...state, state: 'applying', blocker: '', blockers: [] });
   await broadcastUpdateState('applying');
   const applied = await requestInternal({
@@ -280,14 +288,55 @@ async function probeTabIdle(tab) {
   if (!Number.isInteger(tab?.id)) {
     return { idle: false, blockers: ['tab_unavailable'] };
   }
+  if (!isEditorProjectTab(tab)) {
+    return { idle: true, saved: true, ignored: true, blockers: [] };
+  }
+  if (tab.discarded || tab.status === 'unloaded') {
+    return { idle: true, saved: true, ignored: true, blockers: [] };
+  }
+  const firstProbe = await sendTabIdleProbe(tab.id);
+  if (firstProbe) return firstProbe;
+  if (await injectManagedRuntimeIntoTab(tab.id)) {
+    const recoveredProbe = await sendTabIdleProbe(tab.id);
+    if (recoveredProbe) return recoveredProbe;
+  }
+  return { idle: false, blockers: ['tab_probe_unavailable'] };
+}
+
+function isEditorProjectTab(tab) {
+  try {
+    const url = new URL(tab?.url || '');
+    return url.protocol === 'https:' &&
+      (url.hostname === 'www.overleaf.com' || url.hostname === 'overleaf.com') &&
+      /^\/project\/[^/]+(?:\/|$)/.test(url.pathname);
+  } catch (_error) {
+    return false;
+  }
+}
+
+async function sendTabIdleProbe(tabId) {
   try {
     return await withTimeout(
-      chrome.tabs.sendMessage(tab.id, { type: 'codex-overleaf/update-idle-probe' }),
+      chrome.tabs.sendMessage(tabId, { type: 'codex-overleaf/update-idle-probe' }),
       3500,
       { idle: false, blockers: ['tab_probe_timeout'] }
     );
   } catch (_error) {
-    return { idle: false, blockers: ['tab_probe_unavailable'] };
+    return null;
+  }
+}
+
+async function injectManagedRuntimeIntoTab(tabId) {
+  if (!managedRuntimeAssets) return false;
+  try {
+    if (managedRuntimeAssets.css.length) {
+      await chrome.scripting.insertCSS({ target: { tabId }, files: managedRuntimeAssets.css });
+    }
+    await chrome.scripting.executeScript({ target: { tabId }, files: managedRuntimeAssets.js });
+    await new Promise(resolve => setTimeout(resolve, RUNTIME_RECOVERY_SETTLE_MS));
+    return true;
+  } catch (_error) {
+    return false;
   }
 }
 

package/extension/bootstrap/manifest.template.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "Codex Overleaf Link",
-  "version": "1.9.9",
+  "version": "1.9.11",
   "description": "Connect the active Overleaf project to a local Codex bridge.",
   "icons": {
     "16": "assets/icons/icon16.png",

package/extension/src/content/contentRuntime.js

@@ -715,7 +715,7 @@
       reviewAction: trackedChangeInFlight.size > 0,
       dialog: Boolean(activePluginConfirmResolve)
     }),
-    checkSaved: () => callPageBridge('waitForSaveState', { deadlineMs: 1500, pollIntervalMs: 100, requirePositiveSignal: true }),
+    checkSaved: () => callPageBridge('waitForSaveState', { deadlineMs: 1500, pollIntervalMs: 100, requirePositiveSignal: true, allowQuietEditorFallback: true, quietFallbackMs: 1000 }),
     onApplyingChange: applying => { if (panel) panel.dataset.updating = applying ? 'true' : 'false'; },
     showToast: (...args) => showPluginToast(...args),
     getStateMessage: state => ({

package/extension/src/content/settingsPanel.js

@@ -10,7 +10,8 @@
       history: '<path d="M4.2 3.4h7.6"/><path d="M4.2 8h7.6"/><path d="M4.2 12.6h4.6"/><path d="M2.2 3.4h.1"/><path d="M2.2 8h.1"/><path d="M2.2 12.6h.1"/>',
       lock: '<rect x="3.6" y="7" width="8.8" height="6.2" rx="1.2"/><path d="M5.6 7V5.3a2.4 2.4 0 0 1 4.8 0V7"/><path d="M8 9.6v1.2"/>',
       pen: '<path d="M3.2 12.8 4 9.7l6.6-6.6a1.4 1.4 0 0 1 2 2L6 11.7z"/><path d="m9.6 4.1 2.3 2.3"/>',
-      shield: '<path d="M8 2.1 12.4 4v3.5c0 2.9-1.8 5.1-4.4 6.4-2.6-1.3-4.4-3.5-4.4-6.4V4z"/><path d="M6.1 8.1 7.5 9.5 10.2 6.6"/>'
+      shield: '<path d="M8 2.1 12.4 4v3.5c0 2.9-1.8 5.1-4.4 6.4-2.6-1.3-4.4-3.5-4.4-6.4V4z"/><path d="M6.1 8.1 7.5 9.5 10.2 6.6"/>',
+      software: '<rect x="5.1" y="5.1" width="5.8" height="5.8" rx="1.2"/><path d="M12.9 7.1A5.2 5.2 0 0 0 4.1 4.2"/><path d="M4.1 2.2v2h2"/><path d="M3.1 8.9a5.2 5.2 0 0 0 8.8 2.9"/><path d="M11.9 13.8v-2h-2"/>'
     };
     const safeName = Object.prototype.hasOwnProperty.call(icons, name) ? name : 'appearance';
     return `<span class="codex-icon codex-icon-${safeName}" aria-hidden="true"><svg viewBox="0 0 16 16" focusable="false">${icons[safeName]}</svg></span>`;
@@ -148,7 +149,7 @@
           </details>
           <details class="codex-set-group" data-set-group="updates" open>
             <summary class="codex-set-group-head">
-              <span class="codex-set-group-title">${codexSetIcon('appearance')}<span data-i18n="softwareUpdatesTitle">Software updates</span></span>
+              <span class="codex-set-group-title">${codexSetIcon('software')}<span data-i18n="softwareUpdatesTitle">Software updates</span></span>
             </summary>
             <div class="codex-set-card" data-update-settings>
               <div class="codex-set-row">

package/extension/src/content/updateIdle.js

@@ -41,7 +41,7 @@
       } catch (_error) {
         saveResult = { ok: false, state: 'unavailable' };
       }
-      const saved = saveResult?.ok === true && saveResult?.state === 'verified_saved';
+      const saved = saveResult?.ok === true && ['verified_saved', 'verified_quiet'].includes(saveResult?.state);
       if (saved) {
         stableSavedSince = stableSavedSince || Date.now();
       } else {

package/extension/src/content/updateNotice.js

@@ -9,6 +9,7 @@
   let getLocale = () => '';
   let settingsRoot = null;
   let settingsActionInFlight = false;
+  const ACTIVE_UPDATE_STATES = new Set(['downloading', 'staged', 'waiting_for_idle', 'applying', 'awaiting_health']);
 
   function mount(panelLike, options = {}) {
     if (typeof options.getLocale === 'function') {
@@ -69,17 +70,10 @@
         dismiss: 'codex-overleaf/consent-update-dismiss'
       }[action]);
     } catch (error) {
-      currentView = {
-        ...(currentView || {}),
-        state: {
-          ...(currentView?.state || {}),
-          state: 'failed',
-          code: error?.code || 'update_failed',
-          message: error?.message || tx('Update failed.', '更新失败。')
-        },
-        progress: { value: 0, determinate: true, phase: 'failed' },
-        showPanel: true
-      };
+      currentView = await reconcileAfterActionError(error, {
+        action,
+        fallbackMessage: tx('Update failed.', '更新失败。')
+      });
     } finally {
       actionInFlight = false;
       render();
@@ -97,6 +91,49 @@
     return response.result;
   }
 
+  async function reconcileAfterActionError(error, options = {}) {
+    if (options.action === 'install' && isRuntimeRestartError(error)) {
+      return buildRestartingView();
+    }
+    try {
+      const authoritativeView = await request('codex-overleaf/consent-update-get-state');
+      if (authoritativeView?.state) return authoritativeView;
+    } catch (_stateError) {
+      // The local fallback below is used only when the global coordinator is unavailable too.
+    }
+    return {
+      ...(currentView || {}),
+      state: {
+        ...(currentView?.state || {}),
+        state: 'failed',
+        code: error?.code || 'update_failed',
+        message: error?.message || options.fallbackMessage || tx('Update failed.', '更新失败。')
+      },
+      progress: { value: 0, determinate: true, phase: 'failed' },
+      showPanel: true
+    };
+  }
+
+  function isRuntimeRestartError(error) {
+    return /extension context invalidated|message (?:port|channel) closed|receiving end does not exist|could not establish connection|disconnected port/i.test(
+      String(error?.message || error || '')
+    );
+  }
+
+  function buildRestartingView() {
+    return {
+      ...(currentView || {}),
+      state: {
+        ...(currentView?.state || {}),
+        state: 'awaiting_health',
+        code: '',
+        message: ''
+      },
+      progress: { value: 90, determinate: false, phase: 'awaiting_health' },
+      showPanel: true
+    };
+  }
+
   function bindSettingsControls(panel) {
     settingsRoot = panel;
     const button = panel.querySelector?.('[data-check-updates]');
@@ -112,28 +149,23 @@
     settingsActionInFlight = true;
     renderSettings();
     const stateName = currentView?.state?.state || 'idle';
+    let requestedAction = 'check';
     try {
       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 (!['downloading', 'staged', 'waiting_for_idle', 'applying', 'awaiting_health'].includes(stateName)) {
+      } else if (!ACTIVE_UPDATE_STATES.has(stateName)) {
         currentView = await request('codex-overleaf/consent-update-check');
       } else {
         return;
       }
     } catch (error) {
-      currentView = {
-        ...(currentView || {}),
-        state: {
-          ...(currentView?.state || {}),
-          state: 'failed',
-          code: error?.code || 'update_failed',
-          message: error?.message || tx('Update check failed.', '更新检查失败。')
-        },
-        progress: { value: 0, determinate: true, phase: 'failed' },
-        showPanel: true
-      };
+      currentView = await reconcileAfterActionError(error, {
+        action: requestedAction,
+        fallbackMessage: tx('Update check failed.', '更新检查失败。')
+      });
     } finally {
       settingsActionInFlight = false;
       render();
@@ -214,7 +246,6 @@
       : '';
     const currentVersion = state.currentVersion || manifestVersion || '';
     const latestVersion = state.latestVersion || '';
-    const activeStates = ['downloading', 'staged', 'waiting_for_idle', 'applying', 'awaiting_health'];
     let summaryText = tx(
       `Current v${currentVersion}. Signed stable releases are checked automatically.`,
       `当前版本 v${currentVersion}。系统会自动检查签名稳定版本。`
@@ -229,7 +260,7 @@
       summaryText = tx(`Stable v${latestVersion} is available.`, `稳定版本 v${latestVersion} 已可用。`);
       statusText = tx('Ready to download and verify.', '已可下载并验证。');
       buttonText = tx('Update now', '立即更新');
-    } else if (activeStates.includes(stateName)) {
+    } else if (ACTIVE_UPDATE_STATES.has(stateName)) {
       statusText = getCopy(state).detail;
       buttonText = tx('Update in progress', '更新进行中');
     } else if (stateName === 'failed' || stateName === 'rolled_back') {
@@ -244,7 +275,7 @@
     status.textContent = statusText;
     status.hidden = !statusText;
     button.textContent = buttonText;
-    button.disabled = settingsActionInFlight || stateName === 'checking' || activeStates.includes(stateName);
+    button.disabled = settingsActionInFlight || stateName === 'checking' || ACTIVE_UPDATE_STATES.has(stateName);
   }
 
   function visibleActions(state) {

package/extension/src/pageBridge.js

@@ -1308,8 +1308,11 @@
   async function waitForSaveState(params = {}) {
     const deadlineMs = Number.isFinite(Number(params.deadlineMs)) ? Number(params.deadlineMs) : 5000;
     const pollInterval = Number.isFinite(Number(params.pollIntervalMs)) ? Number(params.pollIntervalMs) : 100;
+    const quietFallbackMs = Number.isFinite(Number(params.quietFallbackMs)) ? Number(params.quietFallbackMs) : 1000;
     const deadline = Date.now() + Math.max(0, deadlineMs);
     let lastState = { state: 'unknown', reason: 'Overleaf save state has not been checked yet.' };
+    let quietSignature = '';
+    let quietSince = 0;
 
     do {
       let current;
@@ -1332,6 +1335,25 @@
           reason: current.reason || 'Overleaf save state is unavailable.'
         };
       }
+      const quietEligible = params.allowQuietEditorFallback === true
+        && current.state === 'unknown'
+        && /save indicator was not found/i.test(current.reason || '')
+        && window.navigator?.onLine !== false
+        && detectEditor()?.ok === true;
+      if (quietEligible) {
+        const text = String(readActiveEditorText() || '');
+        const signature = `${getActiveFilePath()}:${text.length}:${text.slice(0, 80)}:${text.slice(-80)}`;
+        if (signature === quietSignature && Date.now() - quietSince >= Math.max(0, quietFallbackMs)) {
+          return { ok: true, state: 'verified_quiet', evidence: 'stable_editor_snapshot_without_save_indicator' };
+        }
+        if (signature !== quietSignature) {
+          quietSignature = signature;
+          quietSince = Date.now();
+        }
+      } else {
+        quietSignature = '';
+        quietSince = 0;
+      }
       lastState = current;
       if (Date.now() >= deadline) {
         break;

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-overleaf-link",
-  "version": "1.9.9",
+  "version": "1.9.11",
   "description": "Cross-platform Chrome bridge that connects Codex to the active Overleaf project.",
   "license": "MIT",
   "type": "commonjs",