✅ 账号管理 - 扫码登录 (QQ/微信)/凭证导入/多账号切换/删除绑定，主账号快速切换
✅ 消息撤回 - 登录链接与二维码超时、完成或被拒时自动撤回，保护账号安全
✅ 数据查询 - 个人档案可视化渲染、家园菜园/守卫/室内精灵、活动日历、公告查询与推送、近期对战详情、背包精灵图鉴检索、交换大厅、远行商人、阵容推荐
✅ 查蛋配种 - 后端图鉴优先查询、离线蛋组兜底、配种兼容性判断，支持精确/模糊/多候选智能匹配，并接入后端尺寸反查
✅ 图片展示 - 深度还原 WeGame 各级视觉效果的排版与艺术风格字体字形重绘，自带自适应宽度渲染
✅ 阵容助手 - 热门阵容推荐、2x3 网格布局展示、阵容码查询、详细技能配置
✅ Ingame 查询 - 支持新版队列化玩家搜索、家园查询、商店信息、好友关系、学生认证与学生活动等文档接口
在 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 |
图片渲染超时时间（毫秒） |
merchant_subscription_enabled |
bool | true |
是否启用远行商人订阅推送（在 08:01 / 12:01 / 16:01 / 20:01 前后 30 秒随机检查，空结果每 4 分钟前后 30 秒最多重试 3 次） |
merchant_subscription_items |
list | ["国王球","棱镜球","炫彩精灵蛋"] |
远行商人默认订阅商品 |
merchant_private_subscription_enabled |
bool | true |
是否允许用户在私聊中订阅远行商人推送 |
home_subscription_enabled |
bool | true |
是否启用家园菜园和精灵灵感订阅推送 |
home_subscription_interval_minutes |
int | 5 |
家园订阅检查间隔（分钟），按首个完成/全部完成两档推送 |
announcement_subscription_enabled |
bool | true |
是否启用洛克公告订阅推送 |
announcement_poll_interval_minutes |
int | 10 |
洛克公告订阅检查间隔（分钟） |
- 绑定后的
token、ticket、扫码凭证等均属于敏感信息，请务必自行妥善保存。 - 请勿截图公开、发送他人，或提交到公开仓库，避免凭证泄露后被冒用。
- 因凭证或绑定信息泄露导致的账号风险、查询被冒用或相关损失，需要由使用者自行承担。
- 非必要不要频繁手动刷新凭证，服务端会自动刷新。
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/ # 洛克交换大厅模板
├── announcement/ # 洛克公告列表与详情模板
├── activity-calendar/ # 洛克活动日历模板
├── home/ # 洛克家园菜园/守卫/室内精灵模板
├── pet-wiki/ # 精灵 wiki 模板
├── skill-wiki/ # 技能 wiki 模板
├── yuanxing-shangren/ # 远行商人模板
├── lineup/ # 洛克阵容助手模板
├── lineup-detail/ # 阵容详情模板
└── searcheggs/ # 🥚 查蛋配种模块（自包含）
├── eggs.py # 查蛋引擎（搜索/蛋组/配种逻辑）
├── Pets.json # 精灵蛋组离线数据（1065只）
├── index.html # 单精灵查蛋渲染模板
├── pair.html # 配种判定渲染模板
└── style.css # 查蛋页面样式
💡 指令前缀：默认为
/，在 AstrBot 配置中自定义
⚠️ 帮助菜单说明
- 标注
实验性功能的命令表示接口字段或返回结构暂不稳定，适合测试使用- 标注
接口暂时关闭/暂不可用的命令表示当前后端未开放，仅返回提示信息
| 指令 | 说明 |
|---|---|
洛克QQ登录/洛克qq登录 |
使用 QQ 扫码快捷登录及绑定 |
洛克微信登录 |
使用微信扫码快捷登录及绑定 |
洛克导入 [ID] [Ticket] |
通过客户端扫尾凭证手动导入登录 |
洛克刷新 |
刷新当前有效主账号 QQ 凭证生存期 |
洛克绑定列表 |
查看所有已扫描绑定的账号记录 |
洛克切换 [序号] |
一键切换当前群聊激活的前置主查询账号 |
洛克解绑 [序号] |
移除不再需要的冗余账号绑定内容 |
| 指令 | 说明 |
|---|---|
洛克档案 |
生成全盘概览的个人数据雷达星级名片 |
洛克战绩 [页码] |
查询并展示指定历史对战记录的对手及结果 |
洛克背包 [分类] [页码] |
展示对应条件精选收藏情况，支持分类如 了不起、异色、炫彩 等 |
洛克交换大厅 [页码] |
浏览其他玩家的精灵交换请求列表 |
远行商人/yxsr |
查询当前轮次远行商人商品 |
洛克公告 [页码] |
查询洛克王国公告列表 |
洛克公告详情 <公告ID> |
查看指定公告详情 |
洛克公告最新 |
查看最新一条公告 |
洛克活动日历 |
查询 activities/info 活动日历（别名：洛克活动、洛克日历） |
订阅洛克公告 |
订阅新公告推送（群聊需群主/群管理员/bot管理员） |
取消订阅洛克公告 |
关闭当前会话的新公告推送 |
洛克商店 <shop_id> |
实验性功能：通过 ingame 接口查询指定商店信息，接口返回暂不稳定 |
洛克玩家 [UID] |
通过 ingame 队列接口查询玩家基础资料，不填 UID 时查询当前绑定账号 |
洛克家园 [UID] |
通过 UID 查询自己或他人的家园菜园、守卫精灵和室内精灵情况 |
订阅家园菜园 [UID] |
订阅指定 UID 的菜园提醒，首个成熟和全部成熟时各推送一次 |
订阅家园灵感 [UID] |
订阅指定 UID 的精灵灵感提醒，首个完成和全部完成时各推送一次 |
取消订阅家园 [菜园/灵感/全部] [UID] |
取消当前会话的家园订阅 |
订阅远行商人 [1/0] [商品...] |
群主/群管理员/bot管理员可订阅远行商人提醒，1 为命中后 @全体，0 为普通提醒；不填商品则使用 WebUI 默认订阅商品 |
取消订阅远行商人 |
关闭当前群远行商人订阅 |
洛克好友关系 <id1,id2> |
实验性功能：仅能拿到有限状态字段，关系说明暂不稳定（需登录） |
洛克学生 [area] [account_type] |
实验性功能：接口信息量有限，当前仅供测试查看（需登录） |
洛克阵容 <分类> <页码> |
查看热门阵容推荐及组成，2x3 网格布局展示 |
查看阵容 <阵容码> |
查看指定阵容的详细信息，包含精灵技能配置 |
洛克wiki <精灵名> |
暂不可用：接口暂时关闭，当前返回提示信息 |
洛克技能 <技能名> |
暂不可用：接口暂时关闭，当前返回提示信息 |
| 指令 | 说明 |
|---|---|
洛克查蛋 <精灵名> |
后端图鉴优先查询精灵蛋组、性别比、孵化信息及同蛋组可配种精灵，后端不可用时本地兜底（别名：查蛋） |
洛克查蛋 0.18 1.5 |
按身高+体重反查（前身高 m 后体重 kg，双参数时优先走后端尺寸查询） |
洛克查蛋 0.18 |
仅按身高(m)反查 |
洛克配种 <父体> <母体> |
判断能否配种，默认前父后母，孵蛋结果跟随母体（别名：配种） |
洛克配种 <精灵名> |
想要孵出该精灵？查询需要哪些父母组合及性别要求 |
🔍 查蛋支持智能匹配：精确名称直接出结果，模糊输入自动匹配，多候选时列出供选择。
💡 发送
洛克可查看插件完整且精美的图片图解版内置帮助。
点击展开预览图
洛克档案 |
洛克战绩 |
|---|---|
 |
 |
洛克背包 |
洛克交换大厅 |
|---|---|
 |
 |
洛克阵容 |
查看阵容 |
|---|---|
 |
 |
远行商人 |
精灵 Wiki |
|---|---|
 |
 |
技能 Wiki |
查蛋结果 |
|---|---|
 |
 |
尺寸反查 |
配种结果 |
|---|---|
 |
 |
洛克家园 |
洛克活动日历 |
|---|---|
 |
 |
你可以通过替换内部图片的方式实现基础的背景个性化：
路径： AstrBot/data/plugins/astrbot_plugin_rocom/img/
| 功能 | 文件 |
|---|---|
| 背景图 | bg.C8CUoi7I.jpg |
| 战绩背景 | record-bg.C1mPRb4R.png |
- 基础查询 (个人档案/战绩/背包)
- 交换大厅 (精灵交换请求列表)
- 阵容助手 (阵容列表/详情查询)
- 查蛋配种 (蛋组查询/配种判定/智能搜索)
- 更多功能 (敬请期待)
点击展开版本历史
新增
- 新增
/洛克活动日历，接入GET /api/v1/games/rocom/activities/info的活动日历数据 - 活动日历新增独立时间轴渲染模板，展示活动状态、时间范围、封面与奖励摘要
优化
- 适配最新后端 ingame 队列协议，
/洛克玩家与/洛克家园支持绑定 token 省略 UID 的查询规则 - 公告列表和公告详情按 Endfield 插件公告页面结构重构，保留洛克王国背景、字体与视觉资源
新增
- 接入洛克公告列表、公告详情、最新公告查询与新公告订阅推送
- 查蛋名称查询改为后端图鉴优先，本地离线数据作为兜底
优化
- 家园
home/info查询按新版队列协议处理：wait_ms=5000，收到202 task_id后轮询任务结果 - 帮助菜单和配置项同步补充公告订阅说明
优化
- 远行商人当前商品卡片新增金币价格和限购数量展示
- 价格与限购从后端新增的
random_goods数据中按商品名补齐，历史时段商品不展示该信息 - 远行商人渲染截图倍率与视口尺寸下调，降低推送图片体积
新增
/洛克QQ登录增加小写别名/洛克qq登录/远行商人增加快捷别名/yxsr- 远行商人渲染页新增“今日其他时段”区域，按时间段展示当日其他轮次商品，每段最多展示 5 个
优化
- 远行商人订阅检查增加
±30s随机延迟，空返回重试也加入±30s抖动，降低刷新窗口和并发请求冲突 - 家园订阅推送将 UID 展示优化为本地绑定的洛克昵称，并自动 @ 对应绑定 QQ 用户
修复
- 修复远行商人订阅空返回重试链路失效的问题
新增
- 新增家园渲染模板，展示家园概览、菜园作物、守卫精灵和室内精灵状态
- 家园菜园接入本地作物名称与图标映射，展示作物名、图标、成熟状态、产量和可偷次数
- 家园订阅支持菜园和精灵灵感两类提醒，并按首个完成、全部完成两档推送
优化
- 帮助菜单和 README 同步补充家园查询、家园订阅的新版说明
- 优化家园模板中灵感完成、灵感收集中、未喂食和守卫中的视觉状态区分
新增
- 远行商人订阅更新日志补充：已支持私聊订阅远行商人推送
- 新增
/洛克家园 [UID]，支持通过 UID 查询自己或他人的家园菜园、守卫精灵和室内精灵情况 - 新增
/订阅家园菜园、/订阅家园灵感与/取消订阅家园，支持菜园/灵感首个完成和全部完成两档提醒
优化
- 适配最新后端 UID 搜索队列机制，查询会优先同步等待并在返回
task_id后继续异步轮询任务结果 - 保持
/洛克玩家与档案补充链路的返回结构不变，兼容新的异步查询流程
优化
- 重构远行商人订阅调度逻辑，不再依赖 AstrBot cron 轮询
- 远行商人订阅改为固定在每日
08:01 / 12:01 / 16:01 / 20:01检查 - 若后端该轮返回空商品，则每 4 分钟最多重试 3 次，三次后暂停本轮重试
修复
- 尺寸反查渲染新增独立“匹配”行，匹配率/命中次数不再混入蛋组字段
- 本地兜底尺寸反查也会展示匹配信息，同名合并时同步累加匹配率与命中次数
修复
- 修正尺寸反查同名结果合并逻辑：不再剥离颜色前缀，避免误合并不同形态
- 后端尺寸查询返回的同名重复项会累加匹配率与命中次数，并聚合编号、身高、体重范围后展示
优化
- 尺寸反查统一使用游戏原生
m输入与展示，移除旧单位兼容分支 - 同名同色尺寸结果改为聚合展示编号与尺寸范围，避免简单去重导致数据丢失
新增
- README 与帮助菜单同步补充实验性功能、暂不可用功能说明
- 远行商人订阅、自定义订阅商品、档案补充信息等现有功能文档补全
优化
- 洛克档案
personal-card底部补充区继续调整，名片展示区精简为纯图片展示 - 帮助菜单中的实验性命令说明与当前插件实现保持一致
修复
- 修复洛克档案模板近期调整时引入的部分文案异常问题
- 修复档案底部名片展示与家园信息区域的对齐问题
新增
- 新增
help_prefix_display配置项，可仅对帮助菜单图片中的命令展示前缀做替换
优化
- 调整查看阵容详情渲染，补充技能名称展示并优化技能区与头像区布局
修复
- 修复
查看阵容指令对阵容码的匹配逻辑，兼容更稳定的阵容码查找 - 修复技能 wiki 在存在精确同名项时仍被模糊结果拦截的问题
- 修复相同 UID 重新登录时旧绑定残留导致的新旧 token 数据混用问题
新增
- 新增
help_prefix_display配置项，仅用于帮助菜单图片中的命令前缀展示
修复
- 重新登录识别到相同 UID 时，会先清理旧绑定数据再写入新 token，避免旧状态残留或数据混用
优化
- 帮助菜单以及查蛋相关统一切换为
HYWenHei-85W-1.ttf字体 - 菜单背景新增轻量深色遮罩，降低过亮区域对文字可读性的影响
- README 同步远行商人订阅命令格式与当前权限说明
修复
- 修复远行商人自定义订阅功能，现在可以正确解析自定义商品名称
- 优化命令参数解析逻辑，从
event.message_str中提取完整参数避免被 AstrBot 按空格拆分
新增
- 新增
/远行商人指令，展示当前轮次商品 - 新增
/订阅远行商人 1|0与/取消订阅远行商人，支持群管理员按群配置推送方式 - 新增
/洛克wiki <精灵名>与/洛克技能 <技能名>指令 - 查蛋双参数尺寸反查正式接入后端
pet/size-query
优化
- 重构精灵 wiki / 技能 wiki 渲染，补齐图标、技能列表、进化链与属性展示
- 优化远行商人渲染，仅展示当前时间段商品，并修正轮次剩余时间表达
- 查蛋结果页、尺寸反查页补充图片化输出与图标展示
修复
- 修复远行商人、wiki 等页面在截图时出现的截断与偏移问题
- 修复交换大厅接口在当前线上环境仍要求
X-Framework-Token时的请求头兼容 - 修复远行商人标题图标路径解析异常
新增
- 新增
/洛克查蛋 <精灵名>指令，查询精灵蛋组、性别比、孵化信息及同蛋组可配种精灵（别名：/查蛋） - 新增
/洛克配种 <精灵A> <精灵B>指令，判断两只精灵能否配种并展示共享蛋组（别名：/配种） - 内置 1015 只精灵离线蛋组数据（含 500 只有蛋组信息），无需登录即可使用
- 智能搜索匹配：精确匹配中文名/ID/英文名 → 唯一模糊命中自动匹配 → 多候选列表引导用户精确输入
架构
- 查蛋模块自包含在
render/searcheggs/目录下（数据、逻辑、模板），main.py仅做薄指令路由，高解耦便于后续切换后端 - 新增
SearchResult类型封装搜索结果（EXACT/FUZZY/MULTI/NOT_FOUND）
新增
- 新增
/洛克刷新所有凭证指令（管理员专用），支持手动批量刷新所有用户凭证 - 手动刷新指令执行前会提示自动刷新功能已配置，仅作调试或强制兜底使用
- 绑定失败时不再保存无效绑定记录
- 改进绑定成功提示格式
优化
- 增强刷新结果统计，显示总用户数、成功数、失败数、跳过数（非 QQ 登录）
- 手动刷新指令最多显示 20 条详细结果
修复
- 修复自动刷新任务生命周期管理
- 修复自动刷新通知发送逻辑
- 修复绑定时未验证角色信息导致无效凭证也能成功绑定的问题
- 优化绑定失败提示，明确告知用户凭证可能无效或已过期
- 新增绑定成功时自动设置为主账号
新增
- 新增自动刷新凭证功能，支持定时刷新所有用户的 QQ 登录凭证
- 支持配置刷新时间（默认每天 00:00 和 12:00）
- 支持配置刷新结果通知群号
优化
- 增强清理绑定统计信息，显示检查用户数、移除数和剩余数
- 优化日志记录，记录每个被删除绑定的用户 ID
修复
- 修复对战记录胜负判断逻辑，API 返回 1 为失败，0 为胜利
- 修复
/洛克删除无效绑定指令修正为清理所有用户的无效绑定（管理员专用） - 修复
/洛克刷新指令响应检查逻辑
优化
- 增强清理绑定统计信息，显示检查用户数、移除数和剩余数
- 优化日志记录，记录每个被删除绑定的用户 ID
修复
- 修复对战记录胜负判断逻辑，API 返回 1 为失败，0 为胜利
/洛克删除无效绑定指令修正为清理所有用户的无效绑定（管理员专用）
修复
- 修复对战记录胜负判断逻辑，API 返回 1 为失败，0 为胜利
新增
- 新增
/洛克删除无效绑定指令（管理员） - 新增双设备扫码提醒
修复
- 修复登录流程，扫码后自动绑定账号
- 修复
/洛克刷新、/洛克阵容错误处理 - 修复洛克背包换页无效问题
- 修复登录消息缺少艾特用户
新增
- 新增
/洛克删除无效绑定指令 - 新增双设备扫码提醒
优化
- 更新登录流程，自动调用绑定 API
- 修复
/洛克刷新使用正确的 API - 优化错误处理和日志记录
新增
- 新增
/洛克交换大厅、/洛克阵容、/查看阵容指令 - 新增精灵背包分类筛选（全部/异色/了不起/炫彩）
优化
- 重构阵容页面为 2x3 网格布局
- 修复页脚显示问题
- 支持背包参数交换位置
- ✨ 初始版本发布
- ✅ 支持 QQ/微信扫码登录
- ✅ 个人档案、战绩、背包查询
- ✅ 图片渲染输出
- Astrbot：AstrBotDevs/AstrBot 提供强大的机器人开发与部署平台支撑
特别感谢：
- 熵增项目组 - 对各类抓取代理转发能力的构筑
本插件界面 UI 由原平台页面自研拆解逆向还原成微网页模板。全部图表美术素材著作及归属权属于腾讯科技 WeGame 及《洛克王国》项目组官方主体。
| 群聊 | 群号 |
|---|---|
| astrbot洛克王国插件BUG反馈 | 870543663 |
| 熵增项目组洛克王国插件交流 | 1097809141 |