まあ丸 v0.2.0

まあ丸 v0.2.0

这次正式把新版本丸面板和“本丸成绩单”推向 V2：小狐狸不只帮你干活，也会把自己能够确认完成的事顺手记下来。

本丸成绩单

• 按每次任务汇总出阵圈数、手入、加速符、补刀装和库存变化。
• 循环任务可查看实测平均圈速，并按 1 小时、6 小时、8 小时或自定义时长估算可完成圈数。
• 重复事件自动折叠，需要时可展开查看每圈明细。
• 任务奖励现在会识别可领取和灰色空状态，只在领取结果能够确认时计数。
• 统计仅作为本地辅助记录，不读取游戏账号后台，也不会把无法确认的行为猜成成绩。

出阵与日课

• 大阪城支持指定 1～99F 和挂机圈数；维护者实机完成了 88F 连续 120 圈。
• 连续作战中可自动补刀装，按配置手入、使用加速符并继续剩余圈数。
• 手入事件只在实际修复刀剑后计数；进入手入室但无需修复的情况不再误算。
• 一键日课的远征会按独立远征的“常用安排”收菜再派出，不与自动排班混用。
• 修正万屋已成功却在日课结尾被标记失败的可视化日志。

面板与文档

• 概览、任务、日志、本丸快照和成绩单形成统一的 V2 工作台。
• 像素主题优化长文本字体与自动排班组件，减少费眼的小字和突兀深色块。
• README 升级为 V2 介绍，补充特色功能、统计边界、实测记录与后续计划。

升级

在まあ丸启动器中检查更新，下载并确认安装即可。安装器只替换程序文件，不会删除
%LOCALAPPDATA%\Maamaru 中的配置、排班、日志、统计数据与识别素材。

まあ丸 v0.1.8

まあ丸 v0.1.8

这次给本丸补上了会记账的成绩单，也把长时间挂机和游戏更新后的恢复能力继续加固。

本丸成绩单

• 新增结构化运行数据与“本丸成绩单”，统计小狐狸实际完成的出阵、任务领奖、远征派遣、演练和手入等记录。
• 大阪城按挂机楼层和圈数展示；普通合战场、异去、联队战与南瓜活动统一归入出阵小结。
• 首页“本丸统计”调整为“本丸快照”，增加近 24 小时小结和成绩单入口。
• 记录只保存在用户数据目录，不保存截图，默认保留 90 天；记账失败不会影响脚本运行。

出阵与恢复

• 一键日课新增大阪城挖地，可设置部队、圈数与挂机楼层，并沿用独立大阪城的阵形、伤势和手入策略。
• 加强普通出阵、异去与大阪城的长时间运行恢复，保留游戏强制更新前的剩余进度。
• 新增自动补刀装功能，自动补刀装会先保存部队记录，战斗后安全恢复，并避免用受损状态覆盖原记录。
• 优化大阪城连续挖地、手入后续跑、层末判断和异常停止行为。

面板

• 恢复旧版庭院挂牌的完整执务文案、场所和已运行时长。
• 统一两套主题的页面骨架、任务配置高度与窄屏布局。
• 手入事件合并为一条小结，隐藏不适合直接展示的内部机器记录。

升级

在まあ丸启动器中检查更新，下载并确认安装即可。安装器只替换程序文件，不会删除
%LOCALAPPDATA%\Maamaru 中的配置、排班、日志、统计数据与识别素材。

まあ丸 v0.1.7

まあ丸 v0.1.7

这次把本丸面板整体翻修了一遍，也给活动出阵补上了不少新玩法。

新增

• 新增异去出阵，可配置地图、部队、行军方式、阵形与伤势停止条件。
• 新增大阪城挖地，可指定完成层数，并在通关 99 层后指定 1～99 层挂机。
• 大阪城支持自动或手动阵形、固定或有利阵形，以及受伤后的返回、手入和继续策略。

面板重构

• 主面板迁移至 Vue 3，重新整理任务选择、运行状态、日志和配置布局。
• 补充异去、大阪城等任务入口和专用图标。
• 优化窄屏布局、状态反馈及多处含义不清的文案。

修复

• 修复自动／手动阵形识别互相串台、战斗中反复切换的问题。
• 修复大阪城道中漏检伤势，以及层末画面判断和返回本丸流程。
• 修复轻伤可能被误判为重伤的问题，伤势识别只检查我方部队区域。
• 修复万屋暖心礼包因商品排版变化而误判售罄或点到其他商品的问题。
• 修复部分活动流程重复点击、空转和停止提示不准确的问题。

升级

在まあ丸启动器中检查更新，下载并确认安装即可。安装器只替换程序文件，不会删除
%LOCALAPPDATA%\Maamaru 中的配置、排班、日志和识别素材。

まあ丸 v0.1.6

🦊 まあ丸 v0.1.6

使用方法：

1. 推荐下载 maamaru-setup-v0.1.6.exe 并按提示安装
2. 从开始菜单或桌面启动まあ丸
3. 启动器检查通过后，点击“启动まあ丸”

想免安装使用，也可以下载 maamaru-launcher-v0.1.6.zip，解压后双击 まあ丸启动器.exe。

Python、运行依赖、识别模板与 OCR 模型均已内置，不需要运行 .bat，也不需要另装资源包。
卸载默认只移除程序，不会删除 %LOCALAPPDATA%\Maamaru 中的配置与历史记录。

需要： Windows 10/11

まあ丸 v0.1.5

🦊 まあ丸 v0.1.5

使用方法：

1. 推荐下载 maamaru-setup-v0.1.5.exe 并按提示安装
2. 从开始菜单或桌面启动まあ丸
3. 启动器检查通过后，点击“启动まあ丸”

想免安装使用，也可以下载 maamaru-launcher-v0.1.5.zip，解压后双击 まあ丸启动器.exe。

Python、运行依赖、识别模板与 OCR 模型均已内置，不需要运行 .bat，也不需要另装资源包。
卸载默认只移除程序，不会删除 %LOCALAPPDATA%\Maamaru 中的配置与历史记录。

需要： Windows 10/11

まあ丸 v0.1.4

まあ丸 v0.1.4

使用方法：

1. 下载 maamaru-launcher-v0.1.4.zip 并解压
2. 双击 まあ丸启动器.exe
3. 启动器检查通过后，点击“启动まあ丸”

Python、运行依赖、识别模板与 OCR 模型均已内置，不需要运行 .bat，也不需要另装资源包。

本次更新

• 重做像素主题首页：加入本丸庭院、待机狐狸、木制框体与桌面三栏布局
• 优化手机与窄屏布局，常用功能和系统设置改为横向分页切换
• 替换任务与资源图标，统一像素主题视觉细节
• 优化日志可视化，技术坐标与识别细节留在“源码日志”中
• 一键日课与独立南瓜大作战可分别保存出阵方案和监视名单
• 修正远征状态、锻刀炉倒计时和成绩单推送状态
• 修复 ntfy 中文消息乱码
• 启动器新增重新检查、环境修复和版本更新检查，并改为适合面板的窗口尺寸
• 补齐南瓜大作战所需的刀剑识别素材

系统要求： Windows 10/11

まあ丸 v0.1.3

🦊 まあ丸 v0.1.3

使用方法：

1. 下载 maamaru-launcher-v0.1.3.zip 并解压
2. 双击 まあ丸启动器.exe
3. 启动器检查通过后，点击“启动まあ丸”

Python、运行依赖、识别模板与 OCR 模型均已内置，不需要运行 .bat，也不需要另装资源包。

本次更新：

• 修复万屋免费礼包售罄识别
• 刀装未满时安全取消出阵并写入日课成绩单
• 修复空 OCR 结果误判重伤
• 可视化日志收起点击坐标、模板分数与 OCR 原文
• 完整技术信息保留在“源码日志”视图

まあ丸 v0.1.2 — 控制台弹窗根治版

まあ丸 v0.1.2 —— 控制台弹窗根治版

本版修了什么

修复了运行任务时全程弹出黑色/控制台窗口抢焦点的恶性 bug（任务管理器里表现为成堆的「控制台主机窗口」conhost.exe，电脑根本没法用）。

根因与修复

• 8/5 起截图/点击/滑动改走「裸 adb.exe 子进程」（为根治 MAA 卡死），但漏了隐藏窗口
• 脚本的工人进程本身是无窗口的，再裸起 adb.exe（控制台程序）时 Windows 被迫给每个 adb.exe 现开控制台窗口 → 战斗循环全程弹窗
• 修复：所有裸 subprocess 调用统一补上 CREATE_NO_WINDOW（隐藏窗口）标志

涉及文件：

1. maa_adapter._adb_run —— 战斗循环最高频路径（截图/点击/滑动，每下都弹）
2. emulator._run / sleep_computer —— 模拟器自启动与休眠
3. flows/logout —— 杀游戏 / 关模拟器 / 休眠三处

使用方法

1. 下载 maamaru-launcher-v0.1.2.zip，解压得到 maamaru-launcher-v0.1.2.exe
2. 双击运行，点「▶ 启动まあ丸」
3. 跑日课/活动任务，确认不再弹窗

已在使用 v0.1.1 的话直接覆盖即可；配置和数据都在 exe 旁的独立目录，不会被覆盖。

まあ丸 v0.1.1 — 长时间运行卡死根治版

まあ丸 v0.1.1 —— 长时间运行卡死根治版

本版修了什么

修复了长时间运行时的卡死问题（自动跑 40-60 分钟后日志戛然而止、面板只能重启）。这是 v0.1.0 用户跑南瓜大作战/长日课时最容易遇到的恶性 bug。

三层根治（k3 与鱼丸联合方案）

1. 脚本跑在独立子进程（新 panel/worker.py）

   • 模拟器自动化引擎（MAA）一旦卡死，只死脚本进程，面板、调度器、QQ/TG 机器人毫发无损
   • 「紧急停止」= 真杀进程，立刻停（旧版是设标志位等下次开口，可能不响应）

2. MAA 全面限时（maa_adapter.py 重写等待逻辑）

   • 所有识别/连接操作不再无限等待：识别 30 秒 / ADB 连接 30 秒 / 资源加载 120 秒超时即放弃
   • 连续 3 次识别超时 = 判定 MAA 已死，脚本进程主动自我了断（退出码 43），面板会提示"重启模拟器后再跑"

3. 沉默看门狗

   • 子进程 300 秒一行日志都没有 = 判定卡死，自动强杀并报出死因（日志最后一行就是它咽气前在干的事）

其他修复

• 南瓜大作战令牌驱动重写：「刷几局」改为「更新令牌烧几枚」（默认 4），令牌=一切，烧完即收工，不再白烧
• 截图/点击/滑动改走裸 ADB 子进程（真超时可杀，绕开 MAA 的 ADB 通道）
• 剪影更新遇到狐狸里程碑对话会驱散重试，不再误收工
• ��斗循环心跳日志显示真实出阵次数

使用方法

1. 下载 maamaru-launcher-v0.1.1.zip
2. 解压双击 まあ丸启动器.exe，等待启动前检查完成
3. 首次运行会自动把素材库展开到 %LOCALAPPDATA%\Maamaru

用户配置与运行数据保存在 %LOCALAPPDATA%\Maamaru，从 v0.1.0 升级不会丢失配置。

文件校验

maamaru-launcher-v0.1.1.zip

SHA-256：138FC7C76089F24F94326FCDF1A1710E0EADB99052CBABDC9E49EAFC19A32009

本项目是非官方游戏自动化工具，仅供学习与技术交流。自动化行为可能违反游戏服务条款，请了解风险后自行决定是否使用。

まあ丸 v0.1.0 — 第一个正式公开版

这是まあ丸的第一个正式公开发行版。把自动化引擎、本丸面板和运行前检查打包发布，面向“不想碰 Python、终端和配置文件”的 Windows 用户。

使用方法

1. 下载下方的 maamaru-launcher-v0.1.0.zip
2. 解压后双击运行 まあ丸启动器.exe，等待启动前检查完成
3. 点击“启动まあ丸”，窗口会自动最大化并进入本丸面板
4. 第一次使用请在“配置”页确认模拟器、部队和任务选项

用户配置与运行数据保存在 %LOCALAPPDATA%\Maamaru，更新程序不会覆盖这些数据。

本版内容

• 单文件 Windows 启动器：检查程序文件、运行环境、8080 端口、ADB 和 MuMu 管理器
• 全新的本丸概览、配置页和持久化日志视图
• 前端从单体 app.js 拆分为独立功能模块
• 一键日课、联队战、南瓜大作战、普通出阵、刷花、演练、远征、锻刀、手入、炼糖与库存快照
• 日课与独立演练统一配置；远征自动排班从即时远征中独立
• 连续出阵按伤势手入、加速当前队伍并继续剩余圈数
• 支持 ntfy，并预留 QQ / Telegram 与近侍聊天配置
• 内置 AGENTS.md：可以把项目交给 Agent，让它主动配置、执行和排查
• 南瓜大作战智能认人已内置素材库（首次启动自动展开到数据目录）

已知限制

• 当前主要面向 Windows + MuMu 模拟器 + 国服，其他环境未验证
• “修复环境”和“检查更新”仍是 V1 基础功能
• QQ 协议端尚未集成自动安装
• 启动模拟器时可能短暂出现终端窗口
• 刀装未满时的自动取消与日课结算提醒仍待完善，遇到整备刀装提示请人工处理

本项目是非官方游戏自动化工具，仅供学习与技术交流。自动化行为可能违反游戏服务条款，请了解风险后自行决定是否使用。

文件校验

maamaru-launcher-v0.1.0.zip

SHA-256：DD644E390F67716E46480C9A33EE40B99356105D7F318340996D20EB01A83E81