You need to enable JavaScript to run this app. discord.py如何实现bot检索用户全量消息并统计指定词汇出现频次
优惠活动
大模型
产品
解决方案
定价
更多

discord.py如何实现bot检索用户全量消息并统计指定词汇出现频次

discord.py 实现指定用户历史消息目标词统计的可行方案

完全可行,核心依赖discord.py提供的历史消息拉取接口 abc.Messageable.history(),配合权限配置和自定义匹配逻辑即可实现,以下是具体落地步骤和示例代码。

前置配置要求

  • 必须在Discord开发者门户开启 MESSAGE CONTENT INTENT 特权意图,否则bot无法读取消息的文本内容。
  • bot在目标服务器内需要具备 查看频道、读取消息历史 权限,否则无法遍历对应频道的历史消息。
  • 若需要统计整个服务器的消息,需要确保bot能访问所有需要统计的频道;若仅统计单个频道,仅需该频道的对应权限即可。

核心实现逻辑

  1. 初始化目标词计数字典,将目标词列表全部转为小写,默认实现不区分大小写的匹配,可根据需求调整。
  2. 遍历所有需要统计的频道,检查bot是否具备该频道的历史读取权限,自动过滤无权限的频道。
  3. 异步迭代频道下的所有历史消息,过滤出发送者为指定用户的消息,可按需过滤其他bot发送的消息。
  4. 对过滤后的消息文本做预处理(转小写、匹配独立单词),匹配目标词列表,累加对应计数。
  5. 遍历完成后返回最终的计数字典。

可直接运行的示例代码

import discord
from discord.ext import commands
import re

# 配置特权意图,必须开启消息内容意图才能读取消息文本
intents = discord.Intents.default()
intents.message_content = True
bot = commands.Bot(command_prefix="!", intents=intents)

async def count_user_words_in_guild(guild: discord.Guild, target_user: discord.User, target_words: list[str]) -> dict[str, int]:
    # 初始化计数字典,默认所有词初始计数为0
    word_counts = {word: 0 for word in target_words}
    # 预处理目标词为小写,实现不区分大小写匹配
    target_words_lower = [word.lower() for word in target_words]

    # 遍历服务器下所有bot可访问的频道
    for channel in guild.channels:
        # 仅处理支持历史消息拉取的频道类型(文本频道、线程、语音频道)
        if not isinstance(channel, (discord.TextChannel, discord.Thread, discord.VoiceChannel)):
            continue
        # 检查bot是否有该频道的历史消息读取权限
        if not channel.permissions_for(guild.me).read_message_history:
            continue

        # 异步拉取该频道的所有历史消息,discord.py会自动处理分页
        async for message in channel.history(limit=None):
            # 仅统计指定用户发送的消息,可按需删除下面这行来统计所有用户的消息
            if message.author != target_user:
                continue
            # 跳过bot发送的消息,不需要统计的话可以删除这行
            if message.author.bot:
                continue
            # 跳过没有文本内容的消息(比如纯附件、纯嵌入消息)
            if not message.content:
                continue

            # 预处理消息文本为小写,匹配所有独立单词(忽略标点、特殊字符)
            content_lower = message.content.lower()
            words_in_msg = re.findall(r"\b\w+\b", content_lower)

            # 匹配目标词,累加计数
            for word in words_in_msg:
                if word in target_words_lower:
                    # 匹配到对应目标词,原目标词计数+1
                    word_counts[target_words[target_words_lower.index(word)]] += 1

    return word_counts

# 示例命令:!countwords @目标用户 词1 词2 词3
@bot.command()
async def countwords(ctx: commands.Context, target_user: discord.User, *words: str):
    # 没有传入目标词的情况下提示
    if not words:
        await ctx.send("请提供需要统计的目标单词列表")
        return
    # 提前告知用户统计已开始,避免误以为bot无响应
    await ctx.send(f"正在统计{target_user.name}的历史消息目标词出现次数,请稍候...")
    # 执行统计
    result = await count_user_words_in_guild(ctx.guild, target_user, list(words))
    # 格式化输出结果
    output = "### 统计结果\n"
    for word, count in result.items():
        output += f"- `{word}`: 出现 {count} 次\n"
    await ctx.send(output)

# 运行bot时填入自己的bot token即可
# bot.run("你的bot token")

自定义调整说明

  • 若需要包含匹配(比如只要消息里出现目标词就算,不要求是独立单词),可以把单词拆分的逻辑替换为:遍历目标词列表,检查目标词的小写形式是否在预处理后的消息文本中存在,存在则计数加1。
  • 若需要统计多词短语(比如“早上好”这类连续词汇),不需要拆分消息文本的单词,直接检查短语的小写形式是否在预处理后的消息文本中存在即可。
  • 若需要限定统计的时间范围,可以给 channel.history() 增加 after 参数,比如传入 datetime.datetime(2023, 1, 1, tzinfo=datetime.timezone.utc) 就只统计2023年之后的消息,避免拉取全量历史导致超时或限流。
  • 若仅需要统计单个频道的消息,不需要遍历服务器的所有频道,直接传入目标频道对象即可,大幅减少拉取时间。
  • 若需要区分大小写匹配,删除所有转小写的预处理逻辑即可。

注意事项

  • Discord对历史消息拉取接口有速率限制,消息量较大时拉取过程会变慢,建议提前告知用户等待时长,必要时在迭代消息的间隔添加合理延时。
  • 纯附件、嵌入内容的消息没有 message.content 字段,会被自动跳过,若需要统计嵌入内容或附件里的文本,需要额外适配 message.embeds、message.attachments 的解析逻辑。
  • 遍历所有频道时,会自动跳过分类、角色频道等非文本类频道,若需要统计归档线程的内容,可额外在频道遍历逻辑中添加对归档线程的筛选。

内容的提问来源于stack exchange,提问作者Ender Duck

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.12 11:15:10