codex-overleaf-link 2.3.4 → 2.3.5

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": "48e7ba193b0723f8e135c4b52e3af1416b1fe35b3cb780207fb0600e7e0f8019",
-  "outputDigest": "866811d95e8bd58d369e0790bf2af5becc93946eb8ad987b80f0be0f80fa965f",
-  "byteLength": 2321914,
+  "sourceDigest": "7ed22d5c82b20220316824547e1dfc359e45dfcdf1f1bca2fb7280195a05361c",
+  "outputDigest": "50436e35fe942b3fd8540a6267fba79c41a53c216b1ffc42995e4ed026771de4",
+  "byteLength": 2337940,
   "inputs": [
     "extension/entries/content-entry.mjs",
     "extension/src/content/activeTurnControl.js",
@@ -17,6 +17,7 @@
     "extension/src/content/diagnosticsController.js",
     "extension/src/content/diagnosticsPanel.js",
     "extension/src/content/diffReviewPanel.js",
+    "extension/src/content/globalPreferencesController.js",
     "extension/src/content/legacyGlobalRegistry.js",
     "extension/src/content/localSkillsPanel.js",
     "extension/src/content/markdownDomRenderer.js",
@@ -68,6 +69,7 @@
     "extension/src/shared/compatibility.js",
     "extension/src/shared/compileAdapter.js",
     "extension/src/shared/failureReasons.js",
+    "extension/src/shared/globalPreferences.js",
     "extension/src/shared/governanceRules.js",
     "extension/src/shared/i18n.js",
     "extension/src/shared/lineReferences.js",

package/extension/src/content/globalPreferencesController.js

@@ -0,0 +1,125 @@
+(function (root, factory) {
+  if (typeof module === 'object' && module.exports) module.exports = factory(require('../shared/globalPreferences'));
+  else root.CodexOverleafModuleRegistry.define('GlobalPreferencesController', ['GlobalPreferences'], factory);
+})(typeof globalThis !== 'undefined' ? globalThis : this, function (Preferences) {
+  'use strict';
+
+  const CONTROLS = Object.freeze({ theme: '[data-theme-select]', locale: '[data-language-select]',
+    preloadProjectContext: '[data-preload-project-context]', loadCodexLocalSkills: '[data-load-codex-local-skills]',
+    loadCodexOverleafSkills: '[data-load-codex-overleaf-skills]' });
+
+  function create(options) {
+    const chromeApi = options.chromeApi;
+    const fallback = Preferences.pick(options.getState?.() || {});
+    let snapshot = null;
+    let loading = null;
+    let subscribed = false;
+    let disposed = false;
+    let lastError = null;
+    let tail = Promise.resolve();
+    const pending = [];
+
+    function view() {
+      return pending.reduce((values, operation) => Preferences.applyPatch(values, operation.patch), snapshot?.values || fallback);
+    }
+
+    function render(force = false) {
+      if (disposed) return;
+      const previous = options.getState?.() || {};
+      const values = view();
+      const changed = Preferences.changedKeys(Preferences.pick(previous), values);
+      options.setState?.({ ...previous, ...values });
+      const panel = options.getPanel?.();
+      if (!panel) return;
+      for (const [field, selector] of Object.entries(CONTROLS)) {
+        const control = panel.querySelector(selector);
+        if (!control) continue;
+        if (typeof values[field] === 'boolean') control.checked = values[field];
+        else if (control.value !== values[field]) control.value = values[field];
+      }
+      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?.();
+    }
+
+    function accept(value) {
+      const next = Preferences.validateSnapshot(value);
+      lastError = null;
+      if (!snapshot || next.revision > snapshot.revision) {
+        snapshot = next;
+        render();
+      }
+      return snapshot;
+    }
+
+    async function request(type, patch) {
+      const response = await chromeApi.runtime.sendMessage({ type, ...(patch ? { patch } : {}) });
+      if (!response?.ok) throw new Error(response?.error?.message || 'Global preferences are unavailable.');
+      return response.result;
+    }
+
+    function onStorageChange(changes, area) {
+      if (disposed || area !== 'local' || !changes[Preferences.STORAGE_KEY]?.newValue) return;
+      try { accept(changes[Preferences.STORAGE_KEY].newValue); } catch (error) { reportError(error); }
+    }
+
+    function reportError(error) {
+      lastError = error;
+      options.onError?.(error);
+    }
+
+    async function initialize() {
+      if (!subscribed) {
+        chromeApi.storage.onChanged.addListener(onStorageChange);
+        subscribed = true;
+      }
+      if (snapshot) return snapshot;
+      if (!loading) {
+        loading = request(Preferences.READ_MESSAGE).then(accept).catch(error => {
+          reportError(error);
+          return null;
+        }).finally(() => { loading = null; });
+      }
+      return loading;
+    }
+
+    function update(input) {
+      const patch = Preferences.validatePatch(input);
+      if (!Preferences.changedKeys(view(), Preferences.applyPatch(view(), patch)).length) return pending.length ? tail : Promise.resolve(snapshot);
+      const operation = { patch };
+      pending.push(operation);
+      render();
+      const result = tail.catch(() => {}).then(() => request(Preferences.PATCH_MESSAGE, patch)).then(Preferences.validateSnapshot).then(value => {
+        accept(value);
+        pending.splice(pending.indexOf(operation), 1);
+        render();
+        return snapshot;
+      }, error => {
+        pending.splice(pending.indexOf(operation), 1);
+        render();
+        reportError(error);
+        throw error;
+      });
+      tail = result;
+      return result;
+    }
+
+    function handleInput(event) {
+      const field = Object.keys(CONTROLS).find(key => event?.target?.matches?.(CONTROLS[key]));
+      if (!field) return null;
+      return update({ [field]: ['theme', 'locale'].includes(field) ? event.target.value : Boolean(event.target.checked) });
+    }
+
+    return Object.freeze({ initialize, update, handleInput,
+      overlay: state => snapshot || pending.length ? { ...state, ...view() } : state,
+      refreshView: () => { if (snapshot) render(true); if (lastError) options.onError?.(lastError); },
+      destroy() {
+        disposed = true;
+        if (subscribed) chromeApi.storage.onChanged.removeListener(onStorageChange);
+      }
+    });
+  }
+
+  return Object.freeze({ create });
+});

package/extension/src/content/legacyGlobalRegistry.js

@@ -27,6 +27,8 @@
     'DiffReviewPanel',
     'FailureReasons',
     'GovernanceRules',
+    'GlobalPreferences',
+    'GlobalPreferencesController',
     'I18n',
     'LineReferences',
     'LocalSkillsPanel',

package/extension/src/content/panelRenderer.js

@@ -327,7 +327,8 @@
 
       return new Promise(resolve => {
         let settled = false;
-        const overlay = doc.createElement('div');
+        const returnFocus = doc.activeElement;
+        const overlay = doc.createElement('dialog');
         overlay.className = 'codex-plugin-confirm';
         overlay.setAttribute('data-plugin-confirm', 'true');
         overlay.setAttribute('role', 'dialog');
@@ -371,13 +372,16 @@
         card.append(head, body, actions);
         overlay.append(card);
         panel.append(overlay);
+        overlay.showModal?.();
 
         const cleanup = value => {
           if (settled) return;
           settled = true;
           activeResolve = null;
           doc.removeEventListener('keydown', onKeydown, true);
+          overlay.close?.();
           overlay.remove();
+          returnFocus?.focus?.();
           resolve(value);
         };
         activeResolve = cleanup;
@@ -398,6 +402,7 @@
         overlay.addEventListener('click', event => {
           if (event.target === overlay) cleanup(false);
         });
+        overlay.addEventListener('cancel', event => { event.preventDefault(); cleanup(false); });
         cancel.addEventListener('click', () => cleanup(false));
         confirm.addEventListener('click', () => cleanup(true));
         doc.addEventListener('keydown', onKeydown, true);

package/extension/src/content/projectSettingsCoordinator.js

@@ -293,6 +293,7 @@
       });
       saveStateSoon();
       renderLocalSkillList();
+      deps.updateGlobalPreferences?.({ codexOverleafSkillEnabled: { [skillId]: Boolean(enabled) } })?.catch(() => {});
     }
 
     function readSkillLoadingSettingsFromSettings() {

package/extension/src/content/providerSettingsCoordinator.js

@@ -14,6 +14,7 @@
       getSettingsPanelInstance: options.getSettingsPanelInstance || (() => null),
       getSelectedModel: options.getSelectedModel || (() => ''),
       getSelectedProviderId: options.getSelectedProviderId || (() => 'builtin'),
+      hasCurrentProject: options.hasCurrentProject || (() => true),
       setSelectedProviderId: options.setSelectedProviderId || (() => {}),
       confirmProviderSwitch: options.confirmProviderSwitch || (() => true),
       clearSelectedModel: options.clearSelectedModel || (() => {}),
@@ -43,6 +44,7 @@
       tx: instance.tx,
       ProviderProfiles: Profiles,
       callbacks: {
+        hasCurrentProject: instance.hasCurrentProject,
         getCurrentProjectProviderId: () => instance.getSelectedProviderId() || 'builtin',
         onTest: context => testProvider(instance, context),
         onCancelTest: () => cancelProviderTest(instance),
@@ -208,6 +210,7 @@
   }
 
   async function prepareProviderActivation(instance, providerId) {
+    requireCurrentProject(instance);
     const previousProviderId = instance.getSelectedProviderId() || 'builtin';
     const provider = instance.Profiles.getProviderById(instance.catalog, providerId);
     if (providerId !== previousProviderId) {
@@ -301,6 +304,7 @@
   async function saveProvider(instance, context, action = {}) {
     instance.dialog.setBusy('saving', instance.tx('Saving provider…', '正在保存模型服务…'));
     try {
+      if (action.activate === true) requireCurrentProject(instance);
       const result = await request(instance, 'codex.providers.upsert', {
         profileId: context.profileId,
         expectedRevision: context.expectedRevision,
@@ -495,6 +499,12 @@
   }
 
   function updateSettingsSummary(instance, override = {}) {
+    if (!instance.hasCurrentProject()) {
+      instance.getSettingsPanelInstance()?.setProviderSummary?.({ summary: instance.tx(
+        'Shared model API profiles · open a project to select a provider',
+        '共享模型 API 配置 · 进入项目后选择使用的服务'), tone: 'info' });
+      return;
+    }
     const selectedProviderId = instance.getSelectedProviderId() || 'builtin';
     const catalogProvider = instance.Profiles.getProviderById(
       instance.catalog,
@@ -594,6 +604,11 @@
     });
   }
 
+  function requireCurrentProject(instance) {
+    if (!instance.hasCurrentProject()) throw createClientError(
+      'provider_project_required', instance.tx('Open an Overleaf project before selecting its provider.', '请先进入 Overleaf 项目，再选择该项目使用的模型服务。'));
+  }
+
   function emptyCatalogChange() {
     return { activeProviderChanged: false, activeModelCatalogChanged: false, changedProviderIds: [] };
   }

package/extension/src/content/providerSettingsDialog.js

@@ -47,12 +47,13 @@
     if (instance.root) {
       return instance.root;
     }
-    const root = instance.document.createElement('div');
+    const root = instance.document.createElement('dialog');
     root.className = 'codex-provider-dialog-root';
+    root.setAttribute('aria-labelledby', 'codex-provider-dialog-title');
     root.hidden = true;
     root.innerHTML = `
       <div class="codex-provider-dialog-backdrop" data-provider-backdrop></div>
-      <section class="codex-provider-dialog" role="dialog" aria-modal="true" aria-labelledby="codex-provider-dialog-title">
+      <section class="codex-provider-dialog">
         <header class="codex-provider-dialog-head">
           <div class="codex-provider-dialog-heading">
             <div class="codex-provider-dialog-titleline">
@@ -79,6 +80,7 @@
     root.addEventListener('input', event => handleInput(instance, event));
     root.addEventListener('change', event => handleInput(instance, event));
     root.addEventListener('keydown', event => handleKeydown(instance, event));
+    root.addEventListener('cancel', event => { event.preventDefault(); requestClose(instance); });
     root.addEventListener('mousedown', event => event.stopPropagation());
     root.addEventListener('click', event => event.stopPropagation());
     return root;
@@ -89,9 +91,12 @@
     instance.root.hidden = false;
     syncTheme(instance);
     setCatalog(instance, catalog || instance.catalog);
+    if (!instance.root.open) instance.root.showModal?.();
     queueMicrotask(() => {
-      instance.root.querySelector('[data-provider-row][aria-current="true"]')?.focus?.()
-        || instance.root.querySelector('input, button, select, textarea')?.focus?.();
+      if (!instance.root || instance.root.hidden) return;
+      const target = instance.root.querySelector('[data-provider-row][aria-current="true"]')
+        || instance.root.querySelector('input, button, select, textarea');
+      target?.focus?.();
     });
   }
 
@@ -106,6 +111,7 @@
       instance.callbacks.onCancelTest?.();
       instance.busy = '';
     }
+    instance.root.close?.();
     instance.root.hidden = true;
     instance.busy = '';
     instance.returnFocus?.focus?.();
@@ -159,6 +165,9 @@
       "Configure experimental third-party integrations used by this project's future Codex runs. Compatibility varies by provider and gateway.",
       '配置当前项目后续 Codex 任务使用的实验性第三方集成；兼容性取决于具体模型服务与网关。'
     );
+    if (instance.callbacks.hasCurrentProject?.() === false) instance.root.querySelector('[data-provider-dialog-subtitle]').textContent = tx(
+      'Manage shared model API profiles. Open a project to choose which provider its future turns use.',
+      '管理共享模型 API 配置。进入项目后，再选择该项目后续任务使用的服务。');
     renderProviderList(instance);
     renderDetail(instance);
     renderFooter(instance);
@@ -408,8 +417,8 @@
       <label class="codex-provider-disclosure">
           <input type="checkbox" data-provider-disclosure ${disclosureSatisfied ? 'checked' : ''}>
           <span data-provider-disclosure-text>${escapeHtml(tx(
-            `Future Codex runs in every Overleaf project tab may send selected project content to ${draft.baseUrl || 'this endpoint'}.`,
-            `所有 Overleaf 项目标签页的后续 Codex 任务都可能把所选项目内容发送到 ${draft.baseUrl || '此端点'}。`
+            `Projects using this shared provider may send task context to ${draft.baseUrl || 'this endpoint'}. Each project chooses its own provider.`,
+            `使用此共享服务配置的项目可能把任务上下文发送到 ${draft.baseUrl || '此端点'}。各项目独立选择使用的服务。`
           ))}</span>
       </label>
       <div class="codex-provider-test-row">
@@ -456,7 +465,7 @@
           'Uses the authentication, model catalog, and provider configuration managed by the local Codex CLI.',
           '使用本地 Codex CLI 管理的身份验证、模型目录和服务配置。'
         ))}</p>
-        ${active
+        ${instance.callbacks.hasCurrentProject?.() === false ? '' : active
           ? `<span class="codex-provider-active-badge">${escapeHtml(tx('Current project', '当前项目'))}</span>`
           : `<button type="button" class="codex-provider-primary-button" data-provider-action="activate-builtin">${escapeHtml(tx('Use for this project', '用于当前项目'))}</button>`}
       </div>
@@ -464,6 +473,7 @@
   }
 
   function getCurrentProjectProviderId(instance) {
+    if (instance.callbacks.hasCurrentProject?.() === false) return '';
     const providerId = instance.callbacks.getCurrentProjectProviderId?.();
     return typeof providerId === 'string' && providerId.trim()
       ? providerId.trim()
@@ -487,6 +497,7 @@
       dirty: instance.dirty,
       destinationChanged,
       canSave: canSaveCurrentDraft(instance),
+      hasProject: instance.callbacks.hasCurrentProject?.() !== false,
       canActivate: canActivateCurrentProvider(instance)
     });
     const saveDisabled = actionState.saveEnabled ? '' : ' disabled aria-disabled="true"';
@@ -508,8 +519,8 @@
     const dirty = options.dirty === true;
     return {
       showSave: isNew || dirty,
-      showSaveAndUse: (isNew || dirty) && (!active || options.destinationChanged === true),
-      showUse: !isNew && !active && !dirty,
+      showSaveAndUse: options.hasProject !== false && (isNew || dirty) && (!active || options.destinationChanged === true),
+      showUse: options.hasProject !== false && !isNew && !active && !dirty,
       saveEnabled: options.canSave === true,
       useEnabled: options.canActivate === true
     };
@@ -662,7 +673,7 @@
       return;
     }
     const focusable = Array.from(instance.root.querySelectorAll('button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled])'))
-      .filter(element => !element.closest('[hidden]'));
+      .filter(element => !element.closest('[hidden]') && (!element.getClientRects || element.getClientRects().length));
     if (!focusable.length) {
       return;
     }
@@ -941,8 +952,8 @@
     if (!text) return;
     const baseUrl = getCurrentBaseUrl(instance) || instance.tx('this endpoint', '此端点');
     text.textContent = instance.tx(
-      `Future Codex runs in every Overleaf project tab may send selected project content to ${baseUrl}.`,
-      `所有 Overleaf 项目标签页的后续 Codex 任务都可能把所选项目内容发送到 ${baseUrl}。`
+      `Projects using this shared provider may send task context to ${baseUrl}. Each project chooses its own provider.`,
+      `使用此共享服务配置的项目可能把任务上下文发送到 ${baseUrl}。各项目独立选择使用的服务。`
     );
   }
 
@@ -984,10 +995,7 @@
     if (!panel) {
       return;
     }
-    const style = instance.document.defaultView.getComputedStyle(panel);
     instance.root.dataset.theme = panel.dataset.theme === 'light' ? 'light' : 'dark';
-    instance.root.style.setProperty('--provider-panel-bg', style.backgroundColor || '#151716');
-    instance.root.style.setProperty('--provider-panel-color', style.color || '#eceeea');
   }
 
   function escapeHtml(value) {
@@ -1011,6 +1019,7 @@
   }
 
   function destroy(instance) {
+    instance.root?.close?.();
     instance.root?.remove?.();
     instance.root = null;
   }

package/extension/src/content/settingsPanel.js

@@ -251,10 +251,12 @@
     for (const selector of ['[data-governance-readonly-patterns]', '[data-governance-writable-patterns]', '[data-sensitive-check-enabled]', '[data-sensitive-confirm-allowed]', '[data-preload-project-context]', '[data-load-codex-local-skills]', '[data-load-codex-overleaf-skills]', '[data-theme-select]', '[data-language-select]']) {
       const element = container.querySelector(selector);
       element?.addEventListener?.('change', event => {
-        instance.callbacks.onInputChange?.(event);
-        flashSaved(instance, event);
+        Promise.resolve(instance.callbacks.onInputChange?.(event))
+          .then(() => flashSaved(instance, event)).catch(() => {});
+      });
+      element?.addEventListener?.('input', event => {
+        Promise.resolve(instance.callbacks.onInputChange?.(event)).catch(() => {});
       });
-      element?.addEventListener?.('input', event => instance.callbacks.onInputChange?.(event));
     }
     // Guardrails: live, non-blocking analysis of the protection globs.
     for (const selector of ['[data-governance-readonly-patterns]', '[data-governance-writable-patterns]']) {

package/extension/src/content/themeController.js

@@ -51,6 +51,9 @@
     const resolved = resolveTheme(preference, mediaQueryList);
     if (panelRoot && typeof panelRoot.setAttribute === 'function') {
       panelRoot.setAttribute('data-theme', resolved);
+      for (const target of panelRoot.ownerDocument?.querySelectorAll?.('.codex-provider-dialog-root, #codex-overleaf-launcher') || []) {
+        target.setAttribute('data-theme', resolved);
+      }
     }
     return resolved;
   }

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.3.4';
+  const BUILD_TARGET_VERSION = '2.3.5';
   const DEFAULT_CHROME_EXTENSION_ID = 'illdpneeeopfffmiepaejglgmhpmdhdc';
   const REQUIRED_CAPABILITIES = Object.freeze([
     'bridgePing',

package/extension/src/shared/globalPreferences.js

@@ -0,0 +1,131 @@
+(function (root, factory) {
+  const api = factory();
+  if (typeof module === 'object' && module.exports) module.exports = api;
+  if (root) root.CodexOverleafGlobalPreferences = api;
+})(typeof globalThis !== 'undefined' ? globalThis : this, function () {
+  'use strict';
+
+  const STORAGE_KEY = 'codexOverleafGlobalPrefsV1';
+  const LEGACY_KEY = 'codexOverleafPrefs';
+  const READ_MESSAGE = 'codex-overleaf/global-preferences/read';
+  const PATCH_MESSAGE = 'codex-overleaf/global-preferences/patch';
+  const DEFAULTS = Object.freeze({ theme: 'dark', locale: 'en', preloadProjectContext: true,
+    loadCodexLocalSkills: true, loadCodexOverleafSkills: true });
+  const FIELDS = Object.freeze([...Object.keys(DEFAULTS), 'codexOverleafSkillEnabled']);
+
+  function validSkillId(id) {
+    return /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,79}$/.test(id)
+      && !['__proto__', 'prototype', 'constructor'].includes(id) && !id.includes('..');
+  }
+
+  function pick(value = {}) {
+    const skills = {};
+    for (const [id, enabled] of Object.entries(value.codexOverleafSkillEnabled || {}).slice(0, 200)) {
+      if (validSkillId(id) && typeof enabled === 'boolean') skills[id] = enabled;
+    }
+    return {
+      theme: ['dark', 'light', 'auto'].includes(value.theme) ? value.theme : 'dark',
+      locale: value.locale === 'zh' ? 'zh' : 'en',
+      preloadProjectContext: value.preloadProjectContext !== false,
+      loadCodexLocalSkills: value.loadCodexLocalSkills !== false,
+      loadCodexOverleafSkills: value.loadCodexOverleafSkills !== false,
+      codexOverleafSkillEnabled: skills
+    };
+  }
+
+  function validatePatch(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error('Invalid global preference patch.');
+    const patch = {};
+    for (const [key, item] of Object.entries(value)) {
+      if (!FIELDS.includes(key)) throw new Error('Unknown global preference: ' + key);
+      if (key === 'theme' && !['dark', 'light', 'auto'].includes(item)
+        || key === 'locale' && !['en', 'zh'].includes(item)
+        || typeof DEFAULTS[key] === 'boolean' && typeof item !== 'boolean') {
+        throw new Error('Invalid global preference: ' + key);
+      }
+      if (key === 'codexOverleafSkillEnabled') {
+        if (!item || typeof item !== 'object' || Array.isArray(item) || Object.keys(item).length > 200) {
+          throw new Error('Invalid skill preference map.');
+        }
+        for (const [id, enabled] of Object.entries(item)) {
+          if (!validSkillId(id) || typeof enabled !== 'boolean') throw new Error('Invalid skill preference.');
+        }
+        patch[key] = { ...item };
+      } else patch[key] = item;
+    }
+    return patch;
+  }
+
+  function applyPatch(values, patch) {
+    return { ...pick(values), ...patch, codexOverleafSkillEnabled: {
+      ...pick(values).codexOverleafSkillEnabled, ...(patch.codexOverleafSkillEnabled || {})
+    } };
+  }
+
+  function changedKeys(left, right) {
+    return FIELDS.filter(key => JSON.stringify(left[key]) !== JSON.stringify(right[key]));
+  }
+
+  function validateSnapshot(value) {
+    if (!value || value.schemaVersion !== 1 || !Number.isSafeInteger(value.revision) || value.revision < 1) {
+      throw new Error('Invalid global preference revision.');
+    }
+    validatePatch(value.values);
+    if (!FIELDS.every(key => Object.hasOwn(value.values, key))) throw new Error('Incomplete global preferences.');
+    return { schemaVersion: 1, revision: value.revision, values: pick(value.values) };
+  }
+
+  function createStore(storage) {
+    let tail = Promise.resolve();
+    function serial(work) {
+      const pending = tail.then(work);
+      tail = pending.catch(() => {});
+      return pending;
+    }
+    async function read() {
+      const stored = await storage.get([STORAGE_KEY, LEGACY_KEY]);
+      if (stored[STORAGE_KEY] !== undefined) return validateSnapshot(stored[STORAGE_KEY]);
+      const snapshot = { schemaVersion: 1, revision: 1, values: pick(stored[LEGACY_KEY] || {}) };
+      await storage.set({ [STORAGE_KEY]: snapshot });
+      return snapshot;
+    }
+    return Object.freeze({
+      read: () => serial(read),
+      patch: input => serial(async () => {
+        const patch = validatePatch(input);
+        const previous = await read();
+        const values = applyPatch(previous.values, patch);
+        if (Object.keys(values.codexOverleafSkillEnabled).length > 200) throw new Error('Too many skill preferences.');
+        if (!changedKeys(previous.values, values).length) return previous;
+        const snapshot = { schemaVersion: 1, revision: previous.revision + 1, values };
+        await storage.set({ [STORAGE_KEY]: snapshot });
+        return snapshot;
+      })
+    });
+  }
+
+  function installBackground(chromeApi) {
+    const store = createStore(chromeApi.storage?.local);
+    chromeApi.runtime.onMessage.addListener((message, sender, respond) => {
+      if (![READ_MESSAGE, PATCH_MESSAGE].includes(message?.type)) return undefined;
+      let allowed = false;
+      try {
+        const url = new URL(sender?.tab?.url || '');
+        allowed = sender.id === chromeApi.runtime.id && url.protocol === 'https:'
+          && ['overleaf.com', 'www.overleaf.com'].includes(url.hostname)
+          && /^\/project(?:\/|$)/.test(url.pathname);
+      } catch (_error) { /* reject unrelated contexts */ }
+      if (!allowed) {
+        respond({ ok: false, error: { message: 'Global preferences require an Overleaf tab.' } });
+        return false;
+      }
+      const pending = message.type === READ_MESSAGE ? store.read() : store.patch(message.patch);
+      pending.then(result => respond({ ok: true, result }), error => respond({ ok: false, error: { message: error.message } }));
+      return true;
+    });
+    return store;
+  }
+
+  return Object.freeze({ STORAGE_KEY, LEGACY_KEY, READ_MESSAGE, PATCH_MESSAGE, FIELDS,
+    pick, validatePatch, validateSnapshot, applyPatch, changedKeys, createStore, installBackground });
+});

package/extension/src/shared/i18n.js

@@ -380,7 +380,7 @@
       contextReadFailed: 'Could not read files: {message}',
       contextNoFiles: 'No usable text files were read from this Overleaf project.',
       contextSelectedFiles: 'Added {count} @file items. Future tasks will focus on them first.',
-      contextDefaultWholeProject: 'Default is the whole project. Add @file; @compile-log and @current-section are available as context options.',
+      contextDefaultWholeProject: 'Default is the whole project. Choose files or add @compile-log. For a section, name it in your request.',
       preloadProjectContextTitle: 'Preload project context',
       preloadProjectContextDescription: 'Fetch the exact project file list in the background after an Overleaf project becomes idle.',
       contextResourceTitle: '{path} (non-text resource, shown only as project structure for now)',
@@ -900,7 +900,7 @@
       contextReadFailed: '读取文件失败：{message}',
       contextNoFiles: '没有从当前 Overleaf 项目读取到可用文本文件。',
       contextSelectedFiles: '已添加 {count} 个 @file；后续任务会优先围绕它们。',
-      contextDefaultWholeProject: '默认使用整个项目。可添加 @file；@compile-log 和 @current-section 将作为后续上下文能力。',
+      contextDefaultWholeProject: '默认使用整个项目。可选择文件或添加 @compile-log；处理章节时请在请求中注明章节名称。',
       preloadProjectContextTitle: '预加载项目上下文',
       preloadProjectContextDescription: 'Overleaf 项目进入空闲状态后，在后台读取精确的项目文件列表。',
       contextResourceTitle: '{path}（非文本资源，当前只作为项目结构显示）',

package/extension/styles/panel.css

@@ -170,14 +170,14 @@
 }
 
 .codex-provider-dialog-root {
-  --provider-bg: var(--provider-panel-bg, #151716);
+  --provider-bg: #151716;
   --provider-surface: #1c1f1d;
   --provider-surface-raised: #222622;
   --provider-line: rgba(255, 255, 255, 0.12);
   --provider-muted: #a0a59f;
   --provider-accent: #79d58a;
   --provider-danger: #ef8176;
-  --provider-text: var(--provider-panel-color, #eef0ec);
+  --provider-text: #eef0ec;
   --provider-field-label: #dfe3dd;
   --provider-control-bg: rgba(255, 255, 255, 0.035);
   --provider-hover: rgba(255, 255, 255, 0.07);
@@ -191,6 +191,14 @@
   position: fixed;
   inset: 0;
   z-index: 2147483600;
+  margin: 0;
+  padding: 0;
+  border: 0;
+  width: 100vw;
+  max-width: none;
+  height: 100vh;
+  max-height: none;
+  background: transparent;
   color: var(--provider-text);
   font-family: "Aptos", "SF Pro Text", sans-serif;
 }
@@ -217,6 +225,7 @@
 }
 
 .codex-provider-dialog-root[hidden] { display: none !important; }
+.codex-provider-dialog-root::backdrop { background: transparent; }
 
 .codex-provider-dialog-backdrop {
   position: absolute;
@@ -1801,9 +1810,15 @@
   box-sizing: border-box;
   width: var(--codex-overleaf-panel-width);
   height: 100vh;
+  max-width: none;
+  max-height: none;
+  margin: 0;
+  border: 0;
+  color: inherit;
   padding: 14px;
   background: rgba(12, 12, 12, 0.68);
 }
+#codex-overleaf-panel .codex-plugin-confirm::backdrop { background: transparent; }
 
 #codex-overleaf-panel .codex-plugin-confirm-card {
   width: 100%;

package/package.json

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