codex-overleaf-link 2.4.0 → 2.4.1

package/README.md

@@ -1,10 +1,13 @@
+> [!NOTE]
+> This development branch can contain unreleased changes. Version-pinned commands below apply after the corresponding release is published. Published installers are available from the [latest stable release](https://github.com/Ghqqqq/codex-overleaf-link/releases/latest).
+
 <div align="center">
   <img src="extension/assets/icons/codex-overleaf-icon.png" width="96" alt="Codex Overleaf Link">
   <h1>Codex Overleaf Link</h1>
   <p><strong>English</strong> | <a href="README.zh-CN.md" lang="zh-CN">简体中文</a></p>
   <p><strong>Empower Overleaf with Codex.</strong></p>
   <p>
-    <img src="https://img.shields.io/badge/version-2.4.0-blue" alt="version">
+    <img src="https://img.shields.io/badge/version-2.4.1-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">
@@ -87,14 +90,14 @@ One command installs the managed native host **and** managed extension runtime.
 macOS / Linux:
 
 ```bash
-CODEX_OVERLEAF_REF=v2.4.0 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.4.0/install.sh)"
+CODEX_OVERLEAF_REF=v2.4.1 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.4.1/install.sh)"
 ```
 
 Windows PowerShell:
 
 ```powershell
-iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.4.0/install.ps1 -OutFile install.ps1
-$env:CODEX_OVERLEAF_REF='v2.4.0'
+iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.4.1/install.ps1 -OutFile install.ps1
+$env:CODEX_OVERLEAF_REF='v2.4.1'
 powershell -ExecutionPolicy Bypass -File install.ps1
 ```
 
@@ -105,7 +108,7 @@ Then open `chrome://extensions`, enable **Developer mode**, click **Load unpacke
 `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@2.4.0 -- install-managed
+npm exec --yes codex-overleaf-link@2.4.1 -- 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.
@@ -225,9 +228,9 @@ npm installs, updates, and uninstalls the coordinated managed extension/native p
 
 | Action | Command |
 |--------|---------|
-| Install / recover / migrate | `npm exec --yes codex-overleaf-link@2.4.0 -- install-managed` |
-| Diagnose | `npm exec --yes codex-overleaf-link@2.4.0 -- doctor` |
-| Uninstall | `npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-managed` |
+| Install / recover / migrate | `npm exec --yes codex-overleaf-link@2.4.1 -- install-managed` |
+| Diagnose | `npm exec --yes codex-overleaf-link@2.4.1 -- doctor` |
+| Uninstall | `npm exec --yes codex-overleaf-link@2.4.1 -- uninstall-managed` |
 
 Use `--extension-id <chrome-extension-id>` only for a custom/dev unpacked extension id that differs from the official bundled id.
 
@@ -238,7 +241,7 @@ Use `--extension-id <chrome-extension-id>` only for a custom/dev unpacked extens
 Remove the managed extension/native installation (append `--browser chromium` on Linux Chromium):
 
 ```bash
-npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-managed
+npm exec --yes codex-overleaf-link@2.4.1 -- uninstall-managed
 ```
 
 The same command works in Windows PowerShell. It also applies to current `install.sh` / `install.ps1` installations, which install the managed pair.
@@ -246,7 +249,7 @@ The same command works in Windows PowerShell. It also applies to current `instal
 For an unmanaged checkout or native-only installation, use `npm run uninstall:native` from the checkout, or:
 
 ```bash
-npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-native
+npm exec --yes codex-overleaf-link@2.4.1 -- uninstall-native
 ```
 
 If you are removing an older native-only source installation and still have its source checkout, its bundled uninstaller can also be invoked directly:
@@ -272,7 +275,7 @@ Remove the extension entry from `chrome://extensions` as well. To erase saved Co
 For a managed installation, rerun the [managed installer](#install), reload the extension in `chrome://extensions`, then refresh the Overleaf tab. This recovers the coordinated extension/native pair after an incomplete installation or incompatible runtime update.
 
 ```bash
-npm exec --yes codex-overleaf-link@2.4.0 -- install-managed
+npm exec --yes codex-overleaf-link@2.4.1 -- install-managed
 ```
 
 For an unmanaged checkout, rebuild the extension and reinstall its native host from the same checkout. Use PowerShell installation commands on Windows.
@@ -395,13 +398,13 @@ The shipped extension targets `https://overleaf.com/project` and `https://www.ov
 Linux Chromium install or update:
 
 ```bash
-CODEX_OVERLEAF_REF=v2.4.0 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.4.0/install.sh)" -- --browser chromium
+CODEX_OVERLEAF_REF=v2.4.1 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.4.1/install.sh)" -- --browser chromium
 ```
 
 Linux Chromium uninstall:
 
 ```bash
-npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-managed --browser chromium
+npm exec --yes codex-overleaf-link@2.4.1 -- uninstall-managed --browser chromium
 ```
 
 ## Extension ID
@@ -415,27 +418,27 @@ illdpneeeopfffmiepaejglgmhpmdhdc
 The installer uses this id by default. For a managed installation with a custom id, rerun the managed installer with the id shown in `chrome://extensions`:
 
 ```bash
-npm exec --yes codex-overleaf-link@2.4.0 -- install-managed --extension-id "<your-chrome-extension-id>"
+npm exec --yes codex-overleaf-link@2.4.1 -- install-managed --extension-id "<your-chrome-extension-id>"
 ```
 
 For an unmanaged extension, use the native-only installer:
 
 ```bash
-npm exec --yes codex-overleaf-link@2.4.0 -- install-native --extension-id "<your-chrome-extension-id>"
+npm exec --yes codex-overleaf-link@2.4.1 -- install-native --extension-id "<your-chrome-extension-id>"
 ```
 
 Both npm commands work in PowerShell. Source installers also accept the `CODEX_OVERLEAF_EXTENSION_ID` environment variable. The Native Messaging manifest's `allowed_origins` must match the loaded extension id.
 
 ## GitHub Release Artifacts
 
-The v2.4.0 GitHub Release contains:
+The v2.4.1 GitHub Release contains:
 
-- `codex-overleaf-link-extension-v2.4.0.zip`: loadable Chrome extension package for manual unpacked installation.
-- `codex-overleaf-native-host-v2.4.0.tar.gz`: native host runtime files used by the installer and release verification.
-- `codex-overleaf-update-v2.4.0.tar.gz`: coordinated extension/native bundle used by the managed updater.
-- `codex-overleaf-link-2.4.0.tgz`: npm native host CLI package for pinned install, doctor, and uninstall flows.
-- `install.sh`: release-pinned macOS / Linux installer that defaults to `v2.4.0` when run directly from the release artifact.
-- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v2.4.0` when run directly from the release artifact.
+- `codex-overleaf-link-extension-v2.4.1.zip`: loadable Chrome extension package for manual unpacked installation.
+- `codex-overleaf-native-host-v2.4.1.tar.gz`: native host runtime files used by the installer and release verification.
+- `codex-overleaf-update-v2.4.1.tar.gz`: coordinated extension/native bundle used by the managed updater.
+- `codex-overleaf-link-2.4.1.tgz`: npm native host CLI package for pinned install, doctor, and uninstall flows.
+- `install.sh`: release-pinned macOS / Linux installer that defaults to `v2.4.1` when run directly from the release artifact.
+- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v2.4.1` 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`, `release-manifest.json`, and `release-manifest.sig`: checksums, release metadata, and its Ed25519 signature.
@@ -512,8 +515,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 | Managed pair recommended; unmanaged Release zip or checkout also available. | Same as macOS Chrome. | Same as macOS Chrome. | Managed or unmanaged; register 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@2.4.0 -- install-managed` | `npm exec --yes codex-overleaf-link@2.4.0 -- install-managed` | `npm exec --yes codex-overleaf-link@2.4.0 -- install-managed` | `npm exec --yes codex-overleaf-link@2.4.0 -- install-managed --browser chromium` |
-| Uninstall command | `npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-managed --browser chromium` |
+| Installer/update command | `npm exec --yes codex-overleaf-link@2.4.1 -- install-managed` | `npm exec --yes codex-overleaf-link@2.4.1 -- install-managed` | `npm exec --yes codex-overleaf-link@2.4.1 -- install-managed` | `npm exec --yes codex-overleaf-link@2.4.1 -- install-managed --browser chromium` |
+| Uninstall command | `npm exec --yes codex-overleaf-link@2.4.1 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.4.1 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.4.1 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.4.1 -- 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` |
 | Managed runtime paths | `~/.codex-overleaf/managed/extension` and `~/.codex-overleaf/managed/native`. | `%LOCALAPPDATA%\CodexOverleaf\managed\extension` and `%LOCALAPPDATA%\CodexOverleaf\managed\native`. | Same as macOS Chrome. | Same as macOS Chrome. |
 | Node/Git/Codex/TeX | Record exact versions; see [Requirements](#requirements) for installation and provider prerequisites. | Same as macOS Chrome. | Same as macOS Chrome. | Same as macOS Chrome. |

package/README.zh-CN.md

@@ -1,10 +1,13 @@
+> [!NOTE]
+> 开发分支可能包含尚未发布的改动。下方固定版本命令适用于对应版本发布之后；已发布的安装器可从[最新稳定版](https://github.com/Ghqqqq/codex-overleaf-link/releases/latest)获取。
+
 <div align="center">
   <img src="extension/assets/icons/codex-overleaf-icon.png" width="96" alt="Codex Overleaf Link">
   <h1>Codex Overleaf Link</h1>
   <p><a href="README.md" lang="en">English</a> | <strong>简体中文</strong></p>
   <p><strong>让 Codex 融入 Overleaf。</strong></p>
   <p>
-    <img src="https://img.shields.io/badge/version-2.4.0-blue" alt="版本">
+    <img src="https://img.shields.io/badge/version-2.4.1-blue" alt="版本">
     <img src="https://img.shields.io/badge/platform-macOS%20%2F%20Windows%20%2F%20Linux-lightgrey" alt="支持平台">
     <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.js 版本要求">
@@ -87,14 +90,14 @@ Chrome 可能要求手动执行 **Load unpacked（加载已解压的扩展程序
 macOS / Linux：
 
 ```bash
-CODEX_OVERLEAF_REF=v2.4.0 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.4.0/install.sh)"
+CODEX_OVERLEAF_REF=v2.4.1 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.4.1/install.sh)"
 ```
 
 Windows PowerShell：
 
 ```powershell
-iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.4.0/install.ps1 -OutFile install.ps1
-$env:CODEX_OVERLEAF_REF='v2.4.0'
+iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.4.1/install.ps1 -OutFile install.ps1
+$env:CODEX_OVERLEAF_REF='v2.4.1'
 powershell -ExecutionPolicy Bypass -File install.ps1
 ```
 
@@ -105,7 +108,7 @@ powershell -ExecutionPolicy Bypass -File install.ps1
 `npm exec` 会安装相同的托管 Native Host 和扩展运行时，无需保留源码检出目录。适合希望固定 npm 包版本的安装方式。
 
 ```bash
-npm exec --yes codex-overleaf-link@2.4.0 -- install-managed
+npm exec --yes codex-overleaf-link@2.4.1 -- install-managed
 ```
 
 随后在 `chrome://extensions` 中启用开发者模式，点击加载已解压的扩展程序，并选择命令打印的托管扩展目录。Release 中的扩展 ZIP 也仍可用于明确采用非托管方式的手动安装。
@@ -225,9 +228,9 @@ npm 命令负责配套扩展与 Native Host 的托管安装、更新和卸载；
 
 | 操作 | 命令 |
 |------|------|
-| 安装 / 恢复 / 迁移 | `npm exec --yes codex-overleaf-link@2.4.0 -- install-managed` |
-| 诊断 | `npm exec --yes codex-overleaf-link@2.4.0 -- doctor` |
-| 卸载 | `npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-managed` |
+| 安装 / 恢复 / 迁移 | `npm exec --yes codex-overleaf-link@2.4.1 -- install-managed` |
+| 诊断 | `npm exec --yes codex-overleaf-link@2.4.1 -- doctor` |
+| 卸载 | `npm exec --yes codex-overleaf-link@2.4.1 -- uninstall-managed` |
 
 仅当自定义或开发版扩展 ID 与官方内置 ID 不同时，才需要使用 `--extension-id <chrome-extension-id>`。
 
@@ -238,7 +241,7 @@ npm 命令负责配套扩展与 Native Host 的托管安装、更新和卸载；
 移除托管扩展 / Native Host 安装；Linux Chromium 需要追加 `--browser chromium`：
 
 ```bash
-npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-managed
+npm exec --yes codex-overleaf-link@2.4.1 -- uninstall-managed
 ```
 
 同一命令也适用于 Windows PowerShell，以及当前 `install.sh` / `install.ps1` 创建的托管安装。
@@ -246,7 +249,7 @@ npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-managed
 非托管源码安装或仅安装 Native Host 的情况，可在源码目录中运行 `npm run uninstall:native`，或执行：
 
 ```bash
-npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-native
+npm exec --yes codex-overleaf-link@2.4.1 -- uninstall-native
 ```
 
 如果需要移除较旧的 Native Host 源码安装，且仍保留源码目录，也可直接调用其中的卸载脚本：
@@ -272,7 +275,7 @@ node "$env:LOCALAPPDATA\CodexOverleaf\source\scripts\uninstall-native-host.mjs"
 托管安装可重新运行[托管安装器](#安装)，在 `chrome://extensions` 中重新加载扩展，再刷新 Overleaf 标签页。这会恢复安装不完整或运行时更新不兼容时的配套扩展 / Native Host。
 
 ```bash
-npm exec --yes codex-overleaf-link@2.4.0 -- install-managed
+npm exec --yes codex-overleaf-link@2.4.1 -- install-managed
 ```
 
 非托管源码安装应从同一个检出目录重新构建扩展并安装 Native Host。Windows 使用对应的 PowerShell 安装命令。
@@ -395,13 +398,13 @@ npm run smoke:extension -- --url 'https://www.overleaf.com/project/<project-id>'
 Linux Chromium 安装或更新：
 
 ```bash
-CODEX_OVERLEAF_REF=v2.4.0 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.4.0/install.sh)" -- --browser chromium
+CODEX_OVERLEAF_REF=v2.4.1 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.4.1/install.sh)" -- --browser chromium
 ```
 
 Linux Chromium 卸载：
 
 ```bash
-npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-managed --browser chromium
+npm exec --yes codex-overleaf-link@2.4.1 -- uninstall-managed --browser chromium
 ```
 
 ## 扩展 ID
@@ -415,27 +418,27 @@ illdpneeeopfffmiepaejglgmhpmdhdc
 安装器默认使用该 ID。托管安装使用自定义 ID 时，应以 `chrome://extensions` 中显示的值重新运行安装器：
 
 ```bash
-npm exec --yes codex-overleaf-link@2.4.0 -- install-managed --extension-id "<your-chrome-extension-id>"
+npm exec --yes codex-overleaf-link@2.4.1 -- install-managed --extension-id "<your-chrome-extension-id>"
 ```
 
 非托管扩展使用 Native-only 安装器：
 
 ```bash
-npm exec --yes codex-overleaf-link@2.4.0 -- install-native --extension-id "<your-chrome-extension-id>"
+npm exec --yes codex-overleaf-link@2.4.1 -- install-native --extension-id "<your-chrome-extension-id>"
 ```
 
 这两条 npm 命令也适用于 PowerShell。源码安装器还接受 `CODEX_OVERLEAF_EXTENSION_ID` 环境变量。Native Messaging 清单的 `allowed_origins` 必须与实际加载的扩展 ID 一致。
 
 ## GitHub Release 制品
 
-v2.4.0 的 GitHub Release 包含：
+v2.4.1 的 GitHub Release 包含：
 
-- `codex-overleaf-link-extension-v2.4.0.zip`：用于手动加载已解压扩展的 Chrome 扩展包。
-- `codex-overleaf-native-host-v2.4.0.tar.gz`：供安装器和发布验证使用的 Native Host 运行时文件。
-- `codex-overleaf-update-v2.4.0.tar.gz`：托管更新器使用的扩展 / Native Host 配套更新包。
-- `codex-overleaf-link-2.4.0.tgz`：提供固定版本安装、doctor 诊断和卸载流程的 npm CLI 包。
-- `install.sh`：固定发布版本的 macOS / Linux 安装脚本，从 Release 制品直接运行时默认使用 `v2.4.0`。
-- `install.ps1`：固定发布版本的 Windows PowerShell 安装脚本，从 Release 制品直接运行时默认使用 `v2.4.0`。
+- `codex-overleaf-link-extension-v2.4.1.zip`：用于手动加载已解压扩展的 Chrome 扩展包。
+- `codex-overleaf-native-host-v2.4.1.tar.gz`：供安装器和发布验证使用的 Native Host 运行时文件。
+- `codex-overleaf-update-v2.4.1.tar.gz`：托管更新器使用的扩展 / Native Host 配套更新包。
+- `codex-overleaf-link-2.4.1.tgz`：提供固定版本安装、doctor 诊断和卸载流程的 npm CLI 包。
+- `install.sh`：固定发布版本的 macOS / Linux 安装脚本，从 Release 制品直接运行时默认使用 `v2.4.1`。
+- `install.ps1`：固定发布版本的 Windows PowerShell 安装脚本，从 Release 制品直接运行时默认使用 `v2.4.1`。
 - `uninstall-native-host.mjs`：删除 Chrome Native Messaging 清单、桥接启动程序和运行时副本的卸载脚本。
 - `nativeHostPlatform.js`、`manifest.js`、`runtimeInstaller.js`：独立卸载脚本所需的配套文件。
 - `SHA256SUMS`、`release-manifest.json`、`release-manifest.sig`：校验和、发布元数据及其 Ed25519 签名。
@@ -512,8 +515,8 @@ Remove-Item -Recurse -Force "$env:LOCALAPPDATA\CodexOverleaf", "$env:USERPROFILE
 | 浏览器 / 通道 / 版本 | 记录 Google Chrome 通道和版本。 | 记录 Google Chrome 通道和版本。 | 记录 Google Chrome 通道和版本。 | 记录 Chromium 通道 / 软件包和版本。 |
 | 安装方式 | 推荐托管安装；也支持非托管 Release ZIP 或源码安装。 | 同 macOS Chrome。 | 同 macOS Chrome。 | 托管或非托管安装均需使用 `--browser chromium` 注册。 |
 | 扩展 ID | 内置 ID 为 `illdpneeeopfffmiepaejglgmhpmdhdc`；自定义 ID 使用 `--extension-id` 传入。 | 同 macOS Chrome。 | 同 macOS Chrome。 | 同 macOS Chrome。 |
-| 安装 / 更新命令 | `npm exec --yes codex-overleaf-link@2.4.0 -- install-managed` | `npm exec --yes codex-overleaf-link@2.4.0 -- install-managed` | `npm exec --yes codex-overleaf-link@2.4.0 -- install-managed` | `npm exec --yes codex-overleaf-link@2.4.0 -- install-managed --browser chromium` |
-| 卸载命令 | `npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.4.0 -- uninstall-managed --browser chromium` |
+| 安装 / 更新命令 | `npm exec --yes codex-overleaf-link@2.4.1 -- install-managed` | `npm exec --yes codex-overleaf-link@2.4.1 -- install-managed` | `npm exec --yes codex-overleaf-link@2.4.1 -- install-managed` | `npm exec --yes codex-overleaf-link@2.4.1 -- install-managed --browser chromium` |
+| 卸载命令 | `npm exec --yes codex-overleaf-link@2.4.1 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.4.1 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.4.1 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.4.1 -- uninstall-managed --browser chromium` |
 | 清单 / 注册表路径 | `~/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` |
 | 托管运行时路径 | `~/.codex-overleaf/managed/extension` 和 `~/.codex-overleaf/managed/native`。 | `%LOCALAPPDATA%\CodexOverleaf\managed\extension` 和 `%LOCALAPPDATA%\CodexOverleaf\managed\native`。 | 同 macOS Chrome。 | 同 macOS Chrome。 |
 | Node / Git / Codex / TeX | 记录准确版本，安装和服务前提见[环境要求](#环境要求)。 | 同 macOS Chrome。 | 同 macOS Chrome。 | 同 macOS Chrome。 |

package/extension/src/content/contentRuntime.js

@@ -5666,7 +5666,7 @@
       const urlProjectId = getCurrentProjectId();
       const projectId = projectIdOverride || urlProjectId;
       if (!projectId) {
-        return;
+        if (options?.reviewRunIds?.length) throw new Error('Review persistence lost its project.'); return;
       }
       // Read currentRunView through a defensive accessor so historical test
       // harnesses that inline `saveState` without re-declaring the module-
@@ -5678,7 +5678,7 @@
           'Skipped saveState: run is in flight on a different project than the current URL; settlement owns persistence.',
           '已跳过 saveState：本次运行所属项目与当前 URL 不一致，写回由 settlement 负责。'
         ));
-        return;
+        if (options?.reviewRunIds?.length) throw new Error('Review persistence project changed.'); return;
       }
       const compactState = prepareStateForStorage(state, { onAggressive: notifyAggressiveCompactionOnce });
       compactState.autoRecompile = state.autoRecompile;
@@ -5699,7 +5699,7 @@
         state: stateSnapshot,
         compactState: compactStateSnapshot,
         projectId,
-        deletedSessionIds: options?.deletedSessionIds,
+        deletedSessionIds: options?.deletedSessionIds, reviewRunIds: options?.reviewRunIds,
         Migration,
         StorageDb,
         SessionPersistence: Modules.SessionPersistence,
@@ -5727,7 +5727,7 @@
           persistScopedState
         );
         if (!committed.ok && (
-          options?.queueMutation
+          options?.reviewRunIds?.length || options?.queueMutation
           || options?.queueMutations?.length
           || committed.reason !== 'stale_view'
         )) {
@@ -5739,12 +5739,12 @@
     } catch (error) {
       if (
         error?.code === 'account_scope_unavailable' &&
-        !options?.queueMutation &&
+        !options?.reviewRunIds?.length && !options?.queueMutation &&
         !(Array.isArray(options?.queueMutations) && options.queueMutations.length)
       ) {
         return;
       }
-      if (options?.queueMutation || options?.queueMutations?.length) {
+      if (options?.reviewRunIds?.length || options?.queueMutation || options?.queueMutations?.length) {
         throw error;
       }
       let fallbackError = null;
@@ -5869,6 +5869,7 @@
           // here (e.g. fallback chrome.storage.local.set rethrew).
           emitStorageQuotaFailure(error, null);
         }
+        if (persistenceOptions?.reviewRunIds?.length) throw error;
         appendPlainLog(tx(`Failed to save session state: ${formatStateSaveError(error)}`, `保存会话状态失败：${formatStateSaveError(error)}`));
       })
       .finally(() => {
@@ -5923,6 +5924,7 @@
       ...(current || {}),
       ...incoming,
       queueMutation: undefined,
+      reviewRunIds: Array.from(new Set([...(current?.reviewRunIds || []), ...(incoming?.reviewRunIds || [])])),
       queueMutations,
       deletedSessionIds: Array.from(new Set([
         ...(current?.deletedSessionIds || []),
@@ -6947,11 +6949,9 @@
       detail: { [tr('detailWillUndo')]: trackedUndo ? formatTrackedChangeFiles(run.undoTrackedChanges) : formatTrackedUndoFiles(run) }
     });
 
-    let result;
-    let trackedUndoPostFilesAtDispatch;
     try {
-      trackedUndoPostFilesAtDispatch = buildTrackedUndoPostFiles(run);
-      result = await callPageBridge('rejectTrackedChanges', {
+      const trackedUndoPostFilesAtDispatch = buildTrackedUndoPostFiles(run);
+      const result = await callPageBridge('rejectTrackedChanges', {
         trackedChanges: run.undoTrackedChanges || [],
         expectedFiles: run.undoExpectedFiles || [],
         postFiles: trackedUndoPostFilesAtDispatch,
@@ -6964,38 +6964,39 @@
         // `aborted_project_changed` and the document is left untouched.
         runProjectId: getRunProjectIdForWriteback(run)
       });
+      writebackOrchestrator.invalidateMirrorAfterUndo(runId, getRunProjectIdForWriteback(run), result);
+      appendRunRecordEvent(runId, {
+        title: trackedUndo
+          ? tr('undoTrackedResult', { applied: result.applied?.length || 0, skipped: result.skipped?.length || 0 })
+          : tr('undoNativeResult', { applied: result.applied?.length || 0, skipped: result.skipped?.length || 0 }),
+        status: result.skipped?.length ? 'failed' : 'completed',
+        detail: {
+          [trackedUndo ? tr('detailRejected') : tr('detailUndone')]: (result.applied || []).map(item => ({
+            [tr('detailFile')]: item.trackedChange?.path || tr('unknownFile'),
+            [tr('detailRecord')]: item.trackedChange?.label || item.trackedChange?.id || item.trackedChange?.key
+          })),
+          [tr('detailSkipped')]: (result.skipped || []).map(item => ({
+            [tr('detailFile')]: item.trackedChange?.path || tr('unknownFile'),
+            [tr('detailRecord')]: item.trackedChange?.label || item.trackedChange?.id || item.trackedChange?.key || '',
+            [tr('detailReason')]: formatBridgeResultReason(item.result, item.trackedChange?.path)
+          }))
+        }
+      });
+      if (lifecycleReject) {
+        WritebackSettlement.attachUndoNotVerifiedFailure(run, result, {
+          buildFailure: buildContentFailure,
+          postFiles: trackedUndoPostFilesAtDispatch
+        });
+        await applyTrackedChangeSettlement(runId, 'reject', result);
+        return;
+      }
+      applyLegacyUndoSettlement(runId, result.skipped?.length ? 'partial' : 'applied', result);
     } finally {
       if (lifecycleReject) {
         trackedChangeInFlight.delete(runId);
+        refreshRunCardControls(runId);
       }
     }
-    writebackOrchestrator.invalidateMirrorAfterUndo(runId, getRunProjectIdForWriteback(run), result);
-    appendRunRecordEvent(runId, {
-      title: trackedUndo
-        ? tr('undoTrackedResult', { applied: result.applied?.length || 0, skipped: result.skipped?.length || 0 })
-        : tr('undoNativeResult', { applied: result.applied?.length || 0, skipped: result.skipped?.length || 0 }),
-      status: result.skipped?.length ? 'failed' : 'completed',
-      detail: {
-        [trackedUndo ? tr('detailRejected') : tr('detailUndone')]: (result.applied || []).map(item => ({
-          [tr('detailFile')]: item.trackedChange?.path || tr('unknownFile'),
-          [tr('detailRecord')]: item.trackedChange?.label || item.trackedChange?.id || item.trackedChange?.key
-        })),
-        [tr('detailSkipped')]: (result.skipped || []).map(item => ({
-          [tr('detailFile')]: item.trackedChange?.path || tr('unknownFile'),
-          [tr('detailRecord')]: item.trackedChange?.label || item.trackedChange?.id || item.trackedChange?.key || '',
-          [tr('detailReason')]: formatBridgeResultReason(item.result, item.trackedChange?.path)
-        }))
-      }
-    });
-    if (lifecycleReject) {
-      WritebackSettlement.attachUndoNotVerifiedFailure(run, result, {
-        buildFailure: buildContentFailure,
-        postFiles: trackedUndoPostFilesAtDispatch
-      });
-      applyTrackedChangeSettlement(runId, 'reject', result);
-      return;
-    }
-    applyLegacyUndoSettlement(runId, result.skipped?.length ? 'partial' : 'applied', result);
   }
 
   async function acceptRun(runId) {
@@ -7025,50 +7026,50 @@
       detail: { [tr('detailAccepted')]: formatTrackedChangeFiles(run.undoTrackedChanges) }
     });
 
-    let result;
     try {
-      result = await callPageBridge('acceptTrackedChanges', {
+      const result = await callPageBridge('acceptTrackedChanges', {
         trackedChanges: run.undoTrackedChanges || [],
         expectedFiles: run.undoExpectedFiles || [],
         postFiles: buildTrackedUndoPostFiles(run),
         appliedOperations: Array.isArray(run.appliedOperations) ? run.appliedOperations : [],
         runProjectId: getRunProjectIdForWriteback(run)
       });
-    } finally {
-      trackedChangeInFlight.delete(runId);
-    }
-    appendAcceptDiagnosticEvents(runId, Array.isArray(result.diagnostics) ? result.diagnostics : []);
-    appendRunRecordEvent(runId, {
-      title: tr('runAcceptTrackedResult', { applied: result.applied?.length || 0, skipped: result.skipped?.length || 0 }),
-      status: result.skipped?.length ? 'failed' : 'completed',
-      detail: {
-        [tr('detailAccepted')]: (result.applied || []).map(item => ({
-          [tr('detailFile')]: item.trackedChange?.path || tr('unknownFile'),
-          [tr('detailRecord')]: item.trackedChange?.label || item.trackedChange?.id || item.trackedChange?.key
-        })),
-        [tr('detailSkipped')]: (result.skipped || []).map(item => ({
-          [tr('detailFile')]: item.trackedChange?.path || tr('unknownFile'),
-          [tr('detailRecord')]: item.trackedChange?.label || item.trackedChange?.id || item.trackedChange?.key || '',
-          [tr('detailReason')]: formatBridgeResultReason(item.result, item.trackedChange?.path)
-        }))
-      }
-    });
-    if (result.ok === false) {
+      appendAcceptDiagnosticEvents(runId, Array.isArray(result.diagnostics) ? result.diagnostics : []);
       appendRunRecordEvent(runId, {
-        title: tr('runAcceptTrackedFailed'),
-        status: 'failed',
+        title: tr('runAcceptTrackedResult', { applied: result.applied?.length || 0, skipped: result.skipped?.length || 0 }),
+        status: result.skipped?.length ? 'failed' : 'completed',
         detail: {
-          [tr('detailReason')]: tr('runAcceptTrackedFailedReason')
+          [tr('detailAccepted')]: (result.applied || []).map(item => ({
+            [tr('detailFile')]: item.trackedChange?.path || tr('unknownFile'),
+            [tr('detailRecord')]: item.trackedChange?.label || item.trackedChange?.id || item.trackedChange?.key
+          })),
+          [tr('detailSkipped')]: (result.skipped || []).map(item => ({
+            [tr('detailFile')]: item.trackedChange?.path || tr('unknownFile'),
+            [tr('detailRecord')]: item.trackedChange?.label || item.trackedChange?.id || item.trackedChange?.key || '',
+            [tr('detailReason')]: formatBridgeResultReason(item.result, item.trackedChange?.path)
+          }))
         }
       });
-      if (!WritebackSettlement.isSuccessfulTrackedChangeSettlement(result)) {
-        refreshRunCardControls(runId);
+      if (result.ok === false) {
+        appendRunRecordEvent(runId, {
+          title: tr('runAcceptTrackedFailed'),
+          status: 'failed',
+          detail: {
+            [tr('detailReason')]: tr('runAcceptTrackedFailedReason')
+          }
+        });
+        if (!WritebackSettlement.isSuccessfulTrackedChangeSettlement(result)) {
+          refreshRunCardControls(runId);
+        }
       }
+      WritebackSettlement.attachAcceptNotVerifiedFailure(run, result, {
+        buildFailure: buildContentFailure
+      });
+      await applyTrackedChangeSettlement(runId, 'accept', result);
+    } finally {
+      trackedChangeInFlight.delete(runId);
+      refreshRunCardControls(runId);
     }
-    WritebackSettlement.attachAcceptNotVerifiedFailure(run, result, {
-      buildFailure: buildContentFailure
-    });
-    applyTrackedChangeSettlement(runId, 'accept', result);
   }
 
   function getRunProjectIdForWriteback(run) {
@@ -7112,7 +7113,7 @@
     );
   }
 
-  function applyTrackedChangeSettlement(runId, kind, result) {
+  async function applyTrackedChangeSettlement(runId, kind, result) {
     const run = findRunRecord(runId);
     const settlement = WritebackSettlement.settleTrackedChangeLifecycle({
       kind,
@@ -7121,12 +7122,12 @@
       failureReasons: FailureReasons
     });
     if (settlement.decision === 'blocked') {
-      refreshRunCardControls(runId);
       return;
     }
-    Object.assign(run, WritebackSettlement.applySettlementTransition(run, settlement));
-    saveStateSoon();
-    refreshRunCardControls(runId);
+    await Modules.ScopedPersistenceCoordinator.applyReviewTransition({
+      getState: () => state, runId, transition: WritebackSettlement.applySettlementTransition(run, settlement),
+      persist: flushQueuedSaveState
+    });
   }
 
   function getRunUndoCount(run) {