UniteSupporter/Gemini-Config-Checker-

项目介绍

Gemini Config Checker 是一个扫描代理配置的工具，用来判断哪些配置能让用户在受支持的地区访问 Google AI Studio 和 Gemini。它的核心思路是：Google 按登录账号判断地区可用性，普通 HTTP 探测会得出误导性结果，因此工具会启动一个独立的 Chrome / Edge / Brave 配置，完成登录后读取 Google 实际展示的内容——AI Studio 跳转到 /docs/available-regions，或 Gemini 提示所在国家不可用（为何需要登录态浏览器）。

交付形态包括 Wails 桌面应用、本地 Web UI 和 Android APK。Simple 模式检测手中一批配置或现成免费列表；Advanced 模式把免费配置串联在一个可用的基础配置之后，以获得不同的出口。引擎支持解析 vless://、vmess://、trojan://、ss://、订阅链接和 base64，并可应用来自 PattN 方案的 anti-DPI 分片配置（anti-DPI 配置）。

快速使用

1. 从 Releases 下载对应平台的构建，发布页附带 SHA256SUMS.txt。
2. Windows 解压后运行 GeminiConfigChecker.exe（WebView2 内置于 Windows 10/11）；Linux 需先安装 libgtk-3-0 和 libwebkit2gtk-4.1-0；macOS 右键应用选择打开。
3. 在 Scan 标签选择 Simple 模式，每行粘贴一个配置（订阅链接或 base64 文本也可），只有在普通 Cloudflare 配置无法连接时才保留 Anti-DPI。
4. 点击 Sign in with Google，在打开的独立浏览器窗口中完成登录，应用检测到后自动关闭窗口。
5. 点击 Start scan，在 Results 标签查看结果：每个配置会标记为 Healthy、Region blocked 或 Error，并分列显示 AI Studio 与 Gemini 的检测结论和延迟。
6. 在 Export 标签复制分享链接或导出可直接导入的 Xray 配置；客户端支持 finalmask 时选 PattN 变体，否则选标准变体会移除该字段。

没有浏览器时，可将检测类型切换为 connectivity only，此时只验证连通性、不校验地区（设置说明）。Web 服务版运行在 http://localhost:8787，提供同一套界面（Web 服务）。

使用约束

• 地区检测需要应用能找到 Chromium 系浏览器，Flatpak 版浏览器无法驱动；每个浏览器检查约占 200 MB 内存，小内存机器应降低并发数。
• Android 版只能运行连通性模式，系统不允许应用驱动已登录的 Chromium。
• 版本 0.1.0 为早期预发布，只有 Windows 经过端到端验证，macOS、Linux 和 Android 构建来自 CI，尚未在真机上运行。
• 桌面构建未签名，Windows SmartScreen 和 macOS Gatekeeper 会拦截提示；未配置仓库密钥时 Android APK 可能使用一次性密钥签名，导致后续版本无法覆盖安装。
• 本地 Web UI 没有鉴权，应只监听本机或通过隧道访问。
• anti-DPI 配置在未过滤的网络中只会增加延迟。
• 检测结果只是采样：Cloudflare Worker 的出口可能在连接之间变化，同一配置可能先通过后失败。

HotRepo 点评

该仓库在 2026-11-15 进入 HotRepo 新项目榜，记录窗口内新增 192 Star，Fork 数为 0。观察窗口很短，不足以说明持续关注度。技术上值得注意的一点是用登录态浏览器而非 HTTP 探测来判断地区可用性，这对这类工具是有意义的区分；README 也明确标注非 Windows 构建尚未在真机验证，这些平台上的早期使用者应预期会有粗糙之处。

许可证

MIT，内置的 Xray-core 与字体沿用各自许可证（许可证）。