Q2TG

QQ 群与 Telegram 群相互转发的 bot

安装方法

1. 首先将用于机器人的账号在 oicq 框架上登录一次，通过设备验证

2. 将 config.example.yaml 复制一份为 config.yaml ，并填入相关设置项

需要 MongoDB 数据库来存储消息 ID 之间的对应关系

（不要忘记 YAML 冒号后的空格（（

以及 QQ 和 TG 的群号都不需要加引号

1. 安装必要的依赖项 yarn install，以及 FFmpeg，tgs-to-gif（需要安装到 PATH 中）

2. 在能同时连接 QQ 和 Telegram 的服务器上启动服务 yarn start

关于 TG 群的 ID

如果不知道群的 ID，可以先不配置转发匹配，运行 bot，在需要查询 ID 的 TG 群里发送 /id 指令即可获得 ID

PS. TG 群组可以分为 Group 和 SuperGroup。在比较旧的版本中群主可以手动转换，而新的版本中已经没有这个概念了（新版本中转换是无感的），但是为了兼容，在群组 ID 上面还是有所区分的。Group 可以单向转换成 SuperGroup，ID 会发生变化。SuperGroup 的 ID 一般以 -100 开头。在配置的时候最好将群组转换成 SuperGroup，这样的话以后 ID 就不会发生变化了，方法是开启「允许新成员查看历史消息」的开关。虽然这不是必要的但是可以避免以后的麻烦。

通过 Docker 部署（推荐）

首先需要安装有 docker 和 docker-compose，并且能同时连接 QQ 和 TG 的机器

1. 下载 docker-compose.yaml，填写相关参数。数据库部分无需改动

2. 运行 docker-compose up -d

支持的消息类型

• [x] 文字（双向）
• [x] 图片（双向）
• [x] GIF

• [x] 闪照

  （目前会转换为普通图片） - [x] 图文混排消息（双向） - [x] 大表情（双向） - [x] TG 中的动态 Sticker

  目前是转换成 GIF 发送的，并且可能有些问题 - [x] 视频（双向） - [x] 语音（双向） - [ ] 小表情

（可显示为文字） - [x] 链接（双向） - [x] JSON/XML 卡片

（包括部分转化为小程序的链接） - [x] 群公告 - [x] 回复（双平台原生回复） - [x] 文件（单向 QQ -> TG，按需获取下载地址） - [x] 转发多条消息记录

（依赖 chatrecord-viewer 服务） - [x] TG 编辑消息（撤回再重发） - [x] 双向撤回消息

如何撤回消息

在 QQ 中，直接撤回相应的消息，撤回操作会同步到 TG

在 TG 中，由于机器人无法接收到撤回指令，可以选择以下操作之一：

• 将消息内容编辑为 /rm
• 回复要撤回的消息，内容为 /rm。如果操作者在 TG 群组中没有「删除消息」权限，则只能撤回自己的消息

为了使撤回功能正常工作，TG 机器人需要具有「删除消息」权限，QQ 机器人需要为管理员或群主

即使 QQ 机器人为管理员，也无法撤回其他管理员在 QQ 中发送的消息

搭建 UserBot 实现监听原生撤回事件

搭配 KunoiSayami/delete-message-notifier，可以将 Telegram 中原生的撤回事件发送给 Q2TG

1. 更改配置文件 config.yaml

yaml api: enabled: true port: 8080 deleteNotifier: /deleteMessages

1. 启动 delete-message-notifier，将上游地址设置为 http://localhost:8080/deleteMessages

使用图床存储头像数据

以前 TG 消息发送者头像会预载到 QQ 消息图片存储中，将 MD5 附在消息里传递给 QQ 群，但是不知道什么原因时间长了会下载不了（显示为灰色，即使重新上传）。

所以现在支持了哔哩图床、sm.ms 图床和腾讯云 COS 三种图床，可以同时开启，按照前文的顺序使用，一个失败的话尝试下一个。需要在配置文件中开启并设置相应 token。

额外功能

• 在 TG 中可以使用 /forwardon 和 /forwardoff 命令控制 TG 到 QQ 的单向开关
• 使用 Icalingua 时可以无缝显示 TG 中的头像和名称

运行演示