M9A 配置方法
提示
M9A 适配正在开发中，期间可能存在 bug，请在保留好原有通用脚本配置的同时使用专用脚本。
什么是 M9A？
M9A 是一个《1999》（亿韭韭韭）第三方软件，能够轻松完成1999日常代理、自动深眠、活动刷取等重复性工作。
基于 MaaFramework 图像识别技术强力驱动。
详情信息请查阅：
安装 M9A
注意
- 请确保已安装 VCRedist x64
- 请确保已安装 .NET 10 桌面运行时
配置脚本
- 进入 脚本管理，单击 新建脚本 并选择 M9A脚本 以添加脚本实例管理页面。
- 在 打开的脚本配置 中的 M9A路径 单击 选择文件夹，打开 M9A 软件所在目录。
- 在 模拟器管理 中选择模拟器和模拟器实例。
如果此处没有模拟器，请先完成 模拟器管理配置
运行配置项
M9A 脚本提供以下运行控制参数：
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 代理次数限制 | 单个用户每日最大代理次数，0 表示无限制 | 0 |
| 运行次数限制 | 任务异常时的最大重试次数 | 3 |
| 运行时间限制 | 单次任务最大运行时间（分钟），超时将强制终止 | 10 |
| 队列结束后自动更新 | 批量任务完成后，若检测到新版本则自动更新 M9A 资源 | 关闭 |
💡 提示: 开启"队列结束后自动更新"后，AUTO-MAS 会在所有真实用户任务完成后，启动虚拟用户执行资源更新，并在更新成功后发送桌面和 Webhook 通知。
⚠️ 重要: 使用自动更新功能前，请确保已手动打开 M9A 并在 M9A 设置中 单独开启资源更新渠道（选择 Mirror 酱 或 GitHub），否则自动更新将无法正常工作。
首次运行前准备
重要
首次在 AUTO-MAS 中使用 M9A 前，请先手动启动一次 M9A，完成以下初始化操作：
- 手动启动 M9A 主程序（
M9A.exe） - 等待 M9A 完成初始化（日志显示 "AgentServer 启动" 后，等待 "任务已全部完成"）
- 在 M9A 设置中：
- 配置 资源下载源（选择 Mirror 酱 或 GitHub）
- 填写 CDK 或 Token（用于更新资源）
- 由您自行在 M9A 中确定是否开启 自动更新 和选择 更新渠道
- 确认后关闭 M9A
完成以上步骤后，回到 AUTO-MAS 点击 保存配置。
配置用户
- 在 脚本管理 的脚本表格内，单击 添加用户 以添加用户。
- 按照设置卡相关提示填写用户信息。
- 可以添加多个用户，AUTO-MAS 会按照用户列表顺序依次执行每个用户的任务队列。
任务队列配置
M9A 支持的任务包括（以软件实际版本为准）：
| 任务 | 说明 |
|---|---|
| 收取荒原 | 收取荒原资源 |
| 每日心相（意志解析） | 自动完成意志解析 |
| 常规作战 | 日常关卡作战 |
| 活动刷取 | 自动刷取活动关卡 |
| 自动深眠 | 自动完成深眠挑战 |
| 自动醒梦 | 自动完成醒梦 |
| 银行购物 | 自动银行购物 |
| 领取奖励 | 自动领取各类奖励 |
在用户配置页面中，您可以从任务列表中选择需要执行的任务，添加到任务队列中，并调整执行顺序。
预设模板
当任务队列为空时，系统会显示 日常-长草 预设模板，一键即可批量添加常用任务到队列中。
日常-长草 模板包含以下任务（适用于无活动或换完商店时的日常刷取）：
| 任务 | 说明 |
|---|---|
| 收取荒原 | 收取荒原资源 |
| 每日心相（意志解析） | 自动完成意志解析 |
| 常规作战 | 日常关卡作战 |
| 自动深眠 | 自动完成深眠挑战 |
| 自动醒梦 | 自动完成醒梦 |
| 银行购物 | 自动银行购物 |
| 领取奖励 | 自动领取各类奖励 |
| 使用兑换码 | 自动使用兑换码 |
💡 提示: 预设模板仅作为快速添加入口的辅助功能，您仍可以通过 添加任务 按钮手动构建任务队列，或者在预设任务基础上增删改。一键添加时，若部分任务未找到对应脚本定义，已自动跳过。
账号切换功能
M9A 支持自动切换账号功能，便于多账号管理：
- 在用户配置页面的 账号信息 字段中填写要切换的目标账号（仅官服有效）
- 当服务器资源选择为 官服 且填写了账号信息时，AUTO-MAS 会自动在任务队列开头插入 切换账号 任务
- 切换账号任务会在 启动游戏 之后、用户自定义任务之前执行
💡 提示: 若无需切换账号，请留空账号信息字段。其他服务器暂不支持账号切换功能。
已知限制
- ✅ 官服：支持（唯一支持账号切换功能的服务器）
- ✅ B服：支持（受 M9A 限制，不支持账号切换）
- ✅ 其他服务器：支持（受 M9A 限制，不支持账号切换）
- ✅ MuMu 模拟器：支持
- ✅ 雷电模拟器：支持
- ❌ 通用模拟器：未测试
- ❌ MXU 图形界面：不支持，仅支持 MFAAvalonia
配置说明
以下为 自动代理 模式下，AUTO-MAS 针对 M9A 的配置策略。
- 用户配置页展示的配置项优先生效。
- AUTO-MAS 会根据您配置的任务队列，自动构建 M9A 的实例配置文件。
- 任务队列自动构建规则：
- 自动在队列开头添加 启动游戏 任务
- 若为官方服务器且填写了账号信息，自动在 启动游戏 后插入 切换账号 任务
- 自动过滤用户手动添加的 启动游戏、关闭游戏、切换账号 任务（避免重复）
- 自动在队列末尾添加 关闭游戏 任务
- 自动跳过标记为
standalone的独立任务 - 最终执行顺序：
启动游戏 → [切换账号] → 用户自定义任务 → 关闭游戏
- 配置安全保障：
- AUTO-MAS 会在运行前自动备份 M9A 的整个
config目录 - 运行期间只修改
config/instances/default.json文件 - 您的
config.json全局配置不会被修改 - 任务结束后会自动还原原始配置
- AUTO-MAS 会在运行前自动备份 M9A 的整个
配置隔离机制
工作原理
AUTO-MAS 实现了完整的配置隔离机制，确保您的 M9A 原始配置安全：
- 运行前备份：将整个
config目录备份到临时路径 - 运行时隔离：只修改实例配置文件，全局配置保持不变
- 运行后还原：完整恢复原始配置状态
优势
- ✅ 配置安全：不用担心配置被污染
- ✅ 自动还原：每次运行都是干净的状态
- ✅ 调试友好：自动保存历史配置备份（
data/script_id/test*.json）
M9A 自动更新机制
功能说明
当开启 队列结束后自动更新 选项后，AUTO-MAS 会在所有真实用户任务完成后自动检测并更新 M9A 资源：
- 版本检测：在首个用户运行期间，AUTO-MAS 会监控 M9A 日志，检测是否有新版本提示
- 虚拟用户更新：若检测到新版本，系统会启动一个虚拟用户（不连接模拟器），仅用于执行资源更新
- 更新监控：实时监控更新过程，检测网络中断、HTTP 错误、超时等异常
- 通知推送：更新成功或失败后，会发送桌面通知和 Webhook 通知
更新失败处理
若更新失败，系统会：
- 记录详细错误日志到
data/script_id/目录 - 发送包含失败原因的通知（如"网络连接中断"、"HTTP 请求失败"等）
- 保留当前版本，不影响下次正常运行
注意事项
- 更新期间 M9A 会自动重启应用，这是正常现象
- 更新超时时间为 10 分钟
- 建议在网络稳定的环境下开启自动更新
常见问题
Q: 可以在一个脚本下添加多个用户吗？
A: 需要确认您的M9A版本，新版本M9A已支持指定账号切换，您可以依托新版本的M9A自行构建账号切换任务。AUTO-MAS 支持在单个脚本下管理多个用户，会依次执行每个用户的任务队列。
Q: 支持哪些模拟器？
A: 已测试支持 MuMu 模拟器 和 雷电模拟器。其他模拟器未测试，可能存在兼容性问题。
Q: 支持 MXU 图形界面吗？
A: 不支持。M9A 适配仅支持 MFAAvalonia 图形界面。
Q: 我的 M9A 配置会被修改吗？
A: 不会。AUTO-MAS 只修改 config/instances/default.json，并且会在任务结束后完整还原您的原始配置。
Q: 如何查看之前运行的配置（主要用来debug）？
A: 每次运行的配置都会保存到 data/script_id/test*.json，最多保留最近 5 个备份。
Q: 任务执行失败怎么办？
- 检查运行时模拟器连接状态
- 查看日志文件分析错误原因
- 在
data/script_id/目录下查看历史配置进行对比
Q: 任务队列需要手动添加"启动游戏"和"关闭游戏"吗？
A: 不需要。AUTO-MAS 会自动在任务队列开头添加 启动游戏，在末尾添加 关闭游戏。如果您手动添加了这些任务，系统会自动过滤以避免重复执行。
Q: "队列结束后自动更新"是如何工作的？
A: 开启后，系统会在所有真实用户任务完成后，检测 M9A 是否有新版本。若有新版本，会启动一个虚拟用户（不连接模拟器，仅用于更新），自动下载并应用最新的 M9A 资源包。更新完成后会发送通知告知结果。
Q: 为什么我的代理次数没有增加？
A: 代理次数以 UTC+4 时区的日期为准。如果当天的代理次数已达到脚本配置中的 代理次数限制，后续用户将被跳过。每日首次代理时会自动重置计数器。