如何在 Discord 机器人中记录消息删除与编辑日志-Python教程-PHP中文网

如何在 Discord 机器人中记录消息删除与编辑日志

本文详细讲解如何使用 discord.py 实现消息删除和编辑的完整日志功能，包括构建结构化 embed 日志、区分编辑前后的消息内容，并安全发送至指定日志频道。

本文详细讲解如何使用 discord.py 实现消息删除和编辑的完整日志功能，包括构建结构化 embed 日志、区分编辑前后的消息内容，并安全发送至指定日志频道。

要为 Discord 服务器构建一套可靠的审核日志系统，关键在于准确捕获 on_message_delete 和 on_message_edit 两个事件，并以清晰、可读的方式呈现变更细节。你已成功实现删除日志，接下来需补全编辑日志逻辑——核心在于理解 on_message_edit 的双参数签名：before 表示编辑前的消息对象，after 表示编辑后的消息对象。

以下是完整的、生产就绪的实现示例（适用于 Cog 类）：

XPack

一款AI开发辅助工具，主要用于全球首个开源的MCP交易平台，适合需要提升相关任务效率的用户。

下载

@commands.Cog.listener()
async def on_message_delete(self, message: discord.Message):
    # 跳过机器人自身消息或无内容消息（如仅含附件）
    if not message.content.strip() and not message.attachments:
        return

    embed = discord.Embed(
        title="?️ Message Deleted",
        color=0xff4444,
        timestamp=message.created_at
    )
    embed.add_field(name="Author", value=f"{message.author.mention} (`{message.author}`)", inline=False)
    embed.add_field(name="Channel", value=message.channel.mention, inline=False)
    embed.add_field(name="Content", value=message.content or "(No text content)", inline=False)

    # 尝试获取并显示附件信息
    if message.attachments:
        attach_list = "\n".join([f"• `{a.filename}` ({self._format_size(a.size)})" for a in message.attachments])
        embed.add_field(name="Attachments", value=attach_list, inline=False)

    log_channel = discord.utils.get(message.guild.channels, name="logging")
    if log_channel:
        await log_channel.send(embed=embed)


@commands.Cog.listener()
async def on_message_edit(self, before: discord.Message, after: discord.Message):
    # 忽略由机器人触发的编辑（如自动生成的响应），或内容未实际变化的情况
    if before.author.bot or before.content == after.content:
        return

    embed = discord.Embed(
        title="✏️ Message Edited",
        color=0xffff44,
        timestamp=after.edited_at or after.created_at
    )
    embed.add_field(name="Author", value=f"{before.author.mention} (`{before.author}`)", inline=False)
    embed.add_field(name="Channel", value=before.channel.mention, inline=False)
    embed.add_field(name="Before", value=before.content[:1024] or "(Empty)", inline=False)
    embed.add_field(name="After", value=after.content[:1024] or "(Empty)", inline=False)

    # 若编辑后内容过长，添加截断提示
    if len(before.content) > 1024:
        embed.set_footer(text="⚠️ Content truncated — full history available via audit log")

    log_channel = discord.utils.get(before.guild.channels, name="logging")
    if log_channel:
        await log_channel.send(embed=embed)

# 辅助方法：格式化文件大小（可选）
def _format_size(self, size_bytes: int) -> str:
    for unit in ["B", "KB", "MB"]:
        if size_bytes <p><strong>重要注意事项：</strong>  </p>