NapCatQQ 群组管理6 个场景接管群务【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ加群请求不断涌来、广告消息要撤回、每周公告要手动发人肉操作容易掉链子。NapCatQQ 群组管理把这些重复动作交给 Bot 层完成接口在协议侧秒级执行。下面按群管场景拆开讲每个动作对应哪个 action、入口在哪里。 自动处理加群请求与禁言新成员多的群最先值得记住的是set_group_add_request传入 flag、是否同意和拒绝理由一次调用处理一条请求count 参数默认 100可以批量拉取待处理项配合简单规则就能成批同意或拒绝把 NapCatQQ 自动审核入群变成固定流程。注意 flag 有有效期建议在收到加群请求事件后立刻处理。接口同时覆盖加群申请与群邀请两种入口都走同一个 flag。请求体长这样{ action: set_group_add_request, flag: 9007199254740991, approve: true }权限管理是同一批接口set_group_admin设置或取消群管理员set_group_ban按时长禁言单个成员set_group_whole_ban全员禁言set_group_kick移出群set_group_card修改成员名片set_group_name修改群名称这些 action 在 packages/napcat-onebot/action/group/ 下每个 action 一个源文件内含参数 schema 与示例排查参数时直接翻文件即可。 一键撤回消息、设精华与标记已读内容治理里使用频率最高的三个动作delete_msg按 message_id 撤回或删除群消息set_essence_msg与del_essence_msg设置、取消群精华mark_msg_as_read标记群消息已读参数只需 group_id 与 message_id它们和收群消息事件组合后你可以先匹配消息内容再调用对应接口内容治理就从人肉巡逻变成事件驱动。另外Bot 需要具备相应的群管理权限否则撤回、禁言类调用会直接失败。 上传群文件并生成下载链接NapCatQQ 群文件管理覆盖从上传到分发的完整链路upload_group_file把本地文件传到群文件空间create_group_file_folder建文件夹归类get_group_root_files与get_group_files_by_folder查根目录和子文件夹内容get_group_file_system_info查看群文件空间配额get_group_file_url返回某个文件的下载链接可直接转发给成员最后一条最值得用配合定时器你可以按时推送资料成员不用再来找链接要地址。实现见 packages/napcat-onebot/action/file/GetGroupFileUrl.ts返回结构里只有url一个字段很好取。WebUI 也内置了文件管理页适合不用写代码时的可视化操作。 定时推送群公告与查询历史公告公告管理是三个接口的组合send_group_notice发新公告get_group_notice查当前群公告del_group_notice删除公告。覆盖前建议先 get 一次现有内容避免误删别人维护中的公告。公告接口常和定时器搭配周一推周报、活动前推通知都是几行规则就能落地的场景。 拉取荣誉榜与活跃成员get_group_honor_info一次返回六类荣誉数据current_talkative 当前龙王与 talkative_list 龙王列表、performer_list 群聊之火与 legend_list 群聊炽热、emotion_list 快乐源泉、strong_newbie_list 冒尖小春笋。只传 group_id 即取全量榜单也可以按 type 指定拉某一类。再配合get_group_member_list拉成员列表、get_group_info拉群基础信息你做一份简单的群活跃统计就够用了数据拿到手周末把荣誉变化直接发回群里成员感知度会好很多。⚙️ 关键词过滤与定时公告推送自动化的关键是把事件和接口接起来。NapCatQQ 会把 OneBot 事件receive_group_msg、加群请求等推送到你的 HTTP/WS 客户端你要做的只有三件事收到 receive_group_msg 事件后匹配关键词命中就调用set_group_ban或delete_msg用定时器按周期调用send_group_notice推公告网络配置HTTP server、WebSocket在 WebUI 的 Config 页完成写规则前建议先打开 WebUI 的 Debug 页直接发一个 action 验证参数和权限省掉反复重启的时间。上手建议先在 WebUI 的 DebugAPI 测试页熟悉各 action 的参数再动手写自动化能省不少调试成本从只读和低危动作开始查成员、发公告确认无误后再启用禁言与踢人加群请求的 flag 有有效期自动审核要在收到事件后立即批量处理排查单个 action 时直接看对应源码文件一个 action 一个文件参数 schema 和示例都写在里面需要更复杂的规则多关键词策略、定时任务、跨群联动时从 WebUI 的插件机制找扩展入口【免费下载链接】NapCatQQModern protocol-side framework based on NTQQ项目地址: https://gitcode.com/gh_mirrors/na/NapCatQQ创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
