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,...>

支持的任务别名：

示例:

• /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 插件模板