驱动器概览
驱动器是 NextBridge 与具体聊天平台之间的适配层。每个驱动器负责接收来自该平台的消息,以及向该平台发送消息。
支持的平台
| 平台 | 驱动器 | 接收 | 发送 | 备注 |
|---|---|---|---|---|
| 腾讯 QQ | NapCat | ✅ | ✅ | 使用非官方 NapCat WebSocket 桥接方案 |
| Discord | Discord | ✅ | ✅ | 通过 Bot 网关接收;通过 Webhook 或 Bot 发送 |
| Telegram | Telegram | ✅ | ✅ | 使用长轮询 |
| 飞书 / Lark | 飞书 | ✅ | ✅ | Webhook 接收;IM API 发送 |
| 钉钉 | 钉钉 | ✅ | ✅ | Webhook 接收;机器人 API 发送 |
驱动器工作原理
每个驱动器在启动时会:
- 向桥接引擎注册发送器,使桥接引擎能够调用它来投递消息。
- 监听平台的消息(WebSocket、长轮询或 HTTP Webhook)。
- 将每条收到的消息规范化为
NormalizedMessage,并传递给桥接引擎。 - 当桥接引擎调用其发送器时,发送格式化后的文本和附件。
媒体文件处理
所有驱动器共享同一套媒体下载工具。当一条带附件的消息到达时,桥接引擎会将附件列表传递给目标驱动器的 send() 方法。各驱动器按照 max_file_size 配置的上限下载文件,并通过目标平台的原生 API 重新上传。
若文件超过大小限制或下载失败,则将文字回退内容附加到消息末尾:
[Image: photo.jpg](https://example.com/photo.jpg)