WingDataVacuum/Gemini-Config-Checker-

项目介绍

Gemini Config Checker 用来测试代理配置（vless、vmess、trojan、ss）能否真正访问 Google AI Studio 和 Gemini，并列出哪些线路可用。普通的 HTTP 探测不可靠：Google 是在页面加载之后按登录账号决定区域可用性的，HTTP 请求可能把每条存活配置都判为健康。因此工具会驱动一个独立的 Chromium 配置，由你登录后打开 AI Studio 和 Gemini，读取两类拦截信号——AI Studio 跳转到 /docs/available-regions，或 Gemini 显示不支持当前国家/地区（为什么需要已登录浏览器）。

两种模式共用一个开关：

• Simple：测试你自带的配置或现成的免费列表，按从本机直连的路径测试。
• Advanced：把免费配置串在一条可用的基础配置后面，让免费配置从该基础配置的出口出去，从而获得 Google 可能接受的另一个出口。

它还提供 anti-DPI 配置（拆分 TLS ClientHello 等），用于普通配置连不通的网络；结果可以导出为分享链接、base64 订阅或可直接导入的 Xray 配置。

快速使用

1. 从 Releases 页面 下载对应平台的构建包，每个版本附带 SHA256SUMS.txt。
2. Windows：解压后运行 GeminiConfigChecker.exe（Windows 10/11 自带 WebView2，构建未签名，SmartScreen 可能提示）。macOS：把 .app 放进 Applications，首次启动右键选择打开。Linux：安装 libgtk-3-0 和 libwebkit2gtk-4.1-0，解压 tar 包后运行 ./GeminiConfigChecker。
3. 打开 Scan 标签页，每行粘贴一条配置（vless://、vmess://、trojan://、ss://），也可以填订阅 URL 或 base64 文本；留空则测试内置的免费列表。
4. 点击 Sign in with Google，会打开一个独立的 Chrome / Edge / Brave 配置，在其中正常登录；检测到登录后窗口自动关闭。应用不会接触你的密码。
5. 点击 Start scan（或 Ctrl+Enter），在 Results 标签页查看结果。

Android 提供 arm64-v8a 的 APK，但只能运行连通性模式，因为 Android 不允许应用驱动已登录的 Chromium，无法核验区域。web server 构建在 http://localhost:8787 提供同样的界面（下载与安装）。

使用约束

• 区域检测需要 Chrome、Edge、Brave 或 Chromium；Flatpak 版浏览器无法被驱动。没有浏览器时只能切到连通性模式，它只证明线路可达，不检查区域。
• 每条配置的区域检测约需 20–40 秒，每个并发的浏览器检测约占 200 MB 内存；默认并发为 4 个浏览器检测和 20 个连通性测试，单次最多测试 60 条配置。
• 结论是采样而非保证。Cloudflare Worker 的出口可能在不同连接之间变化，同一线路现在通过、稍后可能失败，依赖前应重新测试。
• 构建未签名，web 界面没有身份认证，应只监听 localhost 或通过隧道访问，不要直接暴露。免费配置由未知第三方运营，对方能看到流量目的地。
• 桌面端目前只在 Windows 上完整跑通；macOS、Linux 和 Android 构建来自 CI，尚未在真机验证。README 声明许可证为 MIT，而仓库元数据显示 Apache-2.0，再分发前需要核实。
• README 顶部有一个 Dropbox 上的 .rar 下载按钮，与 Releases 说明并存；该压缩包的内容和来源没有说明，优先使用带校验和的 Releases 资产。

从源码构建

需要 Go；桌面版还需要 Wails v2 和平台 webview；Android 需要 Android SDK、JDK 17+ 和 Gradle 8.10。Makefile 提供 make web、make desktop、make android、make dist VERSION=<version> 和 make test（从源码构建）。

HotRepo 点评

这是一个新建仓库，解决的问题很窄也很具体：用真实的登录态浏览器验证代理线路能否进入 Google AI Studio 和 Gemini，而不是靠通用连通性探测。技术上的关键点在于读取 Google 自己的拦截信号，而不是相信 ping 结果。局限同样明确：桌面端目前只在 Windows 上完整跑通，区域检测依赖桌面 Chromium，且结论可能随连接变化。使用或再分发前，下载入口和许可证元数据的不一致值得核对。