You need to enable JavaScript to run this app. Discord.py中on_message场景下配置CooldownMapping防关键词刷屏
优惠活动
大模型
产品
解决方案
定价
更多

Discord.py中on_message场景下配置CooldownMapping防关键词刷屏

on_message 中集成关键词响应冷却的调整方案

原代码核心问题

  • 嵌套定义在on_message内部的cog_check函数从未被实际调用,冷却逻辑完全失效
  • 误用Cog自带的cog_check机制:该机制仅对内置命令生效,自定义监听器执行时不会自动触发其校验流程
  • 缺少基础消息过滤逻辑,未排除机器人自身发送的消息,容易出现无限循环触发监听器的问题

正确实现逻辑

不需要依赖Cog的命令检查机制,直接在on_message的执行流中嵌入冷却判断即可,注意冷却校验的时机要放在关键词匹配完成之后——也就是只有用户发送的消息确实命中触发关键词时,才会占用冷却计数,避免把无意义的普通聊天算入限流规则。
调整后的参考代码如下:

class Listener(commands.Cog):
    def __init__(self, bot):
        self.bot = bot
        # 冷却规则:单用户维度,每10秒最多触发1次关键词响应
        self._keyword_cd = commands.CooldownMapping.from_cooldown(
            1.0, 10.0, commands.BucketType.user
        )
        # 触发关键词列表,可根据实际需求维护
        self.TRIGGER_KEYWORDS = {"要匹配的关键词1", "关键词2", "关键词3"}

    @commands.Cog.listener()
    async def on_message(self, message):
        # 第一步:基础消息过滤
        # 忽略机器人自身发送的消息,避免死循环
        if message.author.bot:
            return
        # 忽略私聊场景(对应你原代码中的guild判断逻辑)
        if message.guild is None:
            return

        # 第二步:匹配触发关键词,未命中则直接返回
        is_trigger_hit = any(keyword in message.content for keyword in self.TRIGGER_KEYWORDS)
        if not is_triggered:
            return

        # 第三步:命中关键词后,校验用户冷却状态
        bucket = self._keyword_cd.get_bucket(message)
        # 若仍在冷却期,返回剩余等待秒数;否则重置冷却计时返回None
        retry_after = bucket.update_rate_limit()
        if retry_after:
            # 冷却期内不触发响应,可选择发送友好提示
            await message.channel.send(
                f"触发过于频繁,请在 {retry_after:.1f} 秒后再尝试",
                delete_after=5
            )
            return

        # 第四步:冷却校验通过,执行原有关键词响应逻辑
        await message.channel.send("关键词对应的自定义响应内容")

可调整的细节说明

  • 冷却规则参数可按需修改:from_cooldown(允许触发次数, 冷却时长(秒), 分桶维度),如果需要按频道、服务器维度限流,只需把commands.BucketType.user替换为对应枚举值即可
  • 如果不同关键词需要独立的冷却规则,可以为每个关键词单独创建CooldownMapping实例,不要共用同一套冷却计数
  • 提示消息可根据机器人的整体风格调整,不需要强制发提示的话,也可以在冷却期内直接静默不响应

内容的提问来源于stack exchange,提问作者Dan A

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.13 19:06:02