Discord 机器人开发#32打造服务器日志·审核日志(Audit Log)频道！自动记录消息删除、编辑、成员进出和踢出（Python 示例）🕵️

pip install -U discord.py python-dotenv

token=여기에_봇_토큰

# discord.py 2.7.1 / Python 3.9+ / python-dotenv 1.x
import os
import json
import asyncio

import discord
from discord import app_commands
from discord.ext import commands
from dotenv import load_dotenv

load_dotenv()
token = os.getenv("token")

CONFIG_FILE = "log_config.json"   # {服务器ID(str): 日志频道ID(int)}
MAX_CONTENT = 1000                # 嵌入字段最多 1024 字 → 留点余量截断

intents = discord.Intents.default()
intents.message_content = True   # 想看被删消息的'内容'就必须开 (特权 Intent)
intents.members = True           # 检测成员进出·昵称·身份组变更 (特权 Intent)
intents.moderation = True        # 踢出·封禁 + 审核日志事件

bot = commands.Bot(command_prefix="!", intents=intents, max_messages=5000)

log_channels: dict[str, int] = {}
lock = asyncio.Lock()

def save():
    with open(CONFIG_FILE, "w", encoding="utf-8") as f:
        json.dump(log_channels, f, ensure_ascii=False, indent=2)


def load():
    global log_channels
    if os.path.exists(CONFIG_FILE):
        with open(CONFIG_FILE, encoding="utf-8") as f:
            log_channels = json.load(f)


def get_log_channel(guild: discord.Guild):
    cid = log_channels.get(str(guild.id))
    return guild.get_channel(cid) if cid else None


def make_embed(title: str, color: discord.Color, user=None) -> discord.Embed:
    embed = discord.Embed(title=title, color=color, timestamp=discord.utils.utcnow())
    if user is not None:
        embed.set_author(name=f"{user} ({user.id})", icon_url=user.display_avatar.url)
    return embed


async def send_log(guild: discord.Guild, embed: discord.Embed):
    channel = get_log_channel(guild)
    if channel is None:
        return
    try:
        await channel.send(embed=embed)
    except discord.Forbidden:
        print(f"⚠️ {guild.name}: 没有在日志频道发送消息的权限。")


def cut(text: str) -> str:
    text = text or "(没有内容 — 只有嵌入/附件，或不在缓存中)"
    return text if len(text) <= MAX_CONTENT else text[:MAX_CONTENT] + " …(已省略)"

async def find_deleter(guild: discord.Guild, author_id: int, channel_id: int):
    """在审核日志里查找'刚刚在这个频道删了这个人消息的管理员'。"""
    try:
        async for entry in guild.audit_logs(limit=5, action=discord.AuditLogAction.message_delete):
            same_target = entry.target is not None and entry.target.id == author_id
            same_channel = entry.extra.channel.id == channel_id
            recent = (discord.utils.utcnow() - entry.created_at).total_seconds() < 15
            if same_target and same_channel and recent:
                return entry.user
    except discord.Forbidden:
        return None
    return None


@bot.event
async def on_raw_message_delete(payload: discord.RawMessageDeleteEvent):
    if payload.guild_id is None:      # 忽略私信
        return
    guild = bot.get_guild(payload.guild_id)
    msg = payload.cached_message

    embed = make_embed("🗑️ 消息删除", discord.Color.red(), msg.author if msg else None)
    embed.add_field(name="频道", value=f"<#{payload.channel_id}>", inline=True)

    if msg is None:
        embed.add_field(name="内容", value="不在缓存中的消息 (机器人启动前的消息)", inline=False)
        embed.set_footer(text=f"消息 ID: {payload.message_id}")
    else:
        if msg.author.bot:
            return
        deleter = await find_deleter(guild, msg.author.id, payload.channel_id)
        who = deleter.mention if deleter else "本人 (或无法确认)"
        embed.add_field(name="删除者", value=who, inline=True)
        embed.add_field(name="内容", value=cut(msg.content), inline=False)
        if msg.attachments:
            files = "\n".join(a.filename for a in msg.attachments)
            embed.add_field(name="附件", value=files, inline=False)
        embed.set_footer(text=f"消息 ID: {msg.id}")

    await send_log(guild, embed)


@bot.event
async def on_raw_message_edit(payload: discord.RawMessageUpdateEvent):
    if payload.guild_id is None:
        return
    before = payload.cached_message
    after = payload.message
    if before is None or after.author.bot:
        return
    if before.content == after.content:      # 过滤掉生成嵌入预览等'假编辑'
        return

    guild = bot.get_guild(payload.guild_id)
    embed = make_embed("✏️ 消息编辑", discord.Color.orange(), after.author)
    embed.add_field(name="频道", value=after.channel.mention, inline=True)
    embed.add_field(name="跳转", value=f"[跳到消息]({after.jump_url})", inline=True)
    embed.add_field(name="编辑前", value=cut(before.content), inline=False)
    embed.add_field(name="编辑后", value=cut(after.content), inline=False)
    await send_log(guild, embed)


@bot.event
async def on_raw_bulk_message_delete(payload: discord.RawBulkMessageDeleteEvent):
    if payload.guild_id is None:
        return
    guild = bot.get_guild(payload.guild_id)
    embed = make_embed("🧹 批量删除消息", discord.Color.dark_red())
    embed.add_field(name="频道", value=f"<#{payload.channel_id}>", inline=True)
    embed.add_field(name="数量", value=f"{len(payload.message_ids)} 条", inline=True)
    await send_log(guild, embed)

@bot.event
async def on_member_join(member: discord.Member):
    embed = make_embed("📥 成员加入", discord.Color.green(), member)
    embed.add_field(name="成员", value=member.mention, inline=True)
    embed.add_field(name="账号创建日期", value=discord.utils.format_dt(member.created_at, "R"), inline=True)
    embed.add_field(name="当前人数", value=f"{member.guild.member_count} 人", inline=True)
    await send_log(member.guild, embed)


@bot.event
async def on_member_remove(member: discord.Member):
    embed = make_embed("📤 成员离开", discord.Color.light_grey(), member)
    embed.add_field(name="成员", value=f"{member} ({member.mention})", inline=True)
    if member.joined_at:
        embed.add_field(name="加入日期", value=discord.utils.format_dt(member.joined_at, "R"), inline=True)
    roles = [r.mention for r in member.roles if r != member.guild.default_role]
    if roles:
        embed.add_field(name="拥有过的身份组", value=" ".join(roles), inline=False)
    await send_log(member.guild, embed)


@bot.event
async def on_member_update(before: discord.Member, after: discord.Member):
    if before.nick != after.nick:
        embed = make_embed("🏷️ 昵称变更", discord.Color.blue(), after)
        embed.add_field(name="变更前", value=before.nick or "(无)", inline=True)
        embed.add_field(name="变更后", value=after.nick or "(无)", inline=True)
        await send_log(after.guild, embed)

    added = [r for r in after.roles if r not in before.roles]
    removed = [r for r in before.roles if r not in after.roles]
    if added or removed:
        embed = make_embed("🎭 身份组变更", discord.Color.blurple(), after)
        if added:
            embed.add_field(name="➕ 新增", value=" ".join(r.mention for r in added), inline=False)
        if removed:
            embed.add_field(name="➖ 移除", value=" ".join(r.mention for r in removed), inline=False)
        await send_log(after.guild, embed)

MOD_ACTIONS = {
    discord.AuditLogAction.kick: ("👢 踢出(Kick)", discord.Color.dark_orange()),
    discord.AuditLogAction.ban: ("🔨 封禁(Ban)", discord.Color.dark_red()),
    discord.AuditLogAction.unban: ("🕊️ 解除封禁(Unban)", discord.Color.teal()),
}


@bot.event
async def on_audit_log_entry_create(entry: discord.AuditLogEntry):
    if entry.action not in MOD_ACTIONS:
        return
    title, color = MOD_ACTIONS[entry.action]
    embed = make_embed(title, color, entry.user)
    target = entry.target
    embed.add_field(name="对象", value=f"{target} (<@{target.id}>)" if target else "(未知)", inline=True)
    embed.add_field(name="执行者", value=entry.user.mention if entry.user else "(未知)", inline=True)
    embed.add_field(name="原因", value=entry.reason or "(未填写原因)", inline=False)
    await send_log(entry.guild, embed)

@bot.event
async def on_guild_channel_create(channel: discord.abc.GuildChannel):
    embed = make_embed("📁 频道创建", discord.Color.green())
    embed.add_field(name="频道", value=f"{channel.mention} (`{channel.name}`)", inline=True)
    embed.add_field(name="类型", value=str(channel.type), inline=True)
    await send_log(channel.guild, embed)


@bot.event
async def on_guild_channel_delete(channel: discord.abc.GuildChannel):
    embed = make_embed("🗂️ 频道删除", discord.Color.red())
    embed.add_field(name="频道", value=f"`{channel.name}`", inline=True)
    embed.add_field(name="类型", value=str(channel.type), inline=True)
    await send_log(channel.guild, embed)


@bot.tree.command(name="로그설정", description="[管理员] 设置发送服务器日志的频道")
@app_commands.describe(채널="用来存放日志的文字频道")
@app_commands.checks.has_permissions(administrator=True)
async def set_log(interaction: discord.Interaction, 채널: discord.TextChannel):
    me = interaction.guild.me
    perms = 채널.permissions_for(me)
    if not (perms.send_messages and perms.embed_links):
        return await interaction.response.send_message(
            f"❌ 我在 {채널.mention} 没有**发送消息·嵌入链接**权限。", ephemeral=True)
    async with lock:
        log_channels[str(interaction.guild.id)] = 채널.id
        save()
    await interaction.response.send_message(f"✅ 以后服务器日志会记录在 {채널.mention}！", ephemeral=True)
    await 채널.send(embed=make_embed("🟢 已设为日志频道", discord.Color.green(), interaction.user))


@bot.tree.command(name="로그해제", description="[管理员] 停止记录服务器日志")
@app_commands.checks.has_permissions(administrator=True)
async def unset_log(interaction: discord.Interaction):
    async with lock:
        log_channels.pop(str(interaction.guild.id), None)
        save()
    await interaction.response.send_message("⏹️ 已关闭日志记录。", ephemeral=True)


@bot.tree.error
async def on_app_command_error(interaction: discord.Interaction, error: app_commands.AppCommandError):
    if isinstance(error, app_commands.MissingPermissions):
        await interaction.response.send_message("❌ 只有管理员才能使用这个命令。", ephemeral=True)
    else:
        raise error


@bot.event
async def on_ready():
    load()
    await bot.tree.sync()
    print(f"✅ 已登录: {bot.user} / 已设置日志的服务器 {len(log_channels)} 个")


bot.run(token)

discord.AuditLogAction.member_update: ("⏳ 禁言/昵称变更", discord.Color.gold()),
discord.AuditLogAction.role_create: ("🎨 身份组创建", discord.Color.green()),
discord.AuditLogAction.role_delete: ("🎨 身份组删除", discord.Color.red()),
discord.AuditLogAction.message_bulk_delete: ("🧹 批量删除 (管理员)", discord.Color.dark_red()),