nonebot-plugin-dcqg-relay 1.1.4

在QQ频道与 Discord 之间同步消息的 nonebot2 插件

QQ频道-Discord 互通

前言

[!CAUTION] QQ 官方机器人于 2025 年 4 月 21 日起不再提供主动推送能力。因此本插件将不能正常工作。

本项目为自用插件，如果有需求或想法请提出，我尽量满足

因用到了QQ官方的频道机器人接口，功能少，限制多，而且很多功能我也没法测试，就没有支持。之后可能会出一个基于 OneBot 适配器的版本（懒）

目前QQ机器人不能发 url，如果从 Discord 转来的消息里带有 url 的活是发不出来的，目前我没有想到解决办法。有想法请提出

功能

可以在指定的QQ子频道和 Discord 频道之间同步消息，只支持普通的文字频道，不支持帖子频道

目前支持的消息：

• 文字
• 图片
• 表情

尚未支持的消息：

• 文件
• 语音
• 视频
• ARK 消息
• Embed 消息

安装

使用 nb-cli 安装

在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装

nb plugin install nonebot-plugin-dcqg-relay

使用包管理器安装

建议使用 poetry

• 通过 poetry 添加到 NoneBot2 项目的 pyproject.toml

poetry add nonebot-plugin-dcqg-relay

• 也可以通过 pip 安装

pip install nonebot-plugin-dcqg-relay

安装开发中版本

pip install git+https://github.com/Autuamn/nonebot-plugin-dcqg-relay.git@main

配置

dcqg_relay_channel_links

• 类型：json
• 默认值：[]
• 说明：链接对应的QQ子频道与 Discord 频道，目前只支持一对一链接

配置文件示例

dcqg_relay_channel_links='[
    {
        "qq_guild_id": "123132",
        "dc_guild_id": 456456,
        "qq_channel_id": "78789",
        "dc_channel_id": 123123,
        "webhook_id": 456456,
        "webhook_token": "xxx"
    },
    {
        "qq_guild_id": str                # QQ频道 id
        "dc_guild_id": int                # Discord 服务器 id
        "qq_channel_id": str              # QQ子频道 id
        "dc_channel_id": int              # Discord 频道 id
        "webhook_id": Optional[int]       # （可选的）Discord 对应频道的 WebHook id
        "webhook_token": Optional[str]    # （可选的）对应 Webhook 的 token
                                        # 请不要将注释放在此处！！
    }
]'

Webhook 的相关配置是可选的，不填插件会自动获取

关于 Webhook 是什么请看：使用網絡鉤手（Webhooks）

得到 Webhook URL 后，可从 URL 中获取 webhook_id 和 webhook_token

Webhook URL 形如： https://discord.com/api/webhooks/{webhook_id}/{webhook_token}

例如：

当 Webhook URL 为 https://discord.com/api/webhooks/1243529342621978694/kq1Vc3NsN4d3SB0MAusB-xbY_e8xMChQmxypIFna0c1lwQS-uL85fqupK2jFfkYtUR1h 时

1243529342621978694 就是 webhook_id

kq1Vc3NsN4d3SB0MAusB-xbY_e8xMChQmxypIFna0c1lwQS-uL85fqupK2jFfkYtUR1h 就是 webhook_token

dcqg_relay_unmatch_beginning

• 类型：list[str]
• 默认值：["/"]
• 说明：指明不转发的消息开头

特别感谢

• nonebot2
• Discord-QQ-Msg-Relay
• koishi-plugin-dcqq-relay