Q2TG

QQ 群与 Telegram 群相互转发的 bot

安装方法

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

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

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

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

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

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

4. 在能同时连接 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

支持的消息类型

• 文字（双向）

• 图片（双向）

  • GIF

  • 闪照

    （目前会转换为普通图片）

• 图文混排消息（双向）

• 大表情（双向）

  • TG 中的动态 Sticker

    目前是转换成 GIF 发送的，并且可能有些问题

• 视频（双向）

• 语音（双向）

• 小表情

  （可显示为文字）

• 链接（双向）

• JSON/XML 卡片

  （包括部分转化为小程序的链接）

• 群公告

• 回复（双平台原生回复）

• 文件（单向 QQ -> TG，按需获取下载地址）

• 转发多条消息记录

  （依赖 chatrecord-viewer 服务）

• TG 编辑消息（撤回再重发）

• 双向撤回消息

如何撤回消息

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

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

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

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

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

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

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

1. 更改配置文件 config.yaml

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

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

使用图床存储头像数据

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

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

额外功能

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

运行演示