AstrBot MAA 远程控制插件 (astrbot_plugin_maa)

通过 AstrBot 远程控制 MAA Assistant Arknights（一款明日方舟游戏小助手）

特性

• 远程控制: 支持通过 QQ 等消息平台远程启动 MAA 任务
• 多任务队列: 支持一次下发多个任务，按顺序执行
• 实时反馈: 任务完成时自动发送通知，并可选自动发送截图

快速开始

1. 安装插件

在 AstrBot 中安装本插件

2. 获取设备 ID

1. 打开 MAA 客户端。
2. 进入 设置 -> 连接设置。
3. 找到并复制 设备标识符 (一段长字符串)。

3. 绑定设备

向机器人发送以下指令进行绑定：

/maa bind <你的设备标识符>

成功后，机器人会告知你需要填入 MAA 的配置信息。

4. 配置 MAA

在 MAA 客户端的 设置 -> 连接设置 中配置：

• 获取任务端点: http://<你的服务器IP>:2828/maa/getTask
• 汇报状态端点: http://<你的服务器IP>:2828/maa/reportStatus
• 用户标识符: 填入你在绑定成功后bot告知你的那一串字符串

Warning

如果你的服务器在局域网内，请确保 IP 地址正确；如果在公网，请确保端口 (默认 2828) 已开放。 如果该端点为 http 协议，MAA 会在每次连接时发出不安全警告。在公网部署明文传输服务是一种非常不推荐且危险的行为，仅供测试使用。

指令

基础指令

• /maa bind <ID>: 绑定 MAA 设备
• /maa unbind: 解绑当前设备
• /maa status: 查看 MAA 设备在线状态及待执行任务
• /maa screenshot (或 /maa ss): 立即获取当前模拟器截图
• /maa stop: 停止当前正在执行的任务
• /maa heartbeat: 发送心跳检测

执行任务

/maa start <任务1,任务2,...>

支持的任务别名：

任务类型	可选别名
所有任务	ALL
基建换班	Base, 基建, 基建换班
开始唤醒	WakeUp, 开始唤醒
刷理智	Combat, 刷理智
自动公招	Recruiting, 公招, 自动公招
信用购物	Mall, 信用, 获取信用及购物
领取奖励	Mission, 领取奖励
自动肉鸽	AutoRoguelike, 肉鸽, 自动肉鸽
生息演算	Reclamation, 生息演算

示例:

• /maa start ALL (一键长草)
• /maa start 刷理智 (单个任务)
• /maa start 开始唤醒,刷理智,信用,领取奖励 (按序执行多个任务)

也可以使用 /maa linkstart 来执行一键长草喵

插件配置

在 AstrBot 管理面板或 config.yaml 中可配置：

• http_host: HTTP 服务监听地址 (默认 0.0.0.0)
• http_port: HTTP 服务监听端口 (默认 2828，因为2月8日是帕拉斯干员的生日)
• auto_screenshot: 任务完成后是否自动发送截图 (默认 true)

Warning

如果你需要发送截图功能，请务必注意你的端点可接受的最大请求大小，因为截图可能会有数十MB，会超过一般网关的默认大小限制。

Changelog

v1.0.0

• 基本功能实现
• feat: 支持通过/maastart设置子任务
• feat: 支持设置是否每项任务完成后立即发送通知

开源协议

AGPL-3.0

参考资料

• MAA Assistant Arknights
• 远程控制协议 | MAA 文档站
• AstrBot 插件模板