群管家怎样工作
群管家不是另一个 QQ 客户端。它接收机器人实现端提供的消息和事件,依据你保存的配置作出处理,再通过实现端请求平台执行。页面能打开、配置能保存、机器人能收到消息、平台完成动作,是四件不同的事。
第一次使用先理解本页;查某个按钮可直接去功能入口地图,判断操作结果则看结果判断与排障。
先认识五个对象
text
机器人账号 ←→ OneBot 实现端 ←→ 连接配置 ←→ 群管家
│
管理已同步的群
│
群级开关、绑定方案和规则图中箭头表示通信与配置关系,不表示所有动作都只经过一条处理链。
| 对象 | 你可以怎样理解 | 不要混淆 |
|---|---|---|
| 机器人 | 平台账号在群管家里的档案 | 档案“启用”不代表账号已经在线 |
| OneBot 实现端 | 实际登录账号并与平台收发消息的软件,如 NapCat | 需要另行准备,不包含在群管家中 |
| 连接配置 | 双方怎样通信、谁监听谁连接、用什么地址和凭据 | 连接口令不是控制台登录密码 |
| 群 | 已同步到本地的管理对象,通过平台群号与实际群关联 | 页面内部编号、列表序号不等于 QQ 群号 |
| 方案与规则 | 方案收纳关键词规则,群选择需要使用的方案 | 新建规则、启用方案不代表所有群自动使用它 |
“默认QQ群设置”是本地配置模板,不是机器人加入的真实群。接入和同步步骤见连接机器人。
改一项设置会影响哪里
| 范围 | 典型内容 | 修改前先核对 |
|---|---|---|
| 应用级 | 指令目录覆盖、全局名单、发送限速、AI 全局额度 | 可能影响多个群,不只是当前顶部选中的群 |
| 共享方案 | 方案内的关键词规则、方案启停 | 哪些群引用了同一个方案 |
| 群级 | 本群开关、方案绑定、本群问答、名片和踢人策略 | 顶部目标群、平台群号及各卡片保存方式 |
| 单条配置 | 一条问答、定时任务或转发规则 | 该条属于哪个群或方案,是否还有别的来源会处理同一事件 |
| 新群默认模板 | 新加入群时采用的默认设置 | 不要当成已经接入的群,也不要假定修改后会追溯覆盖全部已有群 |
复制不是共享。 多个群引用同一个方案,修改其规则会影响引用群;复制成普通方案后,副本独立维护。官方维护云方案还可能自动接收规则更新。具体取舍见方案管理与云方案。
一个容易误改的例子
你想让 A 群不再处理某个词,但 A、B 两群共用同一方案。直接禁用方案内这条规则,可能同时改变 B 群的行为。先决定是让 A 群解绑整个方案,还是为 A 群建立独立副本;不要为了一个群改动所有群的共享规则。
相似需求应该选哪个功能
| 我真正想要的结果 | 优先了解 | 不是用来做什么 |
|---|---|---|
| 消息含某类内容时记录或管理 | 监控方案 | 不是知识问答库;“仅记录”不等于停掉其他功能 |
| 成员问固定问题时回复固定答案 | 问答 | 不是给任意动作编写自定义程序 |
| 有权限的人明确发起查询或管理 | 指令设置 | 不是成员只要说到关键词就都获得管理权 |
| 在指定时间发送内容或执行任务 | 定时任务 | 不是发消息失败后的自动补发保证 |
| 将源群的消息传到另一个群 | 消息转发 | 不是问答回复,也不是匿名化或隐私过滤工具 |
| 根据入群、退出等事件提示 | 群提示 | 不等于全局指令回复文案或 AI 提示词 |
| 对历史群消息归纳内容 | AI 功能 | 需要自己的模型服务、输入消息及相应数据授权 |
“按关键词触发”只是表面相似。这几项功能的权限、输入、优先级和输出不同,不能互相替代。
一条消息为什么没有触发所有功能
普通群消息不是让所有规则同时抢答。有效指令、内容审核、问答、转发和其他自动化之间存在先后关系:前序阶段已经接受处理时,后续消息业务阶段可能不再继续。图片识别、语音转写等派生内容主要用于审核,不会把图片里的一段文字变成管理指令。
- 指令匹配还要满足自己的规则:启停、匹配方式、权限、群级限制、冷却与参数等都会影响是否接受处理。
- 审核有不同来源:刷屏、媒体识别、关键词等有自己的前提和开关。不是关键词规则优先级最高,就能排到有效指令之前。
- 同一条规则链中不会执行每条命中规则:具体取胜顺序见监控方案高级用法。
- 不是所有事件都走普通消息链:成员加入、名片变化、文件上传、投票结算和定时清退等还有各自的处理入口。不要由“一条消息只有一个主要响应”推断整个系统绝不会产生其他独立动作。
正例:为了排查一条问答没有回复,除了检查问题是否匹配,也应检查消息是否已被指令或审核阶段接受。反例:仅提高问答的排序,不能让它绕过前面的权限或审核规则。
开关、权限和授权不是同一回事
| 条件 | 决定什么 |
|---|---|
| 配置保存 | 应用记下了你的设置;有些项还要等待周期或重启 |
| 功能与规则开关 | 这类处理是否参与;开关的范围以对应功能页为准 |
| 聊天指令权限 | 当前发起者能否使用这条指令 |
| 机器人平台权限 | 平台是否允许机器人在该群执行相应动作 |
| 目标保护 | 即使规则命中,也可能不允许处罚受保护成员 |
| 持续授权、确认与执行额度 | 特定高影响能力是否允许本次或持续执行 |
能打开控制台不等于有等级 11 聊天身份;机器人是管理员也不等于已经批准周期清退。详见权限管理和踢人禁言。
没有一个随处适用的“停止全部处罚”开关。 群聊监控开关、不活跃治理总开关、单条指令、定时扫描和模型任务分别控制不同来源。停止哪一种行为,就按该来源关闭并保存回读;已经派发的动作不会因关闭开关自动撤回。
改配置前后的最小核对
- 先选对象:当前群号、方案和规则是不是你要改的对象?
- 看影响面:只影响本群,还是共享方案或应用全局?
- 记原值:停用与删除不同;“恢复默认”也不是恢复你此前的值。
- 理解生效方式:即时提交、保存、应用、周期或重启,以对应设置为准。
- 分开确认:先刷新回读配置,再按结果判断核对业务结果。
刚入门可先做仅观察关键词、不处罚。查具体设置时使用配置与格式参考索引,不用通读全部功能页。