codex-overleaf-link 2.4.1 → 2.5.1

package/extension/src/popup.js

@@ -1,75 +1,218 @@
 (function initPopup() {
   'use strict';
 
+  // Keep only copy produced by this popup eligible for a language refresh.
+  const popupCopyPairs = new Map();
+  let newSiteCopyNodes = [];
+
+  const popupScriptUrl = document.currentScript?.src || chrome.runtime.getURL('src/popup.js');
+  ensureMinimalPopupShell();
   const CodexOverleafCompatibility = window.CodexOverleafCompatibility;
-  const DEFAULT_INSTALL_COMMAND = CodexOverleafCompatibility?.buildInstallCommand?.(
+  const isManagedInstall = chrome.runtime.getManifest()?.background?.service_worker === 'bootstrap/background.js'
+    || window.__CODEX_OVERLEAF_RUNTIME_PREFIX__ === 'runtime/';
+  let installIdentity = { managed: isManagedInstall };
+  const DEFAULT_INSTALL_COMMAND = isManagedInstall ? '' : CodexOverleafCompatibility?.buildInstallCommand?.(
     undefined,
     undefined,
     getCurrentExtensionId()
   ) || 'curl -fsSL https://raw.githubusercontent.com/Ghqqqq/codex-overleaf-link/main/install.sh | bash -s -- --extension-id <chrome-extension-id>';
-  const button = document.getElementById('open-panel');
+  const launcherToggle = document.getElementById('launcher-toggle');
   const status = document.getElementById('status');
+  const connectionToggle = document.getElementById('connection-toggle');
+  const connectionDetails = document.getElementById('connection-details');
+  const connectionLabel = document.getElementById('connection-label');
   const compatStatusIcon = document.getElementById('compat-status-icon');
-  const versionPair = document.getElementById('version-pair');
+  const extensionVersionLabel = document.getElementById('extension-version');
+  const nativeVersionLabel = document.getElementById('native-version');
   const nativeInstall = document.getElementById('native-install');
+  const nativeStatusMessage = document.getElementById('native-status-message');
   const installCommand = document.getElementById('install-command');
   const copyInstallCommand = document.getElementById('copy-install-command');
+  const copyFeedback = document.getElementById('copy-feedback');
   let activeOverleafTab = null;
   let currentInstallCommand = DEFAULT_INSTALL_COMMAND;
+  let lastCompatibility = null;
+  let launcherVisible = false;
+  let launcherReady = false;
 
   installCommand.textContent = currentInstallCommand;
-  button.textContent = 'Show Codex button in Overleaf';
-  setVersionStatus({
-    status: 'native_missing',
-    classification: 'incompatible',
-    extensionVersion: getExtensionCompatibilityMetadata().version
+  setVersionStatus({ status: 'checking', extensionVersion: getExtensionCompatibilityMetadata().version });
+
+  connectionToggle.addEventListener('click', () => {
+    connectionDetails.hidden = !connectionDetails.hidden;
+    connectionToggle.setAttribute('aria-expanded', String(!connectionDetails.hidden));
   });
 
-  button.addEventListener('click', async () => {
-    const tab = activeOverleafTab || await getActiveOverleafProjectTab();
-    if (!tab?.id) {
-      status.textContent = 'Open an Overleaf project tab first.';
-      return;
+  launcherToggle.addEventListener('change', async () => {
+    const desired = launcherToggle.checked;
+    launcherToggle.disabled = true;
+    setLauncherStatus('');
+    try {
+      const tab = await getActiveOverleafProjectTab();
+      if (!tab?.id) throw new Error(utx('Open an Overleaf project tab first.', '请先打开 Overleaf 项目页。'));
+      activeOverleafTab = tab;
+      const before = await chrome.tabs.sendMessage(tab.id, { type: 'codex-overleaf/get-panel-state' });
+      if (typeof before?.launcherVisible !== 'boolean') {
+        throw new Error(utx('Refresh the Overleaf tab, then reopen this popup.', '请刷新 Overleaf 页面，再打开此弹窗。'));
+      }
+      // Keep the existing visibility contract. Do not open or close the panel.
+      if (before.launcherVisible !== desired) {
+        const response = await chrome.tabs.sendMessage(tab.id, { type: 'codex-overleaf/toggle-launcher' });
+        if (response?.ok === false) throw new Error(response.error?.message || response.error
+          || utx('The side button could not be changed.', '侧边入口设置未能修改。'));
+      }
+      const after = await chrome.tabs.sendMessage(tab.id, { type: 'codex-overleaf/get-panel-state' });
+      if (typeof after?.launcherVisible !== 'boolean' || after.launcherVisible !== desired) {
+        throw new Error(utx('The side button state could not be confirmed. Reopen this popup to retry.',
+          '未能确认侧边入口状态，请重新打开此弹窗后重试。'));
+      }
+      launcherVisible = after.launcherVisible;
+      launcherReady = true;
+    } catch (error) {
+      launcherReady = false;
+      setLauncherStatus(error?.message || utx('Refresh the Overleaf tab and try again.', '请刷新 Overleaf 页面后重试。'), true);
+    } finally {
+      launcherToggle.checked = launcherVisible;
+      launcherToggle.disabled = !launcherReady;
     }
-
-    await chrome.tabs.sendMessage(tab.id, { type: 'codex-overleaf/toggle-launcher' });
-    window.close();
   });
 
   copyInstallCommand.addEventListener('click', async () => {
-    await navigator.clipboard.writeText(currentInstallCommand);
-    copyInstallCommand.textContent = 'Copied';
-    setTimeout(() => {
-      copyInstallCommand.textContent = 'Copy install command';
-    }, 1400);
+    if (!currentInstallCommand) return;
+    copyInstallCommand.disabled = true;
+    copyFeedback.hidden = true;
+    try {
+      await navigator.clipboard.writeText(currentInstallCommand);
+      copyInstallCommand.textContent = utx('Copied', '已复制');
+      setTimeout(() => { copyInstallCommand.textContent = utx('Copy install command', '复制安装命令'); }, 1400);
+    } catch (_error) {
+      copyFeedback.textContent = utx('Copy failed. Select the command above to copy it.', '复制失败，可选中上方命令复制。');
+      copyFeedback.hidden = false;
+    } finally {
+      copyInstallCommand.disabled = !currentInstallCommand;
+    }
   });
 
   initPopupState();
   scheduleConsentUpdateUi();
 
+  // Older managed installations keep their bootstrap HTML across runtime
+  // updates. Upgrade only this popup's shell, leaving runtime behavior shared.
+  function ensureMinimalPopupShell() {
+    document.documentElement.classList.add('popup-minimal-root');
+    document.body.classList.add('popup-minimal');
+    if (!document.getElementById('launcher-toggle')) {
+      const shell = document.createElement('div');
+      shell.innerHTML = "<main id=\"popup-shell\">\n  <header class=\"popup-header\">\n    <img id=\"brand-icon\" class=\"popup-icon\" src=\"assets/icons/icon128.png\" width=\"32\" height=\"32\" alt=\"\">\n    <div class=\"popup-brand\">\n      <h1>Codex Overleaf Link</h1>\n      <button id=\"connection-toggle\" class=\"connection-toggle\" type=\"button\" aria-expanded=\"false\" aria-controls=\"connection-details\">\n        <span id=\"compat-status-icon\" class=\"status-icon pending\" aria-hidden=\"true\"></span>\n        <span id=\"connection-label\">Checking connection...</span>\n        <span class=\"connection-chevron\" aria-hidden=\"true\"></span>\n      </button>\n    </div>\n  </header>\n  <section id=\"connection-details\" class=\"connection-details\" aria-label=\"Version details\" hidden>\n    <dl id=\"version-pair\">\n      <div><dt id=\"extension-version-label\">Extension</dt><dd id=\"extension-version\">Unknown</dd></div>\n      <div><dt>Native Host</dt><dd id=\"native-version\">Checking...</dd></div>\n    </dl>\n  </section>\n  <label class=\"launcher-setting\" for=\"launcher-toggle\">\n    <span class=\"launcher-copy\">\n      <strong id=\"launcher-label\">Show Codex side button</strong>\n      <small id=\"launcher-description\">When the panel is closed</small>\n    </span>\n    <input id=\"launcher-toggle\" class=\"launcher-toggle\" type=\"checkbox\" aria-describedby=\"launcher-description\" disabled>\n  </label>\n  <p id=\"status\" class=\"popup-note\" role=\"status\" aria-live=\"polite\" hidden></p>\n  <section id=\"native-install\" class=\"install\" aria-labelledby=\"native-install-title\" hidden>\n    <strong id=\"native-install-title\">Native host attention required</strong>\n    <p id=\"native-status-message\"></p>\n    <code id=\"install-command\"></code>\n    <button id=\"copy-install-command\" class=\"copy-command\" type=\"button\">Copy install command</button>\n    <p id=\"copy-feedback\" class=\"copy-feedback\" role=\"status\" hidden></p>\n  </section>\n</main>";
+      for (const element of Array.from(document.body.children)) {
+        if (element.tagName !== 'SCRIPT') element.remove();
+      }
+      document.body.prepend(shell.firstElementChild);
+    }
+    document.getElementById('brand-icon').src = chrome.runtime.getURL('assets/icons/icon128.png');
+    let stylesheet = document.getElementById('popup-styles');
+    if (!stylesheet) {
+      stylesheet = document.createElement('link');
+      stylesheet.id = 'popup-styles';
+      stylesheet.rel = 'stylesheet';
+      document.head.append(stylesheet);
+    }
+    stylesheet.href = new URL('../styles/popup.css', popupScriptUrl).href;
+  }
+
   async function initPopupState() {
-    await checkNativeHost();
-    await refreshPanelButtonState();
+    try {
+      const stored = await chrome.storage.local.get(['codexOverleafGlobalPrefsV1', 'codexOverleafPrefs']);
+      applyPopupPreferences(stored.codexOverleafGlobalPrefsV1?.values || stored.codexOverleafPrefs || {});
+    } catch (_error) { applyPopupPreferences({}); }
+    chrome.storage.onChanged?.addListener((changes, area) => {
+      if (area === 'local' && changes.codexOverleafGlobalPrefsV1?.newValue?.values) {
+        applyPopupPreferences(changes.codexOverleafGlobalPrefsV1.newValue.values);
+      }
+    });
+    await Promise.all([checkNativeHost(), refreshPanelButtonState(), offerNewSites()]);
   }
 
-  async function refreshPanelButtonState() {
-    const tab = await getActiveOverleafProjectTab();
-    activeOverleafTab = tab;
-    if (!tab?.id) {
-      button.textContent = 'Show Codex button in Overleaf';
-      return;
+  // A runtime update can list an Overleaf site the install did not grant.
+  // Chrome only grants it from a click here; nothing changes until then.
+  async function offerNewSites() {
+    if (!chrome.permissions?.contains || !chrome.permissions?.request) return;
+    let matches = [];
+    try {
+      const url = new URL('../runtime-manifest.json', popupScriptUrl).href;
+      matches = (await (await fetch(url, { cache: 'no-store' })).json()).matches || [];
+    } catch (_error) { return; }
+    const missing = [];
+    for (const value of matches) {
+      if (!/^https:\/\/(?:[a-z0-9-]+\.)*overleaf\.com\/project(?:\/\*)?$/.test(value)) continue;
+      if (!(await chrome.permissions.contains({ origins: [value] }).catch(() => true))) missing.push(value);
     }
+    if (!missing.length) return;
+    const hosts = [...new Set(missing.map(value => new URL(value.replace(/\*$/, '')).host))];
+    const section = document.createElement('section');
+    section.className = 'install';
+    section.dataset.newSites = '';
+    const title = document.createElement('strong');
+    title.textContent = utx('This version supports another Overleaf site', '这一版支持新的 Overleaf 站点');
+    const detail = document.createElement('p');
+    detail.textContent = utx(`Allow access to ${hosts.join(', ')} to use Codex there. Chrome will ask you to confirm.`,
+      `允许访问 ${hosts.join('、')} 后即可在那里使用 Codex，Chrome 会请你确认。`);
+    const button = document.createElement('button');
+    button.type = 'button';
+    button.className = 'copy-command';
+    button.textContent = utx('Allow', '允许');
+    button.addEventListener('click', async () => {
+      const granted = await chrome.permissions.request({ origins: missing }).catch(() => false);
+      if (granted) section.remove();
+    });
+    newSiteCopyNodes = [title, detail, button];
+    section.append(title, detail, button);
+    document.getElementById('popup-shell')?.append(section);
+  }
+
+  function applyPopupPreferences(preferences) {
+    document.documentElement.lang = preferences.locale === 'zh' ? 'zh-CN' : 'en';
+    document.documentElement.dataset.popupTheme = ['light', 'dark', 'auto'].includes(preferences.theme)
+      ? preferences.theme : 'dark';
+    document.getElementById('launcher-label').textContent = utx('Show Codex side button', '显示 Codex 侧边入口');
+    document.getElementById('launcher-description').textContent = utx('When the panel is closed', '面板关闭时显示');
+    document.getElementById('extension-version-label').textContent = utx('Extension', '扩展');
+    document.getElementById('native-install-title').textContent = utx('Local connection needs attention', '本地连接需要处理');
+    connectionDetails.setAttribute('aria-label', utx('Version details', '版本信息'));
+    connectionToggle.title = utx('Show or hide version details', '展开或收起版本信息');
+    copyInstallCommand.textContent = utx('Copy install command', '复制安装命令');
+    [status, copyFeedback, ...newSiteCopyNodes].forEach(refreshPopupCopy);
+    if (lastCompatibility) {
+      setVersionStatus(lastCompatibility);
+      if (!nativeInstall.hidden) showNativeInstallGuide(lastCompatibility);
+    }
+  }
+
+  function setLauncherStatus(message, failed = false) {
+    status.textContent = message;
+    status.hidden = !message;
+    status.setAttribute('role', failed ? 'alert' : 'status');
+  }
 
+  async function refreshPanelButtonState() {
+    launcherReady = false;
+    launcherToggle.disabled = true;
     try {
+      const tab = await getActiveOverleafProjectTab();
+      activeOverleafTab = tab;
+      if (!tab?.id) {
+        setLauncherStatus(utx('Open an Overleaf project to change this preference.', '打开 Overleaf 项目页后可设置侧边入口。'));
+        return;
+      }
       const response = await chrome.tabs.sendMessage(tab.id, { type: 'codex-overleaf/get-panel-state' });
-      const visible = response?.launcherVisible !== false;
-      button.textContent = visible ? 'Hide Codex edge button' : 'Show Codex edge button';
-      status.textContent = visible
-        ? 'The edge button appears whenever the Codex panel is closed.'
-        : 'The Codex edge button is hidden in Overleaf.';
+      if (typeof response?.launcherVisible !== 'boolean') throw new Error('Panel state unavailable');
+      launcherVisible = response.launcherVisible;
+      launcherReady = true;
+      launcherToggle.checked = launcherVisible;
+      launcherToggle.disabled = false;
+      setLauncherStatus('');
     } catch (_error) {
-      button.textContent = 'Show Codex button in Overleaf';
-      status.textContent = 'Refresh the Overleaf tab, then show the Codex button.';
+      setLauncherStatus(utx('Refresh the Overleaf tab, then reopen this popup.', '请刷新 Overleaf 页面，再打开此弹窗。'));
     }
   }
 
@@ -79,10 +222,11 @@
   }
 
   function isOverleafProjectUrl(url) {
-    return /^https:\/\/(www\.)?overleaf\.com\/project\//.test(String(url || ''));
+    return /^https:\/\/(?:(?:www|cn)\.)?overleaf\.com\/project\//.test(String(url || ''));
   }
 
   async function checkNativeHost() {
+    await readInstallIdentity();
     try {
       const response = await chrome.runtime.sendMessage({
         type: 'codex-overleaf/native-request',
@@ -96,16 +240,13 @@
       setVersionStatus(compatibility);
       if (getCompatibilityClassification(compatibility) === 'compatible') {
         nativeInstall.hidden = true;
-        status.textContent = 'Native host connected. Open an Overleaf project tab to use Codex.';
         return;
       }
       showNativeInstallGuide(compatibility);
     } catch (_error) {
       const compatibility = {
-        status: 'native_missing',
-        classification: 'incompatible',
-        installCommand: DEFAULT_INSTALL_COMMAND,
-        updateCommand: DEFAULT_INSTALL_COMMAND,
+        status: 'native_missing', classification: 'incompatible',
+        installCommand: DEFAULT_INSTALL_COMMAND, updateCommand: DEFAULT_INSTALL_COMMAND,
         extensionVersion: getExtensionCompatibilityMetadata().version
       };
       setVersionStatus(compatibility);
@@ -113,11 +254,29 @@
     }
   }
 
+  async function readInstallIdentity() {
+    if (!isManagedInstall) return;
+    try {
+      const response = await fetch(chrome.runtime.getURL('.codex-overleaf-managed-extension.json'));
+      const marker = response.ok ? await response.json() : null;
+      if (marker?.managedBy === 'codex-overleaf-link' && marker.kind === 'extension'
+        && marker.installIdentity?.extensionId === getCurrentExtensionId()) {
+        installIdentity = { ...marker.installIdentity, managed: true };
+      }
+    } catch (_) { /* Older markers cannot prove the original root or browser. */ }
+  }
+
   function showNativeInstallGuide(compatibility = {}) {
     nativeInstall.hidden = false;
     currentInstallCommand = getCompatibilityUpdateCommand(compatibility);
     installCommand.textContent = currentInstallCommand;
-    status.textContent = getNativeStatusMessage(compatibility.status, getCompatibilityClassification(compatibility));
+    copyInstallCommand.disabled = !currentInstallCommand;
+    nativeStatusMessage.textContent = !currentInstallCommand && isManagedInstall
+      ? utx('Repair this Managed installation using its original managed root, browser and extension ID. Rerun the original install-managed command with those parameters.',
+        '修复此托管安装需要原管理根目录、浏览器和扩展 ID。请使用这些原参数重新运行 install-managed 安装命令。')
+      : getNativeStatusMessage(compatibility.status, getCompatibilityClassification(compatibility))
+        + ((compatibility.native?.platform || installIdentity.platform) === 'win32' && isManagedInstall
+          ? utx(' Run the command in PowerShell.', ' 请在 PowerShell 中运行该命令。') : '');
   }
 
   function evaluateNativeCompatibility(response) {
@@ -146,17 +305,25 @@
   }
 
   function setVersionStatus(compatibility = {}) {
-    const classification = getCompatibilityClassification(compatibility);
+    lastCompatibility = compatibility;
+    const pending = compatibility.status === 'checking';
+    const classification = pending ? 'pending' : getCompatibilityClassification(compatibility);
     const extensionVersion = compatibility.extensionVersion || getExtensionCompatibilityMetadata().version;
     const nativeVersion = compatibility.currentNativeVersion || compatibility.nativeVersion || compatibility.native?.version;
-    versionPair.textContent = `Extension ${formatVersion(extensionVersion)} / Native ${formatVersion(nativeVersion)}`;
-    compatStatusIcon.textContent = getStatusIconText(classification);
-    compatStatusIcon.className = `status-icon ${classification}`;
-    compatStatusIcon.title = getCompatibilityStatusTitle(classification);
-    if (compatStatusIcon.dataset) {
-      compatStatusIcon.dataset.status = classification;
-    }
-    compatStatusIcon.setAttribute?.('aria-label', compatStatusIcon.title);
+    extensionVersionLabel.textContent = formatVersion(extensionVersion);
+    nativeVersionLabel.textContent = pending ? utx('Checking...', '正在检查...') : formatVersion(nativeVersion);
+    let label = utx('Update required', '需要更新');
+    if (pending) label = utx('Checking connection...', '正在检查连接...');
+    else if (classification === 'compatible') label = utx('Connected', '已连接');
+    else if (classification === 'update-available') label = utx('Update available', '有可用更新');
+    else if (compatibility.status === 'native_missing') label = utx('Not connected', '未连接');
+    else if (compatibility.status === 'native_unhealthy') label = utx('Needs attention', '需要处理');
+    connectionLabel.textContent = label;
+    connectionToggle.setAttribute('aria-label', label + '. ' + utx('Version details', '版本信息'));
+    compatStatusIcon.textContent = '';
+    compatStatusIcon.className = 'status-icon ' + classification;
+    compatStatusIcon.title = label;
+    compatStatusIcon.dataset.status = classification;
   }
 
   function getExtensionCompatibilityMetadata() {
@@ -164,7 +331,8 @@
       version: CodexOverleafCompatibility?.BUILD_TARGET_VERSION ||
         chrome.runtime.getManifest?.().version ||
         '',
-      extensionId: getCurrentExtensionId()
+      extensionId: getCurrentExtensionId(),
+      ...(isManagedInstall ? { installIdentity } : {})
     };
   }
 
@@ -192,8 +360,9 @@
     return CodexOverleafCompatibility?.buildInstallCommand?.(
       compatibility.recommendedVersion || CodexOverleafCompatibility.BUILD_TARGET_VERSION,
       compatibility.native?.platform || compatibility.platform,
-      getCurrentExtensionId()
-    ) || compatibility.updateCommand || compatibility.installCommand || DEFAULT_INSTALL_COMMAND;
+      getCurrentExtensionId(),
+      installIdentity
+    ) || (isManagedInstall ? '' : compatibility.updateCommand || compatibility.installCommand || DEFAULT_INSTALL_COMMAND);
   }
 
   function getStatusIconText(classification) {
@@ -221,28 +390,33 @@
   function formatVersion(version) {
     const value = String(version || '').trim();
     if (!value) {
-      return 'unknown';
+      return utx('Unknown', '未知');
     }
     return value.startsWith('v') ? value : `v${value}`;
   }
 
   function getNativeStatusMessage(statusValue, classification) {
     if (classification === 'update-available') {
-      return 'Native host update available. Run the update command, then reload the extension.';
+      return utx('An update is available for the local bridge. Run the command below, then reload the extension.',
+        '本地桥接程序有可用更新。运行下方命令后重新加载扩展。');
     }
     switch (statusValue) {
       case 'native_too_old':
-        return 'Native host update required. Run the install command, then reload the extension.';
+        return utx('Update the local bridge with the command below, then reload the extension.',
+          '运行下方命令更新本地桥接程序，然后重新加载扩展。');
       case 'protocol_unsupported':
-        return 'Native host protocol mismatch. Update the native host and extension together.';
+        return utx('The extension and local bridge use different protocols. Update both components together.',
+          '扩展与本地桥接程序的协议不匹配，请一并更新。');
       case 'extension_too_old':
-        return 'Extension update required. Update the Chrome extension before running Codex.';
+        return utx('Update the Chrome extension before running Codex.', '运行 Codex 前需要更新 Chrome 扩展。');
       case 'native_unhealthy':
-        return 'Native host connected, but local Codex is not ready. Check the panel diagnostics.';
+        return utx('The local bridge is connected, but Codex needs attention. Check diagnostics in the side panel.',
+          '本地桥接已连接，Codex 状态需要处理。请查看侧边栏中的诊断。');
       case 'native_missing':
-        return 'Install the local native host before running Codex.';
+        return utx('Run this command in Terminal, then reload the extension.', '在终端运行下方命令，然后重新加载扩展。');
       default:
-        return 'Native host is not compatible. Update the native host, then reload the extension.';
+        return utx('Update the local bridge with the command below, then reload the extension.',
+          '运行下方命令更新本地桥接程序，然后重新加载扩展。');
     }
   }
 
@@ -414,7 +588,7 @@ async function sendConsentAction(action) {
       const summary = document.createElement('summary');
       summary.textContent = utx('Technical details', '技术详情');
       const code = document.createElement('code');
-      code.textContent = [state.code, state.message].filter(Boolean).join(': ');
+      code.textContent = [state.code, formatUpdateFailure(state)].filter(Boolean).join(': ');
       details.append(summary, code);
       card.append(details);
     }
@@ -524,12 +698,26 @@ async function sendConsentAction(action) {
       awaiting_health: [utx('Checking updated components', '正在检查更新后的组件'), latest, utx('Restarting and checking both components', '正在重启并检查两个组件')],
       committed: [utx('Update complete', '更新完成'), latest || current, utx('Extension and Native Host are healthy.', '扩展与 Native Host 均运行正常。')],
       rolled_back: [utx('Previous version restored', '已恢复上一版本'), current, utx('Health check failed, so the previous coordinated pair was restored.', '健康检查失败，已恢复上一组协调版本。')],
-      failed: [utx('Update could not continue', '更新无法继续'), latest, state.message || utx('Check the details and retry.', '请查看详情后重试。')]
+      failed: [utx('Update could not continue', '更新无法继续'), latest, formatUpdateFailure(state) || utx('Check the details and retry.', '请查看详情后重试。')]
     };
     const value = map[state.state] || map.idle;
     return { title: value[0], version: value[1], detail: value[2], phase: value[2] };
   }
 
+  function formatUpdateFailure(state = {}) {
+    const code = String(state.code || '');
+    if (code === 'update_recovery_pending') return utx('The update result is being checked. Recovery has not been confirmed.', '正在确认更新结果，恢复状态尚未确认。');
+    if (['update_bootstrap_health_timeout', 'update_bootstrap_reload_failed'].includes(code)) return utx('The updated startup components did not finish restarting and confirming. Check recovery before retrying.', '更新后的启动组件未能完成重启和确认，请先检查恢复状态。');
+    if (['update_bootstrap_source_mismatch', 'update_bootstrap_source_version_mismatch'].includes(code)) return utx('The installed startup files do not match a supported update source. Check recovery before retrying.', '已安装的启动文件与支持的升级来源不一致，请先检查恢复状态。');
+    if (['update_bootstrap_record_missing', 'update_bootstrap_record_invalid', 'update_bootstrap_backup_mismatch', 'update_bootstrap_already_restoring'].includes(code)) return utx('The startup recovery material could not be confirmed. The update result remains unconfirmed.', '尚未确认启动组件的恢复材料有效，更新结果仍待确认。');
+    if (['update_bootstrap_confirmation_pending', 'update_bootstrap_native_restart_required'].includes(code)) return utx('Waiting for the updated startup components and Native Host to finish restarting and confirming.', '正在等待更新后的启动组件和本机服务完成重启及确认。');
+    if (code === 'update_bootstrap_monitor_unavailable') return utx('The update recovery monitor could not start. Check recovery before retrying.', '更新恢复监护程序未能启动，请先检查恢复状态。');
+    if (['update_bootstrap_transaction_mismatch', 'update_bootstrap_transaction_invalid'].includes(code)) return utx('The startup update transaction could not be matched. Check recovery before retrying.', '未能匹配启动组件的更新事务，请先检查恢复状态。');
+    if (code.startsWith('update_bootstrap_')) return utx('The startup update package or installed files could not be verified. Check recovery before retrying.', '无法验证启动组件更新包或已安装文件，请先检查恢复状态。');
+    if (['update_health_failed', 'update_request_failed', 'update_failed'].includes(code)) return utx('The updated components could not be confirmed. Check recovery before retrying.', '尚未确认更新后的组件正常，请先检查恢复状态。');
+    return state.message || '';
+  }
+
   function formatBlocker(blocker) {
     const labels = {
       unsaved: utx('Overleaf has not confirmed that this document is saved.', 'Overleaf 尚未确认当前文档已保存。'),
@@ -544,7 +732,15 @@ async function sendConsentAction(action) {
     return labels[blocker] || utx('Waiting until every Overleaf tab is saved and idle.', '正在等待所有 Overleaf 标签页完成保存并进入空闲状态。');
   }
 
+  function refreshPopupCopy(element) {
+    const pair = popupCopyPairs.get(element?.textContent);
+    if (pair) element.textContent = utx(...pair);
+  }
+
   function utx(english, chinese) {
+    const pair = [english, chinese];
+    popupCopyPairs.set(english, pair);
+    popupCopyPairs.set(chinese, pair);
     const locale = document.documentElement?.lang || 'en';
     return /^zh\b/i.test(locale) ? chinese : english;
   }

package/extension/src/shared/agentTranscript.js

@@ -63,6 +63,14 @@
     const locale = normalizeLocale(options);
     const type = String(event.type || '');
 
+    if (type === 'codex.local_skills.missing' || type === 'codex.local_skill_invocation.ignored') {
+      return { kind: 'activity', visible: true,
+        title: type === 'codex.local_skills.missing'
+          ? textFor(locale, '所选的本地技能未能加载。', 'A selected local skill could not be loaded.')
+          : textFor(locale, '所选的本地技能已关闭或不可用。', 'A selected local skill is disabled or unavailable.'),
+        status: event.status || 'failed', technicalDetail: normalizeRawEvent(event) };
+    }
+
     if (isContextCompactionEvent(event)) {
       return formatContextCompactionCheckpoint(event, locale);
     }
@@ -372,6 +380,7 @@
         status: 'running',
         streamKey: getCodexStreamKey(method, params),
         streamRole: method === 'item/agentMessage/delta' ? 'assistant' : 'reasoning',
+        streamPhase: params.phase || '',
         appendText: true
       };
     }
@@ -412,12 +421,13 @@
       };
     }
     if (method === 'warning' || method === 'guardianWarning' || method === 'configWarning') {
-      const title = cleanVisibleText(params.message || params.warning || '');
+      const title = cleanVisibleText(params.message || params.warning || params.summary || '');
+      if (!title) return technicalOnly(event, locale);
       return {
         kind: 'activity',
         visible: true,
-        title: title || textFor(locale, 'Codex 返回了一条运行提示。', 'Codex returned a runtime notice.'),
-        status: 'running',
+        title,
+        status: event.status === 'failed' ? 'failed' : method === 'guardianWarning' ? 'warning' : 'info',
         technicalDetail: normalizeRawEvent(event)
       };
     }
@@ -459,6 +469,7 @@
           status,
           streamKey: getItemStreamKey('agent', item),
           streamRole: 'assistant',
+          streamPhase: item.phase || '',
           replaceText: true
         };
       }
@@ -500,6 +511,10 @@
         status,
         detail: {
           command: item.command,
+          itemId: item.id,
+          threadId: event.detail?.params?.threadId,
+          turnId: event.detail?.params?.turnId,
+          commandActions: item.commandActions,
           output: item.aggregatedOutput,
           exitCode: item.exitCode
         }
@@ -723,6 +738,21 @@
     // failure data alongside the human-readable text. The string text is kept
     // verbatim because it has mode-aware nuance (e.g. "No files were written"
     // vs "This run did not start") the catalog's fallback strings don't capture.
+    if (context.code === 'codex_local_skill_unavailable' || /(?:The )?selected local Codex skill is unavailable/i.test(text)) {
+      return {
+        conclusion: textFor(locale, '所选 Codex 本地技能不可用或已关闭，本轮没有启动。', 'The selected local Codex skill is unavailable or disabled. This run did not start.'),
+        nextStep: textFor(locale, '请打开技能页，选择可用且已启用的技能后重新提交。', 'Open Skills, select an available enabled skill, and submit again.'),
+        failureCode: 'codex_local_skill_unavailable'
+      };
+    }
+    if (/^codex_local_skills_/.test(String(context.code || ''))
+      || /local Codex skill discovery|Codex could not (?:list local skills|start local skill discovery)|Codex returned an invalid local skill catalog/i.test(text)) {
+      return {
+        conclusion: textFor(locale, 'Codex 本地技能未能加载，本轮没有启动。', 'Local Codex skills could not be loaded. This run did not start.'),
+        nextStep: textFor(locale, '请打开技能页重新加载本地目录，然后重新提交。', 'Open Skills to reload the local catalog, then submit again.'),
+        failureCode: 'codex_local_skills_failed'
+      };
+    }
     const providerError = translateProviderError(text, locale);
     if (providerError) {
       return providerError;
@@ -863,6 +893,11 @@
         : textFor(locale, '本轮没有可撤销的写入', 'this run has no reversible writes');
     }
 
+    if (input.saveVerification && input.saveVerification.state !== 'not_checked') {
+      report.saveState = input.saveVerification.state === 'verified_saved'
+        ? textFor(locale, '已确认保存', 'Saved')
+        : textFor(locale, '待确认，可检查保存状态', 'Pending confirmation; check save status');
+    }
     const failed = input.status === 'failed' || input.status === 'blocked';
     return {
       title: textFor(locale, '本轮完成报告', 'Task report'),
@@ -946,6 +981,7 @@
       });
     }
 
+    if (report.saveState) meta.push({ key: 'saveState', label: textFor(locale, '保存', 'Save'), value: report.saveState });
     return { conclusion, body: bodySections.join('\n\n'), meta };
   }
 
@@ -976,6 +1012,7 @@
     if (nextStep) {
       sections.push(textFor(locale, `下一步：${nextStep}`, `Next: ${nextStep}`));
     }
+    if (report.saveState) sections.push(textFor(locale, `保存：${report.saveState}`, `Save: ${report.saveState}`));
     return sections.join('\n\n');
   }
 
@@ -1045,7 +1082,7 @@
     if (input.mode === 'ask' || input.status === '只问不改') {
       return textFor(locale, '这轮是只问不改。', 'This run was Ask mode.');
     }
-    if (input.status === 'rejected') {
+    if (input.status === 'cancelled' || input.status === 'rejected') {
       return textFor(locale, '你取消了这轮修改。', 'You cancelled this change.');
     }
     return '';