NapCatQQ群管理：加群、禁言、公告4个高频场景的自动化操作指南

NapCatQQ群管理：加群、禁言、公告4个高频场景的自动化操作指南

【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ

NapCatQQ是基于NTQQ的OneBot框架，把QQ群管理动作变成了可调用的接口。本文覆盖加群申请、禁言、群公告、群文件4个高频场景，每个都给出具体调法和易踩的坑。

一、你实际要管什么

• 加群申请在凌晨11点进来，你总不可能守着手机点同意。
• 群里突然刷屏，你想让所有人闭嘴，但又不想挨个禁言。
• 上周发的群公告写错了一行字，现在想改，历史版本还能找回吗？
• 有人要群里的资料包，你总不好每次手动打包再私发一遍。

下面按场景逐个说怎么配。

二、按场景翻操作手册

1. 加群申请怎么自动同意或拒绝

申请事件带flag进来时，用它去调set_group_add_request。

• 参数approve设true自动同意
• 参数approve设false自动拒绝
• 参数reason填一句拒绝理由，别空着

注意：flag是事件里带的，别拿 QQ 号去凑，凑不出来接口直接报错。

2. 刷屏时单人禁言和全员禁言怎么切

• set_group_ban禁单人，参数duration写时长
• set_group_whole_ban开全员禁言，参数enable切开关
• 先全员禁言止血，处理完再逐个解禁

注意：duration单位是秒，禁1小时填3600，别填成60。另外只有群主能禁管理员，权限不够会直接失败。

3. 群公告发出去之后怎么查历史记录

要置顶、带图、需要确认阅读的公告，调_send_group_notice发布。

• 参数content填正文，image传图片路径
• 参数pinned控制是否置顶
• 历史公告统一调_get_group_notice拉取
• 返回列表带read_num阅读数和发布时间

注意：接口返回的是完整列表，不是单条，想改旧公告得重新发一条顶掉。

4. 群文件上传后怎么给成员发下载链接

• upload_group_file传参数folder归档到指定文件夹
• 上传后返回file_id，记下来
• get_group_file_url用file_id换临时下载链接

注意：链接是临时的，别把它写死在公告里，发之前现取一条。

5. 每周活动前怎么摸一遍活跃成员底数

发活动公告前想看看群里谁是活跃主力，调get_group_honor_info。

• 参数type不传默认全要
• 返回值里有龙王、活跃榜等分类列表
• 拿名单私聊提醒比群发打扰小

注意：荣誉数据有刷新延迟，刚发生的发言不一定算进去。

三、组合起来用，效率翻倍

触发：有群成员加群请求进来 动作：set_group_add_request自动同意，紧接_send_group_notice发一条欢迎公告 结果：新人进群就能看到群规，不用管理员手动打欢迎语

触发：群里刷屏超过阈值 动作：set_group_whole_ban开全员禁言，事后逐人set_group_ban解禁违规者 结果：场面先止血，违规者单独禁，其余人正常发言

触发：每周日晚 动作：get_group_honor_info拉活跃榜，私聊前几名并发_get_group_notice核对上周公告阅读数 结果：活动前摸到底数，阅读数低就补发一条

四、配置前先看这3条

1. 先确认Bot在群里的身份：Bot不是管理员时，禁言、踢人这些接口全部报权限错误，所有群管理动作都以群管理员权限为前提。
2. 禁言时长单位是秒：duration填错单位，可能禁了7分钟而不是1小时，脚本里别用魔法数字。
3. 先确认Bot确实在目标群里：不在群里的任何群操作都会失败，报错信息还不直观，排查起来浪费时间。

先跑通加群申请这一个场景，剩下的按第二章顺序过一遍即可。

【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ