You need to enable JavaScript to run this app. 使用discord.py开发Discord机器人时s!help命令帮助功能失效问题
优惠活动
大模型
产品
解决方案
定价
更多

使用discord.py开发Discord机器人时s!help命令帮助功能失效问题

功能失效核心原因
  • 你编写的kick命令对应的embed代码是直接嵌入在kick命令的执行逻辑内的,仅当用户触发s!kick指令时才会返回对应内容,完全没有接入机器人的帮助命令运行流程。
  • discord.py内置帮助系统默认仅读取命令函数附带的元配置(如brief、description、usage参数)生成帮助内容,不会自动抓取命令执行体内部的自定义embed逻辑,因此输入s!help <command>时无法返回你设计的详情。
可行解决方案

方案1:适配内置帮助系统的参数规则

给kick命令添加官方要求的元配置参数,让内置帮助系统可以自动读取并生成帮助内容,不需要额外写帮助逻辑:

@bot.command(
    name="kick",
    brief="踢出指定服务器成员",
    description="仅拥有踢出成员权限的用户可使用,执行后将目标成员移出服务器",
    usage="<成员> [可选: 踢出原因]"
)
async def kick(ctx, member: discord.Member, reason: str = "无指定原因"):
    # 此处编写kick命令的实际执行逻辑:权限校验、成员踢出操作
    await member.kick(reason=reason)
    await ctx.send(f"已成功踢出成员 {member.mention}")

完成配置后,内置的s!help命令会自动在用户输入s!help kick时,读取上述元参数生成标准化的帮助详情。

方案2:自定义匹配你设计的embed样式的帮助命令

如果需要保留你原本设计的embed返回样式,需要手动重写帮助命令的完整逻辑,不能依赖默认help系统:

  1. 先移除内置默认help命令,避免逻辑冲突:
bot.remove_command("help")
  1. 建立命令与对应帮助信息的映射表,编写自定义help命令逻辑:
# 存储每个命令对应的帮助详情
command_help_db = {
    "kick": {
        "title": "Kick",
        "description": "Kicks a member. Only used by users having kick members permission",
        "syntax": "s!kick <member> (reason)"
    }
}

@bot.command(name="help")
async def custom_help(ctx, target_cmd: str = None):
    # 未输入具体命令时,返回全命令列表提示
    if not target_cmd:
        await ctx.send("输入 s!help <命令名> 可查看对应命令的详细使用说明")
        return
    # 命中对应命令的帮助信息时,返回设计的embed
    matched_cmd = target_cmd.lower()
    if matched_cmd in command_help_db:
        help_content = command_help_db[matched_cmd]
        embed = discord.Embed(
            title=help_content["title"],
            description=help_content["description"]
        )
        embed.add_field(name="**Syntax**", value=help_content["syntax"])
        await ctx.send(embed=embed)
        return
    # 匹配不到对应命令时的提示
    await ctx.send(f"未查询到名为 {target_cmd} 的有效命令")
排查校验点
  • 确认自定义help命令的触发前缀与机器人全局设置的s!前缀一致,无其他同名命令覆盖help逻辑
  • 命令匹配环节加入大小写兼容处理,避免用户输入Kick这类大写开头的命令名时匹配失败
  • 确认bot的消息权限范围内具备发送embed、发送消息的基础权限

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.07 18:45:01