攻略介绍

# 代号鸢与如鸢玩家必备：自动化助手使用全解析 > 通过智能工具提升游戏效率，专注核心玩法体验 ## 核心功能一览

代号鸢与如鸢玩家必备：自动化助手使用全解析

通过智能工具提升游戏效率，专注核心玩法体验

核心功能一览

智能任务自动化系统

• 支持一键执行日常任务流程
• 自动完成体力领取、据点派遣、资源收集等重复性操作
• 实现兰台探索、委派任务等特色玩法的自动化处理
• 战斗辅助模块可自动触发技能释放，优化战斗执行效率

作业方案管理机制

• 提供测试版自动作业执行支持
• 可一键加载复杂战斗配置方案
• 配套工具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
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（Windows）或 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/

实用技巧 & 建议

• 建议优先完成每日任务，获得稳定收益
• 合理分配资源，避免浪费珍贵道具
• 关注官方活动，把握限时奖励机会
• 加入活跃公会，获得更多游戏支持