MaaYuan：代号鸢/如鸢智能自动化助手完全指南

MaaYuan是一款专为代号鸢/如鸢玩家设计的开源自动化助手，通过智能图像识别技术实现游戏日常任务全自动执行。这款免费工具能够自动完成资源收集、战斗辅助等重复操作，让玩家专注于游戏核心乐趣，彻底告别繁琐手动操作。

核心优势：为何选择MaaYuan？

智能任务自动化

• 一键执行日常：自动处理每日体力获取、据点活动、资源收集等常规任务
• 战斗辅助优化：支持自动战斗流程和技能释放，提升重复战斗效率
• 特色玩法支持：包含兰台探索、委派任务等特殊功能自动化，模块位置：agent/custom/action/

作业方案管理

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

多平台兼容

• 全系统支持：完美适配Windows、Linux和macOS操作系统
• 简易部署：提供快速安装脚本和详细配置说明，新手用户也能轻松设置

快速安装流程

标准安装方法（推荐大多数用户）

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

   • Windows 64位：MaaYuan-win-x86_64-vXXX.zip
   • Windows ARM：MaaYuan-win-aarch64-vXXX.zip
   • macOS Intel芯片：MaaYuan-macos-x86_64-vXXX.zip
   • macOS Apple芯片：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或交流频道反馈，共同打造更好的游戏辅助工具！