更新应用与 MAA
从左下角“设置”或 macOS 的“AutoMAA → 设置…”打开独立窗口。AutoMAA 本体在“更新”页管理，MAA 引擎与识别数据在“MAA 环境”页管理：
| 入口 | 适用情况 | 更新范围 |
|---|---|---|
| 设置 → 更新 | 获取界面与工作流功能改进 | AutoMAA App，确认重启后安装 |
| 设置 → MAA 环境 → 更新 MAA → 更新 MAA 稳定版 | 升级任务引擎或解决资源兼容问题 | MaaCore、随包基础识别数据及最新增量数据 |
| 设置 → MAA 环境 → 更新 MAA → 仅更新识别数据 | 同步关卡、活动和界面识别规则 | 规则与图片增量，不更换 MaaCore |
点击“维护”右侧的“更新 MAA”可选择更新内容，选择 Beta 时还需确认。“更新 MAA 稳定版”已包含识别数据同步，不需要再点一次“仅更新识别数据”。基础数据随引擎发布，增量数据单独发布，两者共同供 MaaCore 识别游戏界面。
maa-cli 通过原安装方式单独升级，例如 Homebrew；游戏包体与游戏内数据由用户在游戏运行环境中处理，见游戏更新与人工处理。
更新 AutoMAA
AutoMAA 默认在启动时检查正式版本，也可在“设置 → 更新”或 macOS“AutoMAA”菜单中手动检查。菜单随状态显示检查更新、查看下载进度或更新已就绪，并打开同一更新页：
- 查看新版本内容，选择“下载并校验”。
- 等待校验完成，点击“重启并安装”。
- App 退出、替换并重新打开，原有配置保留；配置兼容性以该版本的发布说明为准。
检查和重试操作使用图标加文字；检查结果、检查时间、取消及错误信息直接显示在更新页。设置窗口标题保持为“设置”，切换页签时平滑适配内容高度；新版本摘要或错误出现时会继续增高，超过屏幕可用高度再滚动；复制成功反馈和进度变化不会反复改变窗口尺寸。
重启安装前必须保存当前编辑；出现“配置尚未保存”时会保留已准备的更新，修复保存问题后再重试。
“自动下载并准备更新”默认关闭。开启后，App 会在空闲时下载并校验当前通道允许的版本，安装仍需确认重启。已准备好的更新可在下次启动后校验并继续安装；失败时保留或恢复旧 App。
App 应位于“应用程序”等可写目录中。直接在 DMG 中运行时，请先完成安装。
接收预发布更新
“接收预发布更新”默认关闭。开启后，检查范围包含正式版与 Beta、RC 等预发布版，并选择版本号更高的更新。预发布版用于提前体验功能，可能包含尚未解决的问题；安装前请阅读对应发布说明。
切换开关会取消当前检查或下载，等待清理后移除当前通道不接受的候选，再重新检查。关闭后，已下载的预发布候选不会继续安装；当前运行的预发布版会保留，直到有更高正式版可升级。例如 0.16.0-beta.1 可以升级到 0.16.0-beta.2 或 0.16.0，关闭开关后不会退回 0.15.10。重启安装已开始时无法切换通道。
启动检查、自动下载、已下载候选恢复和手动安装共用这一开关。此设置只控制 AutoMAA 本体，MAA 引擎的稳定版与 Beta 更新仍在“MAA 环境”页单独选择。
旧版应用内更新只检查正式版。需要手动安装时，请在 GitHub Releases 下载正式版安装包，并按安装指南安装。
自动更新 MAA
“空闲时自动更新 MAA”默认关闭。开启后，在主 App 打开期间每 24 小时最多尝试一次稳定版，并避让正在运行的方案及 90 分钟内的定时任务。关闭开关只影响后续更新。
方案“执行安排… → 执行策略”中的“运行前更新识别数据”是独立设置，只在该方案开始前同步识别数据。后台定时 Runner 不会自行更新 AutoMAA 本体或 MAA 引擎，但仍遵循方案的运行前识别数据设置。
自动更新使用稳定通道，不会静默切换 Beta，也不会把尚未进入稳定通道的 Beta 引擎降级。
查看更新内容
AutoMAA 的版本信息旁始终保留“更新内容”入口，下载、取消或失败后也能打开。跨版本升级会按版本列出变化；“设置 → 关于 → 更新内容”可回看当前版本，支持离线阅读。
MAA 环境页“连接”右侧的“更新内容”菜单提供稳定版、Beta 发布说明及最近更新详情。更新开始后，“本次更新详情”显示安装信息；成功启用后显示引擎版本、基础数据时间和识别数据仓库修订的前后对照，历史记录可从“运行记录 → 更新内容”打开。
更新结束后点击“本次记录”，可直接定位到对应的运行记录详情。修改 maa-cli 路径后，环境版本显示“尚未检测”；请重新检测新路径，旧路径的检测结果不会覆盖它。
对应来源与修订可用时，详情提供上游说明和资源提交差异。上游可能包含其他 GUI 专属功能；资源活动名称也不等于完整变更清单。缺少信息时会明确标注，网络不可用时可阅读已缓存内容或单独重试，不影响更新操作。
耗时与取消
AutoMAA 更新包和 MAA 引擎包在取得下载量后显示“已下载 / 总大小”、百分比与进度条。下载完成后会切换到解压、识别数据同步或校验阶段；下载到 100% 不代表更新已启用。
MAA 引擎包积累足够的传输样本后显示近期平均速度和预计下载剩余时间，续传时只计算本次新增的字节。预计时间不包含资源同步和校验，也不保证网络速度保持不变。下载已有进展后，连续 5 分钟没有新增字节会停止本次传输，并按同一个总时限内最多重试一次的规则处理。Git 同步、解压和校验不按日志静默判断停滞。
识别数据同步、下载信息尚未就绪或当前 maa-cli 未提供可读取的下载信息时，只显示当前阶段和耗时，不估算百分比。重试从本次实际下载量重新显示；取消后等待清理完成，旧进度不会带到下一次更新。
| 操作 | 总时限，含重试与校验 |
|---|---|
| 版本检查、重新校验已下载的 AutoMAA 更新包 | 每项 30 秒 |
| 手动完整更新 MAA | 120 分钟 |
| 手动仅更新识别数据 | 20 分钟 |
| 空闲时自动更新 MAA | 30 分钟 |
| 方案运行前更新识别数据 | 3 分钟 |
| AutoMAA 下载与校验 | 15 分钟 |
手动维护为慢速网络预留更长时间；后台更新保持较短时限并避让即将开始的定时任务，运行前识别数据更新仍保持 3 分钟。临时网络错误（包括 HTTP/2 传输中断）最多重试一次，重试计入同一个总时限；连接断开、服务器拒绝或校验失败可能提前结束，并不一定等待到总时限。校验失败和主动取消不会触发网络重试。
点击进度右侧的圆圈叉号“取消更新”，或按 Command-. 后，等待进程和临时文件清理完成。取消 AutoMAA 下载后，本次打开期间不会自行重新下载，仍可手动继续。确认重启安装之后，替换过程不再提供取消。
MAA 引擎包的部分下载和完整包会保留，取消、超时或重启 App 后，再次更新同一来源和版本时由 maa-cli 尝试续传或复用。下载服务器不支持续传时会重新下载；包信息变化或缓存损坏时会丢弃旧文件。完整包下载后若识别数据同步失败，下次仍可复用引擎包。缓存最多保留 7 天、总量不超过 2 GiB，并在维护时清理。
识别数据通过 Git 增量同步和小文件缓存更新，不使用引擎压缩包的字节续传。候选引擎与资源始终独立准备，保留下载缓存不代表组件已启用。
更新失败时
MAA 候选组件通过兼容性校验后才会启用，失败或取消保留当前安装。方案运行前下载失败时会校验本地数据，可用才继续；主动取消则停止整个方案。
若提示引擎与识别数据不兼容，先尝试“更新 MAA”。稳定版仍不兼容时，可明确确认尝试 Beta，或等待稳定版修复；Beta 也必须通过同样的校验。当前安装不可用时，AutoMAA 会在启动游戏前停止。