如何为 MaaEnd 贡献代码从搭建环境到提交第一个 PR 的完整指南【免费下载链接】MaaEndMaaEnd 终末地小助手基于视觉 AI 的「明日方舟终末地」自动化工具项目地址: https://gitcode.com/gh_mirrors/maa/MaaEndMaaEnd 终末地小助手是一款基于视觉 AI 的「明日方舟终末地」自动化工具通过模板匹配、OCR 等画面识别能力自动执行游戏操作。为 MaaEnd 贡献代码并不要求你会写底层代码——绝大多数贡献都是Pipeline 低代码节点JSON 配置看懂截图、会写 JSON 就能上手。本文带你走完从环境搭建、编码规范到提交第一个 PR 的完整流程并给出常见坑的避坑指南。1. 先认识 MaaEnd 贡献的三种形态贡献形态位置说明Pipeline 低代码assets/resource/pipeline/识别画面 → 执行操作的 JSON 节点最主流的贡献方式Go Serviceagent/go-service/处理 Pipeline 难以实现的复杂算法如价格比较、网格识别Cpp Algoagent/cpp-algo/单个高性能识别算法一般开发者很少改动一句话原则Pipeline 管流程Go 管难点。写新节点前先看 组件指南 确认有没有现成可复用的节点避免重复造轮子。2. 快速搭建 MaaEnd 开发环境环境清单工具版本要求用途Git最新稳定版代码管理本项目依赖子模块uv最新稳定版自动管理 Python 3.10 与脚本依赖Node.js22项目脚本pnpm10前端依赖与格式化Go1.25.6编译 go-service可用git --version、uv --version、node --version、pnpm --version、go version逐条检查。拉取代码并初始化git clone --recursive https://gitcode.com/gh_mirrors/maa/MaaEnd cd MaaEnd uv run setup-workspace pnpm installuv run setup-workspace会自动下载 MaaFramework、MaaDeps 等依赖并编译 go-service首次初始化时已安装的组件会自动跳过后续可用--update强制更新。完整的参数说明与手动配置指南见 快速开始文档。编辑器推荐 VS Code打开仓库根目录后安装工作区推荐扩展入口在 .vscode/extensions.json其中Maa Pipeline Support插件是日常开发利器——截图、框选 ROI、取色全靠它。3. MaaEnd 编码规范核心要点提交任何代码前必须先通读 编码规范不合规范的 PR 会被直接打回。这里提炼最关键的几条Git 提交规范Conventional Commits每次提交使用固定前缀方便 Reviewer 快速理解意图feat:新增功能fix:修复 Bugdocs:仅文档更改style:不影响含义的格式化chore:构建或辅助工具变动示例feat(OutpostTrading): 新增地区建设自动售卖 Pipeline。分支命名同理feat/简短描述、fix/简短描述。Pipeline 低代码规则新手最容易踩雷命名节点名 PascalCase 并以模块名作前缀如OutpostTradingSelectItem。禁止硬延迟不要滥用pre_delay、post_delay、timeout。需要等画面稳定时用pre_wait_freezes/post_wait_freezes其余情况靠增加中间识别节点解决——延迟只会掩盖问题用户设备上照样不稳。识别 → 操作 → 再识别每一步点击都必须基于识别结果像写状态机一样思考。严禁整体识别一次后连点多次。坐标基准 1280×720所有模板图与 ROI 坐标以 720p 为基准运行时由框架自动适配。OCR 写完整文本expected默认写完整句子多语言交给 i18n 工具链自动处理。不盲目重试项目明确拒绝死循环式重试和掩盖失败式重试遇到 Bug 要定位到具体失败节点去修补。提交前格式化默认只需格式化不必在本地跑全量检查pnpm format # JSON/YAML 格式化 pnpm format:go # 改了 agent/go-service/ 时执行 pnpm format:md # 改了 md 文档时执行只有当改动包含tests/**新增/修改测试用例、截图、hits/box期望时才需在本地先跑pnpm test其余改动交给 PR 的 CI 校验即可详见 提交前检查章节。4. 开发调试工具与常见坑调试工作流修改 Pipeline JSON 后在开发工具中重新加载资源即可无需重编译修改agent/go-service/后必须重新编译uv run build-and-install复杂地图路线可用配套 Web 工具 MapNavigator 录制uv run map-navigator启动后自动打开浏览器录制的坐标可直接粘贴进 Pipeline 参数工具说明见 tools/MapNavigator/README.md。新手必看的常见坑坑处理办法Git 状态里出现没改过的子模块修改执行git submodule update --init --recursive同步指针改了 Go 代码却没生效忘了uv run build-and-install模型或 C 依赖目录缺失uv run setup-workspace --update本地能跑、别人环境不行检查是否开了 HDR / 滤镜、帧率与 GPU 差异资源目录出现下划线开头的文件夹Android 打包无法处理必须改普通命名完整坑位清单见 编码规范文末表格。5. 提交你的第一个 PR 完整步骤确认需求在 Issue 区找到或创建需求确认没人正在做Fork 并建功能分支git checkout -b feat/your-feature尽早开 Draft PR标题写清楚在做什么避免他人重复劳动完成开发并 push按上述规范编码、格式化后git push origin feat/your-feature改为 Ready for Review选择目标分支等待维护者 review跟进 CI 状态pnpm check、pnpm test等检查由 CI 自动执行。PR 该往哪个分支提分支用途允许合入的类型v2主开发分支所有类型feat / fix / docs …release/vX.Y当前发布分支仅fix简单判断这个 Bug 在最新正式版里也存在吗存在就往release/vX.Y提合入后 CI 会自动 cherry-pick 回v2不需要你提两个 PR其余日常开发默认往v2提。详细说明见 发版流程文档。写在最后到这里你已经具备了向 MaaEnd 提交代码的全部知识。建议按 开发者文档索引 的阅读路线继续深入零基础先读 超基础入门再跟 快速开始 跑一个完整示例写节点测试时查 节点测试文档。项目还有一个开发交流群欢迎加入祝你的第一个 PR 顺利合入 【免费下载链接】MaaEndMaaEnd 终末地小助手基于视觉 AI 的「明日方舟终末地」自动化工具项目地址: https://gitcode.com/gh_mirrors/maa/MaaEnd创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考