[!NOTE]
只有当您想要开发 MRA 时才需要看当前页面！
用户请转到 MRA 使用手册。
开发 MaaFramework 或开发自己的项目请到 MaaXYZ/MaaFramework。
欢迎收看 牛牛也能看懂的 GitHub Pull Request 使用指南
如果很久以前 fork 过，先在自己仓库的 Settings 里，翻到最下面，删除
打开 MRA 主仓库，点击 Fork，继续点击 Create fork
克隆你自己的仓库到本地，并拉取子模块
git clone --recursive https://github.com/<你的用户名>/MRA.git
⚠
–recursive 一定不要忘！–recursive 一定不要忘！–recursive 一定不要忘！
OCR异常失败很可能就是没加recursive导致。
下载 MaaFramework 的 Release 包，解压到 deps 文件夹中。
配置编程环境
选择性开发工具
| 工具 | 简介 |
|---|---|
| Maa Pipeline Support | VSCode 插件，提供调试、截图、获取 ROI 、取色等功能 |
| MFA Tools | 独立截图、获取 ROI 及取色工具 |
| ImageCropper(不推荐) | 独立截图及获取 ROI 工具 |
开始开发
参考 MaaFramework 相关文档开始愉快的改代码吧。
调试代码
使用以下几种方式调试你改好的代码
使用MaaDebugger调试
下载MaaDebugger独立调试工具
参照README使用
使用cli本地安装调试
安装嵌入式python（仅Windows需要）
./tools/ci/setup_embed_python.ps1
通过运行 install 组装部件
python ./tools/install.py
便可以在 install 文件夹运行 MRA 了。
使用gui安装调试
下载MFAAvalonia最新发行版并解压
将本地仓库中assets/resource中所有内容复制到MFAAvalonia/Resource中
将本地仓库中assets/interface.json文件复制到MFAAvalonia/中
便可以使用MFAAvalonia运行 MRA 了。
git 操作
通常用的最多的基本命令有：
git add <file>：添加文件到暂存区，* 代表全部文件git commit -m "message"：提交暂存区到本地仓库。message 请遵循 约定式提交规范，让你的 commit 信息更加清晰git pull origin <branch>：拉取远程仓库到本地仓库git push origin <branch>：推送本地仓库到远程仓库⚠
开发过程中，每一定数量，记得提交一个 commit, 别忘了写上 message 假如你不熟悉 git 的使用，你可能需要创建并切换到一个新的分支，而不是直接提交在 main 上 这样你的提交就能在新的分支上生长，不会受到 main 更新的打扰
git checkout -b <branch-name> # 创建并切换到新的分支
完成开发后，推送你修改的本地分支到远程仓库（fork 的仓库）
git push origin <branch-name>
当 MRA 仓库出现更改（如其他人的commit），你可能需要把这些更改同步到你的分支
关联 MRA 原仓库：
git remote add upstream https://github.com/MAA1999/MRA.git`
拉取远程仓库更新：
git fetch upstream
变基（推荐）或者合并修改：
git rebase upstream/main # 变基，使commit历史更清晰，完成你的个人pr时建议使用rebase而不是merge来合并修改
或者
git merge upstream/main
git 参考资料：
提交 Pull Request
你修改的代码已经提交到你的仓库，现在你需要提交一个 Pull Request 到 MRA 的仓库，等待维护者审核