如何快速解放双手？MaaYuan：代号鸢/如鸢终极一键长草小助手全攻略 🚀

MaaYuan（GitHub 加速计划）是一款基于图像识别技术的代号鸢/如鸢一键长草小助手，能够自动完成游戏日常任务、资源收集等重复性操作，让玩家告别繁琐操作，专注核心游戏体验。本工具完全免费开源，仅通过游戏界面交互，不会修改任何游戏文件或代码。

📌 核心功能：为什么选择 MaaYuan？

✨ 全自动日常任务处理

• 一键长草：自动完成每日体力领取、据点活动、资源收集等日常操作
• 智能战斗辅助：支持自动战斗、技能释放，提高重复战斗效率
• 特色功能模块：如兰台探索、委派任务等特色玩法自动化，模块路径：agent/custom/action/

🚀 高效抄作业系统

• 测试版自动抄作业：支持导入预设作业方案，一键执行复杂战斗配置
• 作业生成器：配套工具 Maa鸢/司命 提供网页版和客户端版，轻松生成最优作业方案

💻 跨平台支持

• 多系统兼容：完美支持 Windows、Linux 和 macOS 系统
• 简单部署：提供一键安装脚本和详细配置指南，新手也能快速上手

📥 最快安装指南：3分钟上手

一键安装步骤（推荐普通用户）

1. 下载对应系统版本压缩包

   • Windows x86_64：MaaYuan-win-x86_64-vXXX.zip
   • Windows ARM：MaaYuan-win-aarch64-vXXX.zip
   • macOS Intel：MaaYuan-macos-x86_64-vXXX.zip
   • macOS Apple Silicon：MaaYuan-macos-aarch64-vXXX.zip

2. 解压后运行主程序

   • Windows：直接双击 MaaYuan.exe
   • macOS/Linux：终端执行 chmod a+x MaaYuan && ./MaaYuan

3. 依赖修复（如遇报错）

   • 运行文件夹中的 install-deps.ps1（Windows）或 install.py（macOS/Linux）

开发者源码部署（适合技术玩家）

git clone --recursive https://gitcode.com/gh_mirrors/ma/MaaYuan.git
cd MaaYuan
python ./configure.py

⚠️ 注意：必须使用 --recursive 参数完整克隆项目，否则会导致 OCR 识别失败！详细步骤见官方文档：docs/1.1-准备工作.md

⚙️ 最强配置攻略

基础设置流程

1. 启动程序后，在主界面选择游戏版本（代号鸢/如鸢）
2. 根据分辨率调整识别区域（默认支持主流手机模拟器分辨率）
3. 选择需要自动执行的功能模块（日常任务/战斗辅助/抄作业等）
4. 点击"开始运行"，最小化窗口即可自动执行

高级功能配置

• 自定义预设模板：通过 assets/presets/ 目录下的 JSON 文件配置个性化操作流程
• 日志调试：日志文件保存在 debug/custom 目录，可通过 agent/utils/logger.py 调整日志级别
• AI 辅助功能：自动答题模块源码路径：agent/custom/action/autoanswer.py

📝 常见问题解决

❓ 运行程序无反应

• 检查是否安装 .NET 桌面运行时 8
• 尝试重新运行 install-deps.ps1 或 install.py 修复依赖

❓ 识别准确率低

• 确保游戏窗口未被遮挡，分辨率与设置匹配
• 更新资源文件：python ./configure.py

❓ 作业导入失败

• 确认作业文件格式正确（推荐使用官方作业生成器导出）
• 检查网络连接，部分功能需要联网获取最新数据

📚 进阶学习资源

官方文档与教程

• docs/1.1-准备工作.md：环境配置详细指南
• docs/4.1-日常行动通用模块.md：功能模块使用说明

参与开发贡献

• 项目源码：https://gitcode.com/gh_mirrors/ma/MaaYuan
• 贡献指南：提交 PR 前请阅读项目 CONTRIBUTING.md（如有）
• 交流反馈：官方 交流反馈频道

🌟 结语

MaaYuan 作为一款开源免费的游戏辅助工具，致力于为代号鸢/如鸢玩家提供更轻松、高效的游戏体验。通过自动化重复操作，让你有更多时间享受游戏核心乐趣！

✨ 如果喜欢 MaaYuan，欢迎在项目右上角点亮 Star 支持 ✨

如果你在使用过程中遇到任何问题，或有功能建议，欢迎通过项目 Issue 或交流频道反馈，让我们一起打造更好的游戏辅助工具！