首次配置
完成安装后，建议先用一个方案在有人值守时跑通完整流程，再逐个启用定时运行。
1. 检查全局设置
打开“全局设置”，确认：
maa-cli路径正确；Apple Silicon Homebrew 通常是/opt/homebrew/bin/maa；- “检测环境”能够显示 maa-cli 与 MaaCore 版本；需要时使用“更新核心与基础资源”和“热更新识别资源”；
- 游戏客户端已经手动完成包体更新、数据下载、协议确认和登录。
“运行前热更新 MAA 资源”位于每个方案的执行策略中，只更新 MAA 资源，不会下载或更新游戏包体。
2. 添加客户端
在侧边栏“客户端与账号”旁点击添加按钮。每个客户端需要：
| 配置 | 说明 |
|---|---|
| 名称 | 仅用于界面与日志，例如“简中服客户端”“日服客户端” |
| 服务器 | 决定 MAA 的资源和服务端参数 |
| 游戏 App | 选择当前连接环境中的游戏 .app |
| MaaTools 地址 | PlayCover + MaaTools 通常使用 127.0.0.1:1717 |
| MAA Profile | 每个客户端必须唯一，例如 client-cn、client-jp |
| Bundle Identifier | 用于精确识别和关闭当前客户端 |
客户端会严格按照侧边栏顺序串行运行。不要给两个客户端配置相同的 Profile。
客户端、账号和自动化方案顶部都有带铅笔图标的名称框，可随时改成容易辨认的显示名称。名称只用于界面、活动记录和提示；重命名不会改变对象的内部标识，也不会让既有方案、当日断点或定时任务失效。MAA Profile 是单独的技术标识，仍需保持非空且互不重复。
3. 添加账号
一个客户端可以包含任意数量账号。账号只描述“是谁、如何切换”，不再重复保存任务参数。
添加账号后会直接进入账号编辑页，可以先把“新账号”改成“主账号”“小号”等仅自己看得懂的名称；不要把密码或完整手机号写进名称。
- 只有一个启用账号时，“账号匹配片段”可以留空。
- 官服、Bilibili 与繁中服有多个启用账号时，每个账号都必须填写非空、互不重复的匹配片段。
- 填写登录页中足以唯一识别账号的短片段，例如手机号末四位；不要填写完整手机号。
- MAA 当前不支持 YoStar 国际服、日服和韩服自动切换账号；这些客户端只启用一个账号、将片段留空，并在运行前确认游戏当前登录的是目标账号。
- AutoMAA 不读取、不保存游戏密码，也不会处理验证码。
第一次多账号运行时请留意登录页，确认 MAA 选中了正确账号。
4. 配置自动化方案
首次启动会提供两个可自由修改的模板：
- 轻量日常：理智作战、公开招募、基建仅收菜、领取奖励；
- 完整日常：理智作战、公开招募、基建完整换班、信用与购物、领取奖励。
方案名称同样可以直接编辑，例如改成“工作日早晨”“周末清理”或“睡前日常”。
每个方案都可以：
- 自动包含所有已启用账号，或只勾选指定账号；
- 启用、关闭和调整任务顺序；
- 为任务使用 MAA 推荐参数，或开启 AutoMAA 的可视化自定义参数；
- 单独设置资源热更新、失败重试和继续策略；
- 手动运行，或设置独立的每日定时时间。
新增账号后，“所有已启用账号”方案会自动包含它；精确选择账号的方案不会被悄悄改变。
5. 检查并运行
打开要执行的方案，或回到“自动化总览”：
- 确认目标账号、步骤顺序和任务参数；
- 处理“运行检查”中的错误和警告；
- 点击方案的“立即运行”或“运行”；
- 观察首次账号切换、任务结果、客户端关闭和下一客户端启动。
运行中可随时点击“安全停止”或按 Command-.。AutoMAA 会先终止当前 MAA 命令，再关闭游戏和释放连接。
6. 验证结果
在“活动记录”中打开最近一次运行并确认：
- 每个目标账号都显示“已进入”；
- 成功任务显示“完成”；
- 客户端切换前显示“端口已释放”；
- 最后显示当前方案已完成，或给出明确的人工处理提示。
活动记录只呈现日常确认需要的信息。若某一步提供“诊断详情”，可按需展开；提交问题时还可从右上角菜单在 Finder 中打开完整诊断日志。
轻量方案与完整方案的完成记录彼此独立：早上完成过“理智作战”，不会让晚间方案误跳过同名步骤。流程稳定后再配置每日自动运行。