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

Windows

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

macOS

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

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

• 使用方法如下：

  1. 打开终端，解压下载的压缩包，您有以下三种解压方式可供选择：

     选项 1：解压到系统目录（需管理员权限） 此方式将把程序解压到系统目录，需要输入管理员密码获取权限。

     sudo mkdir -p /usr/local/bin/MPA
     sudo tar -xzf <下载的MPA压缩包路径> -C /usr/local/bin/MPA

     选项 2：解压到用户目录（推荐） 该方式无需管理员权限，操作简便且便于管理个人文件。

     mkdir -p ~/MPA
     tar -xzf <下载的MPA压缩包路径> -C ~/MPA

     选项 3：直接解压到下载目录（不推荐） 这种方式操作快捷，但可能会导致 Downloads 文件夹文件杂乱。您只需双击下载的 MPA 压缩包，即可在同级目录自动解压。

  2. 进入解压目录并运行程序：

     • 根据上一步选择的解压方式操作：

       • 若选择选项 1 ，在终端中执行以下命令打开程序目录：

       open /usr/local/bin/MPA

       • 若选择选项 2，在终端中执行以下命令打开程序目录：

       open ~/MPA

       • 若选择选项 3，直接双击解压后的文件夹进入。

     • 找到 FOS 程序并双击运行。

  ⚠️Gatekeeper 安全提示处理： 在 macOS 10.15 (Catalina) 及更高版本中，Gatekeeper 可能会阻止运行未签名的应用程序。若遇到“无法打开，因为无法验证开发者”,或者“已损坏”等错误，请使用以下命令移除隔离属性：

  sudo xattr -rd com.apple.quarantine /usr/local/bin/MPA/*
  # 若选择选项 2，解压到用户目录，使用以下命令：xattr -rd com.apple.quarantine ~/MPA/*
  # 若选择选项 3，直接解压到下载目录，使用以下命令：xattr -rd com.apple.quarantine <下载目录>/MPA/*

Linux

用 Linux 的大佬应该不需要我教

开发相关

自动战斗（专属逻辑）

战斗框架位于 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
通用	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 目录下

鸣谢

开源库

• MaaFramework

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

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

开发者

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

贡献者列表

详见 AUTHORS.md