By name: discord platforms: - discord description: >- Discord 服务器全功能管理。当用户在 Discord 中请求群管（踢人、封禁、解封、禁言、改昵称）、 角色管理（授予/移除/查看角色）、内容管理（线程创建、论坛帖子、Embed 富文本、表情反应）、 或查询成员/服务器信息时使用。即使用户没有提到 Discord，只要上下文是 Discord 场景 且涉及上述操作，就应触发。仅有用户名时必须先 list_members 获取 user ID。 keywords: - discord - adapter:discord - 群管理 - 踢人 - 禁言 - 封禁 - 角色 - 线程 - embed - 反应 - 论坛 - list_members tags: - group - management - im tools: - discord_add_role - discord_remove_role - discord_list_roles - discord_create_thread - discord_react - discord_send_embed - discord_forum_post - discord_kick_member - discord_ban_member - discord_unban_member - discord_mute_member - discord_set_nickname - discord_list_members - discord_get_group_info
Discord 服务器管理技能
Discord 的管理模型围绕「角色」和「权限」展开，与 QQ 的 admin/member 模型不同。
核心原则
ID 获取链
Discord 操作需要精确的 ID（用户 ID、角色 ID）。两步获取：
- 用户 ID：
discord_list_members→ 匹配昵称 - 角色 ID：
discord_list_roles→ 匹配角色名
Example:
用户: 给小明加个"管理员"角色
步骤1: discord_list_members → 找到小明的 user_id
步骤2: discord_list_roles → 找到"管理员"角色的 role_id
步骤3: discord_add_role(user_id, role_id)
角色优先思维
Discord 中几乎所有权限都由角色控制。用户说「给他管理员」不一定是设管理员，可能是授予某个有管理权限的角色。理解用户意图后选择正确的工具。
工具分类
成员管理
| 工具 | 用途 | 说明 |
|---|---|---|
discord_kick_member |
踢出成员 | 被踢后可通过邀请重新加入 |
discord_ban_member |
封禁 | 阻止重新加入 + 可选删除历史消息 |
discord_unban_member |
解除封禁 | — |
discord_mute_member |
禁言 | — |
discord_set_nickname |
改昵称 | 服务器内昵称，非全局 |
discord_list_members |
成员列表 | — |
discord_get_group_info |
服务器/频道信息 | — |
角色管理
| 工具 | 用途 | 说明 |
|---|---|---|
discord_add_role |
授予角色 | 需 role_id |
discord_remove_role |
移除角色 | 需 role_id |
discord_list_roles |
角色列表 | 获取所有角色及其 ID |
内容与互动
| 工具 | 用途 | 说明 |
|---|---|---|
discord_create_thread |
创建线程 | 从消息或频道创建讨论线程 |
discord_react |
表情反应 | 支持 Unicode emoji 和自定义 emoji |
discord_send_embed |
Embed 富文本 | title/description/color/fields 等字段 |
discord_forum_post |
论坛帖子 | 在论坛频道发布帖子 |
易错点
- Discord 昵称是服务器级别的，一个用户在不同服务器可以有不同昵称。
- 角色操作需要角色 ID，不能用角色名直接操作。先
list_roles查。 - Embed 消息不是普通文本，它有固定结构（title/description/color/fields），用于发送富文本格式的消息。
- Bot 只能操作低于自身角色的成员。如果目标用户的最高角色高于 Endpoint 的角色，操作会失败。