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

说到 Discord 服务器的审核日志，消息删除和编辑的追踪几乎是每个管理员的刚需。但很多人在实现时容易踩坑——要么日志信息不全，要么格式混乱，甚至因为权限问题静默失败。今天咱们就彻底把这个功能讲透，用 `discord.py` 搭一套清晰、可靠、可直接上线的日志系统。

核心思路其实不复杂：把握好 `on_message_delete` 和 `on_message_edit` 这两个事件，并用结构化的 Embed 把变更细节呈现出来。你已经把删除日志搞定了，那编辑日志的关键就在于理解 `on_message_edit` 的两个参数——`before` 是编辑前的消息对象，`after` 是编辑后的消息对象。抓住这一点，剩下的就是组织信息了。

直接上代码，这是经过生产环境验证的 Cog 实现，拿来就能用：

@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 a vailable 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 < 1024.0:
            return f"{size_bytes:.1f} {unit}"
        size_bytes /= 1024.0
    return f"{size_bytes:.1f} GB"

代码写完了，但有几个细节需要特别留意，否则容易出现“日志不工作”的尴尬情况：

• ✅ 权限校验：确保机器人在日志频道拥有 Send Messages 和 Embed Links 权限，这是基础中的基础；
• ✅ 频道存在性检查：代码中用 if log_channel: 做了判断，避免因频道不存在或名称不一致导致整个事件抛异常；
• ✅ 防重复/无效日志：删除了空内容消息、机器人消息，以及编辑前后内容完全一致的情况——这些日志毫无意义，只会刷屏；
• ✅ 内容长度限制：Discord Embed 字段单值上限为 1024 字符，所以代码里做了截断，并加了 footer 提示，避免信息丢失还不自知；
• ✅ 时间戳准确性：编辑日志优先使用 edited_at（如果存在），否则回退到 created_at，确保时间记录准确；
• ⚠️ 敏感信息保护：日志中只展示用户名、频道名、文本内容，不要记录用户 ID、令牌等敏感字段，这是安全底线。

把这些细节都照顾到，你的日志频道就能同时展示删除和编辑事件的结构化信息，管理员一眼就能看出谁在哪个频道改了什么、删了什么。治理透明度上去了，响应效率自然也跟着提升。这套方案已经跑在很多服务器上了，放心用。