WireProvostPucker/Gemini-Config-Checker-

项目介绍

这个工具用真实登录态的 Chromium 浏览器逐个打开 AI Studio 和 Gemini 来检验代理线路，因为 Google 是登录后按账号判定地区可用性的。简单 HTTP 探测会对任何活着的线路返回正常，所以它改为读取 Google 的实际结果：AI Studio 跳转到 /docs/available-regions，或 Gemini 显示「Gemini isn't currently supported in your country」，即判为被墙。输入支持 vless://、vmess://、trojan://、ss:// 链接、订阅地址和 base64 文本。

Simple 模式检测你已有的配置；Advanced 模式把免费配置链在一条可用的基础配置之后，用来换一个 Google 能接受的出口。可选的 anti-DPI 配置复刻了一套公开的分片方案，供受限网络中使用。

快速使用

1. 从 Releases 下载对应平台包：Windows amd64/arm64 zip、macOS universal zip、Linux amd64 tar 包或 Android arm64 APK。每个发布都附 SHA256SUMS.txt。
2. Windows 解压后运行 GeminiConfigChecker.exe（构建未签名，SmartScreen 可能要求确认）；Linux 解压后执行二进制。
3. 首次启动在地区检测设置里点 Sign in with Google，会打开一个仅本应用使用的 Chrome / Edge / Brave 独立配置目录，用该登录态读取 AI Studio 和 Gemini。没有可用浏览器时，把检测类型切到 connectivity only，它只证明可达、不验证地区。
4. 进入 Scan 标签，粘贴配置（每行一条），或留空改用内置免费列表；除非所在网络需要，否则保持 anti-DPI 关闭，按 Start scan（Ctrl+Enter）。
5. 在 Results 查看结果：健康/已连接、地区受限（附带各产品状态）或错误。用复制按钮或 Export 标签导出分享链接、base64 订阅或 Xray JSON。

同一套引擎也提供 Web server 构建，界面运行在 http://localhost:8787。

使用约束

• 地区检测需要本机装有可被驱动的 Chrome、Edge、Brave、Chromium、Vivaldi 或 Opera，Flatpak 版浏览器无法驱动。每个并发浏览器检测约占用 200 MB 内存，单条地区检测耗时约 20–40 秒。
• Android 只能做连通性检测，因为系统不允许应用驱动已登录的 Chromium。macOS、Linux 和 Android 构建来自 CI，尚未在真机验证；只有 Windows 被说明为完整跑通过。
• Web server 不带认证，应只监听 localhost 或通过 SSH 隧道访问，不要直接暴露端口。
• 结果是采样而非保证：Cloudflare Worker 的出口可能在连接之间变化，同一条线路这次通过、下次可能失败。免费配置由未知第三方运营，不适合传输敏感数据。
• README 写的是 MIT，仓库元数据显示 Apache-2.0；内置的 Xray-core 保持 MPL-2.0，字体保持 SIL OFL。

从源码构建

需要 Go；桌面版还需 Wails v2 和平台 webview（WebView2、WebKit，或 GTK 3 + WebKitGTK 4.1）。Android 需要 Android SDK、JDK 17+ 和 Gradle 8.10。Make 目标覆盖各变体：make test、make web、make desktop、make android，以及 make dist VERSION=0.1.0。

HotRepo 点评

仓库在 2026-11-15 的新项目榜记录里约 1.5 小时涨了 268 Star，Fork 为 0，也没有 GitHub 全部语言日榜名次。观察窗口很短且只有一次记录，只能说明早期涨星很快，不足以判断趋势。README 里真正值得评估的是实现细节：在连接前加一个本地转发器，补上原版 xray-core 不支持的按分段 lengths 做分片；导出时可区分是否携带 finalmask 的目标客户端格式；以及以登录态浏览器作为判定依据的做法。另一方面，README 顶部放置的 Dropbox 压缩包入口与正文的 Releases 下载说明不一致，也未说明它与仓库源码的关系，选择安装包时应以 Releases 和 SHA256SUMS.txt 为准。