MAA_Punish

基于全新架构的 战双帕弥什 小助手。图像技术 + 模拟控制，解放双手！
由 MaaFramework 强力驱动！

免责声明

• 本资源 开源 且 免费
• 本资源按“现状”提供，不附带任何形式的明示或暗示担保。使用者需自行承担所有风险。
• 作者不对因使用本资源而导致的任何直接、间接或结果性损失承担责任。
• 本资源为独立组件，其MIT许可证不传染，也不受与之集成的其他软件许可证的影响。
• 基于本资源进行的任何商业行为均与原作者无关，使用者不得暗示任何官方关联或认可。

主要功能

• 启动/关闭游戏
• 指挥局抽签
• 宿舍委托
• 宿舍任务
• 指挥局签到
• 拟真围剿
• 刷A级碎片
• 纷争战区自动首通
• 诺曼矿区自动首通
• 幻痛囚笼自动首通
• 历战映射
• 维系者行动
• 领取邮件
• 商店自动购买逆元碎片
• 领取体力
• 拟战场域
• 领取凭证和任务奖励
• 自动肉鸽-宣叙妄响
• 自动肉鸽-厄愿潮声
• 自动肉鸽-矩阵循生
• 自动肉鸽-寒境曙光
• 自动肉鸽-神寂启示录

注意事项

• 安卓端：任意模拟器皆可,如果出现部分任务无法完成,请切换1280*720(240DPI)
• 桌面端：需要使用管理员权限启动
• PlayCover端：支持,但没有测试,如果有问题请反馈
• 打开无法运行首先尝试安装运行库 https://learn.microsoft.com/zh-cn/cpp/windows/latest-supported-vc-redist?view=msvc-170
• 如有其他问题可以提交issue或者加群反馈 965061066，反馈问题请附上日志文件 debug/maa.log，谢谢！

使用说明

下载地址：https://github.com/overflow65537/MAA_Punish/releases

Android

• 下载 MPA-android-vXXX.apk 并安装。
• Android 包名：com.overflow65537.maafw.punish。
• Shizuku / root 授权及后续操作请参考 MaaFwApp 使用说明。
• 首次启动后按应用引导授予通知、电池优化白名单，以及 Shizuku 或 root 权限。
• 未配置正式签名的开发构建会带有 -debug 后缀；安装后续正式版本前可能需要先卸载开发版。

Windows

• 对于绝大部分用户，请下载 MPA-win-x86_64-vXXX.zip
• 若确定自己的电脑是 arm 架构，请下载 MPA-win-aarch64-vXXX.zip
• 解压后运行 FOS.exe即可

macOS

• 若您的 Mac 采用 Intel 处理器，请下载 MPA-macos-x86_64-vXXX.dmg

• 若您的 Mac 采用 M1、M2 等 ARM 处理器，请下载 MPA-macos-aarch64-vXXX.dmg

• 使用方法如下：

  1. 双击打开 dmg，将其中全部内容复制到本地目录（请保持 MFW.app、MFWUpdater、maafw/ 与 resource/ 等文件在同一目录）。推荐复制到用户目录：

     mkdir -p ~/MPA
     cp -R /Volumes/MPA/. ~/MPA/

  2. 打开程序目录并运行主程序：

     open ~/MPA

     找到 MFW.app（或 FOS）并双击运行。不要只拷走 .app。

  ⚠️Gatekeeper 安全提示处理： 由于 MFW.app 没有 Apple 代码签名，Gatekeeper 可能拦截并提示“无法打开，因为无法验证开发者”或“已损坏”（后者多为误报，并非文件真的损坏）。请按住 Control 键并右键点击 MFW.app，选择“打开”，在弹窗中再次确认；首次放行后，之后可直接双击启动。

  若从浏览器下载 dmg，macOS 还可能给文件加上隔离属性（com.apple.quarantine）。若上述方式仍无法打开，可在「系统设置 → 隐私与安全性」中查看是否有“仍要打开”按钮，或执行以下命令移除隔离属性（将路径改为你的实际安装目录）：

  xattr -rd com.apple.quarantine ~/MPA

  也可通过终端尝试启动一次：open ~/MPA/MFW.app。

Linux

• x86_64：请下载 MPA-linux-x86_64-vXXX.tar.gz

• aarch64：请下载 MPA-linux-aarch64-vXXX.tar.gz

• 解压后在同一目录运行 ./MFW 或 ./run-mfw.sh（tar.gz 会保留可执行权限）

  mkdir -p ~/MPA
  tar -xzf MPA-linux-*-vXXX.tar.gz -C ~/MPA
  chmod +x ~/MPA/MFW ~/MPA/MFWUpdater ~/MPA/run-mfw.sh
  ~/MPA/run-mfw.sh

开发相关

自动战斗（专属逻辑）

战斗框架位于 agent/action/combat/。Pipeline 通过 CombatRunner 统一调度；新角色只需在 LoadSetting.py 登记并在 roles/ 下实现 BaseRole 子类（类名 = cls_name），无需逐个注册 agent_file.py。

详细说明见 自动战斗框架开发指南，其中包含 LLM 提示词模板，可直接复制给 Cursor 等工具修改角色打法。

当前已实现专属战斗逻辑的角色：

角色	cls_name	源文件
深红囚影	CrimsonWeave	agent/action/combat/roles/crimson_weave.py
深谣	LostLullaby	agent/action/combat/roles/lost_lullaby.py
终焉	Oblivion	agent/action/combat/roles/oblivion.py
誓焰	Pyroath	agent/action/combat/roles/pyroath.py
启明	Shukra	agent/action/combat/roles/shukra.py
深痕	Stigmata	agent/action/combat/roles/stigmata.py
超刻	Hyperreal	agent/action/combat/roles/hyperreal.py
晖暮	Crepuscule	agent/action/combat/roles/crepuscule.py
希声	Pianissimo	agent/action/combat/roles/pianissimo.py
铮骨	Aegis	agent/action/combat/roles/aegis.py
骇影	Spectre	agent/action/combat/roles/spectre.py
逆冕	InverseCrown	agent/action/combat/roles/inverse_crown.py
霁梦	Limpidity	agent/action/combat/roles/limpidity.py
谬影	Daemonissa	agent/action/combat/roles/daemonissa.py
芒星之迹	Startrail	agent/action/combat/roles/startrail.py
灼惘	Geiravor	agent/action/combat/roles/geiravor.py
幻日	Parhelion	agent/action/combat/roles/parhelion.py
极锋	Arete	agent/action/combat/roles/arete.py
亡歌	Dirge	agent/action/combat/roles/dirge.py
不落日	Aeternion	agent/action/combat/roles/aeternion.py
安魂	Lacrimosa	agent/action/combat/roles/lacrimosa.py
烬航	Effulgence	agent/action/combat/roles/effulgence.py
通用	GeneralFight	agent/action/combat/roles/general_fight.py

未单独实现的角色在进战后会走 GeneralFight 通用逻辑。欢迎 PR 补充；开发问题可加群 965061066 反馈。

开发文档

• MaaFramework 快速开始
• 自动战斗框架开发指南（含 LLM 改战斗提示词）

How to build

如果你要编译源码才看这节，否则直接 下载 即可

桌面端

0. 完整克隆本项目及子项目

   git clone --recursive https://github.com/overflow65537/MAA_Punish.git

1. 下载 MaaFramework 的 Release 包，解压到 deps 文件夹中

2. 安装

   python ./tools/ci/install.py

生成的二进制及相关资源文件在 install 目录下。

Android

Android APK 使用 MaaFwApp 构建。仓库的 install 工作流会自动组装 MaaFramework Android 库、双 ABI Python agent 与本项目资源，并上传 APK artifact；标签构建还会把 APK 加入 GitHub Release。

本地构建需要 JDK 17、Android SDK 和 Python 3，详细命令、打包配方及 release 签名配置见 .github/android/README.md。

鸣谢

开源库

• MaaFramework

  基于图像识别的自动化黑盒测试框架 | An automation black-box testing framework based on image recognition

• MaaFwApp

  MaaFramework 的通用 Android GUI | A general-purpose Android GUI for MaaFramework

• MFW-ChainFlow Assistant 基于 PySide6 的 MaaFramework 前端 | A frontend based on PySide6 for MaaFramework

开发者

感谢以下开发者对 MAA_Punish 作出的贡献：

贡献者列表

详见 AUTHORS.md