codex-overleaf-link 2.5.0 → 2.5.1

package/extension/src/popup.js

@@ -1,10 +1,17 @@
 (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()
@@ -71,6 +78,7 @@
   });
 
   copyInstallCommand.addEventListener('click', async () => {
+    if (!currentInstallCommand) return;
     copyInstallCommand.disabled = true;
     copyFeedback.hidden = true;
     try {
@@ -81,7 +89,7 @@
       copyFeedback.textContent = utx('Copy failed. Select the command above to copy it.', '复制失败，可选中上方命令复制。');
       copyFeedback.hidden = false;
     } finally {
-      copyInstallCommand.disabled = false;
+      copyInstallCommand.disabled = !currentInstallCommand;
     }
   });
 
@@ -157,6 +165,7 @@
       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);
   }
@@ -172,10 +181,10 @@
     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) nativeStatusMessage.textContent = getNativeStatusMessage(
-        lastCompatibility.status, getCompatibilityClassification(lastCompatibility));
+      if (!nativeInstall.hidden) showNativeInstallGuide(lastCompatibility);
     }
   }
 
@@ -217,6 +226,7 @@
   }
 
   async function checkNativeHost() {
+    await readInstallIdentity();
     try {
       const response = await chrome.runtime.sendMessage({
         type: 'codex-overleaf/native-request',
@@ -244,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;
-    nativeStatusMessage.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) {
@@ -303,7 +331,8 @@
       version: CodexOverleafCompatibility?.BUILD_TARGET_VERSION ||
         chrome.runtime.getManifest?.().version ||
         '',
-      extensionId: getCurrentExtensionId()
+      extensionId: getCurrentExtensionId(),
+      ...(isManagedInstall ? { installIdentity } : {})
     };
   }
 
@@ -331,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) {
@@ -558,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);
     }
@@ -668,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 尚未确认当前文档已保存。'),
@@ -688,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);
     }
@@ -730,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;

package/extension/src/shared/auditRecords.js

@@ -25,6 +25,7 @@
     const now = new Date().toISOString();
     return {
       id: input.id || generateId('aud'),
+      accountScopeId: redactSecretLikeText(stringField(input.accountScopeId)),
       projectId: redactSecretLikeText(stringField(input.projectId)),
       sessionId: redactSecretLikeText(stringField(input.sessionId)),
       turnId: redactSecretLikeText(stringField(input.turnId)),
@@ -84,6 +85,7 @@
   function normalizeAuditLogRecord(input = {}) {
     return {
       id: redactSecretLikeText(stringField(input.id)) || generateId('aud'),
+      accountScopeId: redactSecretLikeText(stringField(input.accountScopeId)),
       projectId: redactSecretLikeText(stringField(input.projectId)),
       sessionId: redactSecretLikeText(stringField(input.sessionId)),
       turnId: redactSecretLikeText(stringField(input.turnId)),

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.5.0';
+  const BUILD_TARGET_VERSION = '2.5.1';
   const DEFAULT_CHROME_EXTENSION_ID = 'illdpneeeopfffmiepaejglgmhpmdhdc';
   const REQUIRED_CAPABILITIES = Object.freeze([
     'bridgePing',
@@ -25,6 +25,7 @@
     'codexModels',
     'historyClearPlugin',
     'localSkills',
+    'localCodexSkills',
     'mirrorSensitiveScan',
     'providerProfiles',
     'assetTransfer',
@@ -64,6 +65,8 @@
   }
 
   function evaluateNativeCompatibility(response, metadata = {}) {
+    if (response?.extensionInstallIdentity) metadata = { ...metadata,
+      installIdentity: { ...(metadata.installIdentity || {}), ...response.extensionInstallIdentity } };
     const native = unwrapNativeResponse(response);
     if (!native) {
       return compatibilityResult('native_missing', response, metadata, 'incompatible');
@@ -86,13 +89,25 @@
     return analyzeNativeCompatibility(native, metadata).classification;
   }
 
-  function buildInstallCommand(version = BUILD_TARGET_VERSION, platform, extensionId) {
+  function buildInstallCommand(version = BUILD_TARGET_VERSION, platform, extensionId, options = {}) {
     const normalized = normalizeReleaseVersion(version) || BUILD_TARGET_VERSION;
     const allowedExtensionId = normalizeInstallExtensionId(extensionId);
     const extensionIdArg = allowedExtensionId && allowedExtensionId !== DEFAULT_CHROME_EXTENSION_ID
-      ? ` --extension-id ${allowedExtensionId}`
-      : '';
-
+      ? ` --extension-id ${allowedExtensionId}` : '';
+    if (options.managed === true) {
+      if (!allowedExtensionId || options.extensionId !== allowedExtensionId) return '';
+      const managedRoot = options.managedRoot;
+      const browser = options.browser === 'auto' ? 'chrome' : options.browser;
+      if (!['chrome', 'chromium'].includes(browser) || typeof managedRoot !== 'string'
+        || !managedRoot || managedRoot.length > 4096 || managedRoot.trim() !== managedRoot
+        || /[\u0000-\u001f\u007f]/.test(managedRoot)
+        || !(/^(?:\/|[a-zA-Z]:[\\/]|\\\\)/.test(managedRoot))) return '';
+      // Windows setup commands are shown for PowerShell; POSIX uses sh quoting.
+      const quotedRoot = platform === 'win32' || options.platform === 'win32'
+        ? "'" + managedRoot.replace(/'/g, "''") + "'"
+        : "'" + managedRoot.replace(/'/g, "'\\''") + "'";
+      return `npm exec --yes codex-overleaf-link@${normalized} -- install-managed --browser ${browser} --managed-root ${quotedRoot}${extensionIdArg}`;
+    }
     return `npm exec --yes codex-overleaf-link@${normalized} -- install-native${extensionIdArg}`;
   }
 
@@ -126,7 +141,7 @@
     const extensionVersion = resolveMetadataVersion(metadata);
     const nativeVersion = native && typeof native === 'object' ? native.version : undefined;
     const platform = native && typeof native === 'object' ? native.platform : undefined;
-    const updateCommand = buildInstallCommand(BUILD_TARGET_VERSION, platform, metadata.extensionId);
+    const updateCommand = buildInstallCommand(BUILD_TARGET_VERSION, platform, metadata.extensionId, metadata.installIdentity);
     const updateAvailable = isOlderReleaseVersion(nativeVersion, BUILD_TARGET_VERSION);
     return {
       status,
@@ -139,6 +154,7 @@
       requiredVersion: MIN_COMPATIBLE_NATIVE_VERSION,
       recommendedVersion: BUILD_TARGET_VERSION,
       updateAvailable,
+      ...(metadata.installIdentity ? { installIdentity: metadata.installIdentity } : {}),
       installCommand: updateCommand,
       updateCommand,
       releaseUrl: buildReleaseUrl(BUILD_TARGET_VERSION),

package/extension/src/shared/compileAdapter.js

@@ -9,32 +9,18 @@
 
   const MAX_LOG_BYTES = 32 * 1024;
   const COMPILABLE_EXTENSIONS = new Set(['.tex', '.bib', '.sty', '.cls', '.bst', '.bbx', '.cbx']);
-
   function parseCompileResponse(response) {
-    if (!response || typeof response !== 'object') {
-      return { ok: false, reason: 'Invalid compile response: not an object' };
-    }
-
-    if (!Array.isArray(response.outputFiles)) {
-      return { ok: false, reason: 'Invalid compile response: outputFiles is not an array' };
-    }
-
+    if (!response || typeof response !== 'object') return { ok: false, reason: 'Invalid compile response: not an object' };
+    if (!Array.isArray(response.outputFiles)) return { ok: false, reason: 'Invalid compile response: outputFiles is not an array' };
     const logFile = response.outputFiles.find(function (file) {
       if (!file) return false;
       if (file.type === 'log') return true;
       if (typeof file.path === 'string' && file.path.endsWith('.log')) return true;
       return false;
     });
-
-    if (!logFile) {
-      return { ok: false, reason: 'No log file found in compile output' };
-    }
-
+    if (!logFile) return { ok: false, reason: 'No log file found in compile output' };
     var logUrl = logFile.url || null;
-    if (!logUrl) {
-      return { ok: false, reason: 'Log file has no URL' };
-    }
-
+    if (!logUrl) return { ok: false, reason: 'Log file has no URL' };
     return {
       ok: true,
       status: response.status,
@@ -82,13 +68,9 @@
   }
 
   function truncateLogForContext(log) {
-    if (!log || typeof log !== 'string') {
-      return '';
-    }
+    if (!log || typeof log !== 'string') return '';
 
-    if (new Blob([log]).size <= MAX_LOG_BYTES) {
-      return log;
-    }
+    if (new Blob([log]).size <= MAX_LOG_BYTES) return log;
 
     var lines = log.split('\n');
     var errorBlocks = extractErrorBlocks(lines);
@@ -108,26 +90,17 @@
   }
 
   function isCompileLogFresh(log, lastKnownSourceEditTimestamp) {
-    if (!log || typeof log !== 'object') {
-      return false;
-    }
-
-    if (log.sourceChangeTimestamp == null) {
-      return false;
-    }
+    if (!log || typeof log !== 'object') return false;
+    if (log.sourceChangeTimestamp == null) return false;
 
     return log.sourceChangeTimestamp >= lastKnownSourceEditTimestamp;
   }
 
   function isCompilableFile(filePath) {
-    if (!filePath || typeof filePath !== 'string') {
-      return false;
-    }
+    if (!filePath || typeof filePath !== 'string') return false;
 
     var lastDot = filePath.lastIndexOf('.');
-    if (lastDot === -1) {
-      return false;
-    }
+    if (lastDot === -1) return false;
 
     var ext = filePath.slice(lastDot).toLowerCase();
     return COMPILABLE_EXTENSIONS.has(ext);
@@ -171,27 +144,11 @@
     const warnings = logAvailable && Array.isArray(logResult.warnings)
       ? logResult.warnings.slice(0, 5).map(formatCompileDiagnosticForSummary)
       : [];
-    if (error) {
-      return {
-        status: 'failed',
-        reason: error?.message || 'Post-write compile failed.',
-        errors,
-        warnings,
-        logAvailable
-      };
-    }
-    if (!result?.ok) {
-      return {
-        status: 'failed',
-        reason: result?.reason || 'Post-write compile did not succeed.',
-        errors,
-        warnings,
-        logAvailable
-      };
-    }
+    const failed = Boolean(error) || !result?.ok;
     return {
-      status: result.compile?.status || 'triggered',
-      reason: result.reason || '',
+      status: failed ? 'failed' : result.compile?.status || 'triggered',
+      reason: error ? error?.message || 'Post-write compile failed.'
+        : !result?.ok ? result?.reason || 'Post-write compile did not succeed.' : result.reason || '',
       errors,
       warnings,
       logAvailable
@@ -203,9 +160,74 @@
     return text.length > 180 ? `${text.slice(0, 179)}...` : text;
   }
 
+  // Page/adapter-owned explanations and activity labels are display copy. TeX logs and unknown
+  // upstream diagnostics stay literal; callers retain the original evidence.
+  function localizeCompileReason(value, locale = 'en', depth = 0) {
+    const text = String(value || '');
+    const zh = /^zh(?:\b|[-_])/i.test(String(locale));
+    const messages = [
+      ['Compile succeeded.', '编译成功。'],
+      ['Overleaf compile was triggered. The page will continue showing progress.', '已触发 Overleaf 编译；页面会继续显示编译进度。'],
+      ['Fetching compile log (@compile-log).', '正在获取编译日志 (@compile-log)。'],
+      ['Overleaf save state was not verified.', '尚未确认 Overleaf 已保存。'],
+      ['No Overleaf Recompile button or compile request template is available.', '没有可用的 Overleaf 重新编译按钮或编译请求模板。'],
+      ['Stored compile request template expired. Please click Overleaf Recompile once, then retry.', '已保存的编译请求模板已过期。请先点击一次 Overleaf 重新编译，再重试。'],
+      ['CompileAdapter not available', '编译适配器不可用'],
+      ['CompileAdapter not loaded', '编译适配器未加载'],
+      ['Overleaf save-state checker is unavailable.', 'Overleaf 保存状态检查器不可用。'],
+      ['No compile log URL available', '没有可用的编译日志地址'],
+      ['Clicked Overleaf Recompile, but no compile result was captured.', '已点击 Overleaf 重新编译，但未获取到编译结果。'],
+      ['Invalid compile response: not an object', '编译响应无效：结果不是对象'],
+      ['Invalid compile response: outputFiles is not an array', '编译响应无效：outputFiles 不是数组'],
+      ['No log file found in compile output', '编译输出中未找到日志文件'],
+      ['Log file has no URL', '日志文件没有可用地址'],
+      ['Post-write compile failed.', '写后编译失败。'],
+      ['Post-write compile did not succeed.', '写后编译未成功。'],
+      ['Overleaf save state has not been checked yet.', '尚未检查 Overleaf 保存状态。'],
+      ['Overleaf save state is unavailable.', 'Overleaf 保存状态不可用。'],
+      ['Overleaf is offline; saving cannot be confirmed.', 'Overleaf 当前离线，无法确认保存。'],
+      ['Overleaf document is unavailable for save-state detection.', 'Overleaf 文档不可用，无法检测保存状态。'],
+      ['Overleaf save indicator reports changes are not saved.', 'Overleaf 保存指示器显示修改尚未保存。'],
+      ['Overleaf is still saving or syncing changes.', 'Overleaf 仍在保存或同步修改。'],
+      ['Overleaf save indicator was present, but did not verify that all changes are saved.', '已找到 Overleaf 保存指示器，但未能确认全部修改已保存。'],
+      ['Overleaf save indicator was not found.', '未找到 Overleaf 保存指示器。']
+    ];
+    for (const [en, chinese] of messages) {
+      if (text === en || text === chinese) return zh ? chinese : en;
+    }
+    for (const [en, chinese] of [
+      ['Compile request failed with status ', '编译请求失败，状态码为 '],
+      ['Failed to fetch compile log: ', '获取编译日志失败，状态码为 ']
+    ]) {
+      const prefix = text.startsWith(en) ? en : text.startsWith(chinese) ? chinese : '';
+      if (prefix && /^\d{3}$/.test(text.slice(prefix.length))) return (zh ? chinese : en) + text.slice(prefix.length);
+    }
+    if (depth < 4) for (const [en, chinese] of [
+      ['Post-write compile did not succeed: ', '写后编译未成功：'],
+      ['Post-write compile failed: ', '写后编译出错：'],
+      ['Compile log unavailable: ', '编译日志不可用：'],
+      ['Compile request error: ', '编译请求出错：'],
+      ['Overleaf save-state checker failed: ', 'Overleaf 保存状态检查失败：'],
+      ['Could not check Overleaf save state: ', '无法检查 Overleaf 保存状态：'],
+      ['Could not get fresh compile: ', '无法获取最新编译结果：'],
+      ['Log fetch error: ', '获取日志出错：'],
+      ['Timed out waiting for Overleaf to finish saving changes.', '等待 Overleaf 完成保存超时。'],
+      ['Timed out waiting for a verified Overleaf save state.', '等待确认 Overleaf 保存状态超时。']
+    ]) {
+      const prefix = text.startsWith(en) ? en : text.startsWith(chinese) ? chinese : '';
+      if (prefix) {
+        const rest = text.slice(prefix.length);
+        if (prefix === en && en.endsWith('.') && rest && !rest.startsWith(' ')) continue;
+        const suffix = localizeCompileReason(prefix === en && en.endsWith('.') ? rest.slice(1) : rest, locale, depth + 1);
+        return (zh ? chinese : en) + (!zh && suffix && en.endsWith('.') ? ' ' : '') + suffix;
+      }
+    }
+    return text;
+  }
   return {
     buildPostWriteCompileSummary,
     formatCompileDiagnosticForSummary,
+    localizeCompileReason,
     COMPILABLE_EXTENSIONS,
     MAX_LOG_BYTES,
     extractErrorBlocks,

package/extension/src/shared/composerAttachmentDraft.js

@@ -0,0 +1,151 @@
+(function (root, factory) {
+  if (typeof module === 'object' && module.exports) module.exports = factory(require('./sessionState'));
+  else root.CodexOverleafModuleRegistry.define('ComposerAttachmentDraft', ['SessionState'], factory);
+})(typeof globalThis !== 'undefined' ? globalThis : this, function (SessionState) {
+  'use strict';
+  const EPOCH_KEY = 'composer-attachment-draft:clear-epoch';
+  const normalize = value => SessionState.normalizeComposerAttachmentsForPersistence(value);
+  const scopeKey = scope => JSON.stringify([scope?.accountScopeId || '', scope?.projectId || '']);
+  function checkedScope(scope) {
+    const accountScopeId = String(scope?.accountScopeId || '').trim();
+    const projectId = String(scope?.projectId || '').trim();
+    if (!accountScopeId || !projectId) throw failure('account_scope_unavailable');
+    return { accountScopeId, projectId };
+  }
+  function failure(code) {
+    return Object.assign(new Error(code === 'composer_draft_cleared'
+      ? 'Saved attachments were cleared in another tab. Reload, then reattach files before retrying.'
+      : code === 'composer_draft_conflict'
+        ? 'The saved attachment draft changed in another tab. Reload before changing it.'
+        : 'Attachment draft scope is unavailable or changed.'), { code });
+  }
+  function createStore(openDb) {
+    async function access(input, value) {
+      const scope = checkedScope(input);
+      const id = 'composer-attachment-draft:' + scopeKey(scope);
+      const db = await openDb();
+      return new Promise((resolve, reject) => {
+        const tx = db.transaction('artifacts', value ? 'readwrite' : 'readonly');
+        const store = tx.objectStore('artifacts');
+        let result, error;
+        tx.oncomplete = () => resolve(result);
+        tx.onerror = tx.onabort = () => reject(error || tx.error || new Error('Attachment draft transaction failed.'));
+        const epochRequest = store.get(EPOCH_KEY);
+        epochRequest.onsuccess = () => {
+          const epoch = Number(epochRequest.result?.epoch) || 0;
+          const clearedAt = Number(epochRequest.result?.clearedAt) || 0;
+          const request = store.get(id);
+          request.onsuccess = () => {
+            try {
+              const previous = request.result;
+              if (previous && (previous.accountScopeId !== scope.accountScopeId || previous.projectId !== scope.projectId)) {
+                throw failure('account_scope_unavailable');
+              }
+              const revision = Number(previous?.revision) || 0;
+              result = { epoch, clearedAt, revision, attachments: normalize(previous?.attachments) };
+              if (!value) return;
+              const attachments = normalize(value.attachments);
+              if (value.epoch !== epoch) {
+                // A clear performed by this page also invalidates its old base.
+                // Its empty draft needs no write; an old nonempty draft cannot return.
+                if (!attachments.length) return;
+                throw failure('composer_draft_cleared');
+              }
+              if (value.revision !== revision) throw failure('composer_draft_conflict');
+              if (attachments.length && value.unbased && clearedAt && value.changedAt <= clearedAt) {
+                throw failure('composer_draft_cleared');
+              }
+              result = { epoch, clearedAt, revision: revision + 1, attachments };
+              store.put({ id, type: 'composer-attachment-draft', ...scope, ...result });
+            } catch (caught) { error = caught; tx.abort(); }
+          };
+        };
+      });
+    }
+    async function clear(storeNames) {
+      const db = await openDb();
+      return new Promise((resolve, reject) => {
+        const tx = db.transaction(storeNames, 'readwrite');
+        const artifacts = tx.objectStore('artifacts');
+        const request = artifacts.get(EPOCH_KEY);
+        let epoch;
+        request.onsuccess = () => {
+          epoch = (Number(request.result?.epoch) || 0) + 1;
+          for (const name of storeNames) tx.objectStore(name).clear();
+          artifacts.put({ id: EPOCH_KEY, type: 'composer-attachment-draft-epoch', epoch, clearedAt: Date.now() });
+        };
+        tx.oncomplete = () => resolve({ composerDraftEpoch: epoch });
+        tx.onerror = tx.onabort = () => reject(tx.error || new Error('History clear failed.'));
+      });
+    }
+    return { read: scope => access(scope), write: (scope, value) => access(scope, value), clear };
+  }
+
+  function createController(options) {
+    let scope = options.getScope(), key = scopeKey(scope), generation = 0;
+    let base = null, hydrated = false, changedVersion = 0, savedVersion = 0;
+    let dirtySince = 0, dirtyUnbased = false, loadSequence = 0;
+    let saving = Promise.resolve();
+    const publish = () => options.setAttachments(normalize(options.getAttachments()));
+    function syncScope() {
+      const next = options.getScope(), nextKey = scopeKey(next);
+      if (nextKey === key) return;
+      scope = next; key = nextKey; generation++;
+      base = null; hydrated = false; changedVersion = savedVersion = 0; dirtySince = 0; dirtyUnbased = false;
+      options.clear(); publish();
+    }
+    async function load(requestedScope = options.getScope()) {
+      syncScope();
+      if (scopeKey(requestedScope) !== key) throw failure('stale_hydration');
+      const captured = generation, sequence = ++loadSequence;
+      const snapshot = await options.read(checkedScope(scope));
+      if (captured !== generation || sequence !== loadSequence || scopeKey(options.getScope()) !== key) throw failure('stale_hydration');
+      if (base && snapshot.epoch !== base.epoch) {
+        // Adopt an observed history clear together with its empty local view;
+        // otherwise the next edit could attach an old view to the new epoch.
+        options.clear(); changedVersion = savedVersion = 0; dirtySince = 0; dirtyUnbased = false;
+        hydrated = false; base = snapshot; publish();
+      }
+      const keepLocal = changedVersion || hydrated;
+      // A read alone does not give an unchanged visible draft a newer CAS base.
+      if (!base || !keepLocal) base = snapshot;
+      return keepLocal ? normalize(options.getAttachments()) : snapshot.attachments;
+    }
+    function hydrate(attachments) {
+      syncScope();
+      if (hydrated) return;
+      // Loading is allowed to finish after a local add/remove. Local edits win.
+      if (!changedVersion && !options.getAttachments().length) options.restore(normalize(attachments));
+      hydrated = true; publish();
+    }
+    function changed() {
+      const before = key;
+      syncScope();
+      if (before !== key) return;
+      if (changedVersion === savedVersion) { dirtySince = Date.now(); dirtyUnbased = !base; }
+      changedVersion++; hydrated = true; publish(); options.scheduleSave();
+    }
+    function save(requestedScope = options.getScope()) {
+      syncScope();
+      if (scopeKey(requestedScope) !== key) return Promise.resolve();
+      const captured = generation;
+      const work = async () => {
+        if (captured !== generation || scopeKey(options.getScope()) !== key || changedVersion === savedVersion) return;
+        const version = changedVersion;
+        const attachments = normalize(options.getAttachments());
+        const unbased = dirtyUnbased, changedAt = dirtySince;
+        if (!base) await load(scope);
+        if (captured !== generation || scopeKey(options.getScope()) !== key) return;
+        const written = await options.write(checkedScope(scope), { ...base, attachments, unbased, changedAt });
+        if (captured !== generation) return;
+        base = written; savedVersion = version;
+        if (changedVersion === version) { dirtySince = 0; dirtyUnbased = false; }
+      };
+      const next = saving.then(work, work);
+      saving = next.catch(() => {});
+      return next;
+    }
+    return { syncScope, load, hydrate, changed, save };
+  }
+  return { createStore, createController, normalize, EPOCH_KEY };
+});