README.md

September 22, 2026 · View on GitHub

戳一下！ MaaYuan

license .NET platform commit stars mirrorc
简体中文 · English

Development status: MaaYuan is actively maintained. Current development takes place on the v5 branch.

English Summary

MaaYuan is an open-source, cross-platform automation client for 如鸢 / 代号鸢, built on MaaFramework. It combines image recognition with automated input to handle repetitive in-game tasks. Desktop builds use MFAAvalonia on Windows, macOS, and Linux, while Android is supported through MaaFwApp.

Open-source ecosystem

MaaYuan also serves as the core client of a broader open-source ecosystem:

  • MyShare — a community platform for publishing, sharing, and importing reusable automation workflows directly into MaaYuan.
    Frontend: syoius/MaaYuan-Share-frontend
    Backend: MrSnake0208/MaaYuan-Share-Backend

  • YuanHub (Beta) — an open platform developing a standardized data protocol and OpenAPI for structured, user-owned game account-state data extracted through MaaYuan workflows, such as character ownership, progression, and other account-state information. The data can be used by user-authorized applications and community tools.
    Frontend: MrSnake0208/YuanHub
    Backend: MrSnake0208/BackEndV3-Share

All components are open source and maintained in public GitHub repositories.

中文介绍

基于 MaaFramework 的代号鸢/如鸢小助手。图像技术 + 模拟控制，解放双手！

图形界面基于 MFAAvalonia，支持 Win / Mac /Linux。

Android 端基于 MaaFwApp，支持 Android 9 及以上的 arm64 设备，与桌面端使用相同发布版本号。构建、签名和更新渠道见 Android 发布说明。

建议将模拟器分辨率配置设置为 1280x720, 320dpi 。目前开发组仅基于进行此分辨率进行测试和调整，其他分辨率暂缺人手、不保证使用效果。欢迎多多反馈、加入测试开发！

船新版本 （自动战斗）作业站 锐意测试 ing~ 访问作业站可获得 神秘代码，启动 MaaYuan 后，进入 🎮 抄作业 专属界面 使用 神秘代码 即可一键导入对应作业文件。

  • 作业编辑器 V2：新增类表格视图（类似辟雍学府-操作记录仪的编辑模式），编写作业更方便。

  • 支持录入密探、星盘、攻击力/血量 等信息，还可只看包含/排除指定密探的作业，帮您快速筛选最合适的作业

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

功能介绍

1. 支持的游戏任务:

  • 🌿 日常一条龙

    所有任务遇到体力不足或次数不足时会自动停止，并尝试进行后续任务。

    开启无限循环和自动吃鸟食时，也不会消耗白金币购买鸟食。

    • 🚀 模拟器、游戏自启动 (使用指定账号登录)
    • 📜 鸢报四合一（清鸟食）
    • 💰 领月卡福利
    • 🍚 领取每日进膳体力
    • 🏯 据点日常（✔ 派遣 ✔ 据点情报）
    • 🛍️ 据点商人购物
    • 🔮 观星（✔ 观一次 ✔ 一键观星（需月卡） ✔ 六步观星法）
    • 🏮 历练（✔ 自定义关卡 + 等级 + 次数）
    • 🗡 白鹄行动扫荡（✔ 每日扫荡 + 领奖）
    • 🗡 地宫扫荡（✔ 每日扫荡 ✔ 雀部解密）
    • 🔨 心纸营建自动派遣
    • 🔶 其他日常（✔ 每日分享 ✔ 相见互动 ✔ 家具互动 ✔ 首位密探升级 ✔ 每日送礼）
    • 🔍 楼主查岗（可选 ✔ 自动购买天机符传 ✔ 存 100 体力）

  • 🛠 其他护肝功能

    • 🔄 刷 6-24 / 7-15
      • 随时随地一键开刷，可在日常结束后自动进入，刷光剩余体力
      • 可选刷到体力耗尽（不会消耗白金币回体力）或 指定循环次数
    • 🌺 自动爬兰台
      • 自动切换难度及期数
    • 🔄【宇宙匣】三千世界
      • 不耗体力刷共同出战类成就
    • 🌥️ 云梦巫乡挖煤
      • 自动导航、续关接管
      • 自定义识别速度及精度
    • 🔄 自动刷洞窟
      • 支持 游戏内置自动战斗 及 抄作业 自动刷满洞窟 30 层
    • 🔥 心纸营建自动走历险（首通/手动刷佛脚用，非自动派遣）
    • 🔥 船新版本 （自动战斗）作业站 锐意测试 ing~ 访问作业站可获得 神秘代码，启动 MaaYuan 后，进入 🎮 抄作业 专属界面 使用 神秘代码 即可一键导入对应作业文件。

2. MaaYuan 功能

  • 预设切换
    • 官方提供多种预设，可直接载入使用
      • 代号鸢日常模板
      • 如鸢日常模板
      • 特色功能合集 （活动期间有刷取专项预设！）
      • 新版全部功能
    • 可根据需求在任务列表中 添加 / 删除 / 切换 任务，为不同账号创建不同预设方案，一键长草~

使用说明

Windows

  • 对于绝大部分用户，请下载 MaaYuan-win-x86_64-vXXX.zip
  • 若确定自己的电脑是 arm 架构，请下载 MaaYuan-win-aarch64-vXXX.zip

请注意！Windows 的电脑几乎全都是 x86_64 的，可能占 99.999%，除非你非常确定自己是 arm，否则别下这个！

解压后运行 MaaYuan.exe 即可。

如果遇到报错，可能是没有安装.NET 桌面运行时 10。可以找到文件夹中的install-deps-win.bat，双击运行，等待安装完成， 重新启动计算机 后再次运行 MaaYuan.exe。

MacOS

  • 若使用 Intel 处理器，请下载 MaaYuan-macos-x86_64-vXXX.zip

  • 若使用 M1, M2 等 arm 处理器，请下载 MaaYuan-macos-aarch64-vXXX.zip

  • 解压缩之后，右击文件夹，点击“新建位于文件夹位置的终端窗口”

  • 在终端窗口内逐行输入以下指令

    chmod a+x MaaYuan
./MaaYuan

    注：需要安装.NET 运行库（使用上面的命令启动失败时会直接返回下载地址）。也可以找到文件夹中的install-deps-mac.sh，双击运行，等待安装完成， 重新启动计算机 后再次运行 MaaYuan。

  • Mac 可能会提示：因为 Apple 无法检查其是否包含恶意软件

此时进入选择   设置  -  隐私与安全性，下方出现“已阻止…”点击   仍要打开。 多重复以上步骤，因为有很多文件会被检查。

我抄隔壁的我没 mac，欢迎测试反馈

Linux

差不多同上吧大概，我用 wsl 的，欢迎测试反馈

从零开始学会写作业

  1. MaaYuan零基础开发指南

    0.1 开发工具介绍

  2. MaaYuan开发规范

    1.1 节点信息输出

    1.2 interface字段配置

  3. 编写你的第一份日常行动作业

  4. 编写你的第一份战斗关卡作业

  5. 利用通用模块，快速实现常规功能

    4.1 日常行动通用模块

    4.2 战斗行动通用模块

    4.3 其它通用模块

  6. 把你的作业加入作业列表中

  7. 向本项目贡献代码

鸣谢

本项目由 MaaFramework 强力驱动！桌面图形界面由 MFAAvalonia 提供。

感谢以下开发者对本项目作出的贡献: