基于 MaaFramework 构建的《棕色尘埃2》全流程自动化助手。解放“日常15分钟”的双手，无感替您代跑每日近50分钟的全量日常、周常及活动任务。拒绝枯燥重复，奖励“我全都要”，精力只留给享受游戏。
| 版本通道 | 迭代逻辑与实况 | 获取方式 |
|---|---|---|
|
正式版 (纯数字版本号) |
求稳派的选择。 通常在累积 100+ 次 Commits 与多轮补丁验证后才“姗姗来迟”。适合追求长期稳定、告别折腾的玩家。 |
|
|
公测版 版本号含 Beta |
不断探索边界。 针对现场实况与素材高频迭代，更新粒度以日甚至小时计。强烈欢迎各位“课代表”在此抓虫并提交 Issue。 |
|
⚡ 五分钟快速上手（新用户看这里）
1. 下载对应平台解压 → 2. MuMu 设置 1920×1080 → 3. 游戏切简体中文 → 4. 启动 UI 运行UI 内可直接获取更新推送、下载，由
通道版本差距约为几次 Bug/新功能/等验证 的轮回。
运行提示：当前仅支持模拟器。请务必在良好的网络下运行，连通性波动导致的“重连转圈”易吞掉操作并引发失误。
反馈指南：遇到卡点欢迎提交 Issue。为了快速定位问题，请附带：出错前后几秒的录屏/截图 + 一键导出的打包日志（按钮在UI日志墙上方）
。
第一步 · 模拟器
推荐使用 MuMu 模拟器 12 运行游戏。（需自行配置 Google 环境。省事直接用国际版，亦可参考笔记 Google-Play-Store）。
显示必须设置为 平板版 1920×1080 (DPI ≈ 270 或 280)。
多开 / ADB 讲解 （如不需要多开挂机，可安心跳过。）
多开，在UI(MFAA)中，顶部新建选项卡可实现多实例。项目有存档功能，多开请注意开启并填入多存档存档号。
adb.exe 以 Windows 服务形式运行，默认服务端口 5037，各模拟器实例为其客户端。MuMu 多开器按编号分配 ADB 端口：0 号默认 16384，1 号为 16416，以此类推；国际版后启动的端口号在前者基础上 +1（如 16385）。
通常启动一个 ADB 服务即可控制多个实例，不建议多版本 ADB 并行运行。如有需要，可自定义 ADB 路径与端口加以区分。
第二步 · 游戏内设置
当前已支持自动配置，但需先将游戏语言切换为简体中文且分辨率正确，之后运行中可完成自动设定。
| 分类 | 设置项 | 值 |
|---|---|---|
| 操作 | 选择操作方式 | 点击地面 |
| 图像 | 分辨率 | FHD |
| 图像 | 游戏开始画面 | 主界面 |
| 通知 | 黄色圆点 | 不使用 |
画面质量异常时，请检查渲染方式。新机器通常
Vulkan表现较好，旧机器推荐DirectX。可关闭技能动画以提升运行速度。
第三步 · 人物技能与装备
按下图设置技能位置与装备分解选项（此设置保存在模拟器本地，不影响其他端）。配置一次即可，强化目标等级与金币消耗限额请按个人情况手动设定。
装备备注：请保留至少一件 SR/UR +9 装备用于精炼。
箱庭地图状态识别、技能传送阵自动生成、绝大多数中断场景均已实现自动复位。
推荐在剧情主线地图或传送阵上结束游戏。
Mac 使用指引
Mac 可用，配置流程略复杂，可参考 M9A 文档站（同框架，软件部署部分通用）。 Mac 版 Agent 功能在根目录提供一键修复环境脚本，遇到环境问题时可使用。
帮你打理游戏里的每一天，从启动到收工，近 50 分钟日常无人值守。
🌅 每日开局 启动 & 更新游戏 · 自动前置配置
⚔️ 战斗刷取 狩猎场 · 圣石洞穴 · 肉鸽塔 · PVP · 赛季活动（普通 / 挑战 / 魔兽 / 场域）
🎰 白嫖抽卡 每日免费 · 优惠档 · 多卡池保底保留
💰 资源 & 奖励 全图吸取 · 宠物派遣 · 餐馆结算 · 任务 / 活动 / 通行证 / 邮件一键清收
📅 周常挂机 末日之书 · 自动钓鱼 · 小屋点赞
⭐ 跑商套利 · 自动识别最高价，搓料理，批量进出货，可自定义商品列表
🎣 接管钓鱼 · 检测收杆时机，全自动循环，挂机刷级
- 启动 & 更新游戏 —— 更新游戏程序与数据版本
- 自动前置配置 —— 游戏内设置 / 技能放置 / PVP · 装备 的子菜单
- 多开存档号 —— 记录刷取进度，日常续刷、周常按需刷。
- 狩猎场 · 冒险航线 —— 选资源 / 选图 / 米饭分配
- 圣石洞穴 —— 按属性 / 均衡 / 短板
- 肉鸽塔快速战斗
- PVP 镜中之战 —— 倍率调整
- 赛季活动 —— 普通 / 挑战关卡、魔兽（自配队补刀 或 摆烂全自动）、场域小游戏
- 制作 / 强化 / 分解 / 精炼 — 全任务覆盖自动 / 精炼队列
- 每日免费抽 —— 速抽 / 策略抽
- 每日 90 钻优惠档（指定卡池）
- 保底保留 —— 临近必出时自动停抽
- 地图资源吸取 —— 全卡带 / 每日用尽技能 / 周常存档续吸 / 卡带屏蔽
- 宠物自动派遣
- 餐馆自动结算 —— 收粉 / 升级 / 常客圣石 / 装饰币
- 一键清收 — 公会签到 / 小屋访问 / 广场祈求 / 日常任务 / 版本活动 / 通行证 / 普通邮件 & 商品邮件
- 末日之书一轮 · 自动钓鱼 · 小屋点赞 · 浏览街机界面
- 跑商套利 — 自动识别当日最高价，批量进出货（可自定义商品列表） / 搓利润料理
- 接管钓鱼 — 检测收杆时机，全自动循环
- 爬塔刷层数 / 末日之书刷分数
- 生活技能刷级（完善中）
如需参与开发，请先阅读以下规范，确保本地测试通过后再提交 PR，合并请使用 --no-ff 非快速合并。
- Pipeline 协议规范
- 开发帮助文档
- [资源包制作工具] MaaOWM，多资源包依序挂载，卸载后向目标包写回Diff字段。
提交辅助 Hook：执行 git config core.hooksPath scripts/hooks 后，git commit 将自动打开提交信息辅助界面，便于规范提交格式与触发发版流程。
| 项目 / 作者 | 说明 |
|---|---|
| MaaFramework | 自动化测试框架，本项目核心驱动 |
| MaaPracticeBoilerplate | 项目模板 |
| MFAWPF | Pipeline 协议通用 GUI |
| MFAAvalonia | 基于 Avalonia 的通用 GUI |
| MFAToolsPlus | 开发工具 |
| maa-support-extension | VSCode 扩展 |
| MaaPipelineEditor | 可视化工具 |
| 京墨 | 跑商功能初始代码 (7e5bb2a)，感谢付出与支持 |
| @XiaoXKKK | 接管钓鱼初始代码 (adb06bb)，感谢付出与支持 |
| JZPPP/MaaBD2 | 早期参考项目 |
|
☕ 支持项目 如果 MFABD2 帮您省下了宝贵的肝脏与时间，欢迎请开发者喝杯咖啡。 您的支持是项目持续迭代、修复问题的最强动力！ |