04 · 控制台页面详解(下)
适用版本:ZL-综合插件 2.2.0(2026-10-11 校准) 覆盖页面:🏘️分群配置(10个子页)、💬问答管理、🧠知识库、⏰定时任务、📜黑白名单、🚫违禁词汇、🧩AI 中心、🤖AI 审核(内容安全)、🤝官方协作 🧭 2.1.2 侧边栏包含「官方协作」页,可直接管理官机登录状态、官方群绑定和成员身份映射。
🏘️ 分群配置
按群独立配置:顶部切换目标群(或"全部群"),下方10个子Tab分别管理不同功能。
💡 多机器人用户注意:群列表按归属过滤——切到哪个QQ的视角,就只显示该账号认领的群;归属其他号的群不在这个列表里(详见 08-多机器人认领操作流程.md)。
Tab 1️⃣ 基础配置
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 群开关 | 开 | 本群启停(关=关机,授权仍保留) |
| 本群管理员QQ | 空 | 本群管理指令的授权名单 |
| 聊天女仆角色 | 萝莉 | 可选:萝莉 御姐 管家 |
| 聊天女仆前缀 | # | 唤醒女仆的消息前缀 |
| 允许AI控制指令 | 开 | 管家模式下允许AI用大白话执行插件指令 |
| 警告踢人次数 | - | 累计警告达到次数自动踢出 |
| 自动撤回机器人消息 | 关 | 机器人消息N秒后自动撤回 |
| 自动撤回时间 | 60秒 | 配合上一项 |
| 自动群发消息 | 关 | 定期向本群群发内容(循环消息) |
| 循环间隔 | 10分钟 | 配合上一项 |
| 循环内容 | 空 | 配合上一项 |
| 自定义菜单 | 空 | 本群专属菜单(留空用全局默认菜单) |
| 违禁词检测 | 跟随全局 | 本群违禁词开关 |
| 违禁警告文本 | 内置 | 触发违禁词时的警告文案 |
| 撤回相关 | 见下 | 防撤回提示 + 主动撤回的细分开关 |
撤回相关细分开关(两个独立模块,别搞混):
🔍 防撤回提示(监控撤回):群友撤回消息时机器人播报"谁撤回了什么"
可监控类型:普通群消息 图片 视频 语音 卡片 XML 链接 红包 签到
📷 图片撤回自动还原(1.8.5新增):图片被撤回后自动下载原图重发,链接失效时明确提示
文件消息跟随「链接」开关、合并转发跟随「卡片」开关
🛑 主动撤回(撤回消息):群友发送指定类型消息时机器人自动撤回该消息
可撤回类型:红包 图片 视频 语音 链接 卡片 XML / 签到
主人和插件管理员不会被主动撤回
Tab 2️⃣ 入群审核
自动处理加群申请:
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 处理方式 | 不处理 | 可选:自动同意 自动拒绝 不处理 |
| 默认拒绝理由 | "本群禁止加群" | 自动拒绝时的理由 |
| 昵称关键词拦截 | 关 | 申请者昵称含关键词→拒绝(附自定义理由) |
| 签名关键词拦截 | 关 | 个性签名含关键词→拒绝(⚠️ 等待官方 SDK,暂不可用) |
| 最低QQ等级 | 0 | 等级低于设定值→拒绝(✅ 2.1.4 起可用:查询失败自动放行;需群加群方式设为"需要验证信息"才触发) |
| 最低达人天数 | 0 | 达人天数低于设定值→拒绝(⚠️ 等待官方 SDK,暂不可用) |
| 新人进群禁言 | 0分钟 | 通过审核后先禁言N分钟(0=不禁) |
⚠️ 注意:如果开了入群验证码,不要同时开新人禁言,否则新人被禁言无法打字输验证码!
Tab 3️⃣ 入群验证
新人进群答题验证,防广告小号:
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 验证码开关 | 关 | 总开关 |
| 验证类型 | 随机数字 | 随机数字 中文 英文 算术题 固定验证码 |
| 验证码长度 | 5位 | 2~10位 |
| 有效时间 | 120秒 | 超时未验证→按下方处罚类型处理 |
| 固定验证码 | 空 | 类型选"固定"时使用 |
| 失败次数上限 | 3次 | 1~99次,验证失败达到上限→执行处罚(1.8.5新增) |
| 失败处罚类型 | 踢出 | 踢出 禁言 仅警告(1.8.5新增) |
| 处罚禁言时长 | 60分钟 | 处罚选"禁言"时生效,1~43200分钟(1.8.5新增) |
| 超时处罚类型 | 踢出 | 超时未验证的处罚:踢出 禁言 仅警告 |
| 发送文本 | 内置模板 | 验证题下发内容,支持 [AT] [验证码] [验证码时间] 变量,可配图 |
| 成功文本 | "通过验证,欢迎入群!" | 验证通过的回复,可配图 |
| 错误文本 | "验证码错误,请重新输入" | 输错时回复,支持 [失败次数] [剩余次数] [最大次数] [验证码] [AT] [验证码时间] 变量,可配图 |
| 超时文本 | 内置 | 超时处罚前的提示,可配图 |
| 提示文本 | 内置 | 提示重新获取验证码,可配图 |
💡 验证失败时会自动提醒剩余机会,如"⚠️ 验证失败 1/3 次,还剩 2 次机会";可配置是否重发验证码。 ⚠️ 注意:「验证码成功回复」和「新人进群提示」内容可能重叠,建议二选一,避免新人看到两段欢迎语。
Tab 4️⃣ 入群名片
新人进群自动改名片 + 名片合规检查:
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 自动名片 | 关 | 新人进群自动设置群名片 |
| 男生名片模板 | ♂ | 按QQ资料性别匹配 |
| 女生名片模板 | ♀ | 同上 |
| 默认名片模板 | 空 | 性别未知时使用 |
| 名片检查 | 关 | 定期检查群名片合规 |
| 违规词 | 空 | 名片含这些词视为违规 |
| 处理方式 | 提醒 | 提醒 / 自动重置 |
| 提醒文本 | 内置 | 违规提醒内容 |
| 固定名片 | 关 | 强制全员统一名片格式 |
Tab 5️⃣ 群聊提示
群事件自动播报(每项独立开关 + 自定义模板 + 可配图):
| 事件 | 说明 |
|---|---|
| 👋 新人进群提示 | 有人进群时(开了验证码则等验证通过才发) |
| 🚪 退群提示 | 有人退群 |
| 👟 被踢提示 | 有人被踢 |
| 🔇 禁言提示 | 有人被禁言 |
| 🔊 解禁提示 | 有人被解除禁言 |
| ⬆️ 升级管理提示 | 有人成为管理员 |
| ⬇️ 取消管理提示 | 有人被撤管理 |
| 💌 进群私聊提示 | 新人进群私聊欢迎(群临时会话,无需加好友) |
可用变量(模板里写,发的时候自动替换):
Tab 6️⃣ 刷屏检测
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 刷屏检测 | 关 | 总开关 |
| 检测窗口 | 60秒 | 在此时间内统计条数 |
| 最大条数 | 10条 | 超过即判定刷屏 |
| 处罚方式 | 警告 | 警告 禁言 踢出群 |
| 禁言时长 | 10分钟 | 处罚选禁言时生效 |
| 复合限制 | 内置 | 单条最大行数/中文数/数字数/字母数(防长篇字符刷屏) |
💡 处罚只会执行一次:已禁言的用户再刷屏只撤回消息,不重复警告。
Tab 7️⃣ 功能开关
本群功能级别的精细开关:
| 开关 | 默认 | 控制内容 |
|---|---|---|
| 图片菜单 | 开 | 各类动漫/游戏图片接口 |
| 视频菜单 | 开 | 视频类接口 |
| 便民查询 | 开 | 热搜/天气/解梦等查询 |
| 文案语录 | 开 | 打工人语录/彩虹屁等 |
| 在线听歌 | 开 | 点歌功能 |
| 看图猜词 | 关 | 游戏功能(建设中) |
| 猜数游戏 | 关 | 游戏功能(建设中) |
| 成语接龙 | 关 | 游戏功能(建设中) |
| 邀请统计 | 关 | 记录邀请关系(推荐开启) |
| 发言统计 | 开 | 记录发言数据 |
| 昵称变动播报 | 关 | 成员修改群名片/昵称后群里播报原昵称 → 新昵称(每10分钟轮询检测,每群独立,2.0.4新增) |
| 单个API开关 | 全开 | 每个便民API可单独关闭(防止接口被刷) |
💡 昵称变动播报也可用群内指令控制:
开启昵称提醒关闭昵称提醒昵称提醒状态(私聊控制其他群用「开启昵称提醒 群号」)。
Tab 8️⃣ 邀请统计
| 内容 | 说明 |
|---|---|
| 邀请记录列表 | 谁(头像+昵称)邀请了谁、时间 |
| 邀请排行 | 按邀请人数排名 |
| 时间维度 | 今日 近7天 本月 / 本年 |
| 趋势图 | 真实数据折线图 |
💡 群内指令:
邀请排行、我的邀请、查邀请@某人、清空邀请统计(管理)。
Tab 9️⃣ 发言统计
| 内容 | 说明 |
|---|---|
| 发言记录 | 成员(头像+昵称)的消息数、指令数、问答命中数 |
| 发言排行 | 今日 本周 本月 / 本年 |
| 趋势图 | 活跃人数/消息量走势 |
💡 群内指令:
发言排行、今日发言排行、我的发言、清空发言统计(管理)。
Tab 🔟 每日签到
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 签到开关 | 关 | 开启后群友可签到 |
| 奖励区间 | 10 ~ 100金币 | 每次签到随机获得 |
| 连签阶梯 | 3天×1.2 7天×1.5 15天×2.0 / 30天×3.0 | 连续签到达标后奖励乘以倍率,断签清零 |
| 阶梯自定义 | 支持 | 可增删档位、恢复默认 |
| 签到明细 | - | 本群成员签到情况 |
| 排行榜 | - | 金币榜 + 连签榜 |
💡 群内指令:
签到、我的签到、签到排行、连签排行、重置签到@某人(管理)。
💬 问答管理
关键词自动回复系统(群里问→机器人答)。
配置说明
| 配置项 | 说明 | |||
|---|---|---|---|---|
| 问题(关键词) | 触发词,**多关键词用 ` | 分隔**,如:你好 | hi | 哈喽` |
| 答案 | 回复内容,**多条答案用 ` | ` 分隔 → 随机回复一条** | ||
| 匹配模式 | 精确 模糊(默认) 正则 | |||
| 生效范围 | 当前群 / 全部群(全局问答) | |||
| 导入/导出 | 批量备份、分享词库 |
匹配模式区别
| 模式 | 触发条件 | 例子 |
|---|---|---|
| 精确 | 消息完全等于某关键词 | 关键词你好 → 只有发"你好"才触发 |
| 模糊 | 消息包含某关键词 | 关键词你好 → "大家好啊"也触发 |
| 正则 | 关键词按正则表达式匹配 | 关键词[0-9]{5} → 任意5位数字触发 |
回复内容支持
✅ 纯文本
✅ CQ码(图片
[CQ:image,file=...]等)✅ 变量替换(
[AT]、[昵称]、[QQ]、[群名]、[日期]、[时间]等)✅ 多答案随机
💡 群内指令:
模糊问xx答xx(简化写法)、问答列表、删除问答+问题(含全局版本添加全局问答+问题|答案)。
🧠 知识库(2.1.1 新增)
侧边栏「知识库」页(问答管理之后):机器人的"百科脑子",收录功能用法、群规、指令说明等知识词条。🤖 AI 回答功能用法 群规 指令类问题前,会强制检索知识库再作答,回答更准、更贴合本插件。
页面布局
| 区块 | 说明 |
|---|---|
| 📊 顶部统计卡 | 总词条 启用 累计命中 三个真实统计 |
| 🔍 搜索 + 范围筛选 | 支持搜索过滤,可按范围(全局/本群)筛选词条 |
| 🗂️ 词条卡片 | 卡片式管理:答案预览 + 关键词标签 + 范围/状态/命中徽标 |
| 🛠️ 词条操作 | 每张卡片提供 新增 编辑 启停 / 删除 按钮 |
词条字段含义
| 字段 | 说明 |
|---|---|
| ❓ 问题 | 词条的问题描述,配合关键词用于匹配提问 |
| 💡 答案 | 命中后回复 / AI 引用的内容,卡片上可直接预览 |
| 🏷️ 关键词 | 检索匹配用的标签,多个关键词更容易命中 |
| 🌍 范围 | 全局(所有群生效)/ 本群(仅当前群生效) |
| 🔌 启停 | 一键启用/停用,停用后不参与检索 |
| 🎯 命中 | 累计命中次数统计,以徽标形式展示 |
内置知识包
插件首次启动自动种入 42 条内置功能知识(功能用法、常用指令一应俱全)
内置词条可在控制台正常编辑 / 停用,插件升级不会被覆盖——改完就是你的
命中统计与自动刷新
每条词条都有累计命中次数统计,哪条知识最常被问一目了然
页面每 30 秒自动刷新,列表与统计保持最新
💡 知识库服务于 AI 检索回答;「问答管理」是关键词触发自动回复,两者按需搭配使用。
⏰ 定时任务
让机器人在指定时间自动做事。页面顶部三张统计卡——已启用任务 今日已执行 累计执行——全部是真实统计,每秒自动刷新。
任务编辑器(动态表单)
| 配置项 | 说明 |
|---|---|
| 执行时间 | 时间选择器点选时分(不用手填) |
| 执行周期 | 📅 每天 💼 工作日 🗓️ 每周一 ~ 每周日 / 📆 每月N日(当月没有的日子自动跳过,如2月30日) |
| 任务类型 | 💬 发送群消息(支持变量和@全体成员)/ 🤖 AI群聊总结(到点自动总结当日群聊生成群聊日报)/ 🔇 群禁言 / 🔊 群解除禁言 |
| 目标范围 | 当前群 / 全部群(广播到所有启用群) |
| 发送内容 | 仅「发送群消息」需要填写;选禁言类或 AI 总结时内容框自动隐藏,改为显示操作说明提示 |
| 官机卡片 | 底部按钮排里的按钮(与「插入变量」同一行):给这条任务单独写一份官机专属 Markdown(左编辑右实时预览,变量与验证码/问答卡片一致)。填了则官机发卡片,纯文本可留空(普通号无文本就跳过不发);两边都填时官机发卡片、普通号发纯文本,互不覆盖;都为空才会拦截。已配置的任务在列表「发送内容」列显示「官机卡片」标记;切到禁言/群周报等免内容任务时该按钮自动隐藏 |
💡 任务类型是动态表单:「群禁言 群解除禁言 AI群聊总结」无需填写内容(列表中内容列显示"—(自动执行,无需内容)")。旧版独立类型(群提醒/签到通知/群欢迎/福利通知)已合并进「发送群消息」——执行效果完全相同,升级后旧任务自动归并为「发送群消息」,无需手动调整。
任务列表
| 列/功能 | 说明 |
|---|---|
| ID | 显示数字序号 |
| 目标范围 | 显示目标群名(或"全部群") |
| 上次执行 | 显示最近执行日期;没执行过显示"从未执行" |
| 启用 | 行内开关,点击立即生效并自动保存 |
| 操作 | 编辑 执行 删除(每行按钮) |
| 筛选栏 | 默认只显示当前分群的任务 + 全部群广播任务;下拉切到「全部任务」可查看所有群的任务;另支持按类型/状态筛选和内容搜索 |
自动保存
添加/修改、删除、启用开关切换都会立即自动保存,无需点「保存全部」(按钮仍在,可手动整体保存一次)。删除支持勾选多条后点「删除选中」,也可直接点每行「删除」。
立即执行
编辑器「立即执行」按钮:执行当前正在编辑的已保存任务(新增未保存的任务会提示先保存)
每行「执行」按钮:无视时间立刻跑一次
执行结果实时提示:成功显示"已立即执行,发送到 N 个群";失败会提示具体原因(如"群 xxx 未授权或未启用")
可靠性
🛡️ 错过补跑:电脑睡眠错过定时,30分钟内自动补发
📊 执行记录(上次执行日期)随任务一起保存,不会丢失
📜 任务被跳过时会在运行日志中记录原因:群未授权/未启用、群不在分群配置中、发送内容为空
变量支持
任务内容里可使用:[群号] [群名] [日期] [时间] [AT] 等(编辑器下方变量按钮可一键插入)。
💡 群内指令:
添加定时 HH:mm|内容、定时列表、删除定时+编号。
📜 黑白名单
白名单
白名单成员:跳过违禁词检测(管理号/机器人测试号适用)
黑名单
黑名单成员:无法触发插件的任何指令
命中黑名单的处理动作(可配):警告(默认)/ 禁言(默认30分钟)
拒绝加群:黑名单成员申请入群自动拒绝(理由可自定义"禁止黑名单加群")
自动拉黑策略
| 策略 | 说明 |
|---|---|
| 退群拉黑 | 成员主动退群→自动拉黑(可关) |
| 踢出拉黑 | 被踢出群→自动拉黑(可关) |
💡 群内指令:
添加白名单+QQ、删除黑名单+QQ、名单列表、开启退群拉黑等(插件管理员以上)。
🚫 违禁词汇
群聊内容过滤,触发后按策略处罚。
词库管理
| 范围 | 指令 |
|---|---|
| 本群 | 添加禁言词+词 删除禁言词+词 禁言词列表 |
| 全局 | 添加全局禁言词+词 删除全局禁言词+词 全局禁言词列表 |
支持正则表达式词库
支持批量导入
旧名「违禁词」与「禁言词」互相兼容
处罚策略(可组合)
| 策略 | 说明 |
|---|---|
| ↩️ 撤回 | 撤回触发消息 |
| ⚠️ 警告 | 发送警告文本 |
| 🔇 禁言 | 禁言指定分钟(默认60) |
策略一键配置(群内指令):
💡 白名单成员豁免;主人和插件管理员是否豁免以实际配置为准。
🧩 AI 中心
侧边栏「AI 中心」页:AI 服务、Agent、技能与查询工具的统一管理入口(AI 聊天 额度 Agent 详细用法见 05-AI功能详解.md)。2.1.1 更新重点如下:
🛒 技能市场(我的技能)
| 能力 | 说明 |
|---|---|
| 📥 在线安装 | 「我的技能」新增技能市场,在线浏览并一键安装技能 |
| 📦 导入 .skill 包 | 支持本地导入 .skill 技能包安装 |
| 📤 导出分享 | 把自己的技能导出为 .skill 包分享给他人 |
⌨️ 技能怎么触发
群里直发「技能名 + 内容」,分隔符支持 空格
#:/:,如:文言文翻译 学而时习之,不亦说乎技能名支持缩写:如「互译晚上好」等同「中英互译 晚上好」
记不住格式?直接 @机器人说大白话(如「帮我翻译一下晚上好」),会自动匹配合适的技能执行
🧰 内置查询工具(网格卡片)
「内置查询工具」列表改为网格卡片排版,一行多个工具卡片,每张卡片带风险等级徽标:
| 徽标 | 颜色 | 含义 |
|---|---|---|
| read | 🟢 绿 | 只读查询 |
| write | 🟠 橙 | 写入/修改类操作 |
| danger | 🔴 红 | 危险操作(如禁言/踢人) |
| perm | 🟣 紫 | 需特定权限执行 |
🤖 AI 审核(监控撤回的兜底精判层)
独立设置页(侧边栏「内容安全」):与「分群配置 → 撤回相关(防撤回提示 / 主动撤回)」同属撤回管理体系。2.0.18 起采用低误伤优先的完整审核链路:
结构化提取:识别完整链接、裸域名、连续数字串、字母数字混合串、名片卡片、导流特征词、图片和消息结构;候选命中只代表需要送审,不代表违规
AI 首次精判:返回 Pass(正常)/ Review(疑似)/ Block(确定违规),同时返回风险类型、严重度、置信度和判定依据
疑似延迟复核:Review 立即放行,默认等待 12 秒获取后续聊天语境,再进行一次反证式复核
处罚前二次确认:首次 Block 默认必须再次确认;两次均达到严重度和置信度阈值才允许执行策略
策略执行:撤回、@警告、可选禁言;AI 超时、空回复、格式异常、额度不足或两次结论冲突均自动放行
审核模型
| 配置项 | 说明 |
|---|---|
| 审核专用模型 | 留空用「AI 服务」主模型;建议填便宜快速的多模态模型(如 glm-4v-flash),看图审核需渠道支持传图 |
| 测试连接 | 真实发一次 AI 精判验证通道可用 |
| 自动处置阈值 | 默认 88%;低于阈值即使模型返回违规,也只按 Review 处理,不直接处罚 |
| 处罚前二次确认 | 默认开;首次 Block 必须通过反证式复核,能明显降低单次模型漂移造成的误撤回 |
| 疑似内容延迟复核 | 默认开;Review 不处罚,等待后续语境再复核一次 |
| 复核等待时间 | 默认 12 秒,可设置 5~60 秒;需控制在 QQ 消息可撤回时限内 |
送审范围
| 配置项 | 默认 | 说明 |
|---|---|---|
| 启用 AI 审核 | 关 | 总开关,开启后只审授权群的内容 |
| 链接 / 裸域名 | 开 | 网址与 baidu.com 这类无协议头域名也算 |
| 连续数字串 | 开 | ≥6 位(可能是群号 QQ号 导流号;价格、日期等日常数字不触发) |
| 字母 / 混合串 | 开 | 短链口令、导流码、暗语(纯英文单词 ≥10 位才触发) |
| 名片卡片 | 开 | 好友名片 / 群名片推荐消息 |
| 导流特征词 | 开 | 微信 VX 代刷等,仅作触发判定,是否违规由 AI 定夺 |
| 图片 | 开 | AI 直接看图(每条最多几张见下方) |
| 全量语义审核 | 关 | 开启后所有有效消息都送 AI(纯标点、纯表情和常见无害短回复除外);只扩大送审范围,不会降低处罚门槛,Review 永不直接处罚 |
| 豁免主人 插件管理员 群主 | 开 | 三类身份不送审 |
违规处置
| 配置项 | 默认 | 说明 |
|---|---|---|
| ↩️ 撤回违规消息 | 开 | 需机器人有群管理员权限(撤回后无法恢复) |
| ⚠️ @违规者警告 | 开 | 命中后 @ 并警告 |
| 🔇 自动禁言 | 关 | 开启后按设定时长禁言(默认 60 分钟) |
额度、频控与审计日志
每日送审上限(默认 2000 条):达到上限自动暂停并私聊通知主人,次日 0 点恢复
每群每分钟上限(默认 10 条):防止刷屏烧 token,超限的当条消息直接放行(严格模式全量审核不受此限)
单条最多看图(默认 3 张):防刷图烧额度
最近处置记录:只展示最近 10 条真正执行过策略的记录
AI 执行日志:展示最新 60 条结构化步骤,包含时间、群号、QQ、消息 ID、执行阶段、触发原因、AI 结论、类型、严重度、置信度、依据和最终动作;同一消息 ID 可串起完整链路
日志保留范围:内存最多保留最近 300 条,插件重启后清空,避免长期运行无限增长
哪些情况一定不会直接处罚
AI 返回 Review 疑似 上下文不足
置信度低于自动处置阈值,或严重度低于中度
风险类型为空或为「无」
处罚前第二次审核未再次确认 Block
AI 超时、请求失败、JSON 格式异常、额度不足
纯标点、纯 Emoji,以及「问号」「好的」「收到」等明确无害的短回复
群管指令(管理员可用)
三种送审方式:指令直接带文字(如
检测xxx)、回复某条消息发「检测」、消息里直接带图(检测【图片】= 只测图片)仅主人/插件管理员/群主/群管理员可用,普通成员不响应(消息照常走自动审核)
修改配置后点「保存配置」立即生效
🤝 官方协作(2.1.2)
「官方协作」页用于管理 UniQQ 已登录的 QQ 官方机器人。2.1.2 的职责分工是:
官方机器人负责菜单、问答、AI、提示等可见回复;普通机器人负责禁言、踢人、撤回、管理员、群名片等实际动作,并在后台保持静默。
| 区块 | 说明 |
|---|---|
| 原生官机状态 | 显示框架当前识别到的官方机器人、在线状态和账号信息;登录官机后点「刷新状态」 |
| 协作开关 | 开启后,已绑定群优先由官机回复;关闭后全部恢复普通机器人原流程 |
| 官方机器人白名单 | 只填写已确认的官机 QQ 号;2.1.3 起不再根据消息内容自动学习身份,框架官方虚拟机器人 ID 会自动保护 |
| 群组绑定 | 绑定「官方虚拟群 ID / openid ↔ 真实 QQ 群号」;授权、分群配置和群管执行均以真实群号为准 |
| 成员映射 | 绑定「官方成员虚拟 ID ↔ 真实 QQ」;用于禁言、踢人、改名片和设管理员等操作 |
| Markdown | 官机主菜单和内置子菜单默认发送 Markdown 卡片;问答、提示、菜单也可分别编辑官机卡片 |
| 运行统计 | 查看官机发送、普通机器人回退、已绑定群和网关状态 |
推荐绑定流程
先让官方机器人和普通机器人进入同一个真实 QQ 群,并在 UniQQ 登录成功。
打开「官方协作」页,确认官机显示在线。
在真实群发送
关联官方群+官方虚拟群ID,或在官方群发送关联官方群+真实群号。回到页面检查绑定表,确认虚拟群 ID 与真实群号对应正确。
在官方群 @一次机器人或发送一条消息,让框架采集该群和成员身份。
点击「测试发送」,再发送
菜单、@机器人 你好和一条群管指令验收。
使用注意
官机遵守腾讯被动回复规则:通常需要在 5 分钟窗口内收到群消息,单条消息可回复次数有限。
官机未登录、群未绑定、回复凭据过期或发送失败时,系统自动回退普通机器人,不丢消息。
普通机器人执行群管动作必须在真实群内且具备群主/管理员权限。
官机事件使用 19 位虚拟 ID,不能把它直接当 QQ 号;需要执行群管时由成员映射转换为真实 QQ。
2.1.2 已支持官机图片回复、真实艾特转换以及引用消息/图片交给 AI;特殊复杂消息仍可能按安全策略回退普通机器人。
完整步骤与排错见:13-官方机器人协作教程.md。
🎛️ 右上角设置弹窗(补充)
控制台右上角「⚙️设置」打开,分四个标签:
| 标签 | 内容 |
|---|---|
| 🔒 安全 | 绑定官方群(状态徽章/绑定码输入/绑定时间/上次心跳同步时间/解除绑定按钮)、设备码、版本信息 |
| 🎛️ 行为 | 与全局配置实时同步的快捷项:指令前缀、菜单指令、小尾巴、引用回复、长消息转发、表情回应、未授权回复 |
| 🎨 外观 | 公告栏开关、自动检查更新开关 |
| 🧰 维护 | 当前版本、检查更新(弹窗会展示服务器最新版本与 🆕 最新版本的详细更新内容)、快捷操作 |
💡 首次打开控制台若未绑定,会自动弹出免费声明与绑定引导。
🆕 2.2.1 新增页面
👥 成员比对(安全防护分组)
选定 A / B 两个群,列出两个群同时存在的成员,按两群最高角色(群主 > 管理员 > 成员)筛选;支持选中单人移出、勾选批量移出,可勾选「同时拉黑」防止再进。
🎯 针对系统(安全防护分组)
为指定成员配置「每发一条消息就触发」的联动:撤回他的消息 / 艾特指定的人,可组合、可自定义文案。中间是固定高度的规则表格,使用说明在页面底部;群内指令与页面双通道同步,删除/保存后列表即时刷新。
📮 留言反馈(提醒服务分组)
群友发 反馈/留言 + 内容 转达给主人。页面可配置四个送达渠道:私聊主人(默认开)、私聊指定QQ、Webhook 推送(POST JSON)、邮件送达(复用邮件提醒 SMTP);带每日限频与格式校验(至少开启一个渠道才能保存)。
ℹ️ 关于插件
控制台侧边栏「关于插件」页,展示插件的整体信息。
页面内容
| 区块 | 内容 |
|---|---|
| 📖 插件介绍 | 功能概览、设计理念、版本信息 |
| 💖 赞助码 | 作者收款码,赞助后可获得优先支持 |
| 🏆 赞助名单 | 感谢赞助用户(由作者定期更新) |
| 🛠️ 定制服务 | 可定制各类插件,联系 QQ 939921104 |
| 📄 相关链接 | 控制台帮助按钮打开文档站首页;群内发送 帮助文档 直达 2.1.2 指令大全;同时提供官方群等入口 |
💡 想支持插件持续更新,可以在「关于插件」页扫码赞助;遇到问题需要人工协助,也可以通过定制服务联系作者。