更新应用与 MAA
日常在“全局设置”中管理更新。先根据需要选择更新对象：
| 入口 | 适用情况 | 更新范围 |
|---|---|---|
| AutoMAA 更新 | 获取界面与工作流功能改进 | AutoMAA App，确认重启后安装 |
| 更新 MAA | 升级任务引擎或解决资源兼容问题 | MaaCore、随包基础识别数据及最新增量数据 |
| 仅更新识别数据 | 同步关卡、活动和界面识别规则 | 规则与图片增量，不更换 MaaCore |
“更新 MAA”已包含识别数据同步，不需要再点一次“仅更新识别数据”。基础数据随引擎发布，增量数据单独发布，两者共同供 MaaCore 识别游戏界面。
maa-cli 通过原安装方式单独升级，例如 Homebrew；游戏包体与游戏内数据由用户在游戏运行环境中处理，见游戏更新与人工处理。
更新 AutoMAA
AutoMAA 启动时检查正式版本，也可手动点击“检查更新”：
- 查看新版本内容，选择“下载并校验”。
- 等待校验完成，点击“重启并立即更新”。
- App 退出、替换并重新打开，原有配置保留；配置兼容性以该版本的发布说明为准。
“自动下载并准备更新”默认关闭。开启后，App 会在空闲时下载并校验，安装仍需确认重启。已准备好的更新可在下次启动后继续安装；失败时保留或恢复旧 App。
App 应位于“应用程序”等可写目录中。直接在 DMG 中运行时，请先完成安装。
自动更新 MAA
“空闲时自动更新 MAA”默认关闭。开启后，在主 App 打开期间每 24 小时最多尝试一次稳定版，并避让正在运行的方案及 90 分钟内的定时任务。关闭开关只影响后续更新。
方案中的“运行前更新识别数据”是独立设置，只在该方案开始前同步识别数据。后台定时 Runner 不会自行更新 AutoMAA 本体或 MAA 引擎，但仍遵循方案的运行前识别数据设置。
自动更新使用稳定通道，不会静默切换 Beta，也不会把尚未进入稳定通道的 Beta 引擎降级。
查看更新内容
AutoMAA 的版本信息旁始终保留“更新内容”入口，下载、取消或失败后也能打开。跨版本升级会按版本列出变化；“关于 AutoMAA → 本版本更新内容”可回看当前版本，支持离线阅读。
MAA 可在更新前查看稳定版或 Beta 发布说明。更新开始后，“本次更新详情”显示安装信息；成功启用后显示引擎版本、基础数据时间和识别数据仓库修订的前后对照，历史记录可从“活动记录 → 更新内容”打开。
对应来源与修订可用时，详情提供上游说明和资源提交差异。上游可能包含其他 GUI 专属功能；资源活动名称也不等于完整变更清单。缺少信息时会明确标注，网络不可用时可阅读已缓存内容或单独重试，不影响更新操作。
耗时与取消
| 操作 | 总时限，含重试与校验 |
|---|---|
| 版本检查、重新校验已下载的 AutoMAA 更新包 | 每项 30 秒 |
| 仅更新识别数据，含运行前更新 | 3 分钟 |
| 完整 MAA 更新、AutoMAA 下载与校验 | 15 分钟 |
自动与手动更新共用这些规则。临时网络错误最多重试一次；连接断开、服务器拒绝或校验失败可能提前结束，并不一定等待到总时限。
点击“取消更新”或按 Command-. 后，等待进程和临时文件清理完成。取消 AutoMAA 下载后，本次打开期间不会自行重新下载，仍可手动继续。确认重启安装之后，替换过程不再提供取消。
更新失败时
MAA 候选组件通过兼容性校验后才会启用，失败或取消保留当前安装。方案运行前下载失败时会校验本地数据，可用才继续；主动取消则停止整个方案。
若提示引擎与识别数据不兼容，先尝试“更新 MAA”。稳定版仍不兼容时，可明确确认尝试 Beta，或等待稳定版修复；Beta 也必须通过同样的校验。当前安装不可用时，AutoMAA 会在启动游戏前停止。