代理启动器（ProxyLauncher）

本项目已链接认可 LINUX DO 社区。

一个 macOS 原生小工具：设置好代理地址后，把应用添加进列表，从这里启动的应用会自动注入 HTTP_PROXY / HTTPS_PROXY / ALL_PROXY / NO_PROXY 环境变量，让 Antigravity、Claude 等应用的后台进程（如 language_server）直接走 Clash 本地端口，无需开启 TUN 模式。

原理：应用启动前注入标准代理环境变量，只影响被启动的应用，不修改系统全局代理。

下载安装

从 Releases 下载最新的 ProxyLauncher-x.x.zip，解压后把 代理启动器.app 拖进「应用程序」文件夹。 支持 Apple Silicon 和 Intel（Universal），需要 macOS 13 或更高。

首次打开：本应用没有 Apple 开发者签名，直接双击会提示"无法验证开发者"。 解决方法（任选其一）：

• 打开「系统设置 → 隐私与安全性」，在底部找到被拦截的提示，点「仍要打开」；
• 或在终端执行：xattr -cr /Applications/代理启动器.app，之后正常双击即可。

不想用现成包的话，克隆仓库跑 ./build.sh 自己构建（只需 Xcode 命令行工具）。

使用

1. 先打开 Clash Verge 等代理软件（默认混合端口 7890）。
2. 双击 dist/代理启动器.app 打开。顶部绿点表示代理端口已连通。
3. 点「添加应用」或直接把 App 拖进窗口添加（可多选）。
4. 点某个应用的「启动」即可带代理启动。若该应用已在运行，会提示「退出并重新启动」 （环境变量只在启动那一刻生效）；若代理端口不通，会先提醒。
5. 建议把 代理启动器.app 拖进「应用程序」文件夹，方便从启动台打开。

功能

• 独立启动器生成：应用行悬停的 ⬇ 图标（或右键菜单）可生成 XXX（代理）.app， 用原应用图标，放进 Dock / 启动台后双击即带代理启动，不用先开本工具。 启动器从 ~/Library/Application Support/ProxyLauncher/proxy.env 读取代理地址， 在主界面改了设置后所有启动器自动同步，无需重新生成。
• 测出口：经代理查询出口 IP、国家/城市和运营商，快速判断节点地区是否符合要求 （如「当前地区不支持」类报错）。依次尝试 ipwho.is / api.ip.sb / ip-api.com， 单个接口限流会自动换下一个。
• 自动探测端口：扫描 7890 / 7897 / 7891 / 1080 / 2080 / 8889 / 8118 / 10808 / 10809， 找到可连通的端口自动填入。启动时端口连不通会自动探测；运行中每 6 秒复查， 发现断开（如代理软件换了端口）也会自动重新探测切换。当前设置的端口优先， 能用就不会被改掉。
• 菜单栏常驻：勾选后菜单栏出现 ✈️ 图标，关掉窗口不退出、从 Dock 隐藏， 随时从菜单栏一键启动任意应用。
• 全部启动：一键带代理启动列表里所有未运行的应用。
• 右键应用行：带代理启动、生成启动器、复制等效终端命令、在访达中显示、移除。
• 所有设置自动保存；只影响由本工具（或生成的启动器）启动的应用，不修改系统全局代理。

重新构建

./build.sh        # 产物在 dist/代理启动器.app

只需要 Xcode Command Line Tools（swiftc），不需要完整 Xcode。

文件说明

• Sources/main.swift — 全部应用代码（SwiftUI）
• Info.plist — 应用包信息
• make-icon.swift — 构建时生成图标
• build.sh — 编译 + 打包 + ad-hoc 签名

注意

• 目标应用更新后路径不变，启动器继续可用；若应用被移动/改名，需重新生成启动器。
• 代理环境变量只对「从本工具或启动器启动」的进程生效，从 Dock 直接打开不走代理。