codex-overleaf-link 2.5.0 → 2.5.1

package/extension/src/content/generated/content.bundle.meta.json

@@ -2,9 +2,9 @@
   "schemaVersion": 1,
   "entry": "extension/entries/content-entry.mjs",
   "output": "extension/src/content/generated/content.bundle.js",
-  "sourceDigest": "a96cd1d3e417ecc9e124f48d9ad6dd728256c084f09a804d809299de8e4a7da3",
-  "outputDigest": "09a6e2a4d4c6be0f8f8ad284c601e6cdf1843be09161f70a225abd56277b9c19",
-  "byteLength": 2838686,
+  "sourceDigest": "548acfc19dd7be907e0c5494f2da2e11fa68dfc501e0552846ad63d4e5a35dba",
+  "outputDigest": "404e0523fc534b56e87ea96e62cd112514c06ce034209ec7a05feef83d7a64a9",
+  "byteLength": 3162346,
   "inputs": [
     "extension/entries/content-entry.mjs",
     "extension/src/content/activeTurnControl.js",
@@ -19,6 +19,7 @@
     "extension/src/content/diagnosticsExport.js",
     "extension/src/content/diagnosticsPanel.js",
     "extension/src/content/diffReviewPanel.js",
+    "extension/src/content/directoryCleanupRecovery.js",
     "extension/src/content/globalPreferencesController.js",
     "extension/src/content/legacyGlobalRegistry.js",
     "extension/src/content/localSkillsPanel.js",
@@ -46,13 +47,16 @@
     "extension/src/content/recentProjects.js",
     "extension/src/content/reviewHunks.js",
     "extension/src/content/runActivitySummary.js",
+    "extension/src/content/runCompletionMeta.js",
     "extension/src/content/runController.js",
     "extension/src/content/runFailureNotice.js",
     "extension/src/content/runGuidanceController.js",
     "extension/src/content/runGuidanceView.js",
     "extension/src/content/runPresence.js",
     "extension/src/content/runQueueScheduler.js",
+    "extension/src/content/runRecoveryActions.js",
     "extension/src/content/runResultActions.js",
+    "extension/src/content/runReviewController.js",
     "extension/src/content/runScrollLayout.js",
     "extension/src/content/runSettlementPersistence.js",
     "extension/src/content/runTimelineView.js",
@@ -60,6 +64,7 @@
     "extension/src/content/scopedPersistenceDetachedCommit.js",
     "extension/src/content/scopedPersistencePanelState.js",
     "extension/src/content/selectionContextView.js",
+    "extension/src/content/sensitivePreflight.js",
     "extension/src/content/sessionForkController.js",
     "extension/src/content/sessionManager.js",
     "extension/src/content/sessionMenuView.js",
@@ -83,6 +88,8 @@
     "extension/src/shared/changeHistoryModel.js",
     "extension/src/shared/compatibility.js",
     "extension/src/shared/compileAdapter.js",
+    "extension/src/shared/composerAttachmentDraft.js",
+    "extension/src/shared/directoryCleanupProof.js",
     "extension/src/shared/failureReasons.js",
     "extension/src/shared/globalPreferences.js",
     "extension/src/shared/governanceRules.js",
@@ -110,6 +117,7 @@
     "extension/src/shared/sessionTitle.js",
     "extension/src/shared/settlementFacts.js",
     "extension/src/shared/sharedSessionBridge.js",
+    "extension/src/shared/sharedSessionTransfer.js",
     "extension/src/shared/staleGuard.js",
     "extension/src/shared/storageDb.js",
     "extension/src/shared/storageKeys.js",

package/extension/src/content/globalPreferencesController.js

@@ -40,7 +40,7 @@
       if (force || changed.includes('theme')) options.applyTheme?.(values.theme);
       if (changed.includes('locale')) options.applyLocale?.();
       if (force || changed.includes('preloadProjectContext')) options.onPreloadChange?.(values.preloadProjectContext);
-      if (changed.some(key => key === 'codexOverleafSkillEnabled' || key.startsWith('loadCodex'))) options.onSkillsChange?.();
+      if (changed.some(key => key === 'codexOverleafSkillEnabled' || key === 'codexLocalSkillEnabled' || key.startsWith('loadCodex'))) options.onSkillsChange?.();
     }
 
     function accept(value) {

package/extension/src/content/legacyGlobalRegistry.js

@@ -20,10 +20,12 @@
     'SelectionContext',
     'SelectionContextView',
     'WritebackIntent',
+    'DirectoryCleanupProof',
     'ChangeHistoryModel',
     'ChangeHistoryView',
     'Compatibility',
     'ComposerAttachments',
+    'ComposerAttachmentDraft',
     'ComposerPanel',
     'ContentRuntime',
     'ContextTray',
@@ -61,6 +63,7 @@
     'RunPresence',
     'RunActivityModel',
     'RunController',
+    'RunReviewController',
     'RunExecutionSnapshot',
     'RunGuidanceController',
     'RunInputQueue',
@@ -73,6 +76,7 @@
     'ScopedPersistenceCoordinator',
     'ScopedPersistenceTransaction',
     'SensitiveScan',
+    'SensitivePreflight',
     'SessionManager',
     'SessionForkController',
     'SessionPanel',
@@ -93,6 +97,7 @@
     'UpdateIdle',
     'UpdateNotice',
     'WritebackController',
+    'DirectoryCleanupRecovery',
     'WritebackIntent',
     'WritebackOrchestrator',
     'WritebackPlan',
@@ -111,6 +116,7 @@
     'ProviderProfiles',
     'ProviderSettingsDialog',
     'RunGuidanceView',
+    'RunRecoveryActions',
     'SessionMenuView'
   ]);
 

package/extension/src/content/localSkillsPanel.js

@@ -17,11 +17,17 @@
     document: documentDep = null,
     getPanel = () => null,
     getState = () => null,
+    getScope = () => '',
     setState = () => {},
     saveState = null,
     sendBackgroundNative = () => Promise.resolve({ ok: false }),
     getSkillLoadingSettings = () => ({ loadCodexOverleafSkills: true }),
     isCodexOverleafSkillEnabled = () => true,
+    isCodexLocalSkillEnabled = (id, skill) => skill?.enabled !== false,
+    setCodexLocalSkillEnabled = () => {},
+    getCodexLocalSkills = () => [],
+    getCodexLocalSkillWarnings = () => [],
+    refreshCodexLocalSkills = async () => [],
     setCodexOverleafSkillEnabled = () => {},
     setProjectSettingsStatus = () => {},
     tr = (key) => key,
@@ -36,27 +42,51 @@
       || root.document
       || (typeof globalThis !== 'undefined' ? globalThis.document : null);
 
+    let localSkillsListError = false;
+    let refreshGeneration = 0;
     async function refreshLocalSkills() {
+      const generation = ++refreshGeneration;
+      const scope = getScope();
+      const isCurrent = () => generation === refreshGeneration && scope === getScope();
+      localSkillsListError = false;
       showSkillListLoading();
+      const localList = getPanel()?.querySelector('[data-codex-local-skill-list]');
+      if (localList) {
+        localList.textContent = '';
+        appendLocalSkillEmpty(localList, 'codexOverleafSkillsLoading');
+      }
+      const localRefresh = localList ? refreshCodexLocalSkills({ force: true }) : Promise.resolve([]);
+      const localOutcome = localRefresh.then(() => {
+        if (isCurrent()) renderCodexLocalSkillList();
+        return null;
+      }, error => {
+        if (isCurrent()) { localSkillsListError = true; renderCodexLocalSkillList(); }
+        return error;
+      });
       try {
         const codexOverleafResponse = await sendBackgroundNative({
           method: 'skills.list',
           params: { scope: 'codex-overleaf' }
         });
         if (!codexOverleafResponse?.ok) {
-          throw new Error(codexOverleafResponse?.error?.message || 'native host did not return Codex Overleaf skills');
+          throw new Error(tx('Could not load Codex Overleaf skills. Try again.', '无法加载 Codex Overleaf 技能，请重试。'));
         }
         const codexOverleafSkills = Array.isArray(codexOverleafResponse.result?.skills)
           ? codexOverleafResponse.result.skills
           : [];
+        if (!isCurrent()) return;
         const state = getState() || {};
         setState({
           ...state,
           codexOverleafSkills
         });
         setSlashCodexOverleafSkills(codexOverleafSkills);
+        const localError = await localOutcome;
+        if (!isCurrent()) return;
         renderLocalSkillList();
+        if (localError) throw localError;
       } catch (err) {
+        if (!isCurrent()) return;
         renderLocalSkillList();
         throw err;
       }
@@ -71,6 +101,7 @@
       const placeholder = document.createElement('div');
       placeholder.className = 'codex-project-settings-empty';
       placeholder.textContent = tr('codexOverleafSkillsLoading');
+      placeholder.dataset.i18n = 'codexOverleafSkillsLoading';
       list.append(placeholder);
     }
 
@@ -84,6 +115,7 @@
     }
 
     function renderLocalSkillList() {
+      renderCodexLocalSkillList();
       const list = getPanel()?.querySelector('[data-local-skill-list]');
       if (!list) {
         return;
@@ -93,10 +125,10 @@
       const codexOverleafEnabled = getSkillLoadingSettings().loadCodexOverleafSkills !== false;
       list.textContent = '';
       if (!codexOverleafEnabled) {
-        appendLocalSkillEmpty(list, tr('codexOverleafSkillsDisabled'));
+        appendLocalSkillEmpty(list, 'codexOverleafSkillsDisabled');
       }
       if (!codexOverleafSkills.length) {
-        appendLocalSkillEmpty(list, tr('codexOverleafSkillsEmpty'));
+        appendLocalSkillEmpty(list, 'codexOverleafSkillsEmpty');
         return;
       }
       for (const skill of codexOverleafSkills) {
@@ -104,6 +136,31 @@
       }
     }
 
+    function renderCodexLocalSkillList() {
+      const list = getPanel()?.querySelector('[data-codex-local-skill-list]');
+      if (!list) return;
+      list.textContent = '';
+      const enabled = getSkillLoadingSettings().loadCodexLocalSkills !== false;
+      if (!enabled) appendLocalSkillEmpty(list, 'codexLocalSkillsDisabled');
+      const skills = getCodexLocalSkills();
+      if (localSkillsListError) { appendLocalSkillEmpty(list, 'codexLocalSkillsLoadFailed'); return; }
+      if (!Array.isArray(skills)) { appendLocalSkillEmpty(list, 'codexOverleafSkillsLoading'); return; }
+      if (!skills.length) appendLocalSkillEmpty(list, 'codexLocalSkillsEmpty');
+      const skippedCount = getCodexLocalSkillWarnings().reduce((sum, warning) => sum + (warning?.code === 'codex_local_skills_skipped' ? warning.count : 0), 0);
+      if (skippedCount > 0) {
+        const warning = document.createElement('div');
+        warning.className = 'codex-project-settings-empty';
+        warning._refreshLocale = () => { warning.textContent = tr('codexLocalSkillsSkipped', { count: skippedCount }); };
+        warning._refreshLocale();
+        list.append(warning);
+      }
+      for (const skill of skills) {
+        const title = String(skill.title || skill.name || skill.id).trim();
+        const duplicateTitle = skills.filter(other => String(other.title || other.name || other.id).trim() === title).length > 1;
+        renderCodexOverleafSkillRow(list, { ...skill, title, duplicateTitle, scope: 'codex-local', removable: false }, enabled);
+      }
+    }
+
     function createSkillMark(id) {
       const mark = document.createElement('span');
       mark.className = 'codex-local-skill-icon';
@@ -123,10 +180,11 @@
       if (!id) {
         return;
       }
+      const local = skill.scope === 'codex-local';
       const compact = Boolean(list.closest?.('.codex-settings-workbench'));
       const row = document.createElement('div');
       row.className = 'codex-local-skill-row';
-      row.dataset.scope = 'codex-overleaf';
+      row.dataset.scope = local ? 'codex-local' : 'codex-overleaf';
       if (!masterEnabled) {
         row.dataset.disabled = 'true';
       }
@@ -148,7 +206,7 @@
         'annotated-rewrite': tx('Guided editing for document revisions.', '用于文稿修订的编辑流程。'),
         'parallel-subagents': tx('Split independent subtasks across multiple agents.', '将相互独立的子任务分配给多个 agent。')
       };
-      const description = descriptions[id]
+      const description = (!local && descriptions[id])
         || (typeof skill.description === 'string' ? skill.description.replace(/\s+/g, ' ').trim() : '');
       if (description) {
         const help = document.createElement('span');
@@ -157,7 +215,17 @@
         help.title = description;
         copy.append(help);
       }
-      if (compact) row.append(createSkillMark(id));
+      const sourceText = () => (skill.sourceKind === 'system' ? tx('Codex built-in', 'Codex 内置')
+        : skill.sourceKind === 'plugin' && skill.sourceLabel ? String(skill.sourceLabel) : tx('Local Codex', 'Codex 本地'))
+        + (skill.duplicateTitle ? ' · ' + (skill.sourceHint || id.slice(-8)) : '');
+      let sourceLabel = null;
+      if (local) {
+        sourceLabel = document.createElement('span');
+        sourceLabel.className = 'codex-local-skill-description';
+        sourceLabel.textContent = sourceText();
+        copy.append(sourceLabel);
+      }
+      if (compact) row.append(createSkillMark(local ? '' : id));
       row.append(copy);
       const controls = compact ? document.createElement('div') : row;
       if (compact) controls.className = 'codex-local-skill-controls';
@@ -166,14 +234,25 @@
       const toggle = document.createElement('input');
       toggle.type = 'checkbox';
       toggle.className = 'codex-switch';
-      toggle.checked = isCodexOverleafSkillEnabled(id);
-      toggle.setAttribute('aria-label', (trimmedTitle || id) + ': ' + tr('codexOverleafSkillEnableToggle'));
+      toggle.checked = local ? isCodexLocalSkillEnabled(id, skill) : isCodexOverleafSkillEnabled(id);
+      const accessibleSkillName = (trimmedTitle || id)
+        + (local && skill.duplicateTitle ? ': ' + (skill.sourceHint || id.slice(-8)) : '');
+      toggle.setAttribute('aria-label', accessibleSkillName + ': ' + tr('codexOverleafSkillEnableToggle'));
       if (!masterEnabled) {
         toggle.disabled = true;
       }
       toggle.addEventListener('change', event => {
-        setCodexOverleafSkillEnabled(id, event.target.checked);
+        if (local) setCodexLocalSkillEnabled(id, event.target.checked);
+        else setCodexOverleafSkillEnabled(id, event.target.checked);
       });
+      row._refreshLocale = () => {
+        if (sourceLabel) sourceLabel.textContent = sourceText();
+        toggle.setAttribute('aria-label', accessibleSkillName + ': ' + tr('codexOverleafSkillEnableToggle'));
+        const label = !local && id === 'annotated-rewrite' ? tx('Guided editing for document revisions.', '用于文稿修订的编辑流程。')
+          : !local && id === 'parallel-subagents' ? tx('Split independent subtasks across multiple agents.', '将相互独立的子任务分配给多个 agent。') : '';
+        const help = copy.querySelector('.codex-local-skill-description');
+        if (label && help) { help.textContent = label; help.title = label; }
+      };
 
       if (skill.removable !== false) {
         // The Remove / Confirm / Cancel controls share an actions container so
@@ -198,6 +277,11 @@
         cancelBtn.type = 'button';
         cancelBtn.className = 'codex-set-btn';
         cancelBtn.textContent = tr('localSkillRemoveCancel');
+        const refreshRow = row._refreshLocale;
+        row._refreshLocale = () => {
+          refreshRow(); removeBtn.textContent = tr('localSkillRemove'); cancelBtn.textContent = tr('localSkillRemoveCancel');
+          confirmBtn.textContent = tr(confirmBtn.disabled ? 'localSkillRemoving' : 'localSkillRemoveConfirm');
+        };
 
         function enterConfirming() {
           // Reset any previously confirming row back to its Remove button state.
@@ -274,10 +358,11 @@
       }
     }
 
-    function appendLocalSkillEmpty(list, text) {
+    function appendLocalSkillEmpty(list, key) {
       const empty = document.createElement('div');
       empty.className = 'codex-project-settings-empty';
-      empty.textContent = text;
+      empty.textContent = tr(key);
+      empty.dataset.i18n = key;
       list.append(empty);
     }
 
@@ -293,7 +378,7 @@
         throw new Error(response?.error?.message || 'native host did not remove Codex Overleaf skill');
       }
       const activeSkill = normalizeComposerSkillInvocation(getComposerSkillInvocation());
-      if (activeSkill?.scope === 'codex-overleaf' && activeSkill.skillId === id) {
+      if (activeSkill?.scope === 'codex-overleaf' && activeSkill.id === id) {
         clearComposerSkillInvocation();
       }
       setProjectSettingsStatus(tr('codexOverleafSkillRemoveDone'), 'completed');
@@ -304,6 +389,11 @@
 
     return {
       refreshLocalSkills,
+      refreshLocale: () => {
+        for (const selector of ['[data-local-skill-list]', '[data-codex-local-skill-list]']) {
+          for (const row of getPanel()?.querySelector(selector)?.children || []) row._refreshLocale?.();
+        }
+      },
       renderLocalSkillList,
       removeCodexOverleafSkill
     };

package/extension/src/content/markdownText.js

@@ -1,11 +1,8 @@
 (function initCodexOverleafMarkdownText() {
   'use strict';
 
-  // Markdown / assistant-text rendering — block + inline markdown, the
-  // assistant-visible sanitizers, and line-reference resolution/buttons carved
-  // out of contentRuntime.js (v1.4.5 structural-debt phase 1). The code below
-  // moved verbatim (original indentation kept); the four runtime collaborators
-  // are factory-injected so behavior is unchanged.
+  // Assistant-text rendering, sanitizers, and line-reference controls.
+  // Runtime collaborators are factory-injected.
   function create(deps = {}) {
     const {
       LineReferences,
@@ -588,7 +585,9 @@
       return;
     }
     renderingDiagnosticKeys.add(key);
-    if (typeof options.recordRenderingDiagnostic === 'function') options.recordRenderingDiagnostic({ code, detail });
+    try {
+      if (typeof deps.recordRenderingDiagnostic === 'function') deps.recordRenderingDiagnostic({ code, detail });
+    } catch (_error) { /* A diagnostic sink must not interrupt rendering. */ }
   }
 
   function appendMarkdownParagraphFlow(target, value) {

package/extension/src/content/modelPicker.js

@@ -117,11 +117,12 @@
       if (generation !== modelLoadGeneration) {
         return { stale: true };
       }
+      options.assertCurrent?.();
       const responseProviderId = response?.result?.providerId || '';
       if (selection?.providerId && responseProviderId && responseProviderId !== selection.providerId) {
         return { stale: true };
       }
-      if (selection?.providerId && selection.providerId !== 'builtin'
+      if (response?.ok && selection?.providerId && selection.providerId !== 'builtin'
         && Number(response?.result?.providerRevision) !== Number(selection.providerRevision)) {
         return { stale: true };
       }
@@ -170,6 +171,7 @@
       if (generation !== modelLoadGeneration) {
         return { stale: true };
       }
+      options.assertCurrent?.();
       applyUnavailableModelOptions(error);
       return { stale: false, error };
     }
@@ -251,7 +253,7 @@
       }
       const option = document.createElement('option');
       option.value = id;
-      option.textContent = model.label;
+      option.textContent = model.unverified && model.label === `${id} (custom)` ? tx(`${id} (custom)`, `${id}（自定义）`) : model.label;
       option.dataset.reasoningEfforts = normalizeReasoningEffortsForSelect(model.reasoningEfforts).join(',');
       option.dataset.defaultReasoningEffort = model.defaultReasoningEffort || '';
       option.dataset.reasoningPresentation = model.reasoningPresentation || '';
@@ -269,7 +271,7 @@
     if (selectedId && !renderedSelected && options.allowUnknownSelected !== false) {
       const option = document.createElement('option');
       option.value = selectedId;
-      option.textContent = `${selectedId} (custom)`;
+      option.textContent = tx(`${selectedId} (custom)`, `${selectedId}（自定义）`);
       option.dataset.reasoningEfforts = '';
       option.dataset.defaultReasoningEffort = '';
       option.dataset.reasoningPresentation = 'none';
@@ -370,7 +372,7 @@
     for (const option of Array.from(reasoningSelect.options || [])) {
       list.append(createModelConfigChoice({
         value: option.value,
-        label: option.textContent || formatReasoningEffortLabel(option.value, reasoningSelect.dataset.presentation),
+        label: formatReasoningEffortLabel(option.value, reasoningSelect.dataset.presentation),
         datasetName: 'reasoningChoice'
       }));
     }
@@ -384,6 +386,7 @@
     }
     list.textContent = '';
     for (const option of Array.from(modelSelect.options || [])) {
+      if (option.dataset.unverified === 'true' && [`${option.value} (custom)`, `${option.value}（自定义）`].includes(option.textContent)) option.textContent = tx(`${option.value} (custom)`, `${option.value}（自定义）`);
       const choice = createModelConfigChoice({
         value: option.value,
         label: option.textContent || option.value,

package/extension/src/content/nativeCompatibilityController.js

@@ -12,27 +12,46 @@
     const tx = options.tx;
     const tr = options.tr;
 
+    let installIdentity = options.getExtensionCompatibilityMetadata?.()?.installIdentity || {};
+    function resolveInstallCommand(compatibility = {}) {
+      const metadata = options.getExtensionCompatibilityMetadata?.() || {};
+      installIdentity = { ...installIdentity, ...(metadata.installIdentity || {}), ...(compatibility.installIdentity || {}) };
+      if (installIdentity.managed) return Compatibility?.buildInstallCommand?.(
+        compatibility.recommendedVersion || Compatibility?.BUILD_TARGET_VERSION,
+        compatibility.native?.platform || compatibility.platform || installIdentity.platform,
+        metadata.extensionId, installIdentity
+      ) || '';
+      return compatibility.updateCommand || compatibility.installCommand || options.installCommand || '';
+    }
+
     function sendNative(payload) {
       return dispatch(payload, 'sendNative');
     }
 
-    function sendBackgroundNative(payload) {
-      return dispatch(payload, 'sendBackgroundNative');
+    function sendBackgroundNative(payload, context = {}) {
+      return dispatch(payload, 'sendBackgroundNative', context);
     }
 
-    async function dispatch(payload, channelMethod) {
-      const compatibilityGate = await ensureForMethod(payload?.method);
-      if (!compatibilityGate.ok) return compatibilityGate.response;
-      // Post-Undo cache bookkeeping must survive the ended run's cancellation.
-      if (gatedMethods.has(payload?.method) && payload.method !== 'mirror.invalidate') {
-        options.throwIfCancellationRequested?.();
+    async function dispatch(payload, channelMethod, context = {}) {
+      let compatibilityGate;
+      try {
+        compatibilityGate = await ensureForMethod(payload?.method, context);
+        if (!compatibilityGate.ok) return compatibilityGate.response;
+        // Post-Undo cache bookkeeping must survive the ended run's cancellation.
+        if (gatedMethods.has(payload?.method) && payload.method !== 'mirror.invalidate') {
+          options.throwIfCancellationRequested?.();
+        }
+        context.assertCurrent?.();
+      } catch (error) {
+        if (context.assertCurrent && error && typeof error === 'object') error.requestDispatched = false;
+        throw error;
       }
       return nativeChannel[channelMethod](
         attachEvidence(payload, compatibilityGate.compatibility)
       );
     }
 
-    async function ensureForMethod(method) {
+    async function ensureForMethod(method, { assertCurrent } = {}) {
       const metadata = options.getExtensionCompatibilityMetadata?.() || {};
       const params = Compatibility?.buildBridgePingParams
         ? Compatibility.buildBridgePingParams(metadata)
@@ -41,9 +60,12 @@
         method: 'bridge.ping',
         params
       });
+      // A retired run must not publish even a compatibility failure into a successor.
+      assertCurrent?.();
       const compatibility = Compatibility?.evaluateNativeCompatibility
         ? Compatibility.evaluateNativeCompatibility(response, metadata)
         : options.fallbackNativeCompatibility(response);
+      const installCommand = resolveInstallCommand(compatibility);
       const allowed = !gatedMethods.has(method) ||
         (Compatibility?.isNativeMethodAllowed
           ? Compatibility.isNativeMethodAllowed(method, compatibility)
@@ -51,14 +73,14 @@
       if (allowed) return { ok: true, compatibility };
 
       const message = formatBlockedMessage(method, compatibility);
-      const installCommand = options.installCommand;
       const error = {
         code: 'native_update_required',
         message,
         status: compatibility.status || 'unknown_native',
         classification: options.getNativeCompatibilityClassification(compatibility),
-        installCommand: compatibility.installCommand || installCommand,
-        updateCommand: compatibility.updateCommand || compatibility.installCommand || installCommand,
+        installIdentity,
+        installCommand,
+        updateCommand: installCommand,
         currentNativeVersion: compatibility.currentNativeVersion
           || compatibility.nativeVersion
           || compatibility.native?.version
@@ -102,6 +124,7 @@
           : {};
         const response = await sendBackgroundNative({ method: 'bridge.ping', params });
         const compatibility = Compatibility.evaluateNativeCompatibility(response, metadata);
+        resolveInstallCommand(compatibility);
         const classification = options.getNativeCompatibilityClassification(compatibility);
         if (classification === 'compatible') {
           options.setBadge?.(renderer.headerEl, { type: 'none' });
@@ -158,9 +181,7 @@
         || compatibility.nativeVersion
         || native.version
         || tx('missing', '未安装');
-      const command = compatibility.updateCommand
-        || compatibility.installCommand
-        || options.installCommand;
+      const command = resolveInstallCommand(compatibility);
       const releaseUrl = compatibility.releaseUrl || '';
       const overlay = options.document.createElement('div');
       overlay.className = 'codex-plugin-confirm';
@@ -193,10 +214,12 @@
             `Extension v${extensionVersion} / Native v${nativeVersion}`,
             `扩展 v${extensionVersion} / Native v${nativeVersion}`
           ),
-        tx(
-          'Run the platform-specific command below, reload the extension, then refresh Overleaf.',
-          '运行下面的平台命令，重新加载扩展，然后刷新 Overleaf。'
-        )
+        !command && installIdentity.managed
+          ? tx('Repair Managed using the original managed root, browser and extension ID with install-managed.',
+            '请使用原管理根目录、浏览器及扩展 ID，通过 install-managed 修复托管安装。')
+          : tx('Run the command below, reload the extension, then refresh Overleaf.', '运行下面的命令，重新加载扩展，然后刷新 Overleaf。')
+            + (installIdentity.managed && (native.platform || installIdentity.platform) === 'win32'
+              ? tx(' Use PowerShell.', ' 请使用 PowerShell。') : '')
       ].join('\n\n');
       const commandCode = options.document.createElement('code');
       commandCode.textContent = command;
@@ -221,7 +244,9 @@
       copy.type = 'button';
       copy.className = 'codex-plugin-confirm-confirm';
       copy.textContent = tx('Copy command', '复制命令');
+      copy.disabled = !command;
       copy.addEventListener('click', async () => {
+        if (!command) return;
         await options.navigator.clipboard.writeText(command);
         copy.textContent = tx('Copied', '已复制');
       });
@@ -237,7 +262,7 @@
         if (event.target === overlay) overlay.remove();
       });
       panel.append(overlay);
-      copy.focus();
+      (command ? copy : close).focus();
     }
 
     function scheduleFirstUseOnboardingTip() {

package/extension/src/content/otWarmMirror.js

@@ -833,7 +833,7 @@
     if (getCurrentProjectId() !== projectId) return { useExistingMirror: false, reason: 'project_changed' };
     const otWarmStart = otWarmMirrorController.canUseOtWarmStart({
       enabled: isExperimentalOtEnabled() && !otWarmMirrorState.failureActive,
-      focusFiles,
+      focusFiles, focusFilesAreLiteral: true,
       mirrorStatus
     });
     if (!mirrorStatus?.exists || (!otWarmStart.ok && !isMirrorReusable(mirrorStatus))) {
@@ -858,10 +858,9 @@
       return { useExistingMirror: false, reason: 'overlay_probe_failed', mirrorStatus };
     }
     if (getCurrentProjectId() !== projectId) return { useExistingMirror: false, reason: 'project_changed' };
-    const fileOverlays = buildSnapshotFileOverlays(overlayProject, focusFiles);
-    if (!fileOverlays.length) {
-      return { useExistingMirror: false, reason: 'missing_current_overlay', mirrorStatus };
-    }
+    const fileOverlays = buildSnapshotFileOverlays(overlayProject, focusFiles).filter(file =>
+      !otWarmStart.ok || focusFiles.some(path => normalizeSnapshotPath(path) === normalizeSnapshotPath(file.path)));
+    if (!fileOverlays.length) return { useExistingMirror: false, reason: 'missing_current_overlay', mirrorStatus };
     if (focusFiles.length && !focusFiles.every(path => {
       const normalized = normalizeSnapshotPath(path);
       return fileOverlays.some(file => normalizeSnapshotPath(file.path) === normalized);