Discord.py Bot投票功能与文本回复实现

功能概述

在Discord Bot开发中，经常需要与用户进行交互，例如进行问卷调查、创建投票或收集反馈。一个常见的需求是 Bot 逐个提出问题，并等待用户以文本形式回复每个问题，然后将这些回复作为字符串收集起来进行后续处理。本教程将详细介绍如何利用 discord.py 库的 bot.wait_for 方法实现这一功能，确保每个用户回答都能被准确无误地捕获。

核心原理：bot.wait_for 与 message.content

实现交互式问答的关键在于 bot.wait_for 协程。这个方法允许 Bot 暂停执行，等待特定事件（如 message、reaction_add 等）的发生。当事件发生时，它会返回一个事件对象（例如，用户发送的消息对象 discord.Message）。

为了确保 Bot 收集到的是用户针对特定问题发送的文本回答，我们需要关注以下两点：

1. 事件类型：我们等待的是 message 事件，即用户发送消息。
2. 检查函数 (check)：这是一个 lambda 函数或普通函数，用于过滤事件。它会接收事件对象作为参数，并返回 True 或 False。只有当 check 函数返回 True 时，bot.wait_for 才会返回该事件对象。在我们的场景中，check 函数需要确保消息是由发起命令的用户在当前频道发送的。
3. 提取内容 (message.content)：当 bot.wait_for 成功捕获到符合条件的消息对象 message 后，其核心属性 message.content 就是用户发送的实际文本内容，它是一个字符串。我们只需将这个字符串添加到答案列表中即可。

实现步骤

我们将通过一个具体的 Discord.py Bot 命令来演示如何构建这个交互式投票功能。

1. 导入所需库与 Bot 初始化

首先，确保你已安装 discord.py 库。然后，导入必要的模块并初始化你的 Bot。

import asyncio
import discord
from discord.ext import commands

# 定义你的问题列表
questions = ["你的名字是什么？", "你最喜欢的编程语言是什么？", "你对这个教程有什么建议？"]

# 初始化Bot，并启用必要的Intents
# 注意：从Discord.py 2.0+开始，访问用户发送的消息内容需要显式启用 message_content Intent。
# 如果不启用，message.content 可能会为空或引发错误。
intents = discord.Intents.default()
intents.message_content = True # 确保能够读取用户发送的消息内容

bot = commands.Bot(intents=intents, command_prefix='+')

@bot.event
async def on_ready():
    """Bot 启动成功时在控制台打印消息。"""
    print(f'Bot已登录：{bot.user}')

重要提示： intents.message_content = True 是一个关键步骤。在 discord.py 2.0 版本及以后，为了读取用户消息的文本内容，你必须在 Discord 开发者门户中为你的 Bot 启用 "Message Content Intent"，并在代码中如上所示显式启用 message_content intent。

2. 创建交互式投票命令

接下来，我们将创建一个名为 poll 的异步命令。

@bot.command()
async def poll(ctx):
    """
    启动一个交互式投票，向用户提问并收集文本回答。
    """
    answers = [] # 用于存储用户回答的列表
    await ctx.send("你好！我将问你几个问题，请逐一回答。")

    for i, question in enumerate(questions):
        await ctx.send(f"**问题 {i+1}/{len(questions)}:** {question}")
        try:
            # 等待用户在当前频道回复消息
            # check lambda 确保消息来自发起命令的用户，且在同一频道
            message = await bot.wait_for(
                'message',
                check=lambda m: m.channel == ctx.channel and m.author == ctx.author,
                timeout=60 # 设置60秒的超时时间，如果用户未回复则触发 TimeoutError
            )
            # 关键步骤：将用户消息的内容（字符串形式）添加到答案列表中
            answers.append(message.content)
            await ctx.send(f"好的，你回答了：`{message.content}`") # 确认收到回答

        except asyncio.TimeoutError:
            # 如果用户在指定时间内没有回复，则捕获超时错误并中止投票
            await ctx.send("抱歉，你长时间未回复，投票已中止。")
            break # 超时则中断循环

    # 投票结束后处理答案
    if len(questions) != len(answers):
        await ctx.send("投票未完成，你没有回答所有问题。")
    else:
        await ctx.send("感谢你完成投票！以下是你的回答：")
        for i, answer in enumerate(answers):
            await ctx.send(f"**问题 {i+1}:** {questions[i]}\n**你的回答:** `{answer}`")
        # 这里可以根据需要调用其他函数来处理收集到的答案，例如存储到数据库、发送给管理员或进行进一步分析。
        # 示例：await process_collected_answers(answers, ctx)

3. 运行 Bot

最后，添加代码来运行你的 Bot。

# 替换为你的Bot令牌
# 请确保你的令牌是安全的，不要直接硬编码在公共仓库中
bot.run("YOUR_BOT_TOKEN")

完整代码示例

import asyncio
import discord
from discord.ext import commands

# 定义你的问题列表
questions = ["你的名字是什么？", "你最喜欢的编程语言是什么？", "你对这个教程有什么建议？"]

# 初始化Bot，并启用必要的Intents
# 注意：从Discord.py 2.0+开始，访问用户发送的消息内容需要显式启用 message_content Intent。
# 如果不启用，message.content 可能会为空或引发错误。
intents = discord.Intents.default()
intents.message_content = True # 确保能够读取用户发送的消息内容

bot = commands.Bot(intents=intents, command_prefix='+')

@bot.event
async def on_ready():
    """Bot 启动成功时在控制台打印消息。"""
    print(f'Bot已登录：{bot.user}')

@bot.command()
async def poll(ctx):
    """
    启动一个交互式投票，向用户提问并收集文本回答。
    用法: +poll
    """
    answers = [] # 用于存储用户回答的列表
    await ctx.send("你好！我将问你几个问题，请逐一回答。")

    for i, question in enumerate(questions):
        await ctx.send(f"**问题 {i+1}/{len(questions)}:** {question}")
        try:
            # 等待用户在当前频道回复消息
            # check lambda 确保消息来自发起命令的用户，且在同一频道
            message = await bot.wait_for(
                'message',
                check=lambda m: m.channel == ctx.channel and m.author == ctx.author,
                timeout=60 # 设置60秒的超时时间，如果用户未回复则触发 TimeoutError
            )
            # 关键步骤：将用户消息的内容（字符串形式）添加到答案列表中
            answers.append(message.content)
            await ctx.send(f"好的，你回答了：`{message.content}`") # 确认收到回答

        except asyncio.TimeoutError:
            # 如果用户在指定时间内没有回复，则捕获超时错误并中止投票
            await ctx.send("抱歉，你长时间未回复，投票已中止。")
            break # 超时则中断循环

    # 投票结束后处理答案
    if len(questions) != len(answers):
        await ctx.send("投票未完成，你没有回答所有问题。")
    else:
        await ctx.send("感谢你完成投票！以下是你的回答：")
        for i, answer in enumerate(answers):
            await ctx.send(f"**问题 {i+1}:** {questions[i]}\n**你的回答:** `{answer}`")
        # 这里可以根据需要调用其他函数来处理收集到的答案，例如存储到数据库、发送给管理员或进行进一步分析。
        # 示例：await process_collected_answers(answers, ctx)

# 替换为你的Bot令牌
# 请确保你的令牌是安全的，不要直接硬编码在公共仓库中
bot.run("YOUR_BOT_TOKEN")

关键注意事项

1. Intents 配置：如前所述，discord.Intents.message_content = True 及其在 Discord 开发者门户中的对应设置至关重要。如果未正确配置，Bot 将无法读取用户消息内容。
2. 错误处理：asyncio.TimeoutError 的处理是必不可少的，它能确保 Bot 在用户长时间不回复时能够优雅地退出投票流程，避免命令无限期挂起。
3. 用户体验：
   • 提供清晰的指令和问题提示。
   • 在每次收到回答后给予确认，让用户知道他们的输入已被接收。
   • 在投票开始和结束时提供明确的提示信息。
4. 数据处理：收集到的 answers 列表是一个字符串列表，你可以根据业务需求对其进行进一步处理，例如：
   • 将数据存储到数据库（如 SQLite, PostgreSQL, MongoDB）。
   • 将结果发送到特定的管理员频道。
   • 进行简单的统计分析。
5. 并发性：bot.wait_for 是针对单个用户和单个会话设计的。如果多个用户同时发起 +poll 命令，每个用户都会有独立的投票会话。check 函数确保了每个 wait_for 实例只响应发起该命令的用户。

总结

通过本教程，你已经学会了如何在 discord.py Bot 中实现一个健壮的交互式投票或问卷功能。核心在于正确使用 bot.wait_for 结合适当的 check 函数来监听用户消息，并通过 message.content 属性将用户回答捕获为字符串。遵循这些步骤和注意事项，你将能够构建出更加智能和用户友好的 Discord Bot。