codex-overleaf-link 2.2.1 → 2.3.0

package/extension/src/content/postNavigationSettlementPersistence.js

@@ -0,0 +1,100 @@
+(function initPostNavigationSettlementPersistence(root, factory) {
+  const api = factory();
+  if (typeof module === 'object' && module.exports) module.exports = api;
+  if (root) root.CodexOverleafPostNavigationSettlementPersistence = api;
+})(typeof window !== 'undefined' ? window : globalThis, function postNavigationSettlementPersistenceFactory() {
+  'use strict';
+
+  async function persist(options = {}) {
+    if (options.__insideScopedTransaction !== true) {
+      const accountScopeId = String(options.accountScopeId || '').trim();
+      const projectId = String(options.projectId || '').trim();
+      if (!accountScopeId) {
+        return { ok: false, reason: 'account_scope_unavailable' };
+      }
+      if (!projectId) {
+        return { ok: false, reason: 'project_scope_unavailable' };
+      }
+      if (!options.PersistenceCoordinator
+        || typeof options.PersistenceCoordinator.commitDetached !== 'function') {
+        return { ok: false, reason: 'scoped_persistence_unavailable' };
+      }
+      const committed = await options.PersistenceCoordinator.commitDetached(
+        projectId,
+        accountScopeId,
+        { rebase: true },
+        () => persist({
+          ...options,
+          __insideScopedTransaction: true
+        })
+      );
+      if (!committed || typeof committed !== 'object') {
+        return { ok: false, reason: 'scoped_persistence_invalid_result' };
+      }
+      if (committed.ok !== true) return committed;
+      if (!Object.prototype.hasOwnProperty.call(committed, 'value')) return committed;
+      return committed.value && typeof committed.value === 'object'
+        ? committed.value
+        : { ok: false, reason: 'scoped_persistence_action_result_unavailable' };
+    }
+    const {
+      StorageDb,
+      WritebackSettlement,
+      sessionId,
+      runId,
+      status,
+      statusText,
+      finishedAt,
+      settlementResult
+    } = options;
+    if (!StorageDb || !WritebackSettlement || !sessionId || !runId || !status) {
+      return { ok: false, reason: 'invalid_post_navigation_settlement' };
+    }
+    const record = await StorageDb.getRecord('sessions', sessionId);
+    if (!record) return { ok: false, reason: 'session_not_found' };
+    if (String(record.accountScopeId || '').trim() !== String(options.accountScopeId || '').trim()) {
+      return { ok: false, reason: 'account_scope_mismatch' };
+    }
+    if (String(record.projectId || '').trim() !== String(options.projectId || '').trim()) {
+      return { ok: false, reason: 'project_scope_mismatch' };
+    }
+    const runs = Array.isArray(record.runs) ? [...record.runs] : [];
+    const runIndex = runs.findIndex(run => run && run.id === runId);
+    if (runIndex < 0) return { ok: false, reason: 'run_not_found' };
+
+    let transitioned = settlementResult
+      ? WritebackSettlement.applySettlementTransition(runs[runIndex], settlementResult)
+      : { ...runs[runIndex] };
+    transitioned = WritebackSettlement.applySettlementTransition(
+      transitioned,
+      WritebackSettlement.transitionPostNavigationStatus({
+        status,
+        statusText,
+        finishedAt: finishedAt || transitioned.finishedAt || new Date().toISOString()
+      })
+    );
+    runs[runIndex] = transitioned;
+
+    const now = options.now || new Date().toISOString();
+    record.runs = runs;
+    record.lastActivityAt = now;
+    record.updatedAt = now;
+    await StorageDb.putRecord('sessions', record);
+    return { ok: true, run: transitioned };
+  }
+
+  async function persistRequired(options = {}) {
+    const result = await persist(options);
+    if (result?.ok === true) return result;
+    const reason = String(result?.reason || 'unknown_failure');
+    throw Object.assign(
+      new Error(`Post-navigation settlement persistence failed: ${reason}`),
+      {
+        code: 'post_navigation_settlement_persistence_failed',
+        reason
+      }
+    );
+  }
+
+  return Object.freeze({ persist, persistRequired });
+});

package/extension/src/content/projectProviderSelection.js

@@ -30,24 +30,16 @@
       const nextSpeedTier = deps.readSelectedSpeed?.() || state.speedTier;
       const runSelection = deps.getRunSelection?.(nextProviderId);
       const nextProviderRevision = Number(runSelection?.providerRevision || 0);
+      const providerConfigurationChanged = nextProviderId === (state.providerId || 'builtin')
+        && nextProviderRevision !== Number(state.providerRevision || 0);
+      const resetProviderThread = providerChanged || providerConfigurationChanged;
       const sessions = (state.sessions || []).map(session => ({
         ...session,
         providerId: nextProviderId,
         model: nextModel,
         reasoningEffort: nextReasoningEffort,
         speedTier: nextSpeedTier,
-        codexThreadId: providerChanged ? '' : session.codexThreadId,
-        pendingInputs: (session.pendingInputs || []).map(item => ({
-          ...item,
-          payload: {
-            ...(item.payload || {}),
-            providerId: nextProviderId,
-            providerRevision: nextProviderRevision,
-            model: nextModel,
-            reasoningEffort: nextReasoningEffort,
-            speedTier: nextSpeedTier
-          }
-        }))
+        codexThreadId: resetProviderThread ? '' : session.codexThreadId
       }));
       deps.setState?.(deps.normalizeState({
         ...state,

package/extension/src/content/projectSessionCleanup.js

@@ -23,8 +23,8 @@
     }
 
     async function clearProjectSessions(projectId, projectName) {
-      const StorageDb = window.CodexOverleafStorageDb;
-      const SessionState = window.CodexOverleafSessionState;
+      const StorageDb = deps.StorageDb;
+      const SessionState = deps.SessionState;
       if (!StorageDb || !SessionState) {
         return;
       }
@@ -49,7 +49,7 @@
       if (!approved) {
         return;
       }
-      const Migration = window.CodexOverleafStorageMigration;
+      const Migration = deps.StorageMigration;
       if (Migration?.addSessionTombstones) {
         await Migration.addSessionTombstones(projectId, records.map(record => record.id));
       }

package/extension/src/content/providerSettingsCoordinator.js

@@ -2,8 +2,13 @@
   'use strict';
 
   function create(options = {}) {
-    const Profiles = window.CodexOverleafProviderProfiles;
+    const Profiles = options.ProviderProfiles;
+    const Dialog = options.ProviderSettingsDialog;
+    if (!Profiles || !Dialog?.create) {
+      throw new Error('Provider settings require explicit profile and dialog dependencies.');
+    }
     const instance = {
+      Profiles,
       tx: options.tx || ((english) => english),
       sendBackgroundNative: options.sendBackgroundNative,
       getSettingsPanelInstance: options.getSettingsPanelInstance || (() => null),
@@ -21,12 +26,24 @@
       channel: null,
       dialog: null
     };
-    instance.onProviderChanged = options.onProviderChanged
+    const projectProviderChanged = options.onProviderChanged
       || ((catalog, change) => reconcileProviderSelection(instance, catalog, change));
-    instance.dialog = window.CodexOverleafProviderSettingsDialog.create({
+    instance.onProviderChanged = async (catalog, change) => {
+      const previousProviderId = instance.getSelectedProviderId() || 'builtin';
+      const result = await projectProviderChanged(catalog, change);
+      const nextProviderId = instance.getSelectedProviderId() || 'builtin';
+      updateSettingsSummary(instance);
+      if (previousProviderId !== nextProviderId && instance.dialog?.isOpen?.()) {
+        instance.dialog.setCatalog(instance.catalog, nextProviderId);
+      }
+      return result;
+    };
+    instance.dialog = Dialog.create({
       document: options.document || document,
       tx: instance.tx,
+      ProviderProfiles: Profiles,
       callbacks: {
+        getCurrentProjectProviderId: () => instance.getSelectedProviderId() || 'builtin',
         onTest: context => testProvider(instance, context),
         onCancelTest: () => cancelProviderTest(instance),
         onSave: (context, action) => saveProvider(instance, context, action),
@@ -135,7 +152,7 @@
       await ensureLoadedWithRetry(instance);
     } catch (_error) {
       return instance.refreshModelOptions(
-        window.CodexOverleafProviderProfiles.buildRunSelection(instance.catalog, instance.getSelectedProviderId())
+        instance.Profiles.buildRunSelection(instance.catalog, instance.getSelectedProviderId())
       );
     }
     return reconcileProviderSelection(instance, instance.catalog, { forceSessionRefresh: true });
@@ -143,12 +160,18 @@
 
   async function reconcileProviderSelection(instance, catalog, change = {}) {
     const previousProviderId = instance.getSelectedProviderId() || 'builtin';
-    const requestedProviderId = typeof change.sessionProviderId === 'string' && change.sessionProviderId
+    let requestedProviderId = typeof change.sessionProviderId === 'string' && change.sessionProviderId
       ? change.sessionProviderId
       : previousProviderId;
+    const requestedProviderAvailable = requestedProviderId === 'builtin'
+      || Boolean(instance.Profiles.getProviderById(catalog, requestedProviderId));
+    const selectedProviderWasRemoved = !requestedProviderAvailable;
+    if (selectedProviderWasRemoved) {
+      requestedProviderId = 'builtin';
+    }
     const projectProviderChanged = requestedProviderId !== previousProviderId;
-    if (projectProviderChanged && change.providerSwitchApproved !== true) {
-      const requestedProvider = window.CodexOverleafProviderProfiles.getProviderById(catalog, requestedProviderId);
+    if (projectProviderChanged && !selectedProviderWasRemoved && change.providerSwitchApproved !== true) {
+      const requestedProvider = instance.Profiles.getProviderById(catalog, requestedProviderId);
       const approved = await instance.confirmProviderSwitch({
         providerId: requestedProviderId,
         providerName: requestedProvider?.name || requestedProviderId
@@ -158,13 +181,14 @@
       }
     }
     const changedProviderIds = Array.isArray(change.changedProviderIds) ? change.changedProviderIds : [];
-    if (!change.forceSessionRefresh && !projectProviderChanged && !changedProviderIds.includes(requestedProviderId)) {
+    const providerConfigurationChanged = changedProviderIds.includes(requestedProviderId);
+    if (!change.forceSessionRefresh && !projectProviderChanged && !providerConfigurationChanged) {
       return;
     }
     const loadResult = change.modelsPreloaded === true
       ? { stale: false, selectedModel: change.preloadedModelId || '' }
       : await instance.refreshModelOptions(
-        window.CodexOverleafProviderProfiles.buildRunSelection(catalog, requestedProviderId),
+        instance.Profiles.buildRunSelection(catalog, requestedProviderId),
         { persist: false }
       );
     if (loadResult?.stale || loadResult?.error) {
@@ -175,7 +199,7 @@
       error.details = loadResult?.error || {};
       throw error;
     }
-    if (projectProviderChanged) {
+    if (projectProviderChanged || providerConfigurationChanged) {
       await instance.setSelectedProviderId(requestedProviderId, loadResult?.selectedModel || '');
     }
     await instance.persistInputs();
@@ -185,7 +209,7 @@
 
   async function prepareProviderActivation(instance, providerId) {
     const previousProviderId = instance.getSelectedProviderId() || 'builtin';
-    const provider = window.CodexOverleafProviderProfiles.getProviderById(instance.catalog, providerId);
+    const provider = instance.Profiles.getProviderById(instance.catalog, providerId);
     if (providerId !== previousProviderId) {
       const approved = await instance.confirmProviderSwitch({
         providerId,
@@ -196,13 +220,13 @@
       }
     }
     const result = await instance.refreshModelOptions(
-      window.CodexOverleafProviderProfiles.buildRunSelection(instance.catalog, providerId),
+      instance.Profiles.buildRunSelection(instance.catalog, providerId),
       { persist: false }
     );
     if (result?.stale || result?.error) {
       if (providerId !== previousProviderId) {
         await instance.refreshModelOptions(
-          window.CodexOverleafProviderProfiles.buildRunSelection(instance.catalog, previousProviderId),
+          instance.Profiles.buildRunSelection(instance.catalog, previousProviderId),
           { persist: false }
         ).catch(() => {});
       }
@@ -293,7 +317,11 @@
         selectedId: result.savedProviderId
       });
       await notifyChanged(instance, applied.change, action.activate === true
-        ? { sessionProviderId: result.savedProviderId }
+        ? {
+          sessionProviderId: result.savedProviderId,
+          providerSwitchApproved: true,
+          requireProjection: true
+        }
         : {});
       instance.dialog.setBusy('', '');
       const fellBackToBuiltin = previousCatalog.activeProviderId === result.savedProviderId
@@ -389,7 +417,7 @@
     } catch (error) {
       if (preparation?.previousProviderId && preparation.previousProviderId !== context.profileId) {
         await instance.refreshModelOptions(
-          window.CodexOverleafProviderProfiles.buildRunSelection(instance.catalog, preparation.previousProviderId),
+          instance.Profiles.buildRunSelection(instance.catalog, preparation.previousProviderId),
           { persist: false }
         ).catch(() => {});
       }
@@ -423,7 +451,7 @@
     } catch (error) {
       if (preparation?.previousProviderId && preparation.previousProviderId !== 'builtin') {
         await instance.refreshModelOptions(
-          window.CodexOverleafProviderProfiles.buildRunSelection(instance.catalog, preparation.previousProviderId),
+          instance.Profiles.buildRunSelection(instance.catalog, preparation.previousProviderId),
           { persist: false }
         ).catch(() => {});
       }
@@ -448,7 +476,7 @@
   }
 
   function applyCatalog(instance, result, options = {}) {
-    const nextCatalog = window.CodexOverleafProviderProfiles.normalizeCatalog(result);
+    const nextCatalog = instance.Profiles.normalizeCatalog(result);
     if (instance.loaded && nextCatalog.storeRevision < instance.catalog.storeRevision) {
       return { applied: false, change: emptyCatalogChange() };
     }
@@ -463,19 +491,19 @@
         instance.dialog.setCatalog(instance.catalog, options.selectedId);
       }
     }
-    return { applied: true, change: describeCatalogChange(previousCatalog, nextCatalog) };
+    return { applied: true, change: describeCatalogChange(instance, previousCatalog, nextCatalog) };
   }
 
   function updateSettingsSummary(instance, override = {}) {
     const selectedProviderId = instance.getSelectedProviderId() || 'builtin';
-    const catalogProvider = window.CodexOverleafProviderProfiles.getProviderById(
+    const catalogProvider = instance.Profiles.getProviderById(
       instance.catalog,
       selectedProviderId
     );
     const selectedProvider = catalogProvider?.id === selectedProviderId
       ? catalogProvider
       : (selectedProviderId === 'builtin'
-        ? window.CodexOverleafProviderProfiles.getActiveProvider(instance.catalog)
+        ? instance.Profiles.getActiveProvider(instance.catalog)
         : {
           id: selectedProviderId,
           name: selectedProviderId,
@@ -528,16 +556,16 @@
     }
   }
 
-  function describeCatalogChange(previous, next) {
-    const previousActive = window.CodexOverleafProviderProfiles.getActiveProvider(previous);
-    const nextActive = window.CodexOverleafProviderProfiles.getActiveProvider(next);
+  function describeCatalogChange(instance, previous, next) {
+    const previousActive = instance.Profiles.getActiveProvider(previous);
+    const nextActive = instance.Profiles.getActiveProvider(next);
     const providerIds = new Set([
       ...(previous.providers || []).map(provider => provider.id),
       ...(next.providers || []).map(provider => provider.id)
     ]);
     const changedProviderIds = Array.from(providerIds).filter(providerId => {
-      const previousProvider = window.CodexOverleafProviderProfiles.getProviderById(previous, providerId);
-      const nextProvider = window.CodexOverleafProviderProfiles.getProviderById(next, providerId);
+      const previousProvider = instance.Profiles.getProviderById(previous, providerId);
+      const nextProvider = instance.Profiles.getProviderById(next, providerId);
       return modelCatalogSignature(previousProvider) !== modelCatalogSignature(nextProvider);
     });
     return {
@@ -548,8 +576,13 @@
   }
 
   function modelCatalogSignature(provider = {}) {
+    provider = provider || {};
     return JSON.stringify({
       id: provider.id || '',
+      revision: Number(provider.revision || 0),
+      baseUrl: provider.baseUrl || '',
+      wireApiPreference: provider.wireApiPreference || '',
+      resolvedWireApi: provider.resolvedWireApi || '',
       defaultModelId: provider.defaultModelId || '',
       reasoningAdapter: provider.reasoningAdapter || '',
       reasoningCapability: provider.reasoningCapability || '',
@@ -567,7 +600,7 @@
 
   function getProviderSnapshot(instance, providerId) {
     const requestedId = providerId || instance.getSelectedProviderId() || 'builtin';
-    const provider = window.CodexOverleafProviderProfiles.getProviderById(instance.catalog, requestedId);
+    const provider = instance.Profiles.getProviderById(instance.catalog, requestedId);
     if (!provider) {
       return {
         providerId: requestedId,

package/extension/src/content/providerSettingsDialog.js

@@ -5,11 +5,16 @@
   const CODEX_BLOSSOM_PATH = 'M13.798 23.976a5.7 5.7 0 0 1-2.26-.456 6.1 6.1 0 0 1-1.903-1.27 5.7 5.7 0 0 1-1.88.311 5.75 5.75 0 0 1-2.95-.79 6.2 6.2 0 0 1-2.188-2.159q-.81-1.366-.809-3.045 0-.695.19-1.51a6.4 6.4 0 0 1-1.475-2.038A5.95 5.95 0 0 1 0 10.573Q0 9.278.547 8.08q.547-1.2 1.523-2.062a5.5 5.5 0 0 1 2.307-1.223A5.7 5.7 0 0 1 5.472 2.35 6.1 6.1 0 0 1 7.565.623 5.8 5.8 0 0 1 10.206 0q1.19 0 2.26.456a6.1 6.1 0 0 1 1.903 1.27 5.7 5.7 0 0 1 1.88-.311q1.594 0 2.95.79a6 6 0 0 1 2.165 2.159q.832 1.366.832 3.045 0 .695-.19 1.51a6.3 6.3 0 0 1 1.475 2.062q.523 1.15.523 2.422a5.9 5.9 0 0 1-.547 2.493q-.547 1.2-1.546 2.086a5.4 5.4 0 0 1-2.284 1.199 5.56 5.56 0 0 1-1.118 2.445 5.9 5.9 0 0 1-2.07 1.727 5.8 5.8 0 0 1-2.64.623m-5.876-2.997q1.19 0 2.07-.504l4.472-2.589a.53.53 0 0 0 .238-.455v-2.062L8.945 18.7a.96.96 0 0 1-1.047 0l-4.496-2.613a.7.7 0 0 1-.024.168v.287q0 1.224.571 2.254a4.24 4.24 0 0 0 1.642 1.583q1.047.6 2.331.599m.238-3.908a.6.6 0 0 0 .262.072q.118 0 .238-.072l1.784-1.031-5.734-3.357q-.522-.312-.523-.935V6.545a4.3 4.3 0 0 0-1.903 1.63 4.25 4.25 0 0 0-.714 2.398q0 1.176.595 2.254.594 1.08 1.546 1.63zm5.638 5.323q1.26 0 2.284-.576a4.3 4.3 0 0 0 1.618-1.582q.595-1.008.595-2.254v-5.179a.47.47 0 0 0-.238-.431l-1.808-1.055v6.689q0 .624-.524.935l-4.496 2.613a4.3 4.3 0 0 0 2.57.84m.904-8.776v-3.26l-2.688-1.535-2.712 1.535v3.26l2.712 1.535zM7.756 5.97q0-.623.523-.935l4.496-2.613a4.3 4.3 0 0 0-2.569-.84q-1.26 0-2.284.576A4.3 4.3 0 0 0 6.304 3.74q-.57 1.008-.57 2.254v5.155q0 .287.237.455l1.785 1.055zM19.84 17.43a4.16 4.16 0 0 0 1.88-1.63 4.33 4.33 0 0 0 .713-2.397q0-1.176-.595-2.254-.594-1.08-1.546-1.63l-4.449-2.59q-.143-.096-.261-.072a.46.46 0 0 0-.238.072L13.56 7.936l5.758 3.38a.9.9 0 0 1 .38.384q.143.216.143.528zM15.059 5.25q.524-.335 1.047 0l4.52 2.662V7.48q0-1.15-.57-2.181A4.14 4.14 0 0 0 18.46 3.62q-1.023-.623-2.379-.623-1.19 0-2.07.503L9.54 6.09a.53.53 0 0 0-.238.455v2.062z';
 
   function create(options = {}) {
+    const Profiles = options.ProviderProfiles;
+    if (!Profiles) {
+      throw new Error('Provider settings dialog requires provider profiles.');
+    }
     const instance = {
+      Profiles,
       document: options.document || document,
       tx: options.tx || ((english) => english),
       callbacks: options.callbacks || {},
-      catalog: window.CodexOverleafProviderProfiles.normalizeCatalog({}),
+      catalog: Profiles.normalizeCatalog({}),
       selectedId: 'builtin',
       draft: null,
       dirty: false,
@@ -108,7 +113,7 @@
   }
 
   function setCatalog(instance, catalog, selectedId) {
-    instance.catalog = window.CodexOverleafProviderProfiles.normalizeCatalog(catalog || {});
+    instance.catalog = instance.Profiles.normalizeCatalog(catalog || {});
     const nextId = selectedId || (
       instance.catalog.providers.some(provider => provider.id === instance.selectedId)
         ? instance.selectedId
@@ -151,8 +156,8 @@
       '第三方实验性'
     );
     instance.root.querySelector('[data-provider-dialog-subtitle]').textContent = tx(
-      'Configure experimental third-party integrations used by future Codex runs. Compatibility varies by provider and gateway.',
-      '配置后续 Codex 任务使用的实验性第三方集成；兼容性取决于具体模型服务与网关。'
+      "Configure experimental third-party integrations used by this project's future Codex runs. Compatibility varies by provider and gateway.",
+      '配置当前项目后续 Codex 任务使用的实验性第三方集成；兼容性取决于具体模型服务与网关。'
     );
     renderProviderList(instance);
     renderDetail(instance);
@@ -165,10 +170,10 @@
     const list = instance.root.querySelector('[data-provider-list]');
     const rows = instance.catalog.providers.map(provider => {
       const selected = provider.id === instance.selectedId;
-      const active = provider.id === instance.catalog.activeProviderId;
+      const active = provider.id === getCurrentProjectProviderId(instance);
       const diagnosticCount = Object.values(provider.modelDiagnostics || {}).filter(item => item.status === 'tested').length;
       const status = active
-        ? tx('Active', '使用中')
+        ? tx('Current project', '当前项目')
         : diagnosticCount
           ? tx(`Tested ${diagnosticCount}/${Math.max(1, provider.models.length)}`, `已测试 ${diagnosticCount}/${Math.max(1, provider.models.length)}`)
           : provider.kind === 'custom'
@@ -207,7 +212,7 @@
       .map(model => model.id)
       .filter(id => id !== draft.defaultModelId)
       .join('\n');
-    const active = provider.id && provider.id === instance.catalog.activeProviderId;
+    const active = provider.id && provider.id === getCurrentProjectProviderId(instance);
     const acceptedHost = getEndpointHost(draft.baseUrl);
     const secretSavedAt = formatSecretSavedAt(instance, provider.secretUpdatedAt);
     const disclosureSatisfied = Boolean(
@@ -219,9 +224,9 @@
       <div class="codex-provider-detail-titleline">
         <div>
           <h3>${escapeHtml(draft.name || tx('Custom provider', '自定义模型服务'))}</h3>
-          <p>${escapeHtml(active ? tx('Used by new Codex runs', '新 Codex 任务将使用此服务') : tx('Saved provider profile', '已保存的模型服务配置'))}</p>
+          <p>${escapeHtml(active ? tx('Used by new runs in this project', '当前项目的新任务将使用此服务') : tx('Saved provider profile', '已保存的模型服务配置'))}</p>
         </div>
-        ${active ? `<span class="codex-provider-active-badge">${escapeHtml(tx('Active', '使用中'))}</span>` : ''}
+        ${active ? `<span class="codex-provider-active-badge">${escapeHtml(tx('Current project', '当前项目'))}</span>` : ''}
       </div>
       <div class="codex-provider-form-grid">
         <label class="codex-provider-field">
@@ -440,7 +445,7 @@
 
   function renderBuiltinDetail(instance, detail) {
     const tx = instance.tx;
-    const active = instance.catalog.activeProviderId === 'builtin';
+    const active = getCurrentProjectProviderId(instance) === 'builtin';
     detail.innerHTML = `
       <div class="codex-provider-builtin">
         <span class="codex-provider-builtin-mark" aria-hidden="true">
@@ -452,12 +457,19 @@
           '使用本地 Codex CLI 管理的身份验证、模型目录和服务配置。'
         ))}</p>
         ${active
-          ? `<span class="codex-provider-active-badge">${escapeHtml(tx('Active', '使用中'))}</span>`
-          : `<button type="button" class="codex-provider-primary-button" data-provider-action="activate-builtin">${escapeHtml(tx('Use built-in Codex', '使用内置 Codex'))}</button>`}
+          ? `<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>
     `;
   }
 
+  function getCurrentProjectProviderId(instance) {
+    const providerId = instance.callbacks.getCurrentProjectProviderId?.();
+    return typeof providerId === 'string' && providerId.trim()
+      ? providerId.trim()
+      : 'builtin';
+  }
+
   function renderFooter(instance) {
     const actions = instance.root.querySelector('[data-provider-footer-actions]');
     const provider = getSelectedProvider(instance);
@@ -466,7 +478,7 @@
       actions.innerHTML = `<button type="button" class="codex-provider-secondary-button" data-provider-action="close">${escapeHtml(tx('Close', '关闭'))}</button>`;
       return;
     }
-    const active = provider.id && provider.id === instance.catalog.activeProviderId;
+    const active = provider.id && provider.id === getCurrentProjectProviderId(instance);
     const isNew = !provider.id;
     const destinationChanged = active && getCurrentBaseUrl(instance) !== provider.endpointDisclosureBaseUrl;
     const actionState = getFooterActionState({
@@ -485,8 +497,8 @@
       <span class="codex-provider-footer-spacer"></span>
       <button type="button" class="codex-provider-secondary-button" data-provider-action="close">${escapeHtml(tx('Cancel', '取消'))}</button>
       ${actionState.showSave ? `<button type="button" class="codex-provider-secondary-button" data-provider-action="save"${saveDisabled}>${escapeHtml(tx('Save', '保存'))}</button>` : ''}
-      ${actionState.showSaveAndUse ? `<button type="button" class="codex-provider-primary-button" data-provider-action="save-use"${saveDisabled}>${escapeHtml(tx('Save and use', '保存并使用'))}</button>` : ''}
-      ${actionState.showUse ? `<button type="button" class="codex-provider-primary-button" data-provider-action="use"${useDisabled}>${escapeHtml(tx('Use', '使用'))}</button>` : ''}
+      ${actionState.showSaveAndUse ? `<button type="button" class="codex-provider-primary-button" data-provider-action="save-use"${saveDisabled}>${escapeHtml(tx('Save and use for this project', '保存并用于当前项目'))}</button>` : ''}
+      ${actionState.showUse ? `<button type="button" class="codex-provider-primary-button" data-provider-action="use"${useDisabled}>${escapeHtml(tx('Use for this project', '用于当前项目'))}</button>` : ''}
     `;
   }
 
@@ -677,7 +689,7 @@
     }
     instance.selectedId = id;
     instance.draft = id === '__new__'
-      ? window.CodexOverleafProviderProfiles.buildEmptyDraft()
+      ? instance.Profiles.buildEmptyDraft()
       : null;
     instance.dirty = false;
     delete instance.root.dataset.dirty;
@@ -689,7 +701,7 @@
   }
 
   function readContext(instance) {
-    const provider = getSelectedProvider(instance) || window.CodexOverleafProviderProfiles.buildEmptyDraft();
+    const provider = getSelectedProvider(instance) || instance.Profiles.buildEmptyDraft();
     const get = name => instance.root.querySelector(`[data-provider-field="${name}"]`);
     const defaultModelId = String(get('defaultModelId')?.value || '').trim();
     const modelIds = [defaultModelId, ...String(get('additionalModels')?.value || '').split(/\r?\n/)]
@@ -759,7 +771,7 @@
 
   function getSelectedProvider(instance) {
     if (instance.selectedId === '__new__') {
-      return instance.draft || window.CodexOverleafProviderProfiles.buildEmptyDraft();
+      return instance.draft || instance.Profiles.buildEmptyDraft();
     }
     return instance.catalog.providers.find(provider => provider.id === instance.selectedId)
       || instance.catalog.providers.find(provider => provider.id === 'builtin');