跨平台群绑定
雪希同时挂在两个渠道上:OneBot(有真实 QQ 号的机器人)和 QQ 官方 Bot(只有一串 openid)。 两边看到的「同一个群」其实是两套互不相通的标识 —— OneBot 知道群号,官方只有 group_openid, 而且官方接口不会把 openid 反解成群号。
于是同一个聊天群在两个渠道下会变成两份彼此看不见的配置:
- 在 OneBot 群里开的街机无前缀开关,官方群里不生效
- 在 OneBot 群里加的
.jk地点别名,官方群里查不到 - 语录、每日老婆、NTR 也是一样,各存各的
「群绑定」就是把这两套标识归并到同一个逻辑群上,让配置和榜单共用一份。
绑定流程
绑定方向是官方群发起、OneBot 群确认,因为逻辑群键必须落在有真实群号的一侧。
- 在 QQ 官方 Bot 所在的群里发送
/群绑定码(官方渠道前缀是/) - 拿到 6 位绑定码,10 分钟内有效,只能用一次
- 到 OneBot 的那个群里发送
.群绑 <绑定码>
绑定成功后,这个逻辑群就以 OneBot 群号命名,官方群变成它下面的一个别名。
为什么是反方向
如果在官方群确认,逻辑群键只能取 openid。后台看到的就是一串 574398233D9EF559EA6898E5AABC0D67, 既看不懂也没法和群号对照。让 OneBot 侧确认,键才是能读的群号。
指令
| 指令 | 别名 | 示例 | 说明 |
|---|---|---|---|
群绑定码 | 群绑定申请 | /群绑定码 | 在官方群生成绑定码,10 分钟有效、一次性 |
群绑 | 群绑定 | .群绑 483920 | 在 OneBot 群用绑定码完成绑定 |
群解绑 | 解除群绑定 | .群解绑 | 解除本群的跨平台绑定 |
本群 | 本群信息 | .本群 | 查看本群原始标识、逻辑群键、同组其它渠道 |
权限
只有群主、群管理员或 Bot 管理员能执行这四条指令,普通群成员会收到权限提示。
绑定后共享什么
| 共享(按逻辑群) | 独立(按渠道) |
|---|---|
| 街机地点别名、无前缀开关 | 群成员列表 |
| AI 主动发言开关 | 各渠道自己的消息撤回 |
| AI 群聊上下文、群记忆 | 发送路由(往哪个渠道发) |
| 每日老婆、NTR 记录 | |
| 群语录 |
群成员列表之所以不共享:它必须拿本渠道的原始群标识去平台接口拉取。 把 OneBot 群号发给官方接口,或者把 openid 发给 OneBot,都只会失败。
数据搬迁
绑定那一刻,官方群已经积累的群维度数据会搬到 OneBot 群号名下。
两边的记录撞车时(比如两个群都加了同名别名),统一保留 OneBot 侧、丢弃官方侧, 丢弃了多少条会在绑定结果里告诉你,不会静默处理。
解绑不搬数据。解绑后数据仍留在原来的逻辑群键下,只是本群不再和对方共享 —— 想彻底重来,先解绑再重新绑定即可。
常见问题
Q:提示「绑定码不存在或已过期」? 两种情况:超过了 10 分钟,或者绑定码已经被用过一次,或者机器人重启过(绑定码只存在进程内)。 重新在官方群发一次 /群绑定码 就好。
Q:提示「本群已经绑定到 xxx,请先执行 .群解绑」? 这个群已经属于另一个逻辑群了。先 .群解绑,再重新绑定。
Q:绑完之后榜单里出现了两个我? 群绑只合并群,不合并人。同一个人在两个渠道下仍是两份档案, 需要各自再用 .绑定 做一次用户级绑定(见 签到与账号)。
Q:绑错群了怎么办?.群解绑 随时可用,没有次数限制。群绑定是人工声明 —— 两个标识之间没有任何可以自动校验的关联, 所以绑错了系统发现不了,只能靠解绑纠正。
Q:怎么确认绑对了? 发 .本群。能看到「已绑定 N 个其他渠道」以及各自的原始标识,就是对的。