跨平台绑定
概述
自 EasyBot 2.1.1-dev.1 起，系统引入了**多适配器（Multi-Adapter）**支持。用户在同一套 EasyBot 实例中，可以按需配置多个不同的机器人适配器（例如 LLBot、Telegram、Milky 等），实现单套系统同时对接多个社交平台。
多适配器的引入带来了一个新的问题：如何将同一个玩家的多个社交平台账号关联到同一个游戏身份下？ 跨平台绑定机制正是为了解决这一问题而设计的。
核心规则
跨平台绑定遵循以下约束：
- 一个玩家可以绑定多个平台的账号。 例如，玩家
Steve可以同时绑定一个 QQ 账号和一个 Telegram 账号。 - 一个玩家不能绑定同一平台的多个账号。 例如，玩家
Steve不能同时绑定两个不同的 QQ 号。 - 同一平台共享绑定约束。 Milky 协议与 OneBot 11 协议同属 QQ 平台，因此通过这两个适配器接入的账号被视为同一平台。无论玩家使用 Milky 适配器还是 OneBot 11 适配器连接到 EasyBot，系统均将其识别为同一个 QQ 账号，不可重复绑定。
上述约束为系统级硬限制。若尝试将同一平台的第二个账号绑定到已有该平台绑定的玩家，操作将被拒绝。
支持的服务端实现
跨平台绑定功能的可用性取决于服务端插件 / Mod 的实现情况：
| 实现类型 | 是否支持 |
|---|---|
| Mod 版（Fabric / Forge） | ✅ 支持 |
| 插件版（Bukkit / Spigot / Paper 等） | ✅ 支持 |
| MCDR（MCDReforged） | ❌ 即将支持 |
| Velocity | ❌ 即将支持 |
绑定流程
方式一：游戏内发起（验证码模式）
这是跨平台绑定的主要方式，由玩家在游戏内主动发起：
- 玩家在游戏中执行
/easybot bind命令。 - 系统为该玩家生成一个跨平台绑定验证码。
- 玩家在目标平台（例如 Telegram 群聊）中使用该验证码完成绑定。
- 绑定成功后，该平台账号即关联至当前玩家身份。
验证码具有时效性，过期后需重新生成。
方式二：社交平台信任模式
在已启用社交平台信任模式的群聊中，玩家可以通过以下方式触发跨平台绑定：
- 在群内发送
<绑定关键词> <玩家名>。 - 系统检测到该玩家已绑定其他平台的账号，自动启动跨平台绑定任务。
- 游戏服务器内的被绑定玩家将收到一条确认消息，可直接点击确认完成绑定。
- 玩家亦可使用其已绑定的其他平台账号，在群内发送
确认绑定 <验证码>来完成确认。
双向验证码模式（在群内输入验证码完成绑定）暂不支持跨平台场景。跨平台绑定的群侧确认仅支持上述的信任模式 + 验证码确认方式。
绑定状态查询
跨平台绑定完成后，玩家可通过以下方式查看当前绑定状态：
- 游戏内查询：执行
/easybot status命令查看已绑定的所有平台账号。 - 群内查询：在任意已绑定群聊中发送
我的绑定关键词查询当前账号关联的玩家身份及其跨平台绑定情况。
解绑与跨平台影响
当玩家解除某个平台的绑定时：
- 仅移除该平台账号与玩家的关联，不会影响该玩家在其他平台上的绑定关系。
- 若玩家在强制绑定服务器中解绑了唯一绑定的账号，将触发强制绑定踢出机制（详见绑定功能文档）。
- 解绑操作后，该平台账号可重新绑定到其他玩家，或重新绑定回原玩家。
常见问题
为什么 Milky 和 OneBot 11 不能同时绑定？
Milky 与 OneBot 11 均为 QQ 平台的适配器协议。无论用户通过哪种适配器将 QQ 机器人接入 EasyBot，其底层对应的均为同一个 QQ 号。因此系统将其视为同一平台账号，不允许在同一玩家下重复绑定。
跨平台绑定后，命令和事件如何响应？
跨平台绑定不会改变命令和事件的响应逻辑。系统会根据消息来源的平台和群聊，正确路由命令执行结果与事件通知。例如 ，绑定了 QQ 和 Telegram 的玩家，在两个平台上均能收到与其游戏账号相关的通知（具体通知范围取决于命令的作用域配置）。
为什么 MCDR / Velocity 不支持跨平台绑定？
跨平台绑定依赖服务端实现提供的特定 API 接口，用于在游戏内发送确认消息并接收玩家的确认操作。目前相关接口仅在 Mod 版和插件版中实现，MCDR 与 Velocity 暂未适配。后续版本将根据优先级逐步完善支持。
