fix: stabilize codex config management

Author: NGLSL

src/components/providers/CodexSection/CodexSection.tsx

@@ -121,7 +121,7 @@ export function CodexSection({
             return (
               <Fragment>
                 <div className="item-title">
-                  {t('ai_providers.codex_item_title')}
+                  {item.name?.trim() || t('ai_providers.codex_item_title')}
                   {configDisabled && (
                     <span className="status-badge warning">
                       {t('ai_providers.config_disabled_badge')}

src/i18n/locales/en.json

@@ -258,6 +258,8 @@
     "codex_empty_title": "No Codex Configuration",
     "codex_empty_desc": "Click the button above to add the first configuration",
     "codex_item_title": "Codex Configuration",
+    "codex_config_name_label": "Configuration Name (Optional):",
+    "codex_config_name_placeholder": "e.g.: Primary account / Backup account",
     "codex_add_modal_title": "Add Codex API Configuration",
     "codex_add_modal_key_label": "API Key:",
     "codex_add_modal_keys_label": "API Keys",

src/i18n/locales/zh-CN.json

@@ -258,6 +258,8 @@
     "codex_empty_title": "暂无Codex配置",
     "codex_empty_desc": "点击上方按钮添加第一个配置",
     "codex_item_title": "Codex配置",
+    "codex_config_name_label": "配置名称 (可选):",
+    "codex_config_name_placeholder": "例如: 主账号 / 备用账号",
     "codex_add_modal_title": "添加Codex API配置",
     "codex_add_modal_key_label": "API密钥:",
     "codex_add_modal_keys_label": "API密钥",

src/pages/AiProvidersCodexEditPage.tsx

@@ -30,6 +30,7 @@ type LocationState = { fromAiProviders?: boolean } | null;
 const buildEmptyForm = (): ProviderFormState => ({
   apiKey: '',
   apiKeyEntries: [buildApiKeyEntry()],
+  name: '',
   priority: undefined,
   prefix: '',
   baseUrl: '',
@@ -68,6 +69,7 @@ const normalizeModelEntries = (entries: Array<{ name: string; alias: string }>)
 
 type CodexFormBaseline = {
   apiKeyEntries: Array<{ apiKey: string; proxyUrl: string }>;
+  name: string;
   priority: number | null;
   prefix: string;
   baseUrl: string;
@@ -79,6 +81,7 @@ type CodexFormBaseline = {
 
 const buildCodexBaseline = (form: ProviderFormState): CodexFormBaseline => ({
   apiKeyEntries: normalizeCodexApiKeyEntries(form.apiKeyEntries, form.apiKey, form.proxyUrl),
+  name: String(form.name ?? '').trim(),
   priority:
     form.priority !== undefined && Number.isFinite(form.priority) ? Math.trunc(form.priority) : null,
   prefix: String(form.prefix ?? '').trim(),
@@ -305,6 +308,7 @@ export function AiProvidersCodexEditPage() {
   );
   const isDirty =
     !areCodexApiKeyEntriesEqual(baseline.apiKeyEntries, normalizedApiKeyEntries) ||
+    baseline.name !== String(form.name ?? '').trim() ||
     baseline.priority !== normalizedPriority ||
     baseline.prefix !== String(form.prefix ?? '').trim() ||
     baseline.baseUrl !== String(form.baseUrl ?? '').trim() ||
@@ -526,9 +530,10 @@ export function AiProvidersCodexEditPage() {
     setError('');
     try {
       const payload: ProviderKeyConfig = {
-        // 顶层 api-key 只作为旧版接口和列表删除的兼容字段；实际多 key 配置写入 api-key-entries。
+        // 顶层 api-key 只作为旧版接口和旧配置格式的兼容字段；实际多 key 配置写入 api-key-entries。
         apiKey: apiKeyEntries[0]?.apiKey ?? '',
         apiKeyEntries,
+        name: form.name?.trim() || undefined,
         priority: form.priority !== undefined ? Math.trunc(form.priority) : undefined,
         prefix: form.prefix?.trim() || undefined,
         baseUrl,
@@ -724,6 +729,13 @@ export function AiProvidersCodexEditPage() {
           <div className="hint">{t('common.invalid_provider_index')}</div>
         ) : (
           <div className={styles.openaiEditForm}>
+            <Input
+              label={t('ai_providers.codex_config_name_label')}
+              placeholder={t('ai_providers.codex_config_name_placeholder')}
+              value={form.name ?? ''}
+              onChange={(e) => setForm((prev) => ({ ...prev, name: e.target.value }))}
+              disabled={disableControls || saving}
+            />
             <Input
               label={t('ai_providers.priority_label')}
               hint={t('ai_providers.priority_hint')}

src/pages/AiProvidersPage.tsx

@@ -298,7 +298,7 @@ export function AiProvidersPage() {
       onConfirm: async () => {
         try {
           if (type === 'codex') {
-            await providersApi.deleteCodexConfig(getProviderPrimaryApiKey(entry), entry.baseUrl);
+            await providersApi.deleteCodexConfig(index);
             const next = codexConfigs.filter((_, idx) => idx !== index);
             setCodexConfigs(next);
             updateConfigValue('codex-api-key', next);

src/services/api/providers.ts

@@ -35,6 +35,12 @@ const buildProviderDeleteQuery = (apiKey: string, baseUrl?: string) => {
   return `?${params.toString()}`;
 };
 
+const buildProviderDeleteIndexQuery = (index: number) => {
+  const params = new URLSearchParams();
+  params.set('index', String(index));
+  return `?${params.toString()}`;
+};
+
 const serializeModelAliases = (models?: ModelAlias[]) =>
   Array.isArray(models)
     ? models
@@ -65,6 +71,7 @@ const serializeApiKeyEntry = (entry: ApiKeyEntry) => {
 
 const serializeProviderKey = (config: ProviderKeyConfig, options?: { includeApiKeyEntries?: boolean }) => {
   const payload: Record<string, unknown> = { 'api-key': config.apiKey };
+  if (config.name?.trim()) payload.name = config.name.trim();
   if (options?.includeApiKeyEntries && Array.isArray(config.apiKeyEntries) && config.apiKeyEntries.length) {
     payload['api-key-entries'] = config.apiKeyEntries.map((entry) => serializeApiKeyEntry(entry));
   }
@@ -192,8 +199,10 @@ export const providersApi = {
       value: serializeProviderKey(value, { includeApiKeyEntries: true })
     }),
 
-  deleteCodexConfig: (apiKey: string, baseUrl?: string) =>
-    apiClient.delete(`/codex-api-key${buildProviderDeleteQuery(apiKey, baseUrl)}`),
+  deleteCodexConfig: (target: number | string, baseUrl?: string) =>
+    typeof target === 'number'
+      ? apiClient.delete(`/codex-api-key${buildProviderDeleteIndexQuery(target)}`)
+      : apiClient.delete(`/codex-api-key${buildProviderDeleteQuery(target, baseUrl)}`),
 
   async getClaudeConfigs(): Promise<ProviderKeyConfig[]> {
     const data = await apiClient.get('/claude-api-key');

src/services/api/transformers.ts

@@ -132,6 +132,10 @@ const normalizeProviderKeyConfig = (item: unknown): ProviderKeyConfig | null =>
   if (apiKeyEntries.length) {
     config.apiKeyEntries = apiKeyEntries;
   }
+  const name = record?.name ?? record?.['name'];
+  if (typeof name === 'string' && name.trim()) {
+    config.name = name.trim();
+  }
   const priority = record?.priority ?? record?.['priority'];
   if (priority !== undefined && priority !== null && String(priority).trim() !== '') {
     const parsed = Number(priority);

src/types/provider.ts

@@ -36,6 +36,7 @@ export interface GeminiKeyConfig {
 export interface ProviderKeyConfig {
   apiKey: string;
   apiKeyEntries?: ApiKeyEntry[];
+  name?: string;
   priority?: number;
   prefix?: string;
   baseUrl?: string;