概述
discord-server-ctrl（脚本名 discord-admin.sh）是一个 Discord 服务器管理的命令行技能，覆盖从基础审核到高级配置的完整管理能力。所有操作通过设置机器人令牌后执行脚本完成。
使用方式
设置机器人令牌：
export DISCORD_BOT_TOKEN="your-bot-token"
赋予脚本执行权限：
chmod +x discord-admin.sh
查看全部命令：
./discord-admin.sh --help
可选环境变量包括 DISCORD_GUILD_ID（默认服务器）、DISCORD_DEFAULT_TIMEOUT（API 超时秒数）、DISCORD_MAX_RETRIES（限速重试次数）、DISCORD_OUTPUT_FORMAT（json、pretty、minimal）。
主要能力
- 服务器信息：服务器概览、vanity URL 查询与设置、模板相关操作。
- 频道管理：列出、创建（文本、语音、分类、论坛、舞台、公告等类型）、编辑、权限查看与覆盖、删除、清理不活跃频道。
- 角色管理：创建、编辑（颜色、层级显示、可提及、权限增删）、调整位置、删除、批量分配与移除、复制角色。
- 成员管理：信息查询、昵称设置与重置、超时（禁言）与解除、踢出、封禁（含临时封禁与消息删除天数）、解封、批量踢出与封禁、封禁列表、头像设置。
- AutoMod：规则列表、创建（关键词、预设、正则、屏蔽列表）、动作配置、关键词增删清空、启用/停用、删除。
- 消息管理：发送文本、嵌入消息、带附件消息、编辑、删除（单条、批量、按范围）、清理、搜索（按内容或用户）、置顶/取消置顶、置顶列表、历史记录。
- Webhook：列表、创建、查询、编辑、以自定义身份执行（支持 TTS 与嵌入）、删除。
- 表情与贴纸：列出、创建（URL 或 base64）、修改、删除；贴纸列出、创建、编辑、删除。
- 音板：列出音效、播放、默认音效（标注 Beta）。
- 定时事件：列表、创建（VOICE、STAGE_INSTANCE、EXTERNAL 类型）、编辑状态、删除。
- 邀请：列表、创建（最大使用次数、有效期、临时、唯一）、查询、删除；vanity URL 设置。
- 审计日志：按用户、按动作类型筛选查询，支持多种审计动作类型。
- 线程：列表、创建、编辑（归档、锁定、自动归档时长）、删除、加入/离开。
- 舞台频道：创建、编辑、关闭舞台实例。
- 集成管理：列出集成、同步、删除。
- 服务器设置：名称、图标、启动图、语音区域、AFK 频道与超时、系统频道、通知级别、内容过滤、MFA 等级、验证等级；启用/禁用社区功能；所有权转移。
- 组件：Widget 查询与编辑。
- 审核日志：设置、查询、禁用审核日志频道及配置记录项。
- 批量操作：大规模封禁、踢出、批量角色分配、频道权限同步、角色克隆。
- 模板：列出、创建、同步、删除、用模板创建服务器。
权限要求
可选用 Administrator 权限，或授予细粒度权限：MANAGE_CHANNELS、MANAGE_ROLES、KICK_MEMBERS、BAN_MEMBERS、MANAGE_MESSAGES、MANAGE_GUILD、VIEW_AUDIT_LOG、MANAGE_EMOJIS、MANAGE_WEBHOOKS、MANAGE_GUILD_EXPRESSIONS、MANAGE_EVENTS、MODERATE_MEMBERS。
限速处理
脚本自动处理 Discord 限速：消息发送为每频道 1 请求/秒，其他操作为 50 请求/10 秒，遇到 429 错误时进行指数退避，并检测全局限速。
适用场景
适合需要脚本化、批量或自动化管理 Discord 服务器的管理员，例如一次性搭建社区服务器（创建角色、频道、AutoMod、邀请与审核日志）、日常维护与批量审核操作。
限制
音板功能标注为 Beta。批量删除消息受 Discord 14 天限制。vanity URL 设置需服务器满足 DISCOVERABLE 与加成条件。部分功能（如社区启用、所有权转移、舞台频道）受 Discord 服务器状态与权限约束。除上述说明外，未提供更多关于收费或平台支持的信息。