每个 YAWBDB 功能都需要特定的 Discord 权限才能工作。本页逐个功能列出机器人所需要的权限。
⚠️ 重要： YAWBDB 的邀请链接不会预先授予任何权限。添加机器人之后，你必须给它的身份组授予下面列出的权限（如果你更喜欢简单的设置，也可以授予 Administrator）。故障排查请参阅 机器人权限。
🔑 基础权限（所有功能）
这些权限是机器人能够工作的最低要求：
| 权限 | 原因 |
|---|---|
| View Channels | 读取它所运行的频道 |
| Send Messages | 回复、发布日志和确认消息 |
| Embed Links | 机器人的大多数回应都使用嵌入消息 |
| Attach Files | 导出文件、录音、转录文本 |
| Read Message History | 为审核和 AI 功能提供上下文 |
🗝️ 各功能的权限
| 功能 | 额外权限 |
|---|---|
| Moderation | Ban Members, Kick Members, Moderate Members (timeout) |
| Automod | Manage Messages（删除被过滤的消息）, Moderate Members |
| Anti-Raid | Ban Members, Kick Members, Moderate Members |
| Anti-Nuke | View Audit Log（必需，用于识别每个操作是谁执行的），再根据所选的响应方式加上 Manage Roles / Kick Members / Ban Members。机器人的身份组必须高于它所要防范的管理员 |
| Honeypot | Manage Messages（删除陷阱消息），再根据操作加上 Ban Members / Kick Members / Moderate Members。可选的警告嵌入消息需要 Manage Messages（置顶） |
| Server Logs | 仅基础权限（建议授予 View Audit Log，以获得更丰富的操作者数据） |
| Reaction Roles | Manage Roles, Add Reactions |
| Giveaways | 仅基础权限（发布嵌入消息、读取成员身份组，可选地向获奖者发送私信） |
| Suggestions | 仅基础权限，如果你启用了讨论串，还需要 Create Public Threads |
| Starboard | 仅基础权限（读取反应、转发并更新它自己的消息） |
| Scheduled Messages | 仅基础权限（在预定的时间发布到目标频道） |
| Social Alerts | 仅基础权限（发布公告嵌入消息）。要提及某个身份组，请把该身份组设为可被提及，或授予 Mention @everyone, @here, and All Roles |
| Embed Builder | 仅基础权限（把编写好的嵌入消息发布到所选频道） |
| Birthdays | 公告只需要基础权限；如果你使用生日身份组，还需要 Manage Roles，并且机器人的身份组要在它之上。要提及某个身份组，请把该身份组设为可被提及，或授予 Mention @everyone, @here, and All Roles |
| Games | 仅基础权限（在使用命令的频道里发布游戏嵌入消息及其按钮） |
| Form Builder | 仅基础权限（在回答频道里发布提交摘要）。要提及某个身份组，请把该身份组设为可被提及，或授予 Mention @everyone, @here, and All Roles |
| Join Verification | Manage Roles（分配已验证身份组）；如果启用了自动踢出，还需要 Kick Members |
| Discord Reports | Create Public/Private Threads, Send Messages in Threads, Manage Threads |
| Discord Tickets | Manage Channels 或讨论串相关权限（工单频道）, Manage Threads |
| Leveling | Manage Roles（身份组奖励） |
| Auto Join Role | Manage Roles |
| Audio Recording / AudioToText | Connect, Speak（语音频道） |
| Rules Channel | Manage Messages（保持规则频道整洁） |
| Auto Responder / AI Response / Random Bot Interactions | 仅基础权限 |
| Voting | 仅基础权限 |
| 对外 Webhook | 无：它从不接触 Discord。这是一个面板功能：它所需要的是面板权限 将服务器从团队中移除，或者团队所有权 |
🪜 身份组层级很重要
Discord 只允许机器人对低于它自身最高身份组的成员和身份组进行操作：
- 机器人无法封禁、踢出、禁言或警告最高身份组高于机器人身份组的成员。
- 机器人无法分配在身份组列表中位于它自身身份组之上的奖励身份组。
如果某个审核操作或身份组奖励悄无声息地失败了，请在 Server Settings → Roles 中把 YAWBDB 的身份组往上拖。
✅ 快速检查清单
- 打开 Server Settings → Roles，选择 YAWBDB 的身份组。
- 为你启用的功能授予相应的权限（见上表）。
- 把该身份组移到机器人必须管理的任何身份组之上。
- 检查各频道的权限覆盖：频道级别的拒绝会压过身份组级别的允许。