discord.py如何实现bot检索用户全量消息并统计指定词汇出现频次
discord.py 实现指定用户历史消息目标词统计的可行方案
完全可行,核心依赖discord.py提供的历史消息拉取接口 abc.Messageable.history(),配合权限配置和自定义匹配逻辑即可实现,以下是具体落地步骤和示例代码。
前置配置要求
- 必须在Discord开发者门户开启
MESSAGE CONTENT INTENT特权意图,否则bot无法读取消息的文本内容。 - bot在目标服务器内需要具备
查看频道、读取消息历史权限,否则无法遍历对应频道的历史消息。 - 若需要统计整个服务器的消息,需要确保bot能访问所有需要统计的频道;若仅统计单个频道,仅需该频道的对应权限即可。
核心实现逻辑
- 初始化目标词计数字典,将目标词列表全部转为小写,默认实现不区分大小写的匹配,可根据需求调整。
- 遍历所有需要统计的频道,检查bot是否具备该频道的历史读取权限,自动过滤无权限的频道。
- 异步迭代频道下的所有历史消息,过滤出发送者为指定用户的消息,可按需过滤其他bot发送的消息。
- 对过滤后的消息文本做预处理(转小写、匹配独立单词),匹配目标词列表,累加对应计数。
- 遍历完成后返回最终的计数字典。
可直接运行的示例代码
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
相关产品推荐
相关产品推荐

