GMT-N 使用说明

GMT-N 是基于原作者 761696148 的 Game-Map-Tracker 做的体验优化版。感谢原作者提供 GMT 的基础能力与开源项目，本版本主要围绕日常跑图体验、路线管理和地图标注功能做补充。

当前 GMT-N 仅保留 SIFT 视觉定位；AI 方案运行代码已移除，设置界面中的 AI 区块仅作为未来重新接入的占位。

快速开始

1. 解压发行包，双击 GMT-N.exe 启动。
2. 首次启动会要求选择游戏小地图区域：左键拖动框选，滚轮缩放，按回车或双击确认。
3. 程序会显示在屏幕顶部，鼠标悬停可展开地图和路线面板。
4. 点 锁定 或按 Alt+` 可开启鼠标穿透，避免悬浮窗影响游戏操作；再次按 Alt+` 解锁。
5. 如果定位偏了，点 重定位，或在地图上双击正确位置进行手动校准。

常用功能

• 实时跟点：自动识别游戏小地图，在大地图上显示当前位置。
• 地图窗口：支持滚轮缩放、左键拖动、双击重定位。
• 路线管理：可搜索路线、勾选追踪路线、重置路线进度。
• 路线编辑：可新建分类/路线，重命名、删除、添加说明；地图右键可把点加入当前路线。
• 地图标注：可显示/隐藏不同类型标注，手动新增、更改、删除标注点。
• 标注拉取：设置中可拉取 17173 图标和标注点位。
• 标注生成路线：可根据某类标注生成一条参考路线，再按实际地形自行调整。

与 GMT 的主要不同

项目	GMT	GMT-N
定位方案	原项目提供多种定位方案	当前发行版仅保留 SIFT；AI UI 占位待未来接入
使用侧重点	提供完整的地图实时跟点基础能力	更偏向日常跑图时的交互和路线管理体验
路线功能	已有路线相关能力	增强路线列表、分类、说明、优化节点编辑等操作
标注功能	以原项目基础能力为核心	增加/整理地图标注拉取(从17173地图拉取，感谢)、标注管理、标注生成路线等功能

GMT-N 不是为了取代原 GMT，而是在原项目基础上按个人使用习惯做了一些体验优化。

注意事项

• 如果更换分辨率、游戏窗口位置或小地图 UI，建议在设置里重新选择小地图区域。
• 拉取标注 会在 annotations/ 下生成新的标注文件，不会覆盖当前正在使用的标注文件。
• 标注生成的路线无法判断高低差、障碍物和实际可通行路径，只适合作为参考。
• 发布包不内置、不预选第三方底图或标注文件；请把自行取得的底图放入 maps/、标注文件放入 annotations/，再到设置窗口选择。底图保存后需要重启生效。
• 请尽量不要删除 config.json、routes/、annotations/、tools/、maps/ 等程序数据文件或目录。

文件位置

• main_island.py：程序入口；开发时可在项目根目录运行 python main_island.py。
• config.py、config_defaults.py：运行配置、默认配置和底图路径管理。
• ui_island/：悬浮窗 UI、路线管理、更新检查、地图视图等应用代码。
• Plan_SIFT/：SIFT 定位引擎。
• packaging/：PyInstaller 打包配置文件。
• tools/：点位拉取、路线转换、地图下载等辅助工具和工具数据。
• scripts/：构建、发布、更新器和配置生成脚本。
• routes/：路线、分类、路线进度等数据。
• maps/：底图图片位置。用户可以自由放入并选择自定义底图；路线和标注按文件中的原始 x/y 像素坐标绘制，自定义底图可能导致点位偏移。
• annotations/：用户选择或拉取生成的地图标注数据文件。
• config.json：窗口、小地图区域、路线显示等设置。