metona-ai-desktop/electron/utils/network-proxy.ts

/**
 * 网络代理应用工具（v0.6.4 P4-5）
 *
 * 目标：为 Electron 侧的全部网络出口提供统一的代理配置入口：
 *
 * 1. Chromium session 栈（session.setProxy）：
 *    - defaultSession（渲染页面自身请求）
 *    - persist:metona-agent-browser（web_fetch 浏览器回退 / web_browser 隐藏窗口）
 *      该分区由 BrowserWindowManager 在首次使用时创建 —— 本工具在启动期与配置
 *      变更时直接 fromPartition 预配置，先于任何窗口创建生效。
 *
 * 2. 主进程 Node fetch（LLM adapters / web_fetch HTTP 阶段 / SearXNG 测试 /
 *    更新检查）：Node 的 global fetch 与 undici 通过 globalThis 上的
 *    Symbol.for('undici.globalDispatcher.1') 共享调度器 —— 这里用 npm 安装的
 *    undici 调 setGlobalDispatcher 即可令原生 fetch 走 ProxyAgent（连接池首次
 *    触发后对全部后续请求生效）。
 *
 * 配置来源：app_config 的 `network.proxyUrl`；未配置时回退环境变量
 * HTTPS_PROXY/HTTP_PROXY；两者皆空则显式恢复直连。
 *
 * 失败语义：任一通道设置失败仅记录警告并继续，绝不阻断主流程 —— 网络不可达类
 * 故障由各调用方的既有超时/重试机制兜底。
 */

import { session } from 'electron';
import log from 'electron-log';
// v0.8.0 P1-4: Agent 浏览器分区的 Pinned 代理状态探测（避免覆盖浏览器通道
// 的 SSRF pinning 代理设置）
import { isPinnedProxyActive } from './pinned-proxy';

const AGENT_BROWSER_PARTITION = 'persist:metona-agent-browser';

/**
 * v0.7.3 P2-1: 代理激活标志（模块级状态，由 applySessionProxy 维护）。
 *
 * SSRF DNS pinning（ssrf-dispatcher）在此标志为 true 时必须退化为"仅入口校验"：
 * 代理模式下 DNS 解析发生在代理服务端，本地无法感知/约束最终连接的 IP，
 * per-request dispatcher 也会旁路用户配置的 ProxyAgent（破坏代理语义）。
 * 已知边界与 M7 结论一致，显式暴露而非隐藏。
 */
let proxyActive = false;

export function isProxyActive(): boolean {
  return proxyActive;
}

export async function applySessionProxy(proxyUrl: string | null | undefined): Promise<void> {
  const envProxy = process.env['HTTPS_PROXY'] || process.env['HTTP_PROXY'] || '';
  const rules = (typeof proxyUrl === 'string' ? proxyUrl.trim() : '') || envProxy;
  proxyActive = rules !== '';

  // ===== 通道一：Chromium sessions =====
  try {
    const config = rules !== '' ? { proxyRules: rules } : { mode: 'direct' as const };
    await session.defaultSession.setProxy(config);
    // v0.8.0 P1-4: agent-browser 分区的代理优先级 ——
    // ① 用户显式配置了代理（rules 非空）→ 用户代理语义优先，覆盖 Pinned 代理
    //   （M7 已知限制口径：该模式下浏览器通道无 pinning）；
    // ② 未配置代理但 Pinned 代理已激活 → 不动该分区（保留浏览器通道 SSRF pinning）；
    // ③ 其余 → 显式直连。
    if (rules !== '' || !isPinnedProxyActive()) {
      await session.fromPartition(AGENT_BROWSER_PARTITION).setProxy(config);
      log.info(
        `[Network] agent-browser partition proxy ${rules === '' ? 'set to direct' : `rules: ${rules}`}`,
      );
    } else {
      log.info(
        '[Network] agent-browser partition left on SSRF pinned proxy (no user proxy configured)',
      );
    }
    log.info(
      `[Network] Chromium default session proxy ${rules === '' ? 'set to direct (no proxy)' : `rules: ${rules}`}`,
    );
  } catch (err) {
    log.warn(
      `[Network] Failed to apply Chromium session proxy "${rules}": ${(err as Error).message}`,
    );
  }

  // ===== 通道二：主进程 Node fetch（undici 全局 dispatcher）=====
  // 动态 import：主进程所有 fetch 出口共享该调度器；setGlobalDispatcher 写入的
  // 全局符号对所有引用同一 undici registry 的 fetch 实例生效。失败不阻断主流程。
  await (async () => {
    try {
      const { Agent, ProxyAgent, setGlobalDispatcher } = await import('undici');
      if (rules !== '') {
        setGlobalDispatcher(new ProxyAgent({ uri: rules, connectTimeout: 15_000 }));
        log.info(`[Network] Node fetch dispatcher → ProxyAgent(${rules})`);
      } else {
        setGlobalDispatcher(new Agent());
        log.info('[Network] Node fetch dispatcher → direct Agent');
      }
    } catch (err) {
      // 理论仅在 undici 原生绑定异常时发生；fetch 将保持默认直连行为
      log.warn(
        `[Network] Failed to set undici dispatcher for proxy "${rules}": ${(err as Error).message}`,
      );
    }
  })();
}