技术原理与架构实现

一、 架构总览与核心设计

Local-AI-Route 基于 Tauri v2 + Rust 构建，专为桌面 AI 打造免 TUN、免改系统代理的进程级路由工具。

• 免全局 TUN / 免改系统代理：不改系统网络与注册表，避免 VPN 冲突与内网污染；无须高权限虚拟网卡驱动，常驻待机内存约 20MB。
• 微内核设计：Rust 直接调用底层原语（Win32 / POSIX），实现微秒级进程派生与状态观测。

二、 进程级网络接管机制

针对 Electron/Chromium 与混合架构，从启动阶段完成参数与环境接管：

1. Chromium 网络栈注入：主进程启动时注入 --proxy-server=<url> 与 --proxy-bypass-list=<rules>，接管页面核心 HTTP/HTTPS/WebSocket 流量。
2. 强制禁用 UDP QUIC（--disable-quic）：针对 AI 依赖的 SSE 长连接，规避本地代理对 UDP QUIC 握手丢包或超时，强制降级至稳定 TCP 隧道，消除断连与白屏。
3. 多层级环境变量穿透：IDE（Antigravity/Cursor）的代码补全与 Agent 运行于独立 LSP 进程（language_server）。启动前全量注入 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY、NO_PROXY 与 NODE_USE_ENV_PROXY=1，确保子进程环境继承。

三、 跨平台二进制发现与消歧

1. Windows MSIX 真实路径穿透：针对商店版应用，规避虚拟执行别名（Execution Alias）丢弃命令行参数的缺陷，遍历注册表 AppModel\Repository\Packages 定位真实物理路径。
2. Squirrel 动态版本自愈：Claude 等目录随更新变动（app-x.y.z/），引擎内置版本比较算法，自动重定向至最新二进制。
3. 严格应用消歧：通过注册表签名与路径交叉比对，严格区分 Antigravity 独立客户端与 Antigravity IDE。
4. macOS / Linux：解析 Info.plist 的 CFBundleExecutable；Linux 依据 XDG 规范解析 .desktop 与系统 PATH。

四、 双层安全生命周期管理

1. 优雅退出优先：Windows 广播 WM_CLOSE，Unix 发送 SIGTERM，触发客户端内置保存机制，保障未保存草稿完整。
2. PID 进程树拓扑追踪：针对 Electron 托盘残留，构建进程 DAG 图，超时或重启时递归回收孤儿进程。
3. 四态状态机：实时比对参数，精确区分 Stopped、RunningDirect、RunningProxied 与 RestartNeeded。

五、 四维立体连接诊断引擎

1. 上游隧道探测：经本地代理向探测点握手，明确区分网络超时与 HTTP 403（403 证明 TCP/TLS 代理隧道完全正常，仅为上游 WAF 拦截）。
2. 主进程命令行核验：实时抓取进程启动参数，校验 --proxy-server 与当前配置端口一致性。
3. LSP 子进程环境核验：下钻提取 language_server 内存 environ 表，验证 HTTPS_PROXY 继承生效。
4. 内核级 TCP 连接快照：调用 Win32 IP Helper API（GetExtendedTcpTable）直读内核网络表，精准高亮直连代理端口的 ESTABLISHED 连接。
5. 隐私脱敏：导出报告时自动正则替换用户家目录为 %USERPROFILE%。

https://github.com/skyline-e/Local-AI-Route