feat(frontend): expose upstream network proxy settings

Author: GcsSloop

frontend/src/features/settings/SettingsPage.test.tsx

@@ -21,6 +21,10 @@ const baseSettings = {
   usage_request_timeout_seconds: 15,
   proxy_host: "127.0.0.1",
   proxy_port: 6789,
+  upstream_proxy_mode: "system",
+  upstream_proxy_url: "",
+  upstream_proxy_username: "",
+  upstream_proxy_password: "",
   auto_failover_enabled: true,
   auto_backup_interval_hours: 24,
   backup_retention_count: 10,
@@ -107,6 +111,8 @@ describe("SettingsPage", () => {
     expect(screen.getByRole("tab", { name: "关于" })).toBeInTheDocument();
     fireEvent.click(screen.getByRole("tab", { name: "代理" }));
     expect(await screen.findByRole("switch", { name: "自动故障转移开关" })).toBeInTheDocument();
+    fireEvent.click(screen.getByRole("radio", { name: "手动指定" }));
+    fireEvent.change(screen.getByRole("textbox", { name: "上游代理地址" }), { target: { value: "http://127.0.0.1:7890" } });
     expect(screen.queryByText("自动故障转移队列")).not.toBeInTheDocument();
     fireEvent.click(screen.getByRole("tab", { name: "数据" }));
     expect(await screen.findByText("费用统计")).toBeInTheDocument();
@@ -125,6 +131,8 @@ describe("SettingsPage", () => {
           body: JSON.stringify({
             ...baseSettings,
             launch_at_login: true,
+            upstream_proxy_mode: "manual",
+            upstream_proxy_url: "http://127.0.0.1:7890",
             provider_pricing: { codex: { input_per_million: 4.5, output_per_million: 0 } },
             account_pricing: { "1": { input_per_million: 0, output_per_million: 15.2 } },
           }),
@@ -134,12 +142,16 @@ describe("SettingsPage", () => {
     expect(applyDesktopAppSettings).toHaveBeenCalledWith({
       ...baseSettings,
       launch_at_login: true,
+      upstream_proxy_mode: "manual",
+      upstream_proxy_url: "http://127.0.0.1:7890",
       provider_pricing: { codex: { input_per_million: 4.5, output_per_million: 0 } },
       account_pricing: { "1": { input_per_million: 0, output_per_million: 15.2 } },
     });
     expect(onSettingsChanged).toHaveBeenCalledWith({
       ...baseSettings,
       launch_at_login: true,
+      upstream_proxy_mode: "manual",
+      upstream_proxy_url: "http://127.0.0.1:7890",
       provider_pricing: { codex: { input_per_million: 4.5, output_per_million: 0 } },
       account_pricing: { "1": { input_per_million: 0, output_per_million: 15.2 } },
     });

frontend/src/features/settings/SettingsPage.tsx

@@ -183,6 +183,10 @@ export function SettingsPage({
       provider_pricing: initialSettings.provider_pricing ?? {},
       account_pricing: initialSettings.account_pricing ?? {},
       usage_request_timeout_seconds: initialSettings.usage_request_timeout_seconds ?? 15,
+      upstream_proxy_mode: initialSettings.upstream_proxy_mode ?? "system",
+      upstream_proxy_url: initialSettings.upstream_proxy_url ?? "",
+      upstream_proxy_username: initialSettings.upstream_proxy_username ?? "",
+      upstream_proxy_password: initialSettings.upstream_proxy_password ?? "",
     });
   }, [initialSettings]);
 
@@ -580,6 +584,56 @@ export function SettingsPage({
             </div>
           </Card>
 
+          <Card className="settings-card" variant="borderless">
+            <SectionHeader
+              icon={<DesktopOutlined />}
+              title={t("上游网络代理")}
+              description={t("仅影响 AI Gate 发往上游服务商的网络请求，不影响 AI Gate 本地代理监听地址。")}
+            />
+            <div className="settings-stack">
+              <Radio.Group
+                value={draftSettings.upstream_proxy_mode ?? "system"}
+                onChange={(event) => updateDraft({ upstream_proxy_mode: event.target.value })}
+              >
+                <Radio value="system">{t("跟随系统")}</Radio>
+                <Radio value="direct">{t("直连")}</Radio>
+                <Radio value="manual">{t("手动指定")}</Radio>
+              </Radio.Group>
+              <Text type="secondary">{t("Clash / Mihomo 常见地址示例：")}http://127.0.0.1:7890</Text>
+            </div>
+            {draftSettings.upstream_proxy_mode === "manual" ? (
+              <div className="settings-field-grid">
+                <label className="settings-field">
+                  <span className="settings-field-label">{t("上游代理地址")}</span>
+                  <Input
+                    aria-label={t("上游代理地址")}
+                    value={draftSettings.upstream_proxy_url}
+                    onChange={(event) => updateDraft({ upstream_proxy_url: event.target.value })}
+                    placeholder="http://127.0.0.1:7890"
+                  />
+                </label>
+                <label className="settings-field">
+                  <span className="settings-field-label">{t("上游代理用户名（可选）")}</span>
+                  <Input
+                    aria-label={t("上游代理用户名（可选）")}
+                    value={draftSettings.upstream_proxy_username}
+                    onChange={(event) => updateDraft({ upstream_proxy_username: event.target.value })}
+                    placeholder={t("留空则不使用认证")}
+                  />
+                </label>
+                <label className="settings-field">
+                  <span className="settings-field-label">{t("上游代理密码（可选）")}</span>
+                  <Input.Password
+                    aria-label={t("上游代理密码（可选）")}
+                    value={draftSettings.upstream_proxy_password}
+                    onChange={(event) => updateDraft({ upstream_proxy_password: event.target.value })}
+                    placeholder={t("留空则不使用认证")}
+                  />
+                </label>
+              </div>
+            ) : null}
+          </Card>
+
         </div>
       ),
     },

frontend/src/lib/api.ts

@@ -228,6 +228,10 @@ export type AppSettings = {
   usage_request_timeout_seconds?: number;
   proxy_host: string;
   proxy_port: number;
+  upstream_proxy_mode?: "system" | "direct" | "manual";
+  upstream_proxy_url?: string;
+  upstream_proxy_username?: string;
+  upstream_proxy_password?: string;
   auto_failover_enabled: boolean;
   auto_backup_interval_hours: number;
   backup_retention_count: number;