VolumePhoenixDeem/Gemini-Config-Checker-

项目介绍

Gemini Config Checker 用真实登录的浏览器打开 Google AI Studio 和 Gemini，读取 Google 是否弹出地区限制，从而判断某条代理配置能不能用。普通 HTTP 探测对所有存活配置都会返回正常，因为地区可用性是 Google 在页面加载后按登录账号判定的，所以工具选择用浏览器会话作为判据。

它有两种模式。Simple 用于测试你手上已有的一批配置或内置免费列表，看哪些能通；Advanced 把免费配置串在一条可用的基础配置后面，寻找 Google 能够接受的另一个出口。输入格式支持 vless://、vmess://、trojan://、ss://、订阅链接和 base64 文本。

适合已经持有代理配置、需要确认哪条能访问 Gemini 与 AI Studio 的用户，不是通用网络诊断工具。

快速使用

1. 从 Releases 页面 下载对应平台的构建产物。桌面版覆盖 Windows amd64/arm64、macOS 通用包和 Linux amd64；Android APK 仅支持 arm64-v8a。
2. Linux 先装运行库：sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0，也可以改用 Web 服务器版本后打开 http://localhost:8787。
3. 启动应用，保持默认的 Simple 模式，在输入框里每行粘贴一条配置；留空则扫描内置免费列表。
4. 点击 Sign in with Google，会打开一个独立的 Chrome/Edge/Brave 配置目录，登录成功后窗口自动关闭。
5. 点击 Start scan，在 Results 标签查看结果。地区模式每条配置大约 20–40 秒；只想知道线路是否可达时可选 connectivity only。

从源码构建的方式见 构建说明：make web、make desktop、make android、make dist VERSION=0.1.0。

使用约束

• 地区检测依赖 Chrome、Edge 或 Brave，Flatpak 版浏览器无法驱动；没有可用浏览器时可切到仅连通性模式，但该模式不验证地区。
• 桌面版未签名：Windows 可能出现 SmartScreen 提示，macOS 可能需要右键打开或移除隔离属性。
• 端到端只在 Windows 上实际跑通过，macOS、Linux 和 Android 构建来自 CI，尚未在真机验证。
• Android 无法驱动登录状态的 Chromium，只支持连通性模式。
• 免费配置由未知第三方运营，README 建议不要通过它们传输敏感流量。
• Web 服务器没有认证，必须只监听本机或通过 SSH 隧道访问。
• LICENSE 文件声明 MIT，而仓库元数据标为 Apache-2.0，两者不一致。

HotRepo 点评

该项目在 2026-11-15 首次出现在新项目榜，首个统计窗口内新增 192 星、0 Fork，起步涨幅明显，但只有一条快照，不足以判断热度能否持续。对读者真正有价值的是设计取舍：读取登录状态浏览器里 Google 自己的地区页面，而不是依赖延迟或 HTTP 状态码，这与 README 描述的地区按账号判定的行为一致。