如果这个插件对你有帮助，请点亮⭐支持一下！
✅ 账号管理 - 扫码登录 (QQ/微信)/凭证导入/多账号切换/删除绑定，主账号快速切换
✅ 消息撤回 - 登录链接与二维码超时、完成或被拒时自动撤回，保护账号安全
✅ 数据查询 - 个人档案可视化渲染、近期对战详情、背包精灵图鉴检索、交换大厅、阵容推荐
✅ 图片展示 - 深度还原 WeGame 各级视觉效果的排版与艺术风格字体字形重绘，自带自适应宽度渲染
✅ 阵容助手 - 热门阵容推荐、2x3 网格布局展示、阵容码查询、详细技能配置
在 AstrBot 插件管理器中搜索 astrbot_plugin_rocom 安装，或通过 Git 克隆：
cd AstrBot/data/plugins
git clone https://github.com/Entropy-Increase-Team/astrbot_plugin_rocom.git确保已安装 Playwright 浏览器内核：
playwright install chromium| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
api_base_url |
string | https://wegame.shallow.ink |
API 服务后端地址 |
wegame_api_key |
string | 无 | |
render_timeout |
number | 30000 |
图片渲染超时时间（毫秒） |
astrbot_plugin_rocom/
├── main.py # 插件入口，指令路由
├── metadata.yaml # 插件元数据
├── _conf_schema.json # WebUI 配置 schema
├── core/ # 核心逻辑
│ ├── client.py # API 异步客户端
│ ├── user.py # 用户数据中心
│ └── render.py # HTML 渲染助手
├── data/ # 持久化存储
│ └── users.json # 用户绑定数据
├── img/ # 各项渲染所需依赖底图
├── ttf/ # 无衬线免税字体库
└── render/ # 网页模板资源
├── bind-list/ # 绑定列表与多账号面板模板
├── menu/ # 帮助菜单模板
├── package/ # 背包图鉴汇总模板
├── personal-card/ # 洛克档案面板模板
├── record/ # 对战回放数据模板
├── exchange-hall/ # 洛克交换大厅模板
├── lineup/ # 洛克阵容助手模板
└── lineup-detail/ # 阵容详情模板
💡 指令前缀：默认为
/，在 AstrBot 配置中自定义
| 指令 | 说明 |
|---|---|
洛克QQ登录 |
使用 QQ 扫码快捷登录及绑定 |
洛克微信登录 |
使用微信扫码快捷登录及绑定 |
洛克导入 [ID] [Ticket] |
通过客户端扫尾凭证手动导入登录 |
洛克刷新 |
刷新当前有效主账号 QQ 凭证生存期 |
洛克绑定列表 |
查看所有已扫描绑定的账号记录 |
洛克切换 [序号] |
一键切换当前群聊激活的前置主查询账号 |
洛克解绑 [序号] |
移除不再需要的冗余账号绑定内容 |
| 指令 | 说明 |
|---|---|
洛克档案 |
生成全盘概览的个人数据雷达星级名片 |
洛克战绩 [页码] |
查询并展示指定历史对战记录的对手及结果 |
洛克背包 [分类] [页码] |
展示对应条件精选收藏情况，支持分类如 了不起、异色、炫彩 等 |
洛克交换大厅 [页码] |
浏览其他玩家的精灵交换请求列表 |
洛克阵容 <分类> <页码> |
查看热门阵容推荐及组成，2x3 网格布局展示 |
查看阵容 <阵容码> |
查看指定阵容的详细信息，包含精灵技能配置 |
💡 发送
洛克可查看插件完整且精美的图片图解版内置帮助。
点击展开预览图
洛克档案 |
洛克战绩 |
|---|---|
 |
 |
洛克背包 |
洛克交换大厅 |
|---|---|
 |
 |
洛克阵容 |
查看阵容 |
|---|---|
 |
阵容详细信息 |
你可以通过替换内部图片的方式实现基础的背景个性化：
路径： AstrBot/data/plugins/astrbot_plugin_rocom/img/
| 功能 | 文件 |
|---|---|
| 背景图 | bg.C8CUoi7I.jpg |
| 战绩背景 | record-bg.C1mPRb4R.png |
- 基础查询 (个人档案/战绩/背包)
- 交换大厅 (精灵交换请求列表)
- 阵容助手 (阵容列表/详情查询)
- 更多功能 (敬请期待)
点击展开版本历史
新增
- 新增
/洛克刷新所有凭证指令（管理员专用），支持手动批量刷新所有用户凭证 - 手动刷新指令执行前会提示自动刷新功能已配置，仅作调试或强制兜底使用
- 绑定失败时不再保存无效绑定记录
- 改进绑定成功提示格式
优化
- 增强刷新结果统计，显示总用户数、成功数、失败数、跳过数（非 QQ 登录）
- 手动刷新指令最多显示 20 条详细结果
修复
- 修复自动刷新任务生命周期管理
- 修复自动刷新通知发送逻辑
- 修复绑定时未验证角色信息导致无效凭证也能成功绑定的问题
- 优化绑定失败提示，明确告知用户凭证可能无效或已过期
- 新增绑定成功时自动设置为主账号
新增
- 新增自动刷新凭证功能，支持定时刷新所有用户的 QQ 登录凭证
- 支持配置刷新时间（默认每天 00:00 和 12:00）
- 支持配置刷新结果通知群号
优化
- 增强清理绑定统计信息，显示检查用户数、移除数和剩余数
- 优化日志记录，记录每个被删除绑定的用户 ID
修复
- 修复对战记录胜负判断逻辑，API 返回 1 为失败，0 为胜利
- 修复
/洛克删除无效绑定指令修正为清理所有用户的无效绑定（管理员专用） - 修复
/洛克刷新指令响应检查逻辑
优化
- 增强清理绑定统计信息，显示检查用户数、移除数和剩余数
- 优化日志记录，记录每个被删除绑定的用户 ID
修复
- 修复对战记录胜负判断逻辑，API 返回 1 为失败，0 为胜利
/洛克删除无效绑定指令修正为清理所有用户的无效绑定（管理员专用）
修复
- 修复对战记录胜负判断逻辑，API 返回 1 为失败，0 为胜利
新增
- 新增
/洛克删除无效绑定指令（管理员） - 新增双设备扫码提醒
修复
- 修复登录流程，扫码后自动绑定账号
- 修复
/洛克刷新、/洛克阵容错误处理 - 修复洛克背包换页无效问题
- 修复登录消息缺少艾特用户
新增
- 新增
/洛克删除无效绑定指令 - 新增双设备扫码提醒
优化
- 更新登录流程，自动调用绑定 API
- 修复
/洛克刷新使用正确的 API - 优化错误处理和日志记录
新增
- 新增
/洛克交换大厅、/洛克阵容、/查看阵容指令 - 新增精灵背包分类筛选（全部/异色/了不起/炫彩）
优化
- 重构阵容页面为 2x3 网格布局
- 修复页脚显示问题
- 支持背包参数交换位置
- ✨ 初始版本发布
- ✅ 支持 QQ/微信扫码登录
- ✅ 个人档案、战绩、背包查询
- ✅ 图片渲染输出
- Astrbot：Soulter/AstrBot 提供强大的机器人开发与部署平台支撑
特别感谢：
- 熵增项目组 - 对各类抓取代理转发能力的构筑
本插件界面 UI 由原平台页面自研拆解逆向还原成微网页模板。全部图表美术素材著作及归属权属于腾讯科技 WeGame 及《洛克王国》项目组官方主体。
| 群聊 | 群号 |
|---|---|
| astrbot洛克王国插件BUG反馈 | 870543663 |
| 熵增项目组洛克王国插件交流 | 1097809141 |