写给 Discord 机器人开发者的 2026 年 9 月 API 变更汇总 - 文件 20MiB·斜杠命令多行输入·年龄验证(Age Assurance)·邀请目标用户·shard 必填，用 discord.py 2.7.1 应对（Python 示例）🗞️

pip install discord.py==2.7.1 python-dotenv

DISCORD_TOKEN=여기에_봇_토큰

# discord/utils.py (2.7.1)
DEFAULT_FILE_SIZE_LIMIT_BYTES = 10485760   # 10 MiB

@bot.tree.command(name="파일한도", description="显示机器人在这个服务器能上传的文件大小")
async def file_limit(interaction: discord.Interaction):
    live = interaction.filesize_limit          # Discord 随这次交互一起发来的值
    cached = interaction.guild.filesize_limit if interaction.guild else None  # 库内置的表
    msg = f"Discord 告知的上限：**{live / MIB:.0f} MiB**"
    if cached is not None:
        msg += f"\ndiscord.py 表的值(guild.filesize_limit)：{cached / MIB:.0f} MiB"
    await interaction.response.send_message(msg, ephemeral=True)

@bot.tree.command(name="여러줄", description="把多行输入的文字按行拆开显示")
@app_commands.describe(text="试试用 Shift+Enter 换行输入")
async def multiline(interaction: discord.Interaction, text: app_commands.Range[str, 1, 1000]):
    lines = [line.strip() for line in text.splitlines() if line.strip()]
    if not lines:
        await interaction.response.send_message("内容是空的！", ephemeral=True)
        return
    body = "\n".join(f"{i}. {line}" for i, line in enumerate(lines, start=1))
    await interaction.response.send_message(f"一共收到 **{len(lines)} 行**。\n{body}")

async def fetch_all_guilds_by_shard(client: discord.Client) -> list:
    """给使用大型机器人分片的应用用。普通机器人直接用 client.fetch_guilds() 就行。"""
    _, _, start_limit = await client.http.get_bot_gateway()
    max_concurrency = start_limit["max_concurrency"]
    guilds = []
    for shard in range(max_concurrency):
        route = Route("GET", "/users/@me/guilds")
        data = await client.http.request(route, params={"shard": shard, "limit": 200})
        guilds.extend(data)
    return guilds

@bot.tree.command(name="상태보기", description="读取成员的自定义状态（可能看不到）")
async def show_status(interaction: discord.Interaction, member: discord.Member):
    custom = next((a for a in member.activities if isinstance(a, discord.CustomActivity)), None)
    if custom is None:
        text = "没有设置自定义状态，或者因为资料隐私设置，机器人看不到。"
    else:
        text = f"{custom.emoji or ''} {custom.name or ''}".strip() or "(只有表情的状态)"
    await interaction.response.send_message(f"{member.display_name}: {text}", ephemeral=True)

@bot.tree.command(name="초대대상", description="创建只有指定的人才能使用的邀请链接")
@app_commands.describe(member="允许使用邀请链接的成员")
async def invite_target(interaction: discord.Interaction, member: discord.Member):
    channel = interaction.channel
    if not isinstance(channel, discord.TextChannel):
        await interaction.response.send_message("请在文字频道里使用！", ephemeral=True)
        return

    await interaction.response.defer(ephemeral=True)
    invite = await channel.create_invite(max_age=3600, max_uses=1, unique=True,
                                         reason=f"{member} 专属邀请")

    # discord.py 2.7.1 还没有对应的方法，所以直接调用端点
    route = Route("PUT", "/invites/{code}/target-users/{user_id}",
                  code=invite.code, user_id=member.id)
    await bot.http.request(route)   # 成功时返回 204（无响应体）

    await interaction.followup.send(
        f"已创建 {member.mention} 专属邀请链接（1 小时，1 次）：{invite.url}", ephemeral=True
    )

@bot.tree.command(name="정리예상", description="计算 30 天内没有活动的成员有多少（不会真的踢出）")
@app_commands.describe(days="多少天没有活动就算作清理对象 (1~30)")
async def prune_estimate(interaction: discord.Interaction, days: app_commands.Range[int, 1, 30] = 30):
    guild = interaction.guild
    if guild is None:
        await interaction.response.send_message("请在服务器里使用！", ephemeral=True)
        return

    perms = guild.me.guild_permissions
    if "PRUNE_REQUIRES_ADMIN" in guild.features:
        if not perms.administrator:
            await interaction.response.send_message(
                "这个服务器开启了 **PRUNE_REQUIRES_ADMIN**，机器人需要管理员权限。",
                ephemeral=True,
            )
            return
    elif not (perms.kick_members and perms.manage_guild):
        await interaction.response.send_message(
            "机器人需要 **踢出成员 + 管理服务器** 权限才能计算。", ephemeral=True
        )
        return

    await interaction.response.defer(ephemeral=True)
    count = await guild.estimate_pruned_members(days=days)
    await interaction.followup.send(f"按 {days} 天计算，清理对象：**{count} 人**（只做了计算）", ephemeral=True)

# discord.py 2.7.1 / Python 3.8+
# 2026 年 9 月 Discord API 变更检查机器人 (sept_check.py)
import os

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

load_dotenv()
TOKEN = os.getenv("DISCORD_TOKEN")
if not TOKEN:
    raise SystemExit("❌ .env 文件里没有 DISCORD_TOKEN！")

intents = discord.Intents.default()
intents.members = True      # 成员信息（需要在开发者门户里开启）
intents.presences = True    # 用于查看自定义状态（需要在开发者门户里开启）
bot = commands.Bot(command_prefix="!", intents=intents)

MIB = 1024 * 1024


@bot.event
async def on_ready():
    await bot.tree.sync()
    print(f"✅ 已登录：{bot.user} / discord.py {discord.__version__}")


# ① 9/11 - 字符串选项多行输入
@bot.tree.command(name="여러줄", description="把多行输入的文字按行拆开显示")
@app_commands.describe(text="试试用 Shift+Enter 换行输入")
async def multiline(interaction: discord.Interaction, text: app_commands.Range[str, 1, 1000]):
    lines = [line.strip() for line in text.splitlines() if line.strip()]
    if not lines:
        await interaction.response.send_message("内容是空的！", ephemeral=True)
        return
    body = "\n".join(f"{i}. {line}" for i, line in enumerate(lines, start=1))
    await interaction.response.send_message(f"一共收到 **{len(lines)} 行**。\n{body}")


# ② 9/3 - 文件上传默认上限 20 MiB
@bot.tree.command(name="파일한도", description="显示机器人在这个服务器能上传的文件大小")
async def file_limit(interaction: discord.Interaction):
    live = interaction.filesize_limit          # Discord 随这次交互一起发来的值
    cached = interaction.guild.filesize_limit if interaction.guild else None  # 库内置的表
    msg = f"Discord 告知的上限：**{live / MIB:.0f} MiB**"
    if cached is not None:
        msg += f"\ndiscord.py 表的值(guild.filesize_limit)：{cached / MIB:.0f} MiB"
    await interaction.response.send_message(msg, ephemeral=True)


# ③ 8/27 - PRUNE_REQUIRES_ADMIN 服务器功能
@bot.tree.command(name="정리예상", description="计算 30 天内没有活动的成员有多少（不会真的踢出）")
@app_commands.describe(days="多少天没有活动就算作清理对象 (1~30)")
async def prune_estimate(interaction: discord.Interaction, days: app_commands.Range[int, 1, 30] = 30):
    guild = interaction.guild
    if guild is None:
        await interaction.response.send_message("请在服务器里使用！", ephemeral=True)
        return

    perms = guild.me.guild_permissions
    if "PRUNE_REQUIRES_ADMIN" in guild.features:
        if not perms.administrator:
            await interaction.response.send_message(
                "这个服务器开启了 **PRUNE_REQUIRES_ADMIN**，机器人需要管理员权限。",
                ephemeral=True,
            )
            return
    elif not (perms.kick_members and perms.manage_guild):
        await interaction.response.send_message(
            "机器人需要 **踢出成员 + 管理服务器** 权限才能计算。", ephemeral=True
        )
        return

    await interaction.response.defer(ephemeral=True)
    count = await guild.estimate_pruned_members(days=days)
    await interaction.followup.send(f"按 {days} 天计算，清理对象：**{count} 人**（只做了计算）", ephemeral=True)


# ④ 9/18 - 邀请目标用户(target user)端点
@bot.tree.command(name="초대대상", description="创建只有指定的人才能使用的邀请链接")
@app_commands.describe(member="允许使用邀请链接的成员")
async def invite_target(interaction: discord.Interaction, member: discord.Member):
    channel = interaction.channel
    if not isinstance(channel, discord.TextChannel):
        await interaction.response.send_message("请在文字频道里使用！", ephemeral=True)
        return

    await interaction.response.defer(ephemeral=True)
    invite = await channel.create_invite(max_age=3600, max_uses=1, unique=True,
                                         reason=f"{member} 专属邀请")

    # discord.py 2.7.1 还没有对应的方法，所以直接调用端点
    route = Route("PUT", "/invites/{code}/target-users/{user_id}",
                  code=invite.code, user_id=member.id)
    await bot.http.request(route)   # 成功时返回 204（无响应体）

    await interaction.followup.send(
        f"已创建 {member.mention} 专属邀请链接（1 小时，1 次）：{invite.url}", ephemeral=True
    )


# ⑤ 9/17·9/22 - 自定义状态可能看不到
@bot.tree.command(name="상태보기", description="读取成员的自定义状态（可能看不到）")
async def show_status(interaction: discord.Interaction, member: discord.Member):
    custom = next((a for a in member.activities if isinstance(a, discord.CustomActivity)), None)
    if custom is None:
        text = "没有设置自定义状态，或者因为资料隐私设置，机器人看不到。"
    else:
        text = f"{custom.emoji or ''} {custom.name or ''}".strip() or "(只有表情的状态)"
    await interaction.response.send_message(f"{member.display_name}: {text}", ephemeral=True)


# ⑥ 9/15 - 大型机器人分片应用必须带 shard 查询参数
async def fetch_all_guilds_by_shard(client: discord.Client) -> list:
    """给使用大型机器人分片的应用用。普通机器人直接用 client.fetch_guilds() 就行。"""
    _, _, start_limit = await client.http.get_bot_gateway()
    max_concurrency = start_limit["max_concurrency"]
    guilds = []
    for shard in range(max_concurrency):
        route = Route("GET", "/users/@me/guilds")
        data = await client.http.request(route, params={"shard": shard, "limit": 200})
        guilds.extend(data)
    return guilds


bot.run(TOKEN)

python sept_check.py