想想,既然这是一个交互性的非AI的BOT,还是发出来吧
现在已经是史山了,不建议参考
您可以使用更轻量的 DownRota(开发状态请自行在我名下搜索)
原因如下
找不到直接 @RotaBOT 的方法,得重构了 而且屋漏偏逢连夜雨,GitHub SSH 不上了,已跑比去 gitcode
ProxyRota 是一个面向 Rotaeno 玩家的自动化 B40 / Rating 追踪工具。它通过 QQ 官方机器人协议,作为一个“代理”自动与群内的查询机器人(如 RotaBOT)交互,定时拉取并保存你的 B40 图片,方便在 OBS 等直播软件中实时展示。
项目采用 生产者-消费者 架构:GUI 或定时器作为生产者,将指令放入队列;唯一的后台 Worker 作为消费者,串行执行指令,从根本上杜绝了多指令并发导致的状态错乱。同时,针对扫码登录、快捷登录、定时拉取等场景,代码做了精细的状态隔离与超时处理。
- 定时自动拉取:按设定间隔,自动执行
/r update→/b40,并将 B40 图片保存到本地。 - 通用图片捕获:除 B40 外,手动执行的任何指令(如
/r me、/r chart)如果返回图片,也会自动保存,支持通过{cmd}占位符自定义文件名。 - 精准登录拦截:
- 识别
/login cn|global|国服|国际服,进入带 130 秒倒计时的扫码等待状态,期间暂停定时任务,并支持手动取消。 - 识别好友码 / 会话码格式,走瞬时完成的“快捷登录”流程。
- 无参数的
/login原样放行,用于获取官方帮助文本。
- 识别
- 单 Worker 队列:所有指令(定时、手动、登录)进入同一队列串行执行,不会出现两条消息同时发给 RotaBOT 的情况。
- GUI 控制台:基于 Tkinter,提供状态栏、实时日志、登录按钮与指令输入框,与后台异步事件循环安全隔离。
- 配置外置:敏感凭证(AppID、AppSecret、OpenID)全部通过
.env文件管理,适合直接开源。
- Python 3.8+
- 一个已通过 QQ 开放平台认证的机器人应用(个人主体即可)
- 已加入 RotaBOT 的 QQ 群聊
pip install -r requirements.txt复制 .env.example 为 .env,填入你的信息:
APP_ID=你的AppID
APP_SECRET=你的AppSecret
GROUP_OPENID=目标群的OpenID
ROTABOT_OPENID=RotaBOT的OpenID
SAVE_PATH_B40=b40_latest.png
SAVE_PATH_OTHER=img_{cmd}.pngAPP_ID 和 APP_SECRET 可以在 QQ 开放平台的机器人开发设置页找到。两个 OpenID 无法直接查看 QQ 号获得,需要通过其它方法来捕获。
具体方法详见 OpenID.md。
python proxy_rota.py启动后,Tkinter 控制台会显示连接状态。点击“登录 国服”或“登录 国际服”完成首次绑定,之后定时任务便会按默认 300 秒的间隔自动拉取 B40。
- 扫码登录:点击 GUI 按钮或在输入框输入
/login cn(国服)//login global(国际服)。程序会拦截该指令,进入专用登录状态,请直接在群聊中扫描 RotaBOT 发出的二维码,程序本身不显示二维码。扫码成功后状态自动解除;若 2 分钟内未扫码,程序会捕获 RotaBOT 的超时回显并安全退出登录状态。你也可以随时点击“放弃登录”手动终止。 - 快捷登录:直接在输入框发送
/login 你的好友码或/login 你的会话码。程序会将其识别为瞬时任务,发送后等待“绑定成功”或错误回显,并立即打印结果。
输入框支持发送任意 @RotaBOT 指令。指令执行后:
- 如果 RotaBOT 返回图片,程序会根据
.env中的SAVE_PATH_OTHER模板自动保存。例如发送/r chart,默认会保存为img__r_chart.png;多图会自动追加_0、_1等序号。 - 如果返回纯文本(如错误提示、帮助信息),会直接显示在日志区。
- 登录扫码期间,程序会拦截所有非登录指令,防止干扰 RotaBOT 的登录上下文。
将 .env 中的 SAVE_PATH_B40 指向的图片文件添加为 OBS 的图像源,并勾选“当文件发生变化时重新加载”(或使用脚本定时刷新)。每当程序完成一次 B40 拉取并覆盖该文件,OBS 画面便会自动更新。
- 不要将
.env提交到 Git。.gitignore已默认排除该文件。 - RotaBOT 的服务由社区开发者维护,使用时应遵守其使用规范,避免高频轰炸指令。
- 本项目使用 QQ 官方机器人协议,不涉及第三方框架,无封号风险,但也因此受限于官方 API 的能力边界(例如无法主动获取群成员列表,OpenID 必须通过事件被动捕获)。
MIT License。欢迎提交 Issue 与 PR。
ProxyRota 的核心价值在于“代理”与“排队”:它不重新实现查询逻辑,而是让一个合规的官方机器人替你完成“发指令 → 等回复 → 存图片”的枯燥循环。如果你在部署或使用中遇到问题,欢迎在 Issues 中反馈。
该 README.md 由 DeepSeek 生成。
以下是 ProxyRota 的 README.md 文件。其中“配置说明”部分详细介绍了如何获取两个关键的 OpenID,这是项目能否成功运行的第一步。