codex-overleaf-link 2.1.2 → 2.1.4

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-2.1.2-blue" alt="version">
+    <img src="https://img.shields.io/badge/version-2.1.4-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=v2.1.2 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.1.2/install.sh)"
+CODEX_OVERLEAF_REF=v2.1.4 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.1.4/install.sh)"
 ```
 
 Windows PowerShell:
 
 ```powershell
-iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.1.2/install.ps1 -OutFile install.ps1
-$env:CODEX_OVERLEAF_REF='v2.1.2'
+iwr https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.1.4/install.ps1 -OutFile install.ps1
+$env:CODEX_OVERLEAF_REF='v2.1.4'
 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@2.1.2 -- install-managed
+npm exec --yes codex-overleaf-link@2.1.4 -- 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@2.1.2 -- install-managed` |
-| Diagnose | `npm exec --yes codex-overleaf-link@2.1.2 -- doctor` |
-| Uninstall | `npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-managed` |
+| Install / update | `npm exec --yes codex-overleaf-link@2.1.4 -- install-managed` |
+| Diagnose | `npm exec --yes codex-overleaf-link@2.1.4 -- doctor` |
+| Uninstall | `npm exec --yes codex-overleaf-link@2.1.4 -- 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 v2.1.2 GitHub Release contains:
+The v2.1.4 GitHub Release contains:
 
-- `codex-overleaf-link-extension-v2.1.2.zip`: loadable Chrome extension package for manual unpacked installation.
-- `codex-overleaf-native-host-v2.1.2.tar.gz`: native host runtime files used by the installer and release verification.
-- `codex-overleaf-link-2.1.2.tgz`: npm native host CLI package for pinned install, doctor, and uninstall flows.
-- `install.sh`: release-pinned macOS / Linux installer that defaults to `v2.1.2` when run directly from the release artifact.
-- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v2.1.2` when run directly from the release artifact.
+- `codex-overleaf-link-extension-v2.1.4.zip`: loadable Chrome extension package for manual unpacked installation.
+- `codex-overleaf-native-host-v2.1.4.tar.gz`: native host runtime files used by the installer and release verification.
+- `codex-overleaf-link-2.1.4.tgz`: npm native host CLI package for pinned install, doctor, and uninstall flows.
+- `install.sh`: release-pinned macOS / Linux installer that defaults to `v2.1.4` when run directly from the release artifact.
+- `install.ps1`: release-pinned Windows PowerShell installer that defaults to `v2.1.4` 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 v2.1.2 GitHub Release contains:
 Remove the native host (use `--browser chromium` on Linux Chromium):
 
 ```bash
-npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-managed
+npm exec --yes codex-overleaf-link@2.1.4 -- 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=v2.1.2 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.1.2/install.sh)" -- --browser chromium
+CODEX_OVERLEAF_REF=v2.1.4 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/v2.1.4/install.sh)" -- --browser chromium
 ```
 
 Linux Chromium uninstall:
 
 ```bash
-npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-managed --browser chromium
+npm exec --yes codex-overleaf-link@2.1.4 -- uninstall-managed --browser chromium
 ```
 
 ## Features
@@ -292,7 +292,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@2.1.2 -- install-managed
+npm exec --yes codex-overleaf-link@2.1.4 -- install-managed
 ```
 
 **The Windows popup or panel shows a Bash recovery command**
@@ -341,8 +341,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@2.1.2 -- install-managed` | `npm exec --yes codex-overleaf-link@2.1.2 -- install-managed` | `npm exec --yes codex-overleaf-link@2.1.2 -- install-managed` | `npm exec --yes codex-overleaf-link@2.1.2 -- install-managed --browser chromium` |
-| Uninstall command | `npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-managed --browser chromium` |
+| Installer/update command | `npm exec --yes codex-overleaf-link@2.1.4 -- install-managed` | `npm exec --yes codex-overleaf-link@2.1.4 -- install-managed` | `npm exec --yes codex-overleaf-link@2.1.4 -- install-managed` | `npm exec --yes codex-overleaf-link@2.1.4 -- install-managed --browser chromium` |
+| Uninstall command | `npm exec --yes codex-overleaf-link@2.1.4 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.1.4 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.1.4 -- uninstall-managed` | `npm exec --yes codex-overleaf-link@2.1.4 -- 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. |
@@ -378,7 +378,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@2.1.2 -- install-managed
+npm exec --yes codex-overleaf-link@2.1.4 -- 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.
@@ -388,11 +388,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@2.1.2 -- install-native
+npm exec --yes codex-overleaf-link@2.1.4 -- install-native
 ```
 
 Legacy native-only installations can be removed with:
 
 ```bash
-npm exec --yes codex-overleaf-link@2.1.2 -- uninstall-native
+npm exec --yes codex-overleaf-link@2.1.4 -- uninstall-native
 ```

package/extension/bootstrap/manifest.template.json

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

package/extension/src/content/contentRuntime.js

@@ -604,7 +604,7 @@
     window,
     getSettingsPanelInstance: () => settingsPanelInstance,
     getSelectedModel: () => state?.model || '', getSelectedProviderId: () => state?.providerId || 'builtin',
-    setSelectedProviderId: providerId => { state = updateActiveSession(state, { providerId: providerId || 'builtin' }); },
+    setSelectedProviderId: (providerId, model) => { state = updateActiveSession(state, { providerId: providerId || 'builtin', ...(model !== undefined ? { model } : {}) }); const modelSelect = panel?.querySelector('[data-model]'); if (model !== undefined && modelSelect) modelSelect.value = ''; },
     refreshModelOptions: loadModelOptions, persistInputs: persistPanelInputs
   });
   // v1.8.1 D3: the dashboard was a one-shot render — another tab finishing a
@@ -6313,7 +6313,7 @@
       saveStateSoon();
       return;
     }
-    renderReasoningOptions(getRenderedModelEntries());
+    if (event?.target?.matches?.('[data-speed]')) state = updateActiveSession(state, { speedTier: readSelectedSpeedInput() }); renderReasoningOptions(getRenderedModelEntries());
     renderSpeedOptions(getRenderedModelEntries());
     readPanelInputs();
     renderModelConfigChoices();

package/extension/src/content/modelPicker.js

@@ -83,20 +83,24 @@
     const modelSelect = getPanel()?.querySelector('[data-model]');
     const reasoningSelect = getPanel()?.querySelector('[data-reasoning]');
     const speedSelect = getPanel()?.querySelector('[data-speed]');
+    let changedInput = null;
 
     if (choice.dataset.reasoningChoice && reasoningSelect) {
       reasoningSelect.value = choice.dataset.reasoningChoice;
+      changedInput = reasoningSelect;
     } else if (choice.dataset.modelChoice && modelSelect) {
       modelSelect.value = choice.dataset.modelChoice;
+      changedInput = modelSelect;
       renderReasoningOptions(getRenderedModelEntries());
       renderSpeedOptions(getRenderedModelEntries());
     } else if (choice.dataset.speedChoice && speedSelect) {
       speedSelect.value = choice.dataset.speedChoice;
+      changedInput = speedSelect;
     }
 
     renderModelConfigChoices();
     updateModelDisplay();
-    await persistPanelInputs();
+    await persistPanelInputs(changedInput ? { type: 'change', target: changedInput } : undefined);
   }
   async function loadModelOptions(providerSelection) {
     const generation = ++modelLoadGeneration;

package/extension/src/content/providerSettingsCoordinator.js

@@ -111,7 +111,11 @@
       : previousProviderId;
     const sessionProviderChanged = requestedProviderId !== previousProviderId;
     if (sessionProviderChanged) {
-      instance.setSelectedProviderId(requestedProviderId);
+      const requestedProvider = window.CodexOverleafProviderProfiles.getProviderById(catalog, requestedProviderId);
+      const preferredModelId = requestedProvider?.kind === 'custom'
+        ? requestedProvider.defaultModelId || requestedProvider.models?.[0]?.id || ''
+        : '';
+      instance.setSelectedProviderId(requestedProviderId, preferredModelId);
     }
     const changedProviderIds = Array.isArray(change.changedProviderIds) ? change.changedProviderIds : [];
     if (!change.forceSessionRefresh && !sessionProviderChanged && !changedProviderIds.includes(requestedProviderId)) {

package/extension/src/content/runController.js

@@ -49,6 +49,7 @@
       model: state.model,
       reasoningEffort: state.reasoningEffort,
       speedTier: state.speedTier,
+      locale: state.locale === 'zh' ? 'zh' : 'en',
       session: state.session,
       threadId: codexThreadId || undefined,
       customInstructions: normalizedCustomInstructions || undefined,
@@ -70,7 +71,7 @@
     return params;
   }
 
-  function buildSessionHistoryResult({ assistantMessage = '', syncOutcome = {}, syncChanges = [], locale = 'zh' } = {}) {
+  function buildSessionHistoryResult({ assistantMessage = '', syncOutcome = {}, syncChanges = [], locale = 'en' } = {}) {
     const parts = [];
     const finalAnswer = truncateSessionHistoryText(assistantMessage, 1600);
     if (finalAnswer) {

package/extension/src/content/writebackController.js

@@ -193,7 +193,7 @@
     };
   }
 
-  function formatUnsupportedLocalChangeSummary(changes = [], locale = 'zh') {
+  function formatUnsupportedLocalChangeSummary(changes = [], locale = 'en') {
     if (!changes.length) {
       return '';
     }
@@ -218,7 +218,7 @@
     return lines.join('\n');
   }
 
-  function formatUnsupportedLocalChangeReason(changeOrReason, locale = 'zh') {
+  function formatUnsupportedLocalChangeReason(changeOrReason, locale = 'en') {
     const isEnglish = locale === 'en';
     const change = typeof changeOrReason === 'object' && changeOrReason
       ? changeOrReason
@@ -247,7 +247,7 @@
       : '当前类型暂不支持自动写回。';
   }
 
-  function formatBinaryPayloadLimitReason(change = {}, locale = 'zh') {
+  function formatBinaryPayloadLimitReason(change = {}, locale = 'en') {
     const isEnglish = locale === 'en';
     const size = formatBytes(change.size);
     const limit = formatBytes(change.limit || change.aggregateLimit || change.nativeOutputLimit);

package/extension/src/shared/agentTranscript.js

@@ -49,7 +49,7 @@
   };
 
   function normalizeLocale(options = {}) {
-    return options?.locale === 'en' ? 'en' : 'zh';
+    return options?.locale === 'zh' ? 'zh' : 'en';
   }
 
   function textFor(locale, zh, en) {
@@ -430,7 +430,7 @@
       && /(context|thread|turn|conversation|codex)/i.test(label);
   }
 
-  function formatContextCompactionCheckpoint(event = {}, locale = 'zh') {
+  function formatContextCompactionCheckpoint(event = {}, locale = 'en') {
     const method = String(event.detail?.method || event.title || '');
     const running = event.status === 'running' || /(started|starting|begin|prepar)/i.test(method);
     return {
@@ -559,7 +559,7 @@
     return `${prefix}:${itemId || 'current'}`;
   }
 
-  function formatPlanUpdateTitle(params = {}, locale = 'zh') {
+  function formatPlanUpdateTitle(params = {}, locale = 'en') {
     const steps = Array.isArray(params.plan) ? params.plan : [];
     const active = steps.find(step => step.status === 'in_progress') || steps.find(step => step.status === 'pending');
     const text = cleanVisibleText(active?.step || params.explanation || '');
@@ -568,7 +568,7 @@
       : textFor(locale, 'Codex 更新了执行计划。', 'Codex updated its plan.');
   }
 
-  function formatPlanUpdateDetail(params = {}, locale = 'zh') {
+  function formatPlanUpdateDetail(params = {}, locale = 'en') {
     const steps = Array.isArray(params.plan) ? params.plan : [];
     if (!steps.length) {
       return undefined;
@@ -892,7 +892,7 @@
    * part of Codex's answer. `formatHumanReport` retains the legacy flat-text
    * shape for transcripts, storage fallback, and existing assertions.
    */
-  function buildStructuredHumanReport(report = {}, locale = 'zh') {
+  function buildStructuredHumanReport(report = {}, locale = 'en') {
     const conclusion = cleanVisibleMarkdownText(report.conclusion || '');
 
     const bodySections = [];
@@ -939,7 +939,7 @@
     return { conclusion, body: bodySections.join('\n\n'), meta };
   }
 
-  function formatHumanReport(report = {}, locale = 'zh') {
+  function formatHumanReport(report = {}, locale = 'en') {
     const sections = [];
     const conclusion = cleanVisibleMarkdownText(report.conclusion || '');
     if (conclusion) {
@@ -969,7 +969,7 @@
     return sections.join('\n\n');
   }
 
-  function buildFallbackReport(input, counts, locale = 'zh') {
+  function buildFallbackReport(input, counts, locale = 'en') {
     const operations = Array.isArray(input.operations) ? input.operations : [];
     const appliedOperations = collectAppliedOperations(input.applyResults);
     const affectedFiles = collectAffectedFiles(operations, input.summary, input.applyResults);
@@ -1023,7 +1023,7 @@
     return localized.nextAction || primary.nextAction || '';
   }
 
-  function formatWriteResult(appliedCount, skippedCount, locale = 'zh') {
+  function formatWriteResult(appliedCount, skippedCount, locale = 'en') {
     return textFor(
       locale,
       `已写入 ${appliedCount} 项，跳过 ${skippedCount} 项`,
@@ -1031,7 +1031,7 @@
     );
   }
 
-  function inferUnchangedReason(input, locale = 'zh') {
+  function inferUnchangedReason(input, locale = 'en') {
     if (input.mode === 'ask' || input.status === '只问不改') {
       return textFor(locale, '这轮是只问不改。', 'This run was Ask mode.');
     }
@@ -1041,7 +1041,7 @@
     return '';
   }
 
-  function formatFallbackNextStep(input, skippedCount, affectedFiles, locale = 'zh') {
+  function formatFallbackNextStep(input, skippedCount, affectedFiles, locale = 'en') {
     if (skippedCount) {
       return textFor(locale, '请查看本轮报告中的跳过项，处理后可以重试。', 'Review the skipped items in this report, then retry after resolving them.');
     }
@@ -1070,7 +1070,7 @@
     };
   }
 
-  function technicalOnly(event, locale = 'zh') {
+  function technicalOnly(event, locale = 'en') {
     return {
       kind: 'technical',
       visible: false,
@@ -1094,7 +1094,7 @@
     return TECHNICAL_EVENT_PATTERNS.some(pattern => pattern.test(type));
   }
 
-  function summarizeCommandActivity(event, locale = 'zh') {
+  function summarizeCommandActivity(event, locale = 'en') {
     const type = String(event.type || '');
     const command = String(event.detail?.command || '');
     const output = String(event.detail?.output || '');
@@ -1140,7 +1140,7 @@
     return 'check';
   }
 
-  function formatCommandStartedTitle(kind, command, locale = 'zh') {
+  function formatCommandStartedTitle(kind, command, locale = 'en') {
     if (kind === 'search') {
       const query = extractSearchQuery(command);
       return query ? textFor(locale, `正在搜索项目内容：${query}`, `Searching project content: ${query}`) : textFor(locale, '正在搜索项目内容。', 'Searching project content.');
@@ -1157,7 +1157,7 @@
     return textFor(locale, '正在执行一次本地检查。', 'Running a local check.');
   }
 
-  function formatCommandCompletedTitle(kind, output, failed, locale = 'zh') {
+  function formatCommandCompletedTitle(kind, output, failed, locale = 'en') {
     if (failed) {
       if (kind === 'search') {
         return textFor(locale, '搜索没有正常完成。', 'Search did not finish normally.');
@@ -1184,7 +1184,7 @@
     return textFor(locale, '本地检查已完成。', 'Local check completed.');
   }
 
-  function formatCommandPublicDetail(kind, command, locale = 'zh') {
+  function formatCommandPublicDetail(kind, command, locale = 'en') {
     if (kind !== 'search') {
       return undefined;
     }
@@ -1235,7 +1235,7 @@
     return files;
   }
 
-  function formatFilesInline(files = [], locale = 'zh') {
+  function formatFilesInline(files = [], locale = 'en') {
     const values = normalizeStringList(files);
     if (!values.length) {
       return textFor(locale, '没有文件', 'no files');
@@ -1300,7 +1300,7 @@
       .trim();
   }
 
-  function addListSection(sections, label, values, locale = 'zh') {
+  function addListSection(sections, label, values, locale = 'en') {
     const items = normalizeStringList(values);
     if (!items.length) {
       return;
@@ -1314,7 +1314,7 @@
    * rendered report. Per-item first line gets the `- ` bullet; subsequent
    * lines pass through verbatim (the formatter already indents them).
    */
-  function addStructuredListSection(sections, label, values, locale = 'zh') {
+  function addStructuredListSection(sections, label, values, locale = 'en') {
     const items = normalizeMultilineStringList(values);
     if (!items.length) {
       return;
@@ -1408,7 +1408,7 @@
     return files;
   }
 
-  function formatOperationLine(operation, locale = 'zh') {
+  function formatOperationLine(operation, locale = 'en') {
     const labels = OPERATION_LABELS[locale] || OPERATION_LABELS.zh;
     const label = labels[operation?.type] || operation?.type || textFor(locale, '处理', 'process');
     const filePath = operation?.path || operation?.from || operation?.to || textFor(locale, '未知文件', 'unknown file');
@@ -1418,7 +1418,7 @@
       : (reason ? `${filePath}：${label}（${reason}）` : `${filePath}：${label}`);
   }
 
-  function formatOperationReason(operation, locale = 'zh') {
+  function formatOperationReason(operation, locale = 'en') {
     const key = operation?.reasonKey || '';
     const count = Number(operation?.reasonParams?.count || 0);
     if (key === 'localWorkspaceDelete') {
@@ -1440,7 +1440,7 @@
     return localizeVisibleReason(operation?.reason || '', locale);
   }
 
-  function formatSkippedOperationLine(item, locale = 'zh') {
+  function formatSkippedOperationLine(item, locale = 'en') {
     const operation = item?.operation || {};
     const labels = OPERATION_LABELS[locale] || OPERATION_LABELS.zh;
     const label = labels[operation.type] || operation.type || textFor(locale, '处理', 'process');
@@ -1547,7 +1547,7 @@
     };
   }
 
-  function formatSkippedReason(result = {}, operation = {}, locale = 'zh') {
+  function formatSkippedReason(result = {}, operation = {}, locale = 'en') {
     const key = result.reasonKey || '';
     const code = result.code || '';
     const filePath = result.reasonParams?.filePath || operation?.path || operation?.from || operation?.to || '';
@@ -1664,7 +1664,7 @@
     return parts.join(', ');
   }
 
-  function localizeVisibleReason(reason, locale = 'zh') {
+  function localizeVisibleReason(reason, locale = 'en') {
     const text = cleanVisibleText(reason || '');
     if (!text || locale !== 'en') {
       return text;

package/extension/src/shared/compatibility.js

@@ -12,7 +12,7 @@
   const MIN_NATIVE_VERSION = '1.0.0';
   const MIN_COMPATIBLE_NATIVE_VERSION = '1.0.0';
   const MIN_COMPATIBLE_EXTENSION_VERSION = '1.0.0';
-  const BUILD_TARGET_VERSION = '2.1.2';
+  const BUILD_TARGET_VERSION = '2.1.4';
   const DEFAULT_CHROME_EXTENSION_ID = 'illdpneeeopfffmiepaejglgmhpmdhdc';
   const REQUIRED_CAPABILITIES = Object.freeze([
     'bridgePing',

package/extension/src/shared/sessionState.js

@@ -1051,6 +1051,9 @@
       runs,
       task: summarizeTextForStorage(session.task, 'task'),
       mode: normalizeMode(session.mode || fallbackState.mode),
+      providerId: typeof session.providerId === 'string' && session.providerId
+        ? session.providerId
+        : 'builtin',
       model: normalizeTextField(session.model || fallbackState.model || DEFAULT_PANEL_STATE.model, 80),
       reasoningEffort: normalizeReasoning(session.reasoningEffort || fallbackState.reasoningEffort),
       speedTier: normalizeSpeedTier(session.speedTier || fallbackState.speedTier),

package/native-host/src/codexRuntimeIdentity.js

@@ -0,0 +1,217 @@
+'use strict';
+
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+
+const RUNTIME_ENV_KEY = 'CODEX_OVERLEAF_CODEX_RUNTIME_JSON';
+const MAX_CODEX_CANDIDATES = 8;
+const VERSION_TIMEOUT_MS = 700;
+
+function buildCodexRuntimeIdentity(options = {}) {
+  const env = options.env || process.env;
+  const platform = options.platform || process.platform;
+  const delimiter = options.delimiter || (platform === 'win32' ? ';' : path.delimiter);
+  const selectedPath = String(options.selectedPath || '').trim();
+  const discovered = discoverCodexCandidates(options.pathValue || env.PATH || '', {
+    delimiter,
+    env,
+    platform
+  });
+  const candidatePaths = selectedPath
+    ? [selectedPath, ...discovered.filter(candidate => !sameExecutablePath(candidate, selectedPath, platform))]
+    : discovered;
+  const candidates = candidatePaths.slice(0, MAX_CODEX_CANDIDATES).map((candidatePath, index) => ({
+    path: candidatePath,
+    displayPath: compactHomePath(candidatePath, env, platform),
+    version: readCodexVersion(candidatePath, { env, platform }),
+    source: classifyCodexSource(candidatePath),
+    selected: index === 0 && Boolean(selectedPath)
+  }));
+  const selected = candidates.find(candidate => candidate.selected) || null;
+
+  return {
+    schemaVersion: 1,
+    selected,
+    candidates,
+    multipleInstallations: candidates.length > 1,
+    selectedBy: selected ? 'path-order' : 'not-found'
+  };
+}
+
+function discoverCodexCandidates(pathValue, options = {}) {
+  const platform = options.platform || process.platform;
+  const delimiter = options.delimiter || (platform === 'win32' ? ';' : path.delimiter);
+  const extensions = executableExtensions(options.env || process.env, platform);
+  const seen = new Set();
+  const result = [];
+
+  for (const rawSegment of String(pathValue || '').split(delimiter)) {
+    const segment = rawSegment.trim();
+    if (!segment) continue;
+    for (const extension of extensions) {
+      const candidate = path.join(segment, `codex${extension}`);
+      const key = platform === 'win32' ? candidate.toLowerCase() : candidate;
+      if (seen.has(key) || !isExecutableFile(candidate, platform)) continue;
+      seen.add(key);
+      result.push(candidate);
+      break;
+    }
+  }
+  return result;
+}
+
+function executableExtensions(env, platform) {
+  if (platform !== 'win32') return [''];
+  const configured = String(env.PATHEXT || '.COM;.EXE;.BAT;.CMD')
+    .split(';')
+    .map(value => value.trim().toLowerCase())
+    .filter(Boolean);
+  return ['', ...new Set(configured)];
+}
+
+function isExecutableFile(candidate, platform) {
+  try {
+    if (!fs.statSync(candidate).isFile()) return false;
+    fs.accessSync(candidate, platform === 'win32' ? fs.constants.F_OK : fs.constants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function readCodexVersion(candidatePath, options = {}) {
+  if (!candidatePath) return '';
+  const platform = options.platform || process.platform;
+  const result = spawnSync(candidatePath, ['--version'], {
+    encoding: 'utf8',
+    env: options.env || process.env,
+    maxBuffer: 64 * 1024,
+    shell: platform === 'win32' && /\.(?:cmd|bat)$/i.test(candidatePath),
+    timeout: VERSION_TIMEOUT_MS,
+    windowsHide: true
+  });
+  const output = `${result.stdout || ''}\n${result.stderr || ''}`.trim();
+  const match = output.match(/\bcodex(?:-cli)?\s+v?([^\s]+)/i);
+  return match ? match[1] : '';
+}
+
+function classifyCodexSource(candidatePath) {
+  const normalized = normalizeSlashes(candidatePath).toLowerCase();
+  let resolved = normalized;
+  try {
+    resolved = normalizeSlashes(fs.realpathSync(candidatePath)).toLowerCase();
+  } catch {
+    // Keep the visible path when a symlink target cannot be resolved.
+  }
+  if (normalized.includes('/applications/chatgpt.app/')) return 'chatgpt-app';
+  if (normalized.includes('/applications/codex.app/')) return 'codex-app';
+  if (normalized.includes('/.nvm/versions/node/')) return 'npm-nvm';
+  if (resolved.includes('/node_modules/@openai/codex')) return 'npm-global';
+  if (normalized.includes('/opt/homebrew/') || normalized.includes('/homebrew/')) return 'homebrew-prefix';
+  if (normalized.includes('/.npm-global/')) return 'npm-global';
+  return 'path';
+}
+
+function compactHomePath(candidatePath, env = process.env, platform = process.platform) {
+  const home = String(env.HOME || env.USERPROFILE || os.homedir() || '');
+  if (!home) return candidatePath;
+  const caseFold = value => platform === 'win32' ? value.toLowerCase() : value;
+  const normalizedCandidate = path.normalize(candidatePath);
+  const normalizedHome = path.normalize(home);
+  if (caseFold(normalizedCandidate) === caseFold(normalizedHome)) return '~';
+  if (caseFold(normalizedCandidate).startsWith(`${caseFold(normalizedHome)}${path.sep}`)) {
+    return `~${path.sep}${normalizedCandidate.slice(normalizedHome.length + 1)}`;
+  }
+  return candidatePath;
+}
+
+function serializeCodexRuntimeIdentity(identity) {
+  return JSON.stringify(identity || emptyIdentity());
+}
+
+function getCodexRuntimeIdentityFromEnv(env = process.env) {
+  try {
+    const parsed = JSON.parse(String(env[RUNTIME_ENV_KEY] || ''));
+    if (parsed && typeof parsed === 'object' && Array.isArray(parsed.candidates)) return parsed;
+  } catch {
+    // Fall through to the legacy single-path representation.
+  }
+  const selectedPath = String(env.CODEX_OVERLEAF_CODEX_PATH || '').trim();
+  const selected = selectedPath ? {
+    path: selectedPath,
+    displayPath: compactHomePath(selectedPath, env, env.CODEX_OVERLEAF_PLATFORM || process.platform),
+    version: String(env.CODEX_OVERLEAF_CODEX_VERSION || ''),
+    source: String(env.CODEX_OVERLEAF_CODEX_SOURCE || classifyCodexSource(selectedPath)),
+    selected: true
+  } : null;
+  return {
+    schemaVersion: 1,
+    selected,
+    candidates: selected ? [selected] : [],
+    multipleInstallations: false,
+    selectedBy: selected ? 'legacy-path' : 'not-found'
+  };
+}
+
+function buildCodexRuntimeEvent(env = process.env) {
+  const identity = getCodexRuntimeIdentityFromEnv(env);
+  const selected = identity.selected;
+  if (!selected) return null;
+  const version = selected.version || 'unknown version';
+  const candidateCount = identity.candidates.length;
+  return {
+    type: 'codex.runtime.selected',
+    title: identity.multipleInstallations
+      ? `Using Codex CLI ${version}; ${candidateCount} installations were detected.`
+      : `Using Codex CLI ${version}.`,
+    status: 'completed',
+    detail: {
+      path: selected.displayPath || selected.path,
+      version: selected.version || '',
+      source: selected.source || 'path',
+      selectedBy: identity.selectedBy || 'path-order',
+      multipleInstallations: identity.multipleInstallations === true,
+      warningCode: identity.multipleInstallations ? 'multiple_codex_installations' : '',
+      candidates: identity.candidates.map(candidate => ({
+        path: candidate.displayPath || candidate.path,
+        version: candidate.version || '',
+        source: candidate.source || 'path',
+        selected: candidate.selected === true
+      })),
+      technical: true
+    }
+  };
+}
+
+function sameExecutablePath(left, right, platform) {
+  const normalize = value => path.normalize(String(value || ''));
+  return platform === 'win32'
+    ? normalize(left).toLowerCase() === normalize(right).toLowerCase()
+    : normalize(left) === normalize(right);
+}
+
+function normalizeSlashes(value) {
+  return String(value || '').replace(/\\/g, '/');
+}
+
+function emptyIdentity() {
+  return {
+    schemaVersion: 1,
+    selected: null,
+    candidates: [],
+    multipleInstallations: false,
+    selectedBy: 'not-found'
+  };
+}
+
+module.exports = {
+  RUNTIME_ENV_KEY,
+  buildCodexRuntimeEvent,
+  buildCodexRuntimeIdentity,
+  discoverCodexCandidates,
+  getCodexRuntimeIdentityFromEnv,
+  readCodexVersion,
+  serializeCodexRuntimeIdentity
+};

package/native-host/src/nativeDoctor.js

@@ -56,6 +56,7 @@ async function runDoctor(options = {}) {
       errors: []
     },
     bridge: null,
+    codex: null,
     ping: {
       attempted: false
     },
@@ -106,6 +107,10 @@ async function runDoctor(options = {}) {
   body.ping = pingResult;
 
   if (body.ping.ok) {
+    body.codex = sanitizeCodexRuntime(
+      rawPingResponse?.result?.environment?.codex,
+      pathOptions
+    );
     body.compatibility = sanitizeCompatibility(
       evaluateNativeCompatibility(rawPingResponse, { version: PACKAGE_VERSION })
     );
@@ -206,6 +211,19 @@ function formatDoctorHuman(body = {}) {
     lines.push(`Native compatibility: ${body.compatibility.classification || 'unknown'}`);
     lines.push(`Native version: ${body.compatibility.nativeVersion || 'unknown'}`);
   }
+  if (body.codex) {
+    lines.push(`Codex status: ${body.codex.ok ? 'available' : 'not found'}`);
+    lines.push(`Codex path: ${body.codex.path || 'unknown'}`);
+    lines.push(`Codex version: ${body.codex.version || 'unknown'}`);
+    lines.push(`Codex source: ${body.codex.source || 'unknown'}`);
+    if (body.codex.multipleInstallations) {
+      lines.push('Warning: multiple Codex installations detected.');
+      lines.push('Codex candidates:');
+      for (const candidate of body.codex.candidates) {
+        lines.push(`  ${candidate.selected ? '*' : '-'} ${candidate.path || 'unknown'} (${candidate.version || 'unknown'}, ${candidate.source || 'path'})`);
+      }
+    }
+  }
   if (body.ping?.ok === false) {
     lines.push(`Ping: failed (${body.ping.error || 'unknown error'})`);
   } else if (body.ping?.ok === true) {
@@ -255,6 +273,28 @@ function normalizeDiagnosticPath(targetPath, options = {}) {
   return value;
 }
 
+function sanitizeCodexRuntime(codex, pathOptions) {
+  if (!codex || typeof codex !== 'object') return null;
+  const normalizeCodexPath = value => {
+    const normalized = normalizeDiagnosticPath(value, pathOptions);
+    return normalized.includes('<absolute-path>') ? String(value || '') : normalized;
+  };
+  return {
+    ok: codex.ok === true,
+    path: normalizeCodexPath(codex.path || ''),
+    version: String(codex.version || ''),
+    source: String(codex.source || ''),
+    selectedBy: String(codex.selectedBy || ''),
+    multipleInstallations: codex.multipleInstallations === true,
+    candidates: Array.isArray(codex.candidates) ? codex.candidates.map(candidate => ({
+      path: normalizeCodexPath(candidate?.path || ''),
+      version: String(candidate?.version || ''),
+      source: String(candidate?.source || ''),
+      selected: candidate?.selected === true
+    })) : []
+  };
+}
+
 function finalizeDoctorResult(body) {
   const classification = classifyDoctorResult(body);
   body.ok = classification.ok;

package/native-host/src/nativeEnvironment.js

@@ -4,6 +4,11 @@ const fs = require('node:fs');
 const os = require('node:os');
 const path = require('node:path');
 const { spawnSync } = require('node:child_process');
+const {
+  buildCodexRuntimeIdentity,
+  getCodexRuntimeIdentityFromEnv,
+  serializeCodexRuntimeIdentity
+} = require('./codexRuntimeIdentity');
 
 const TOOL_NAMES = ['codex', 'latexmk', 'pdflatex', 'xelatex', 'lualatex', 'bibtex', 'biber'];
 const LATEX_TOOL_NAMES = ['latexmk', 'pdflatex', 'xelatex', 'lualatex', 'bibtex', 'biber'];
@@ -32,6 +37,16 @@ function buildNativeRuntimeEnv(baseEnv = process.env, options = {}) {
   for (const tool of TOOL_NAMES) {
     env[getToolEnvName(tool)] = resolveExecutable(tool, env.PATH, { ...runtimeOptions, env }) || '';
   }
+  const codexRuntime = buildCodexRuntimeIdentity({
+    selectedPath: env.CODEX_OVERLEAF_CODEX_PATH,
+    pathValue: env.PATH,
+    delimiter: runtimeOptions.delimiter,
+    env,
+    platform: runtimeOptions.platform
+  });
+  env.CODEX_OVERLEAF_CODEX_RUNTIME_JSON = serializeCodexRuntimeIdentity(codexRuntime);
+  env.CODEX_OVERLEAF_CODEX_VERSION = codexRuntime.selected?.version || '';
+  env.CODEX_OVERLEAF_CODEX_SOURCE = codexRuntime.selected?.source || '';
 
   return env;
 }
@@ -200,13 +215,25 @@ function resolveExecutable(name, pathValue, options = {}) {
 }
 
 function summarizeNativeEnvironment(env = process.env, options = {}) {
+  const codexRuntime = getCodexRuntimeIdentityFromEnv(env);
+  const selectedCodex = codexRuntime.selected || {};
   const runtimeOptions = { ...options, platform: getNativeRuntimePlatform({ ...options, env }) };
   const availableLatex = LATEX_TOOL_NAMES.filter(tool => Boolean(env[getToolEnvName(tool)]));
   const missingLatex = LATEX_TOOL_NAMES.filter(tool => !env[getToolEnvName(tool)]);
   return {
     codex: {
       ok: Boolean(env.CODEX_OVERLEAF_CODEX_PATH),
-      path: env.CODEX_OVERLEAF_CODEX_PATH || ''
+      path: env.CODEX_OVERLEAF_CODEX_PATH || '',
+      version: selectedCodex.version || '',
+      source: selectedCodex.source || '',
+      selectedBy: codexRuntime.selectedBy || 'not-found',
+      multipleInstallations: codexRuntime.multipleInstallations === true,
+      candidates: codexRuntime.candidates.map(candidate => ({
+        path: candidate.displayPath || candidate.path || '',
+        version: candidate.version || '',
+        source: candidate.source || 'path',
+        selected: candidate.selected === true
+      }))
     },
     latex: {
       ok: availableLatex.length > 0,

package/native-host/src/taskRunnerRuntime.js

@@ -1,5 +1,7 @@
 'use strict';
 
+const { buildCodexRuntimeEvent } = require('./codexRuntimeIdentity');
+
 const { spawn } = require('node:child_process');
 const crypto = require('node:crypto');
 const { buildOperationSummary, splitDeletePlan } = require('../../extension/src/shared/summary');
@@ -157,6 +159,10 @@ async function handleCodexRun(request, env, emit) {
       'Codex CLI was not found. Install Codex or make sure the `codex` command is available in your login shell.'
     );
   }
+  const codexRuntimeEvent = buildCodexRuntimeEvent(env);
+  if (codexRuntimeEvent && typeof emit === 'function') {
+    emit(codexRuntimeEvent);
+  }
 
   const projectKey = resolveProjectKey(params);
   const lockToken = acquireProjectLock(projectKey);
@@ -883,6 +889,7 @@ function validateTaskResultOperationQuotas(result = {}) {
 }
 
 function buildDefaultUserReport(mode, operations = [], params = {}) {
+  const locale = normalizeReportLocale(params.locale);
   const checked = (params.project?.files || [])
     .map(file => file?.path)
     .filter(path => typeof path === 'string' && path.length > 0)
@@ -891,19 +898,29 @@ function buildDefaultUserReport(mode, operations = [], params = {}) {
 
   return {
     conclusion: hasOperations
-      ? 'Codex 已准备好建议修改，等待确认或写入。'
-      : '这轮任务已完成，没有写入 Overleaf 文件。',
+      ? reportText(locale, 'Codex prepared proposed changes and is waiting for confirmation or writeback.', 'Codex 已准备好建议修改，等待确认或写入。')
+      : reportText(locale, 'This task completed without writing Overleaf files.', '这轮任务已完成，没有写入 Overleaf 文件。'),
     checked,
     findings: [],
-    plannedChanges: hasOperations ? operations.map(formatOperationForUserReport) : [],
+    plannedChanges: hasOperations ? operations.map(operation => formatOperationForUserReport(operation, locale)) : [],
     appliedChanges: [],
-    unchangedReason: hasOperations ? '' : (mode === 'ask' ? '这轮是只问不改。' : ''),
+    unchangedReason: hasOperations
+      ? ''
+      : (mode === 'ask' ? reportText(locale, 'This run was Ask mode.', '这轮是只问不改。') : ''),
     nextStep: hasOperations
-      ? '请确认修改方案后写入 Overleaf。'
-      : '可以继续追问，或加入更多 @context 后再检查。'
+      ? reportText(locale, 'Review and confirm the proposed changes before writing them to Overleaf.', '请确认修改方案后写入 Overleaf。')
+      : reportText(locale, 'Continue the conversation, or add more @context and run another check.', '可以继续追问，或加入更多 @context 后再检查。')
   };
 }
 
+function normalizeReportLocale(locale) {
+  return locale === 'zh' ? 'zh' : 'en';
+}
+
+function reportText(locale, english, chinese) {
+  return locale === 'zh' ? chinese : english;
+}
+
 function normalizeUserReport(value, fallback) {
   if (!value || typeof value !== 'object') {
     return fallback;
@@ -926,17 +943,13 @@ function normalizeStringArray(value, fallback = []) {
   return value.filter(item => typeof item === 'string');
 }
 
-function formatOperationForUserReport(operation) {
-  const labels = {
-    edit: '编辑',
-    create: '新建',
-    rename: '重命名',
-    move: '移动',
-    delete: '删除'
-  };
-  const label = labels[operation?.type] || operation?.type || '处理';
-  const filePath = operation?.path || operation?.to || '未知文件';
-  return `${filePath}：${label}`;
+function formatOperationForUserReport(operation, locale = 'en') {
+  const labels = locale === 'zh'
+    ? { edit: '编辑', create: '新建', rename: '重命名', move: '移动', delete: '删除' }
+    : { edit: 'edit', create: 'create', rename: 'rename', move: 'move', delete: 'delete' };
+  const label = labels[operation?.type] || operation?.type || reportText(locale, 'change', '处理');
+  const filePath = operation?.path || operation?.to || reportText(locale, 'unknown file', '未知文件');
+  return locale === 'zh' ? `${filePath}：${label}` : `${filePath}: ${label}`;
 }
 
 function collectResultOperations(result) {

package/package.json

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