feat: 支持 API 429 (Too Many Requests) 自动故障转移与轮询

.vscode/settings.json

@@ -65,7 +65,7 @@
     "editor.defaultFormatter": "redhat.vscode-yaml",
     "editor.formatOnSave": true
   },
-  "python.languageServer": "Pylance",
+  "python.languageServer": "None",
   "rust-analyzer.cargo.extraEnv": {
     "PYO3_PYTHON": "${workspaceFolder}/src-tauri/pyembed/python/python.exe"
   }

app/components/panels/ConfigGroupPanel.vue

@@ -248,6 +248,10 @@ const handleSave = async () => {
     configGroups.value.push(payload);
     currentIndex.value = configGroups.value.length - 1;
   } else if (hasSelection.value) {
+    const currentGroup = configGroups.value[selectedIndex.value];
+    if (currentGroup?.id) {
+      payload.id = currentGroup.id;
+    }
     configGroups.value.splice(selectedIndex.value, 1, payload);
   }
 
@@ -449,7 +453,7 @@ const moveDown = async () => {
           <tbody v-if="configGroups.length">
             <tr
               v-for="(group, index) in configGroups"
-              :key="index"
+              :key="group.id || index"
               class="cursor-pointer transition-colors hover:bg-amber-100/30 group"
               :class="selectedIndex === index ? 'bg-amber-100/70' : ''"
               :style="{ height: 'var(--row-h)' }"

app/components/panels/SettingsPanel.vue

@@ -15,6 +15,7 @@ import {
 
 const store = useMtgaStore();
 const appInfo = store.appInfo;
+const configGroups = store.configGroups;
 
 const clearConfirmOpen = ref(false);
 const clearConfirmTitle = "确认清除数据";
@@ -116,6 +117,94 @@ const openThemeDialog = () => {
   themeDialogOpen.value = true;
 };
 
+const enable429Failover = computed({
+  get: () => store.enable429Failover.value,
+  set: (value) => {
+    store.enable429Failover.value = value;
+  },
+});
+
+const failover429CooldownSeconds = computed({
+  get: () => store.failover429CooldownSeconds.value,
+  set: (value) => {
+    store.failover429CooldownSeconds.value = value;
+  },
+});
+
+const routingGroupIds = computed({
+  get: () => store.routingGroupIds.value,
+  set: (value) => {
+    store.routingGroupIds.value = value;
+  },
+});
+
+type RoutingGroupOption = {
+  key: string;
+  label: string;
+  ids: string[];
+};
+
+const routingGroupOptions = computed<RoutingGroupOption[]>(() => {
+  const grouped = new Map<string, RoutingGroupOption>();
+  configGroups.value.forEach((group, index) => {
+    const id = (group.id || "").trim();
+    if (!id) {
+      return;
+    }
+    const name = (group.name || "").trim();
+    const key = name ? `name:${name}` : `id:${id}`;
+    const label = name || `配置组 ${index + 1}`;
+    const current = grouped.get(key);
+    if (current) {
+      current.ids.push(id);
+      return;
+    }
+    grouped.set(key, { key, label, ids: [id] });
+  });
+  return Array.from(grouped.values());
+});
+
+const selectedRoutingGroupKeys = computed({
+  get: () => {
+    const selectedIds = new Set(routingGroupIds.value);
+    return routingGroupOptions.value
+      .filter((option) => option.ids.some((id) => selectedIds.has(id)))
+      .map((option) => option.key);
+  },
+  set: (keys: string[]) => {
+    const selectedKeys = new Set(keys);
+    routingGroupIds.value = Array.from(
+      new Set(
+        routingGroupOptions.value
+          .filter((option) => selectedKeys.has(option.key))
+          .flatMap((option) => option.ids),
+      ),
+    );
+  },
+});
+
+const handleFailoverChange = async () => {
+  const ok = await store.saveConfig();
+  if (ok) {
+    store.appendLog(`API 智能调度已${enable429Failover.value ? "启用" : "禁用"}`);
+  } else {
+    store.appendLog("保存配置失败");
+  }
+};
+
+const handleRoutingGroupsChange = async () => {
+  const ok = await store.saveConfig();
+  if (ok) {
+    if (selectedRoutingGroupKeys.value.length) {
+      store.appendLog(`已设置轮询配置组数量：${selectedRoutingGroupKeys.value.length}`);
+    } else {
+      store.appendLog("轮询配置组未指定，仅使用当前激活配置");
+    }
+    return;
+  }
+  store.appendLog("保存配置失败");
+};
+
 const handleThemeSave = (value: ThemeConfig) => {
   const normalized = sanitizeThemeConfig(value);
   copyThemeConfig(themeConfig, normalized);
@@ -139,6 +228,58 @@ const handleThemeSave = (value: ThemeConfig) => {
   </div>
 
   <div class="mt-4 space-y-4">
+    <div class="mtga-soft-panel space-y-3">
+      <div>
+        <div class="text-sm font-semibold text-slate-900">转发策略</div>
+        <div class="text-xs text-slate-500">负载均衡与自动容错</div>
+      </div>
+      <label class="label cursor-pointer justify-start gap-3 p-0">
+        <input
+          v-model="enable429Failover"
+          type="checkbox"
+          class="toggle toggle-primary toggle-sm"
+          @change="handleFailoverChange"
+        />
+        <span class="label-text text-slate-700">启用多节点轮询与自动故障转移</span>
+      </label>
+      <div v-if="enable429Failover" class="flex items-center gap-3 pl-11">
+        <span class="text-xs text-slate-600">节点冷却周期 (秒)</span>
+        <input
+          v-model.number="failover429CooldownSeconds"
+          type="number"
+          class="mtga-input w-20 px-2 py-1 text-center"
+          min="1"
+          @change="handleFailoverChange"
+        />
+      </div>
+      <div v-if="enable429Failover" class="pl-11 space-y-2">
+        <div class="text-xs text-slate-600">轮询配置组（可多选，未选则仅使用当前激活配置）</div>
+        <div v-if="routingGroupOptions.length" class="space-y-1">
+          <label
+            v-for="option in routingGroupOptions"
+            :key="option.key"
+            class="label cursor-pointer justify-start gap-2 p-0"
+          >
+            <input
+              v-model="selectedRoutingGroupKeys"
+              type="checkbox"
+              class="checkbox checkbox-primary checkbox-xs"
+              :value="option.key"
+              @change="handleRoutingGroupsChange"
+            />
+            <span class="label-text text-xs text-slate-700">
+              {{ option.label }} · {{ option.ids.length }} 个 API
+            </span>
+          </label>
+        </div>
+        <div v-else class="text-xs text-slate-400">暂无可选配置组</div>
+      </div>
+      <div class="text-xs text-slate-500 pl-11 leading-relaxed">
+        开启后，请求将在选中配置组间轮询分发。若节点触发 429 (Too Many Requests)
+        频率限制，将自动静默切换至可用节点并对受限节点执行冷却隔离，确保服务连续性。
+      </div>
+    </div>
+
     <div class="mtga-soft-panel space-y-3">
       <div>
         <div class="text-sm font-semibold text-slate-900">用户数据</div>

app/composables/mtgaTypes.ts

@@ -1,4 +1,5 @@
 export type ConfigGroup = {
+  id?: string;
   name?: string;
   api_url: string;
   model_id: string;
@@ -13,6 +14,9 @@ export type ConfigPayload = {
   current_config_index: number;
   mapped_model_id: string;
   mtga_auth_key: string;
+  routing_group_ids?: string[];
+  enable_429_failover?: boolean;
+  failover_429_cooldown_seconds?: number;
 };
 
 export type AppInfo = {

app/composables/useMtgaStore.ts

@@ -162,13 +162,32 @@ const clampIndex = (value: number, max: number) => {
   return Math.min(Math.max(value, 0), max - 1);
 };
 
+const createConfigGroupId = (index: number) => {
+  if (typeof globalThis !== "undefined" && globalThis.crypto?.randomUUID) {
+    return globalThis.crypto.randomUUID();
+  }
+  return `group-${Date.now()}-${index}-${Math.random().toString(16).slice(2, 10)}`;
+};
+
+const normalizeConfigGroups = (groups: ConfigGroup[]) =>
+  groups.map((group, index) => {
+    const id = coerceText(group.id).trim() || createConfigGroupId(index);
+    return { ...group, id };
+  });
+
 export const useMtgaStore = () => {
   const api = useMtgaApi();
 
   const configGroups = useState<ConfigGroup[]>("mtga-config-groups", () => []);
   const currentConfigIndex = useState<number>("mtga-current-config-index", () => 0);
   const mappedModelId = useState<string>("mtga-mapped-model-id", () => "");
   const mtgaAuthKey = useState<string>("mtga-auth-key", () => "");
+  const routingGroupIds = useState<string[]>("mtga-routing-group-ids", () => []);
+  const enable429Failover = useState<boolean>("mtga-enable-429-failover", () => false);
+  const failover429CooldownSeconds = useState<number>(
+    "mtga-failover-429-cooldown-seconds",
+    () => 60,
+  );
   const runtimeOptions = useState<RuntimeOptions>("mtga-runtime-options", () => ({
     ...DEFAULT_RUNTIME_OPTIONS,
   }));
@@ -449,24 +468,59 @@ export const useMtgaStore = () => {
     if (!result) {
       return false;
     }
-    configGroups.value = result.config_groups || [];
+    const loadedGroups = Array.isArray(result.config_groups) ? result.config_groups : [];
+    configGroups.value = normalizeConfigGroups(loadedGroups);
     currentConfigIndex.value = clampIndex(
       result.current_config_index ?? 0,
       configGroups.value.length,
     );
+    const availableGroupIds = new Set(
+      configGroups.value.map((group) => coerceText(group.id).trim()),
+    );
+    routingGroupIds.value = Array.isArray(result.routing_group_ids)
+      ? Array.from(
+          new Set(
+            result.routing_group_ids
+              .map((id) => coerceText(id).trim())
+              .filter((id) => id && availableGroupIds.has(id)),
+          ),
+        )
+      : [];
     mappedModelId.value = coerceText(result.mapped_model_id);
     mtgaAuthKey.value = coerceText(result.mtga_auth_key);
+    enable429Failover.value = Boolean(result.enable_429_failover);
+    const cooldownRaw = Number(result.failover_429_cooldown_seconds);
+    failover429CooldownSeconds.value = Number.isFinite(cooldownRaw)
+      ? Math.max(1, Math.round(cooldownRaw))
+      : 60;
     return true;
   };
 
   const saveConfig = async () => {
+    configGroups.value = normalizeConfigGroups(configGroups.value);
     const clampedIndex = clampIndex(currentConfigIndex.value, configGroups.value.length);
     currentConfigIndex.value = clampedIndex;
+    const availableGroupIds = new Set(
+      configGroups.value.map((group) => coerceText(group.id).trim()),
+    );
+    routingGroupIds.value = Array.from(
+      new Set(
+        routingGroupIds.value
+          .map((id) => coerceText(id).trim())
+          .filter((id) => id && availableGroupIds.has(id)),
+      ),
+    );
     const payload: ConfigPayload = {
       config_groups: configGroups.value,
       current_config_index: clampedIndex,
       mapped_model_id: coerceText(mappedModelId.value),
       mtga_auth_key: coerceText(mtgaAuthKey.value),
+      routing_group_ids: routingGroupIds.value,
+      enable_429_failover: enable429Failover.value,
+      failover_429_cooldown_seconds: Math.max(
+        1,
+        Math.round(Number(failover429CooldownSeconds.value) || 60),
+      ),
     };
     const ok = await api.saveConfig(payload);
     return Boolean(ok);
@@ -807,6 +861,9 @@ export const useMtgaStore = () => {
     currentConfigIndex,
     mappedModelId,
     mtgaAuthKey,
+    routingGroupIds,
+    enable429Failover,
+    failover429CooldownSeconds,
     runtimeOptions,
     logs,
     systemPrompts,

app/docs/ui-migration.md

@@ -56,6 +56,8 @@ app/
 - [x] `MainTabs` 支持切换并挂载各 Tab 内容（证书/hosts/代理/数据/关于）。
 - [x] `ConfigGroupPanel` 改为可交互：列表数据、选中状态、增删改弹窗。
 - [x] `GlobalConfigPanel` 与 `RuntimeOptionsPanel` 接入真实数据与保存逻辑。
+- [x] 新增 `routing_group_ids` 配置读写，支持按组路由选择。
+- [x] 设置页接入配置组多选，轮询仅针对选中组（空则回退全部）。
 - [x] `LogPanel` 支持追加日志流（从后端或前端事件）。
 - [x] `UpdateDialog`、确认弹窗完善交互与 HTML 内容渲染。
 - [x] 用 `pyInvoke` 串起最小功能链路（例如 `greet` -> 日志输出）。
@@ -146,6 +148,7 @@ config_groups: ConfigGroup[]
 current_config_index: number
 mapped_model_id: string
 mtga_auth_key: string
+routing_group_ids: string[]
 runtime_options: {
   debugMode: boolean
   disableSslStrict: boolean