# Go Map Tracker Guide

> Go Map Tracker Guide is an Agent Skill for development published in the MaaEnd/MaaEnd repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

MaaEnd MapTracker 相关组件编写指南。为 agent/go-service/maptracker 下的 Go 代码提供说明，并提供 MapTracker 的开发文档指引。在参与开发 MapTracker 的 Go 代码实现时，或需要了解 MapTracker 详细工作原理时使用。

- Skill name: `go-map-tracker-guide`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/MaaEnd/MaaEnd/blob/HEAD/.claude/skills/go-map-tracker-guide/SKILL.md
- Repository: MaaEnd/MaaEnd (3,413 GitHub stars when collected)

## SKILL.md

# MaaEnd MapTracker 组件编写指南

**MapTracker** 是 MaaEnd 项目中，通过计算机识别方法识别游戏内的地图信息，以提供玩家定位、寻路、导航等功能的组件。

需要注意当前项目中存在两套相似的系统，一套是使用 Go 编写的 MapTracker，另一套是使用 Cpp 编写的 MapNavigator/Locator，两套系统的实现方式完全不同且没有交集，本指南针对的是 Go 版本的 MapTracker，在开发时要区分。

## 参考资料

### 重要文档

当你判断确实正在进行 MapTracker 的开发工作时，*务必无条件地先读取下列文档*以快速了解详细内容：

- docs/zh_cn/developers/components/map-tracker.md 列出了 pipeline JSON 调用方视角下的 MapTracker 的使用方式；
- docs/zh_cn/developers/components/map-tracker(advanced).md 列出了更具体的有关 MapTracker 维护和开发的细节。

## 组件概览

### 核心代码

**Go** 代码位于 agent/go-service/maptracker 目录下，主要包含以下子包：

- default 包：主要提供小地图（游戏画面左上角的实时小地图）识别、寻路的功能，属于核心功能；
    - assert_location：MapTrackerAssetLocation 节点实现；
    - infer.go：MapTrackerInfer 节点实现；
    - move.go：MapTrackerMove 节点实现；
    - 其他辅助文件。
- bigmap 包：主要提供大地图（游戏内打开地图页面时显示的大地图）识别的功能；
    - infer.go：MapTrackerBigMapInfer 节点实现；
    - pick.go：MapTrackerBigMapPick 节点实现；
    - 其他辅助文件。
- internal 包：主要提供一些辅助功能；
    - resource.go：资源加载辅助。
- compatible 包：对 Cpp 方案的兼容层，次要，一般无需维护。

主要的依赖项是 agent/go-service/pkg/minicv 包，提供了定制化的计算机视觉功能，例如模板匹配。

### 工具代码

为了帮助使用者和维护者对地图图片、路线进行快速的操作和可视化，在 tools/map_tracker 目录下提供了一些使用 **Python** 写的工具代码。具体如下：

- \_internal 包：
    - core_utils.py：常用工具函数；
    - gui_pages.py：提供了 GUI 页面实现；
    - gui_widgets.py：提供了可复用的 GUI 组件；
    - http_utils.py：下载相关；
    - location_service.py：依赖于 maa_interface.py 提供工具内调用 MapTracker 定位的功能；
    - maa_interface.py：提供了与游戏交互的接口；
    - pipeline_handler.py：提供了 pipeline JSON 解析的功能；
    - sprite_utils.py：提供了 GUI 中显示图标的能力；
    - zmdmap_schemas.py：提供了 zmdmap 数据解析的功能。
- map_fetcher.py：提供了从 zmdmap 获取最新地图图片的功能；
- map_generator.py：提供了基于最新图片来生成优化后的地图图片和数据的功能；
- map_tracker_editor：向用户提供路线编辑等可视化功能。

---

Source: https://www.openparable.com/skill/development/go-map-tracker-guide (OpenParable). Cite the canonical URL above.
