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

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

🎯 核心功能特色

智能任务自动化系统

MaaYuan的智能自动化系统能够一键执行日常任务，自动处理每日体力获取、据点活动、资源收集等常规操作。战斗辅助功能支持自动战斗流程和技能释放，显著提升重复战斗效率。特色玩法支持包含兰台探索、委派任务等特殊功能自动化，让玩家享受无忧游戏体验。

作业方案管理功能

支持测试版自动作业执行，可以一键应用复杂战斗配置。配套软件Maa鸢/司命提供网页和客户端版本，帮助玩家轻松创建最优作业方案。

🚀 快速安装指南

标准安装方法（推荐新手）

1. 下载对应版本：选择适合您操作系统的压缩包版本

   • Windows 64位系统
   • Windows ARM架构
   • macOS Intel芯片
   • macOS Apple芯片

2. 解压运行：

   • Windows用户：直接双击MaaYuan.exe
   • macOS/Linux用户：终端执行权限设置后运行主程序

3. 依赖处理：如遇运行错误，执行安装文件夹内的依赖修复脚本

源码编译安装（适合开发者）

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：功能模块使用教程

智能功能模块

• 自动答题系统：agent/custom/action/autoanswer.py
• 通用自动应答：agent/custom/action/general_autoanswer.py
• 图像识别模块：agent/custom/reco/

💎 总结

MaaYuan作为一款开源免费的游戏自动化助手，通过智能化技术为代号鸢/如鸢玩家带来革命性的游戏体验。自动化重复操作不仅节省时间，更让玩家能够专注于游戏的核心乐趣和策略思考。

通过简单的设置和配置，MaaYuan能够成为您游戏中的得力助手，让您享受更纯粹、更有趣的游戏时光！