如何为 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），仅供参考
企业数字化 ERP 产品动态
相关推荐
跨境女装短视频怎么降本？从AI数字人到爆款复刻的实操方法 TikTok 女装赛道的竞争，正在从“有没有产品”转向“能不能持续产出内容”。
同一款服装，可能需要测试不同模特、不同场景、不同开场台词和不同剪辑节奏。对于中小跨境团队来说，如果每条视频都依赖实拍，就要承担模特、场地、摄影、… · 2026/9/25 22:13:32
邹平省心的新房装修设计公司实力与用户口碑 淄博业之峰家园装饰有限公司是淄博本土深耕家装行业的正规服务商，成立24年来始终立足淄博本地需求，为各类家装业主提供全流程的品质装修服务，其核心定位是做淄博人值得托付的良心家装品牌，主营别墅装修、新房装修、老房改造、大平… · 2026/9/25 22:13:19
YouTube 视频推广怎么做 内容优化广告和服务如何区分 选择适合目标的 YouTube 推广方式的数据分析和 96SMM 产品支持
先确定观看、订阅还是业务目标，再选择内容优化、YouTube 或 Google Ads、合作推广或具体第三方项目。不同方式的数据和交付必须分开报告。
本文按“明确问题、完成内容、记录数据、诊断原因、选择支持、… · 2026/9/25 22:13:19
SQL Server生产级存储过程实战：校验、事务、错误捕获与性能调优 简介：本资源是一份面向SQL Server初学者与数据库开发人员的存储过程实践入门包，聚焦核心语法、参数传递与典型业务场景应用。压缩包内含3个SQL脚本文件，总大小仅4KB，轻量易学：其中两个为供应链管理类报表存储过程&… · 2026/9/26 0:20:28
高并发限流器的微架构设计：无锁滑动时间窗口与令牌桶的内存与并发优化 高并发限流器的微架构设计：无锁滑动时间窗口与令牌桶的内存与并发优化在大促活动的入口网关层（API Gateway），**限流器（Rate Limiter）**是保护下游大模型推理集群、核心数据库与支付结算服务不被突发海量流量… · 2026/9/26 0:20:28
Oracle补丁包安装指南：OPatch实战从识别到验证 简介：面向64位Linux环境的Oracle 11.2.0.4.161018季度补丁包，编号24006111，适用于Oracle 11g第二版企业级数据库的日常维护与安全加固。该补丁包涵盖自上一季度以来的累积修复，可解决已知漏洞、稳定性问题并带来性能优化ÿ… · 2026/9/26 0:20:21
语音处理:Whisper语音识别实战 语音处理:Whisper语音识别实战 专栏:AI/LLM工程化实战 - 从Prompt到Agent的完整落地指南 模块7 多模态AI应用篇 第68篇 摘要 摘要:Whisper是OpenAI开源的语音识别模型，tiny到large五档尺寸，中文转录准确率随模型增大明显提升，本文覆盖音频转文… · 2026/9/26 0:20:07
TTS文字转语音:多引擎对比与集成 TTS文字转语音:多引擎对比与集成 专栏:AI/LLM工程化实战 - 从Prompt到Agent的完整落地指南 模块7 多模态AI应用篇 第69篇 摘要 摘要:TTS文字转语音引擎怎么选，OpenAI TTS与Edge TTS与开源ChatTTS、CosyVoice四类对比，中文音色、流式合成与缓存策略一次讲… · 2026/9/26 0:20:00
Agent技能体系设计实战：从工具调用到技能编排 1. agent-skills到底在解决什么问题最近大半年，我一直在折腾基于LLM的Agent项目，陆陆续续接手过几套不同团队留下的代码基座，发现一个非常普遍的现象：大家在初期Demo阶段跑得飞快，各种花哨的Agent能力都能演示出来&… · 2026/9/26 0:19:53
数据库课后习题答案别硬背：当测试用例集刷，效率翻倍 简介：万常选版《数据库原理与设计》课后习题答案资源，覆盖第2至6章及第9章，适合正在学习关系模型、数据库建模、关系数据理论与模式求精的本科生、自学者作为复习与自测材料。压缩包共7个文件，含3个doc参考答案、2个sql示例脚本、… · 2026/9/26 0:00:21
OpenClaw 替代品？Hermes Agent 踩坑实录：macOS 飞书接入 TaoToken 配置 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/26 0:00:40
向下兼容与向上兼容：接口设计中的兼容性策略与工程实践 一次版本升级事故，是很多团队绕不过去的坎。线上环境里，服务端明明已经上线了新版接口，老的移动端还在照着旧文档传参数。请求一到网关，校验直接拒绝，用户操作失败，客服群炸了锅，开发群里开始互… · 2026/9/26 0:00:46
