## 什么是 GeoHelper？ **GeoHelper** 是一款专为 **Steam 上的 GeoGuessr** 设计的简洁、可定制的桌面辅助工具。 它能实时显示回合信息：坐标、国家、地区、道路、邮编、国旗和地图预览。 非常适合 **自定义地图、单人游戏、独自练习以及学习地理**。 ### 核心功能 - 精美、可拖拽和调整大小的窗口小部件，支持完全自定义布局 - 强大的自定义主题系统（JSON + CSS 变量） - 实时坐标和丰富的地理位置数据 - 地图预览（默认使用 OpenStreetMap，同时支持 Google Maps） - 体积极小（约 6MB），这得益于 **Tauri** - 无注入、无 DLL、无浏览器扩展——使用 Steam 自身的 Chrome DevTools Protocol (CDP) ## 工作原理 GeoHelper 连接到由 Steam 暴露的 Chrome DevTools Protocol 端点（`--remote-debugging-port=9222`），并读取游戏自身的网络 RPC 流量。所有处理均在您的机器上本地完成。 ## 快速开始 1. 从 [发布页面](../../releases/latest) 下载最新版本 2. 在 Steam 中右键点击 **GeoGuessr** → 属性 → 启动选项，并添加： --remote-debugging-port=9222 3. 运行 GeoHelper 并开始游戏 **支持平台：** Windows 10/11、Linux、macOS 11+ ### Linux 依赖项 Ubuntu/Debian 构建通常会自动从 `.deb` 包安装所需的 WebKitGTK 依赖项。在 Arch 系发行版（如 Arch Linux 和 CachyOS）上，请先安装运行时依赖项： ``` git clone https://github.com/wiktorekdev/geohelper.git cd geohelper/packaging/arch makepkg -si ``` 如果您更倾向于直接运行 AppImage 或原始二进制文件，请手动安装运行时依赖项： ``` sudo pacman -S --needed webkit2gtk-4.1 libsoup3 gtk3 libayatana-appindicator ``` 如果您在 Arch/CachyOS 上从源代码构建 GeoHelper，请安装完整的 Tauri 开发依赖集： ``` sudo pacman -S --needed webkit2gtk-4.1 base-devel curl wget file openssl appmenu-gtk-module libappindicator-gtk3 librsvg xdotool ``` ## 自定义 点击铅笔图标进入 **编辑模式**： - 将窗口小部件拖放到屏幕任意位置 - 切换和调整单个窗口小部件的大小 - 自定义主题（内置主题 + 通过 `themes.json` 完全自定义） - 每个窗口小部件的样式设置（颜色、字体、内边距等）

## 地图提供商 | 功能 | OpenStreetMap（默认） | Google Maps（可选） | | ------------ | ----------------------- | ------------------------ | | 可用性 | 内置 | 需要 API 密钥 | | 价格 | 完全免费 | Google Cloud 免费套餐 | | 样式 | 多种 CartoDB 样式 | 道路图、卫星图、暗色主题 | ## 从源代码构建 ``` npm install npm run dev # development with hot reload npm run build # create release builds ``` ## 免责声明 这是一个 **个人学习与练习工具**。 在排名或竞技模式中使用辅助工具违反 GeoGuessr 的服务条款，并可能导致封号。请负责任地使用。 ## 许可证 [MIT 许可证](LICENSE)

标签：GeoGuessr助手, Steam工具, Tauri框架, 单人游戏辅助, 可拖拽界面, 可视化界面, 国家识别, 国旗展示, 地区信息, 地图预览, 地理教育, 坐标追踪, 学习地理, 实时信息显示, 无注入技术, 桌面应用程序, 游戏辅助工具, 练习工具, 自动化攻击, 自定义主题, 跨平台支持, 轻量级应用, 道路信息, 邮编显示