🌱 QQ 农场助手
插件名称： astrbot_plugin_qqfarm
仓库 metadata 版本： 1.0.0
通过 AstrBot 连接 QQ Farm Bot UI，查看账号状态、更新账号 Code，并启动或停止农场账号。
该插件不是完整的 QQ 农场游戏本体，而是一个账号管理入口。能否正常使用取决于管理员是否已经部署并配置 QQ Farm Bot UI 服务。
🚀 快速开始
| 命令 | 说明 |
|---|---|
@bot 农场帮助 | 查看农场助手命令 |
@bot 农场状态 | 查看所有农场账号的运行状态 |
@bot 农场详情 账号ID | 查看指定农场账号详情 |
@bot 更新农场Code 账号ID Code | 更新指定账号的 Code |
@bot 启动农场 账号ID | 启动指定农场账号 |
@bot 停止农场 账号ID | 停止指定农场账号 |
📊 查看账号状态
查看全部账号
@bot 农场状态
用于查看 QQ Farm Bot UI 中已经添加的农场账号及其当前状态。
查看指定账号详情
@bot 农场详情 1
将 1 替换为实际账号 ID。
README 没有列出详情结果的完整字段，因此具体显示内容以 bot 实际返回为准。
🔑 更新账号 Code
@bot 更新农场Code 账号ID Code
示例：
@bot 更新农场Code 1 ABCDEFG
该命令会把指定账号的 Code 更新到 QQ Farm Bot UI 服务中。
Code 可能属于账号登录或授权凭证。建议只在私聊中发送，不要在公开群聊中展示，也不要转发给其他人。
▶️ 启动与停止账号
启动账号
@bot 启动农场 1
停止账号
@bot 停止农场 1
启动和停止操作只会影响指定账号，账号 ID 必须与 QQ Farm Bot UI 中的记录一致。
🧩 使用前提
管理员需要提前配置：
| 配置项 | 作用 |
|---|---|
base_url | QQ Farm Bot UI 服务地址，必填 |
token | 服务使用的 x-admin-token |
admin_password | 用于登录并获取新 token 的管理员密码 |
token 与 admin_password 至少需要填写一个。
普通用户不需要知道这些值，也不应向其他人索要或传播管理员 token 和密码。
⚠️ 使用注意
- 未配置
base_url时，插件会提示管理员完成配置。 token与管理员密码都未配置时，插件无法正常调用管理接口。- 更新 Code、启动账号和停止账号都属于账号管理操作。
- 仓库 README 没有明确列出每个命令的权限范围，本站是否开放给普通用户以实际 AstrBot 权限配置为准。
- Code、token 和管理员密码都应视为敏感凭证。
- 外部 QQ Farm Bot UI 服务不可用时，命令可能超时或报错。
❓ 常见问题
Q：为什么提示未配置服务地址？
管理员尚未填写 base_url，需要先在插件配置页面设置 QQ Farm Bot UI 地址。
Q：为什么能查看状态，却无法启动或停止账号？
可能是 token 已失效、管理员密码不正确，或者服务端拒绝了管理操作。
Q：账号 ID 是 QQ 号吗？
README 只写明参数为“账号 ID”，没有说明它一定等于 QQ 号。请以 @bot 农场状态 返回的账号标识为准。
Q：为什么更新 Code 后仍然不能运行？
可能是 Code 无效、已过期，或 QQ Farm Bot UI 本身存在错误。需要管理员查看服务端日志。
Q：可以在群聊里发 Code 吗？
不建议。Code 可能包含账号授权信息，应在私聊或其他安全环境中发送。
📎 项目信息
- 显示名称：QQ 农场助手
- 仓库 metadata 版本：1.0.0
- 作者：sanqi-ya
- 项目地址：https://github.com/sanqi-ya/astrbot_plugin_qqfarm
