Discord.py 2.3+ 支持通过 poll 关键字参数发送原生投票，而非仅靠反应模拟；需正确构造 discord.Poll 对象并传入 send() 方法的 poll= 参数，否则仅输出对象表示而无法渲染为交互式投票。
discord.py 2.3+ 支持通过 `poll` 关键字参数发送原生投票，而非仅靠反应模拟；需正确构造 `discord.poll` 对象并传入 `send()` 方法的 `poll=` 参数，否则仅输出对象表示而无法渲染为交互式投票。
Discord 自 2023 年起推出的原生投票功能（即用户右键消息可创建的带进度条、多选项、限时统计的 Poll），现已通过 discord.py 官方 API 完整支持——但必须使用 poll= 关键字参数显式传入 discord.Poll 实例，不能直接作为位置参数或字符串发送。
以下是一个完整、可运行的示例：
import discord
from discord import app_commands
from datetime import timedelta
@bot.tree.command(name="poll", description="创建一个原生 Discord 投票")
@app_commands.describe(
question="投票问题",
option1="选项一",
option2="选项二",
hours="投票持续时间（小时，最长7天）"
)
async def create_poll(interaction: discord.Interaction, question: str, option1: str, option2: str, hours: float = 1.0):
# 构建 Poll 对象（最多支持 10 个选项）
poll = discord.Poll(
question=question,
duration=timedelta(hours=min(max(hours, 0.1), 168)), # 限制：0.1h ~ 168h（7天）
allow_multiselect=False # 可设为 True 允许多选
)
poll.add_answer(text=option1)
poll.add_answer(text=option2)
# 可继续添加：poll.add_answer(text="选项三")
try:
await interaction.response.send_message(poll=poll) # ✅ 关键：poll=keyword
except discord.HTTPException as e:
await interaction.response.send_message(f"❌ 创建投票失败：{e}", ephemeral=True)⚠️ 重要注意事项：
-
poll=必须是命名参数，写成await ctx.send(poll=p)；若写成await ctx.send(p)或await ctx.send(str(p))，只会输出<poll ...></poll>字符串，不会渲染为真实投票； -
duration必须是datetime.timedelta，且取值范围为 6 分钟至 7 天（即timedelta(minutes=6)至timedelta(days=7)），超出将引发HTTPException； - 每个 Poll 最多支持 10 个选项，调用
add_answer()超过此数会抛出ValueError； - 投票一经发送不可编辑或删除选项（Discord 限制），请确保内容准确后再发送；
- 用户端需 Discord 桌面/Web/新版移动端才能查看和参与；旧版 App 或部分第三方客户端可能不显示。
✅ 总结：原生投票不是“高级反应”，而是 Discord 消息的一种独立类型。只要使用 poll= 参数配合合法 discord.Poll 实例，你的 bot 就能发出与人类用户创建完全一致的、带实时统计、匿名选项、倒计时和结果摘要的正式投票。
