By name: kook platforms: - kook description: >- KOOK 服务器管理能力。当用户在 KOOK 中请求群管（踢人、封禁、解封、改昵称）、 角色管理（创建/删除/授予/撤销角色）、黑名单操作或查询成员列表时使用。 即使用户没有提到 KOOK，只要上下文是 KOOK 场景且涉及上述操作，就应触发。 仅有昵称时必须先 list_members 获取 user_id。 keywords: - kook - KOOK - adapter:kook - 群管理 - 角色 - 黑名单 - 封禁 - list_members tags: - group - management - im tools: - kook_grant_role - kook_revoke_role - kook_list_roles - kook_create_role - kook_delete_role - kook_blacklist - kook_kick_member - kook_ban_member - kook_unban_member - kook_set_nickname - kook_list_members
KOOK 服务器管理技能
KOOK 的管理模型类似 Discord，以角色为核心。此技能覆盖成员管理和角色系统。
核心原则
ID 获取链
操作成员需要 KOOK 用户 ID，操作角色需要角色 ID：
kook_list_members→ 获取用户 IDkook_list_roles→ 获取角色 ID
黑名单 ≠ 踢人
kook_blacklist 是永久性封禁，被拉黑的用户无法再加入服务器。kook_kick_member 只是移除，用户可以通过邀请重新加入。
工具详解
成员管理
| 工具 | 用途 | 说明 |
|---|---|---|
kook_kick_member |
踢出 | 可重新加入 |
kook_ban_member |
封禁 | 阻止重新加入 |
kook_unban_member |
解除封禁 | — |
kook_set_nickname |
改昵称 | 服务器内昵称 |
kook_list_members |
成员列表 | — |
kook_blacklist |
黑名单操作 | 不可逆，谨慎使用 |
角色管理
| 工具 | 用途 | 说明 |
|---|---|---|
kook_create_role |
创建角色 | — |
kook_delete_role |
删除角色 | — |
kook_grant_role |
授予角色 | 需 user_id + role_id |
kook_revoke_role |
撤销角色 | 需 user_id + role_id |
kook_list_roles |
角色列表 | 获取所有角色及 ID |
易错点
- 黑名单是永久封禁，与普通踢人（kick）不同。用户说「把他踢了」用 kick，说「永久拉黑」才用 blacklist。
- 角色操作需要 role_id，先
kook_list_roles查询。 - 创建角色后还需要 grant_role 才能给成员分配，创建 ≠ 分配。