私聊管理与群发
私聊机器人时先选定一个操作群作为上下文，再执行群级管理；周期清退的持续授权、未决核实、跨群群发和连接凭据也在这里完成。这些指令的启停与权限在应用设置 → 指令设置维护（见指令设置），聊天帮助的用法见聊天指令与帮助。
本页内容：
群聊与私聊同源，但不等于每条操作都支持双通道。 多数操作两个通道共用同一份目录和同一套校验；只支持群聊或只支持私聊的，会在帮助详情和状态标签里注明。私聊里未选群也能读说明，但群级写操作会先要求选群。
选好操作群只是记住目标，不等于授权。 选择会持久保留，执行时仍会核验你的成员身份、等级、目标保护和群级开关；不要因为已经选群就认为获得了持续清退或其他高风险操作的批准。
私聊选定操作群
| 想做什么 | 发送 | 说明 |
|---|---|---|
| 列出你所在的群 | 我的群、我的群 第2页 | 每页 20 条；只列候选群，不改变当前选择 |
| 指定操作群 | 按帮助当前显示的「设置私聊操作群」完整命令发送，群号写平台群号 | 群聊里可无参取当前群；私聊必须带群号 |
| 核对当前选择 | 查私聊操作群 | 无参数，只回当前选择 |
| 取消选择 | 清除私聊操作群 | 无参数；清除后群级操作要重新选群 |
| 查目标群编码 | 查群编码 | 群聊回当前群，私聊回已选群；不接受群号参数 |
- 群号要用平台群号：不要把列表序号或控制台内部编号当成平台群号。候选只来自你本人所在的群；同一群号在多个连接下存在时不会替你猜群。
- 群内也能设置：在群里发送同一指令可把该群记为你的私聊操作群，反馈回原群；私聊里设置则回私聊。
- 词形可能被改过：上表中的「设置私聊操作群」「查私聊操作群」「清除私聊操作群」「查群编码」都能在指令设置改触发词，改过后按
帮助 <操作名>当前显示的完整消息发送。我的群是私聊内建入口，不在指令目录里。 - 选群后按
帮助 <操作名>查到的用法操作；群内语法不能直接照搬到私聊，私聊里需要先有操作群上下文。
周期移除的持续授权
「移除授权」用于批准周期清退（人口控制、不活跃清退、跨群独占）的持续执行。默认关闭，要求等级 11；控制台里选「持续授权」只是配置意图，真正的批准在聊天里完成。
| 想做什么 | 发送 |
|---|---|
| 批准某个能力 | 移除授权 授权 <能力位> [群号…] |
| 查看当前授权 | 移除授权 状态 <能力位> |
| 撤销本人在该能力的授权 | 移除授权 停用 <能力位> |
- 能力位可写
population、inactive、exclusivity，也可写中文「人口控制」「不活跃清退」「跨群独占」；三项分别批准，不能互相代替。群号省略时使用当前会话已选的操作群。 - 上表按目录默认写法演示。「移除授权」的触发词可在指令设置改，改过后按
帮助 <操作名>当前显示的完整消息发送。 - 显式授权命令发送一条完整消息即完成批准，批准绑定当前策略版本、逐群规则和上限。发送前确认控制台里的自动化配置和范围确实是你想要的——保存配置不等于批准。
- 持续授权不是每轮再确认。扩大范围、提高上限或改变已批准内容后，要重新发送授权命令；可证明的缩小与停用立即生效。
- 「停用」只撤销本人在该能力下的授权，不影响其他操作者或其他能力。具体配置步骤、额度与未知结果见踢人设置。
未决核实
「未决核实」用于查询本账号被阻断的操作，并按已保存的平台终态证据核实结果。默认关闭，最低要求等级 6，仅私聊可用。
| 想做什么 | 发送 |
|---|---|
| 查询本账号结果不明、仍被阻断的操作与占用额度 | 未决核实 |
| 按短键核实某次操作 | 未决核实 核实 <短键> |
- 短键从「未决核实」列表或回执原样复制，不要自造；没有短键时不要拿额度编号代替。
- 上表按目录默认写法演示。「未决核实」的触发词可在指令设置改，改过后按
帮助 <操作名>当前显示的完整消息发送。 - 系统依据原操作已保存的证据结算，不能由你指定成功、退款或强行解锁；证据不足时仍保持阻断，也不释放旧额度。
- 成员现在仍在群里，不能证明原尝试从未派发。相关指令停用不影响已经消耗的额度。
文本群发
跨群发送纯文本。默认关闭，要先在应用设置 → 指令设置启用，并确认所需权限不低于 6；群聊和私聊共用同一条命令。
- 用法：
文本群发 <群号1>[,<群号2>…] <正文>。群号处也可填本地群 ID，多个用逗号或空格分隔（中英文逗号均可），重复目标自动去重。私聊里先选好操作群只作上下文锚点，实际目标仍以命令里写出的群为准。 - 上限：最多 5 个群、每群 1 条、单条不超过 1000 字；只发纯文本，消息里出现
[CQ:或@all会被拒绝（即不能带 CQ 码或 @全体）。 - 回执与停止：发送一条完整指令即提交，校验通过后按显式目标派发；回复会列出本次目标、逐群结果和停止短键。以逐群结果判断已派发、未派发或结果未知，不把“已受理”当作全部送达。文本群发不使用下节的图片任务查询命令；结果未知时保留回执、核对消息记录，不要直接重发。执行期间按回执中的完整停止消息操作，只停止尚未开始的群，已在途的消息不撤销。停止短键以本次回执为准，不要复用其他回执的短键。
- 额度：每个目标群和每位操作者滚动 1 小时内最多 10 次尝试。发出后不能靠停用撤回已送达消息。
- 词形、示例和回执细节以
帮助 文本群发当前显示为准。
群发图片
跨群发送图片。默认关闭，要先在应用设置 → 指令设置启用，并确认所需权限不低于 6；词形与示例以 帮助 群发图片 当前显示为准。
目标都是 1-5 个显式群、每群 1 条，群号可填本地群 ID 或协议群号，不接受群名，重复目标自动去重。有两种写法：
- 图片地址：
群发图片 <群1>,<群2> <图片地址>——图片直链（http/https）或平台可访问的绝对路径；服务端只做形状校验，不下载图片。 - 图文组合：把
群发图片 <群1>,<群2> <文字>和一张图片放在同一条消息里发出。先写指令和群号，再写文字，图片贴在消息里；文字与图片的先后顺序会保留，至多一张图，文字总量不超过 1000 字。图片由服务端读取并核验字节后按同一份字节发送；图文组合当前仅 OneBot 11 连接可用，其它连接会明确拒绝。
发送一条完整指令即完成内容与目标核对并受理派发。受理只表示任务已建立，不等于每个群都已派发或平台已成功送达；结果用 查询群发任务 <任务ID> [第N页] 查看逐群进度。任务结果保留 30 分钟，超期按过期回复；只有任务创建者能查。结果未知时不要自动重发，先按任务查询核实，避免重复发送。
连接凭据的读取风险
读取连接凭据会在原聊天通道返回明文。 不要在有无关成员的群里读取，不要分享聊天记录、截图或包含凭据的日志。启用 webhook 推送时，相关敏感事件仍可能以明文进入接收端；接收端及其日志也必须保护。
等级 11 的真实超级管理员可通过受支持的群聊或私聊指令读取、替换、清除连接凭据；完整用法以 帮助 连接管理 当前显示为准。
- 保存凭据不等于所有连接已重新装配；运行态应用随连接装配，不自动重装。
- 回信失败也不代表保存失败。应先核对当前状态，不要只凭有没有回信重复修改。
- AI 模型密钥和敏感请求头的聊天写入当前不开放，写入会被拒绝并零写入；请在 AI 管理 → 服务设置 的模型弹窗里配置。
没成功先检查什么
- 私聊指令不执行：先确认已经选好操作群，再用
查私聊操作群核对；群级写操作未选群时会被要求先选。 - 提示权限不足：这些指令另有不可下调的等级底线（持续授权 11，未决核实和群发不低于 6）。把控制台里的等级改低不能绕过底线，也不会改变你的真实成员身份。
- 群发已回执但没看到消息：文本群发查看本次逐群回执和消息记录；群发图片按回执里的任务 ID 查询逐群结果。区分受理、派发和平台成功，结果未知时不要直接重发。
- 停止后仍有群收到：停止只作用于尚未开始的群，已在途的消息不撤销。
- 授权已停用但仍有动作：核对是否还有其他操作者或其他能力的有效授权，以及控制台里的功能开关和调度状态。
- 拿不准词形时，发送帮助按当前显示的操作名查详情，见聊天指令与帮助。