Discord.py Bot Cogs 命令未加载或未显示问题排查与解决

import asyncio
import discord
import os
from discord.ext import commands

# 初始化 Bot 意图，这里使用全部意图，请根据实际需求进行精简
intents = discord.Intents.all()
bot = commands.Bot(command_prefix="!", intents=intents)

async def load_extensions():
    """异步加载 cogs 文件夹中的所有扩展（Cogs）。"""
    cogs_dir = "./cogs"
    if not os.path.exists(cogs_dir):
        print(f"错误: Cogs 文件夹 '{cogs_dir}' 不存在。")
        return

    for filename in os.listdir(cogs_dir):
        if filename.endswith(".py"):
            try:
                # 构造 Cog 的完整模块路径，例如 "cogs.ping"
                await bot.load_extension(f"cogs.{filename[:-3]}")
                print(f"成功加载 Cog: {filename}")
            except commands.ExtensionFailed as e:
                print(f"加载 Cog 失败: {filename} - {e}")
            except Exception as e:
                print(f"加载 Cog 时发生未知错误: {filename} - {e}")

async def main():
    """主函数，负责加载 Cogs 并启动 Bot。"""
    await load_extensions()
    # 确保将 "TOKEN" 替换为您的 Bot 令牌
    await bot.start("YOUR_BOT_TOKEN")

if __name__ == "__main__":
    asyncio.run(main())

from discord.ext import commands

class Ping(commands.Cog):
    def __init__(self, bot):
        self.bot = bot

    @commands.command()
    async def ping(self, ctx):
        """回复 Bot 的延迟。"""
        await ctx.send(f"Pong! {round(self.bot.latency * 1000)}ms!")
        print(f"Bot 延迟为 {round(self.bot.latency * 1000)}ms!")

async def setup(bot):
    """将 Ping Cog 添加到 Bot 中。"""
    await bot.add_cog(Ping(bot))

import discord
from discord.ext import commands

# 假设这些变量在 'stuff.py' 或其他地方被定义
# 为了示例完整性，这里做简单定义，实际项目中应确保它们可访问
reason1 = "Reason One"
reason2 = "Reason Two"
reason3 = "Reason Three"
reason4 = "Reason Four"
reason5 = "Reason Five"
reason6 = "Reason Six"
reason7 = "Reason Seven"

class IGBan(commands.Cog):
    def __init__(self, bot):
        self.bot = bot

    @commands.Cog.listener()
    async def on_message(self, message):
        # 监听器逻辑，这部分通常不受权限装饰器影响
        if message.author.bot:
            return

        # 示例：处理以 !1 到 !7 开头的消息
        # ... (省略大部分与问题不直接相关的 on_message 逻辑) ...

    @commands.command()
    @commands.has_role('Blue') # <-- 关键所在：命令要求用户拥有 'Blue' 角色
    async def igunban(self, ctx):
        """显示 IG Unban 命令的使用说明。"""
        embed = discord.Embed(title="Use for Following Reasons:", color=0x8A3AB9)
        embed.set_author(name="IG Unbanner")
        embed.add_field(name=f"[1] {reason1}", value="", inline=False)
        embed.add_field(name=f"[2] {reason2}", value="", inline=False)
        # ... (省略其他 reason 字段) ...
        embed.add_field(name="** **", value="```Usage```", inline=False)
        embed.add_field(name="", value="```!reason:username:name:email```", inline=False)
        embed.add_field(name="** **", value="```Example```", inline=False)
        embed.add_field(name="", value="```!7:John_doe:JohnDoe:email@example.com```", inline=False)
        await ctx.send(embed=embed)

async def setup(bot):
    """将 IGBan Cog 添加到 Bot 中。"""
    await bot.add_cog(IGBan(bot))

    @commands.command()
    # @commands.has_role('Blue') # <-- 暂时注释掉或移除此行
    async def igunban(self, ctx):
        # ... 命令逻辑 ...

class IGBan(commands.Cog):
    def __init__(self, bot):
        self.bot = bot

    @commands.Cog.listener()
    async def on_command_error(self, ctx, error):
        """处理 Cog 内的命令错误。"""
        if isinstance(error, commands.MissingRole):
            await ctx.send(f"抱歉，{ctx.author.mention}，您需要拥有 '{error.missing_role}' 角色才能使用此命令。", ephemeral=True)
        elif isinstance(error, commands.MissingPermissions):
            await ctx.send(f"抱歉，{ctx.author.mention}，您缺少必要的权限来使用此命令。", ephemeral=True)
        else:
            # 对于其他类型的错误，可以继续传递或进行其他处理
            print(f"发生未处理的命令错误: {error}")
            # await ctx.send(f"执行命令时发生错误: {error}") # 调试时可开启