WestLocksmithSpout/Gemini-Config-Checker-

项目介绍

普通 HTTP 请求从哪个国家发都会返回「正常」，所以常规连通性探测会把所有活着的配置都标成健康。这个工具改用一个已登录 Google 账号的真实浏览器逐条访问 AI Studio 和 Gemini，读取 Google 对该账号给出的结论：AI Studio 跳到 /docs/available-regions，或 Gemini 显示「当前国家不支持」(为什么需要登录浏览器)。

它有两种模式。Simple 直接测试你粘贴的配置或订阅里的配置，回答「哪些配置能用」。Advanced 先拿一条能用的 base 配置，再把免费配置链在它后面，回答「哪些免费配置能通过我的配置出去」，适合 Cloudflare 配置能连但出口被 Google 拦的情况。结果可以导出成分享链接、base64 订阅或完整 Xray JSON，供 v2rayN、PattN 等客户端导入(使用指南)。

快速使用

1. 从 Releases 下载对应平台的构建。Windows 解压 gemini-config-checker-desktop_<version>_windows_amd64.zip 后运行 GeminiConfigChecker.exe；Linux 需先安装 libgtk-3-0 和 libwebkit2gtk-4.1-0，也可以用 web server 构建后打开 http://localhost:8787。
2. 在顶栏选择 Simple 或 Advanced。
3. 点 Sign in with Google，会打开一个独立的 Chrome/Edge/Brave 配置目录完成登录；应用看不到密码，点 Remove account from app 只会删除这个独立配置。
4. Simple 模式下每行粘贴一条 vless://、vmess://、trojan:// 或 ss:// 链接，也可以填订阅地址；留空则测试内置的免费列表。
5. 点 Start scan，在 Results 页查看 Healthy、Region blocked 或 Error，以及 AI Studio 和 Gemini 分列的结果和延迟。

Android 无法驱动已登录浏览器，APK 只提供连通性检测，不能验证区域。

使用约束

• 项目目前是 0.1.0 早期预发布版，只在 Windows 上做过端到端运行；macOS、Linux 和 Android 构建来自 CI，尚未在真机验证。
• 区域检测需要 Chrome、Edge、Brave 或 Chromium。Flatpak 版本的浏览器无法被驱动；放在非标准路径的浏览器通过 GCC_BROWSER 或 CHROME_BIN 指定。
• 区域模式每条配置约 20–40 秒，每个并发浏览器检查约占用 200 MB 内存，默认同时 4 个；连通性模式更快但不检查区域。
• Web server 没有身份认证，只监听 127.0.0.1，需要远程访问时用隧道而不是直接暴露。
• 桌面构建未签名，Windows SmartScreen 和 macOS Gatekeeper 首次启动会告警。
• 检测结果是抽样而非保证：Cloudflare Worker 的出口可能每次连接都变，同一配置可能这次通过、下次失败，长期使用前需复测。
• 免费配置由未知第三方运营，不要通过它们传输敏感数据。GitHub 元数据标注 Apache-2.0，README 则写项目为 MIT，内置 Xray-core 保持 MPL-2.0。

HotRepo 点评

该项目在 2026-11-15 的新项目榜上出现，约 1.5 小时的观察窗口内新增 278 星、0 Fork。这是一次早期快速冲高，时间序列不足以判断趋势，也没有 GitHub 全部语言日榜名次可参照。对一个核心价值就是「浏览器里读 Google 判定」的工具来说，目前只有 Windows 跑通端到端是个明显缺口，其他平台的构建结果在作者报告真机测试前应当视为未验证。项目也明确把 anti-DPI 配方和扫描逻辑归功于其他维护者的工作(致谢)。