Discord

Discord 驱动器通过 Discord 网关（Bot Token）接收消息，并支持通过 Webhook 或 Bot 两种方式发送消息。

准备工作

1. 在 Discord 开发者门户 创建一个 Bot 应用。
2. 在 Bot 页面中启用 Message Content Intent（消息内容权限）。
3. 复制 Bot Token。
4. 如需 Webhook 发送：在频道设置中创建 Webhook 并复制其 URL。
5. 将 Bot 邀请至你的服务器，确保其拥有 Read Messages 和 Send Messages 权限。

配置项

在 config.json 的 discord.<实例ID> 下添加：

键	是否必填	默认值	说明
bot_token	否*	—	Discord Bot Token，接收消息和 bot 发送模式均需此项
send_method	否	webhook	"webhook" 或 "bot"
webhook_url	否*	—	Webhook URL，send_method 为 "webhook" 时必填
max_file_size	否	8388608（8 MB）	发送附件时单个文件的最大字节数

* bot_token（用于接收）和 webhook_url（用于发送）至少需要提供其中一个。

{
  "discord": {
    "dc_main": {
      "bot_token": "your_bot_token",
      "send_method": "webhook",
      "webhook_url": "https://discord.com/api/webhooks/ID/TOKEN",
      "max_file_size": 8388608
    }
  }
}

发送模式

webhook（默认）

通过 Discord Webhook URL 发送消息。支持通过规则 msg 配置中的 webhook_title 和 webhook_avatar 为每条消息设置自定义显示名和头像。

"msg": {
  "msg_format": "{msg}",
  "webhook_title": "{user} @ {from}",
  "webhook_avatar": "{user_avatar}"
}

bot

通过 Bot 自身发送消息，需要提供 bot_token。不支持每条消息自定义用户名和头像。

规则频道键

在 rules.json 的 channels 或 from/to 下使用：

键	说明
server_id	Discord 服务器（Guild）ID
channel_id	Discord 频道 ID

{
  "dc_main": {
    "server_id": "1061629481267245086",
    "channel_id": "1269706305661309030"
  }
}

额外 msg 键

以下键可放在规则的 msg 块中，仅在 send_method 为 "webhook" 时被 Discord 驱动器使用：

键	说明
webhook_title	Webhook 消息上显示的用户名
webhook_avatar	Webhook 消息上显示的头像 URL

两者均支持与 msg_format 相同的模板变量。

注意事项

• Bot 发送的消息不会被再次桥接（Webhook 回显不会触发事件）。
• 文件会被下载后通过 multipart 表单重新上传。若文件超过 max_file_size，其 URL 将以文字形式附加到消息中。