用途：discord-server-ctrl 是一个 Discord 服务器管理技能，以命令行脚本 discord-admin.sh 的形式提供，覆盖服务器、频道、角色、成员、消息、自动化审核等管理操作，定位为面向真实服务器管理员的综合管理工具。
主要能力：
- 服务器信息与模板：查看服务器概览、vanity URL 设置与查询、模板列出/创建/使用，以及从模板创建新服务器。
- 频道管理：支持文本、语音、分类、论坛、舞台、公告等类型的创建，频道编辑（名称、主题、NSFW、限流等）、权限查看与覆盖设置、删除及批量清理。
- 角色管理：列出角色层级、创建带颜色与权限的角色、编辑名称/颜色/hoist/mentionable/权限增减、调整位置、删除，以及批量分配与移除角色。
- 成员管理：成员信息查询、昵称设置与重置、超时（禁言）、踢出、封禁（含临时封禁与删除消息天数）、解封、封禁列表、批量踢出/封禁、头像设置。
- AutoMod：规则列出、创建（关键词、预设、正则、阻止列表）、动作配置（警告、阻止消息、超时）、关键词增删清空、规则启用/禁用与删除。
- 消息管理：发送文本/嵌入/文件消息、编辑、删除、批量删除、按范围删除、按天数清理、搜索（全局与按用户）、置顶/取消置顶/置顶列表、历史记录获取。
- Webhook：列出、创建、查询、编辑、执行（支持自定义用户名/头像、TTS、嵌入）、删除。
- 表情与贴纸：表情列出、创建（URL 或 base64）、编辑、删除；贴纸列出、创建、编辑、删除。
- 声音板（Beta）：列出声音、播放声音（可设音量）、默认声音。
- 定时事件：列出、创建（VOICE/STAGE_INSTANCE/EXTERNAL 类型）、编辑状态、删除。
- 邀请：列出、创建（最大次数/有效期/临时/唯一）、查询、删除；vanity URL 管理。
- 审计日志：按数量、用户、动作类型筛选查询。
- 子区管理：列出、创建、编辑（归档/锁定/自动归档时长）、删除、加入/离开。
- 舞台频道：创建舞台实例、编辑主题/隐私级别/计划开始时间、关闭舞台。
- 集成管理：列出集成（机器人/应用）、同步、删除。
- 服务器设置：编辑名称、图标、启动图、语音区域、AFK 频道与超时、系统频道、通知级别、内容过滤、MFA 等级、验证等级；启用/禁用社区功能；转让服务器。
- 组件与小工具：Widget 获取与编辑；审核日志频道设置与配置；批量封禁/踢出/角色分配；频道权限同步、角色克隆；模板同步与删除。
使用方式： 需要先设置环境变量 DISCORD_BOT_TOKEN（机器人令牌），可选 DISCORD_GUILD_ID、DISCORD_DEFAULT_TIMEOUT、DISCORD_MAX_RETRIES、DISCORD_OUTPUT_FORMAT。脚本需赋予执行权限（chmod +x discord-admin.sh），通过 ./discord-admin.sh --help 查看全部命令。命令格式通常为 ./discord-admin.sh <子命令> <guildId> [参数]。权限方面可选择授予 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 反垃圾规则、维护审核日志频道、管理 Webhook 与模板、执行日常维护脚本等。资料中提供了完整服务器搭建与日常审核的脚本示例。
限制与注意事项： 使用需要有效的 Discord 机器人令牌及相应权限；部分功能受 Discord 平台自身限制（如 vanity URL 需满足 DISCOVERABLE 与 boosts 条件、批量删除消息有 14 天限制、声音板为 Beta）；令牌与权限需妥善保管。资料未提供具体的收费、价格、平台版本要求或效果承诺，这些信息暂未提供。