一、插件基本信息

名称、作者、版本、运行环境

二、开发初衷

为什么做这个插件

三、下载与安装

下载渠道、安装步骤、免费绑定

四、快速上手

5 分钟跑起来

五、控制台界面总览

导航结构、顶栏、状态栏、设置弹窗

六、首页

数据看板与快捷操作

七、全局配置

对所有群生效的设置

八、菜单指令

关键词 → 固定回复

九、授权群组

授权、开关机、到期提醒

十、分群配置

单群独立配置（10 个标签页）

十一、问答管理

关键词自动回复

十二、知识库与长期记忆

AI 的百科脑与记性

十三、定时任务

定时 / 周期自动执行

十四、黑白名单

名单管理与处置策略

十五、违禁词汇

词库与四档处置

十六、内容安全

AI 审核链路

十七、AI 中心

AI 服务、Agent、技能

十八、文字转图片

把文字渲染成图片

十九、金币玩法

抢金币与奴隶系统

二十、提醒服务

邮件 / 告警 / 预警 / 生日 / 日程

二十一、官方协作

QQ 官方机器人接入

二十二、群内指令大全

全部指令速查

二十三、可用变量大全

内容里的可替换占位符

二十四、权限等级体系

五级权限模型

二十五、常见问题 FAQ

排障速查

二十六、售后服务与联系方式

反馈与支持

插件名称

ZL-综合插件

插件 ID

XiaoLin.ZLComprehensivePlugin

作者

薇薇

作者 QQ

939921104

官方群

327942687

当前版本

2.1.6

官网 / 下载地址

https://blog.zxiaolin.com

适用框架

UniQQ（建议 1.1.0.1 及以上）

运行环境

Windows，.NET 运行时，需 WebView2

插件类型

综合群管与自动回复插件

收费模式

完全免费，授权群数量与成员数量均无上限

一句话简介

综合群管与自动回复插件，原生支持 UniQQ 官方机器人、普通 QQ 与官机协作通道。

一站式

菜单指令、问答、知识库、违禁词、定时任务、名单管理、入群审核、验证码、刷屏检测、AI 全部内置，无需再装其他插件

可视化

全部功能通过网页控制台配置，所见即所得，改完保存立即生效，不用改代码、不用重启

分群化

每个群可拥有完全独立的配置，一套插件管理多个风格不同的群

实时化

首页数据（消息量、指令量、日志、好友数）每秒实时刷新，机器人做了什么一目了然

多号友好

支持多机器人「1 群 1 管理」，每群指定归属号，其余号完全静默

官方渠道

https://blog.zxiaolin.com →「uniqq 官方论坛」下载

文件名

XiaoLin.ZLComprehensivePlugin.uniqq

授权方式

群内发 授权本群，或控制台「授权群组」页操作

授权群上限

无上限

单群成员上限

无上限

授权时长

可永久，也可指定天数（如 授权本群 30天）

辅助工具

群授权码、群绑定码（准入模式）

—

首页

数据看板：状态、运行数据、日志、快捷操作

基础设置

全局配置

对所有群生效的全局设置

授权群组

哪些群可以使用插件

分群配置

单个群的独立配置（10 个标签页）

官方协作

QQ 官方机器人接入与绑定

消息互动

菜单指令

菜单类指令及回复内容

问答管理

关键词自动回复规则

知识库

AI 检索用的知识词条

长期记忆

AI 的长期记忆条目

定时任务

定时 / 周期性任务

安全防护

黑白名单

成员名单管理与策略

违禁词汇

词库与触发处置

内容安全

AI 审核（精判 / 复核 / 处置日志）

扩展玩法

AI 中心

AI 服务、Agent、技能、内置工具

文字转图片

文字渲染成图片的样式配置

金币玩法

抢金币与奴隶系统

提醒服务

邮件提醒

新成员进群邮件通知

异常告警

风险事件邮件告警

关键词预警

群内关键词命中预警

生日纪念

成员生日登记与祝福

日程提醒

个人日程提醒

其他

使用帮助

打开在线文档

关于插件

版本、赞助、定制服务

框架 QQ

切换当前操作的机器人账号（多号框架可选）

群　号

下拉选择要配置的群，选中即为「当前分群」

归属

本群由哪个 QQ 管理；多号同群时只有归属号会响应指令

群开关

快速开 / 关当前群的插件功能（立即自动保存）

服务运行中

插件运行状态指示灯

插件版本

当前版本，如 v2.1.6

框架

UniQQ 名称与版本

设备码

当前设备的唯一识别码

未保存修改

显示有几处修改未保存，提醒及时保存

🔒 安全

绑定官方群（状态徽章 / 绑定码输入 / 绑定时间 / 心跳同步时间 / 解除绑定）、设备码、版本信息

🎛️ 行为

与全局配置实时同步的快捷项：指令前缀、菜单指令、小尾巴、引用回复、长消息转发、表情回应、未授权回复

🎨 外观

公告栏开关、自动检查更新开关

🧰 维护

当前版本、检查更新（展示服务器最新版本与详细更新内容）、快捷操作

欢迎语

按时间段显示问候

服务状态点

🟢 运行中 ｜ 🟠 全局开关已关闭 ｜ 🔴 运行异常（附原因）

N 个群组启用

当前启用插件功能的群数量

「进入全局配置」

快捷跳转

插件状态

运行中 / 已停用 / 异常，以及全局总开关状态

授权群组

已授权数 / 已知群组数

在线时长

从插件启动至今的持续运行时间

好友数量

机器人 QQ 当前好友总数

消息处理

每收到一条群消息 +1（大数字为累计，小字为今日）

指令响应

每命中一条指令或问答 +1

定时任务

每执行一次定时任务 +1

拦截违规

违禁词 / 黑名单 / 刷屏等每拦截一次 +1

INFO

蓝

普通信息（启动、保存配置、事件提示）

CMD

紫

群内触发指令 / 命中问答

TASK

黄

定时任务执行记录

WARN

橙

警告（拦截违规、拒绝加群、通道回退）

ERROR

红

运行错误

ADD

绿

新增类操作（自动同意好友、授权等）

保存配置

一次性保存所有页面的修改（快捷键 Ctrl + S）

重新加载

丢弃未保存修改，从磁盘重新读取配置

导入 / 导出

导出配置为 JSON 备份，或从 JSON 导入

使用帮助

打开官方帮助站点

全局主人

插件最高权限人 QQ，多个用逗号或换行分隔。默认 939921104，请务必改成自己的 QQ

全局小尾巴

每条回复末尾自动附加的文字，常用于署名或广告；留空则不附加。改完必须保存，下一条回复即生效

启用插件总开关

插件总电源，关闭后所有群功能全部停止

开

仅授权群可使用插件

开启后未授权群无法使用功能

开

未授权群回复提示

未授权群有人发疑似指令时回复未授权提示语

开

启用扩展 API 指令

段子 / 谜语 / 运势 / 诗词等娱乐查询指令的总开关

开

机器人被邀请加群时自动同意

仅对普通成员的邀请请求生效

关

机器人被邀请进群后通知主人

被拉群时私聊通知主人

关

机器人被添加好友时自动同意

仅对好友申请生效

关

风险事件通知主人

被踢出群 / 离开群 / 离线时私聊通知

关

机器人回复时引用原消息

回复以引用方式发送

关

超长消息自动转合并转发卡片

超过 1200 字的回复改用合并转发，防刷屏和截断

开

指令执行成功后贴表情回应

指令命中后给原消息贴一个表情

开

文字消息转图片发送

纯文字渲染成图片；群内也可发 开启文字转图片 / 关闭文字转图片 切换

关

命令前缀

所有指令前的引导符号，可留空

填 / 后需发 /菜单

菜单指令

触发菜单回复的关键词

默认 菜单

未授权提示

未授权群触发指令时的回复文本

默认"本群暂未授权使用 ZL-综合插件。"

ID / 序号

指令编号，点击行可选中编辑

关键词

触发指令的文字

权限

无 / 管理员 / 主人

状态

已启用 / 已停用

操作

编辑 / 删除

关键词

群成员发送这个词即触发回复

触发方式

完全匹配 / 模糊匹配 / 正则匹配

权限

无 = 所有人 ｜ 管理员 = 群管 ｜ 主人 = 仅主人

普通机器人文本

普通号发送的内容，每行一组，可用 `

` 分隔

官机 Markdown

点按钮排里的「✨ Markdown」切换编辑，再点「预览」编辑官机专属卡片。两者独立保存，互不覆盖

保存

保存当前编辑的指令

删除

删除当前选中的指令

测试

让机器人向当前群真实发送一次该指令内容

✨ Markdown

切换「普通文本 / 官机 Markdown」编辑模式

预览

打开官机卡片预览编辑器

授权群总数

已授权数（上限显示为 ∞，即不限）

已授权成员

授权群内成员总数

剩余授权数

不限制

今日新增授权

今天新授权的群数量

ID / 序号

序号

群号

QQ 群号

群名称

群名片

群成员数

当前群人数

授权状态

已授权 / 未授权

到期时间

授权截止日期（留空为永久）

操作

编辑授权

到期时间

设置授权有效截止日期

设置授权

按设定日期授权

取消授权

撤销该群授权

开启 / 关闭群

切换该群的插件启用状态

开启全部群 / 关闭全部群

一键批量操作

群授权码

生成授权码交给他人，对方凭码激活自己的群

群绑定码

发码群内领地绑定码，仅目标群群主可领，用于准入式授权

群开关

开

本群启停（关 = 关机，授权仍保留）

本群管理员 QQ

空

本群管理指令的授权名单

聊天女仆角色

萝莉

萝莉 / 御姐 / 管家（另有 Agent 智能助手，在 AI 中心设置）

聊天女仆前缀

#

唤醒女仆的消息前缀

允许 AI 控制指令

开

管家模式下允许 AI 用大白话执行插件指令

警告踢人次数

—

累计警告达到次数自动踢出

自动撤回机器人消息

关

机器人消息 N 秒后自动撤回（默认 60 秒）

自动群发消息

关

定期向本群群发内容（循环消息，默认间隔 10 分钟）

自定义菜单

空

本群专属菜单，留空用全局默认菜单

违禁词检测

跟随全局

本群违禁词开关

违禁警告文本

内置

触发违禁词时的警告文案

处理方式

不处理

自动同意 / 自动拒绝 / 不处理

默认拒绝理由

"本群禁止加群"

自动拒绝时发送

昵称关键词拦截

关

昵称含关键词 → 拒绝

签名关键词拦截

关

⚠️ 等待官方 SDK，暂不可用

最低 QQ 等级

0

✅ 可用：查询失败自动放行；需群加群方式为"需要验证信息"

最低达人天数

0

⚠️ 等待官方 SDK，暂不可用

新人进群禁言

0 分钟

通过审核后先禁言 N 分钟

验证码开关

关

总开关

验证类型

随机数字

随机数字 / 中文 / 英文 / 算术题 / 固定验证码

验证码长度

5 位

2 ~ 10 位

有效时间

120 秒

超时按「超时处罚类型」处理

固定验证码

空

类型选"固定"时使用

失败次数上限

3 次

1 ~ 99 次

失败处罚类型

踢出

踢出 / 禁言 / 仅警告

处罚禁言时长

60 分钟

处罚选"禁言"时生效

超时处罚类型

踢出

踢出 / 禁言 / 仅警告

自动名片

关

新人进群自动设置群名片

男生 / 女生 / 默认名片模板

♂ / ♀ / 空

按 QQ 资料性别匹配

名片检查

关

定期检查群名片合规

违规词

空

名片含这些词视为违规

处理方式

提醒

提醒 / 自动重置

固定名片

关

强制全员统一名片格式

👋 新人进群提示

有人进群（开了验证码则等验证通过才发）

💌 进群私聊提示

新人进群私聊欢迎（群临时会话，无需加好友）

🚪 退群提示

有人退群

👟 被踢提示

有人被踢

🔇 禁言提示

有人被禁言

🔊 解禁提示

有人被解除禁言

⬆️ 升级管理提示

有人成为管理员

⬇️ 取消管理提示

有人被撤管理

刷屏检测

关

总开关

检测窗口

60 秒

在此时间内统计条数

最大条数

10 条

超过即判定刷屏

处罚方式

警告

警告 / 禁言 / 踢出群

禁言时长

10 分钟

处罚选禁言时生效

复合限制

内置

单条最大行数 / 中文字数 / 数字数 / 字母数

图片菜单

开

各类动漫 / 游戏图片接口

视频菜单

开

视频类接口

便民查询

开

热搜 / 天气 / 解梦等查询

文案语录

开

打工人语录 / 彩虹屁等

在线听歌

开

点歌功能

看图猜词 / 猜数游戏 / 成语接龙

关

游戏功能（建设中）

邀请统计

关

记录邀请关系（推荐开启）

发言统计

开

记录发言数据

昵称变动播报

关

成员改名片 / 昵称后群里播报「原昵称 → 新昵称」（每 10 分钟轮询，每群独立）

单个 API 开关

全开

每个便民 API 可单独关闭，防止接口被刷

签到开关

关

开启后群友可签到

奖励区间

10 ~ 100 金币

每次签到随机获得

连签阶梯

3 天 ×1.2 / 7 天 ×1.5 / 15 天 ×2.0 / 30 天 ×3.0

达标后奖励乘倍率，断签清零

阶梯自定义

支持

可增删档位、恢复默认

签到明细 / 排行榜

—

金币榜 + 连签榜

问题（关键词）

触发词，**多关键词用 `

分隔**，如 你好

hi

哈喽`

答案

回复内容，**多条答案用 `

` 分隔 → 随机回复一条**

匹配模式

精确 / 模糊（默认） / 正则

生效范围

当前群 / 全部群（全局问答）

导入 / 导出

批量备份、分享词库

精确

消息完全等于关键词

关键词 你好 → 只有发"你好"才触发

模糊

消息包含关键词

关键词 你好 → "大家好啊"也触发

正则

关键词按正则表达式匹配

关键词 [0-9]{5} → 任意 5 位数字触发

📊 顶部统计卡

总词条 / 启用 / 累计命中

🔍 搜索 + 范围筛选

可按全局 / 本群筛选

🗂️ 词条卡片

答案预览 + 关键词标签 + 范围 / 状态 / 命中徽标

🛠️ 操作

新增 / 编辑 / 启停 / 删除

❓ 问题

词条的问题描述，配合关键词匹配提问

💡 答案

命中后回复 / AI 引用的内容

🏷️ 关键词

检索匹配标签，多个更容易命中

🌍 范围

全局（所有群）/ 本群

🎯 命中

累计命中次数徽标

范围

本群（仅该群生效）/ 全局（所有授权群生效）

容量

每个范围最多保存 100 条，超出自动淘汰最旧的

操作

支持搜索（记忆内容 / 来源）

执行时间

时间选择器点选时分

执行周期

📅 每天 / 💼 工作日 / 🗓️ 每周一 ~ 每周日 / 📆 每月 N 日（当月没有的日子自动跳过）

任务类型

💬 发送群消息 ｜ 🤖 AI 群聊总结 ｜ 🔇 群禁言 ｜ 🔊 群解除禁言

目标范围

当前群 / 全部群

发送内容

仅「发送群消息」需要填写；免内容类型自动隐藏输入框并显示操作说明

官机卡片

给该任务单独写一份官机专属 Markdown（左编辑右实时预览）。填了则官机发卡片、普通号仍发纯文本，互不覆盖；纯文本可留空（普通号无文本就跳过不发）；两者都空才会拦截

ID

数字序号

目标范围

目标群名（或"全部群"）

上次执行

最近执行日期；未执行过显示"从未执行"

发送内容

配置了官机卡片的任务会显示「官机卡片」标记

启用

行内开关，点击立即生效并自动保存

操作

编辑 / 执行 / 删除

筛选栏

默认显示当前分群任务 + 全部群广播任务，可切到「全部任务」；支持按类型 / 状态筛选与内容搜索

自动保存

增删改与开关切换都会立即自动保存

立即执行

编辑器按钮执行当前已保存任务；每行按钮无视时间立刻跑一次

错过补跑

电脑睡眠错过定时，30 分钟内自动补发

任务记录

上次执行日期随任务保存

跳过记录

群未授权 / 未启用、不在分群配置中、内容为空都会在日志中记录原因

退群拉黑

成员主动退群 → 自动拉黑（可关）

踢出拉黑

被踢出群 → 自动拉黑（可关）

本群

添加禁言词 词 / 删除禁言词 词 / 禁言词列表

全局

添加全局禁言词 词 / 删除全局禁言词 词 / 全局禁言词列表

⚠️ 警告

发送警告文本

↩️ 撤回

撤回触发消息

🔇 禁言

禁言指定分钟（默认 60）

👢 踢出

移出本群

审核专用模型

留空用「AI 服务」主模型；建议填便宜快速的多模态模型（如 glm-4v-flash）

自动处置阈值

默认 88%；低于阈值即使模型判违规也只按 Review 处理

处罚前二次确认

默认开

疑似内容延迟复核

默认开

复核等待时间

默认 12 秒，可设 5 ~ 60 秒

启用 AI 审核

关

总开关，开启后只审授权群

链接 / 裸域名

开

网址与无协议头域名

连续数字串

开

≥ 6 位；价格、日期等日常数字不触发

字母 / 混合串

开

短链口令、导流码、暗语（纯英文单词 ≥ 10 位才触发）

名片卡片

开

好友名片 / 群名片推荐消息

导流特征词

开

微信 / VX / 代刷等

图片

开

AI 直接看图

全量语义审核

关

所有有效消息都送 AI；不会降低处罚门槛

豁免主人 / 插件管理员 / 群主

开

三类身份不送审

↩️ 撤回违规消息

开

需机器人有群管理员权限

⚠️ @违规者警告

开

命中后 @ 并警告

🔇 自动禁言

关

开启后按设定时长禁言（默认 60 分钟）

每日送审上限

2000 条

达上限自动暂停并私聊通知主人，次日 0 点恢复

每群每分钟上限

10 条

超限当条直接放行

单条最多看图

3 张

防刷图烧额度

最近处置记录

10 条

只展示真正执行过策略的记录

AI 执行日志

60 条

含时间、群号、QQ、消息 ID、执行阶段、触发原因、AI 结论、类型、严重度、置信度、依据、最终动作

基础接入

API 地址、密钥、模型名、测试连接

频控与上下文

冷却时间、上下文轮数、单次上限

扩展能力

图片识别、联网搜索、群聊总结

四套人设

萝莉 / 御姐 / 管家 / 御姐管家（纯陪聊）+ Agent 智能助手（唯一可调用全部工具与技能的人设）

AI 状态面板

顶部展示当前服务、模型、引擎、人设、额度状态

触发方式

群里 #内容（前缀可改），或 @机器人 说话

人设切换

主人 / 管理员发 人设 Agent、人设 萝莉，自动清空会话记忆避免串味

未配置 AI 时

回复"AI 服务还没配置好呢"

冷却与额度

受频控限制；关闭聊天女仆开关后 @机器人 不再闲聊

图片识别

发图并 @机器人，或回复图片发「检测」

群聊总结

总结（当日群聊六大板块日报）／总结@某人

管家模式

大白话执行插件指令，需「允许 AI 控制指令」开启

在线安装

「我的技能」内置技能市场，在线浏览并一键安装

导入 / 导出

支持本地导入与导出 .skill 技能包

触发方式

群里直发「技能名 + 内容」，分隔符支持空格 / # / : / ：

敏捷用法

记不住格式就直接 @机器人 说大白话，自动匹配合适技能

直通车

点名技能（如 中英互译 今天天气真好）直接执行，不经过模型

定位

本群唯一能调用插件全部工具与技能的人设

触发

@机器人 说人话，如「帮我添加一个问答 用户问 1 回答 2」

内置工具

45 个，覆盖查询 / 配置 / 群管

风险徽标

🟢 read 只读 ｜ 🟠 write 写入 ｜ 🔴 danger 危险 ｜ 🟣 perm 需权限

安全机制

危险操作二次确认；配置类指令（问答 / 违禁词 / 定时）直接执行不回编

权限注入

工具按提问者实际权限动态注入，普通成员拿不到管理类工具

开关

全局配置里的「文字消息转图片发送」；群内也可发 开启文字转图片 / 关闭文字转图片

渲染引擎

普通纯文字走高速 GDI+；含彩色 Emoji 走 WebView2

保持文字

链接、邮箱、@ 和 CQ 消息保持可点击文字，不转图

排版与尺寸

最大宽度 / 固定宽度、字号、行距、内边距等

配色

文字色与背景色可选，支持随机彩色

测试预览

页面底部实时预览，与实际发送效果一致

回退

渲染或发送失败自动回退文字，不丢消息

总开关

开启后群友可发 抢金币@某人

相关参数

单次奖励区间、冷却时间、每日次数上限等

总开关

开启后可用 买奴隶 / 赎身 / 抢奴隶 / 释放奴隶 / 我的奴隶

相关参数

价格、抢夺成功率、冷却等

邮箱服务（SMTP）

服务器（如 smtp.qq.com）、端口（587 = STARTTLS，465 = 隐式 SSL）、发件邮箱、授权码、发件人名称、超时（最大 1440 分钟）

默认邮件模板

主题（如「欢迎加入『{群名}』」）、正文；可开启 HTML 模式渲染图文并用内联样式

当前分群设置

本群开关、延迟发送、本群模板覆盖

发送记录

历史发送结果

告警规则

总开关、告警类型勾选、收件邮箱、同类告警冷却（默认 30 分钟）

告警记录

历史告警

监控与通知

总开关、监控词表（每行一个）、通知方式、冷却（默认 10 分钟，0 = 不冷却）、收件邮箱

当前分群设置

本群开关、本群词表覆盖（覆盖后本群只匹配本群词表）

触发记录

历史命中记录

提醒设置

允许群友自行登记（群里发 我的生日 3月5日）、总开关、发送时间（默认 10 点）、祝福模板

当前分群设置

本群开关、本群模板覆盖

名单管理

本群生日名单，支持按昵称 / 事件名搜索、手动增删

个人日程

群友可自行挂日程，到期在群内提醒

分群开关

关闭后该群成员无法挂日程、到期也不提醒

原生官机状态

显示框架识别到的官方机器人、在线状态与账号信息

协作开关

开启后已绑定群优先由官机回复；关闭则全部恢复普通机器人流程

官方机器人白名单

只填已确认的官机 QQ 号；框架官方虚拟机器人 ID 会自动保护

群组绑定

绑定「官方虚拟群 ID / openid ↔ 真实 QQ 群号」；授权、分群配置与群管执行均以真实群号为准

成员映射

绑定「官方成员虚拟 ID ↔ 真实 QQ」，用于禁言、踢人、改名片、设管理员

Markdown

官机主菜单与内置子菜单默认发 Markdown 卡片；问答、提示、菜单可各自编辑官机卡片

运行统计

官机发送、普通机器人回退、已绑定群、网关状态

菜单

所有人

返回菜单内容（触发词可自定义）

运行状态 / 插件状态

所有人

查看运行状态、授权情况

帮助文档

所有人

直达在线文档

授权本群

主人

授权当前群（可加天数：授权本群 30）

取消授权本群

主人

取消当前群授权

开启本群 / 关闭本群

插件管理员

切换本群插件功能

闭嘴 / 说话

群管理员及以上

本群停用 / 恢复（最快静默方式）

绑定码

所有人（官方群内）

获取一次性绑定码

添加主人 QQ / 删除主人 QQ

主人

增删全局主人

添加插件管理员 QQ / 删除插件管理员 QQ

主人

增删插件管理员

添加群管理员 QQ / 删除群管理员 QQ

插件管理员

增删本群管理员

管理员列表

所有人

查看主人 / 管理员列表

添加白名单 QQ / 删除白名单 QQ

群管理员

白名单增删

添加黑名单 QQ / 删除黑名单 QQ

群管理员

黑名单增删

名单列表

所有人

查看本群黑白名单

`添加问答 问题

答案`

群管理员

添加本群问答

删除问答 问题

群管理员

删除本群问答

问答列表

所有人

查看本群问答

`添加全局问答 问题

答案`

插件管理员

添加全局问答

删除全局问答 问题 / 全局问答列表

插件管理员 / 所有人

删除 / 查看全局问答

添加禁言词 词 / 删除禁言词 词

群管理员

本群词库增删

禁言词列表

所有人

查看本群词库

添加全局禁言词 词 / 删除全局禁言词 词

插件管理员

全局词库增删

禁言词策略 警告=开 撤回=开 禁言=关 时间=60

群管理员

一键配置处置策略

`添加定时 08:30

早上好`

插件管理员

添加每天 08:30 的任务

定时列表

所有人

查看本群定时任务

删除定时 1

插件管理员

删除编号 1 的任务

发言排行 / 今日发言排行 / 我的发言

发言数据与排行

邀请排行 / 我的邀请 / 查邀请@某人

邀请数据与排行

群龙王

今日龙王

签到 / 我的签到 / 签到排行 / 连签排行

签到体系

本群成员 / 成员信息

成员查询

点歌 歌名

在线点歌（网易云 / QQ / 酷狗 / 酷我），支持序号点歌与热门榜单

抢金币@某人

金币玩法

买奴隶@某人 / 赎身 / 抢奴隶@某人 / 释放奴隶@某人 / 我的奴隶

奴隶系统

赞@某人 / 戳一戳@某人

互动

段子 / 谜语 / 土味情话 / 舔狗日记

文案语录（需开「文案语录」）

今日运势 关键词 / 诗词 内容 / 农历 / 历史今天

便民查询（需开「便民查询」）

头衔申请 内容

头衔兑换

撤回

撤回引用 / 上一条消息

导出聊天 / 导出聊天 7天

导出聊天记录（主人 / 插件管理员）

总结 / 总结@某人

AI 群聊总结

[AT]

@对方（艾特该成员）

问答、群事件提示、验证码文案、定时任务

[QQ]

对方 QQ 号

问答、群事件提示

[昵称] / [QQ昵称]

对方昵称

问答、群事件提示

[QQ头像]

对方头像

验证码文案

[验证码]

当前验证码内容

验证码文案

[验证码时间]

验证码有效期秒数

验证码文案

[失败次数] / [剩余次数] / [最大次数]

验证失败计数

验证码错误文案

[操作QQ]

执行操作的人

群事件提示

[操作QQ昵称]

操作者昵称

群事件提示

[群号]

群号

群事件提示、定时任务

[群名] / [群名称]

群名称

群事件提示、定时任务

[人数]

当前群人数

群事件提示

[日期]

当前日期

群事件提示、定时任务

[时间] / [当前时间]

当前时间

群事件提示、定时任务

成员

所有人

菜单、问答、娱乐指令、各类列表查询

群管理员

群内是管理员，或被 添加群管理员

名单管理、本群问答 / 违禁词管理、撤回与检测指令

群主

QQ 群主身份

同群管理员

插件管理员

被 添加插件管理员 或在控制台填写

开关本群、定时任务、全局问答 / 违禁词、导出聊天

主人

「全局主人」中填写

一切权限：授权群、管理主人、跨群控制

双击插件包没反应 / UniQQ 里看不到插件

包必须放进 Plugins 目录，不要在压缩包里直接运行；确认框架版本不低于 1.1.0.1

控制台报错 Unable to load DLL 'WebView2Loader.dll'

安装 WebView2 运行时（Win10/11 一般自带）

装了新包还是旧行为

完全退出 UniQQ 再重开；确认控制台底部显示的是新版本号

如何确认当前加载的版本

群内发 运行状态，或看控制台底部版本与「关于插件」页

机器人在我的群完全不说话

① 全局总开关是否开启 ② 群是否已授权且「仅授权群可使用插件」为开 ③ 分群配置里本群开关是否开启 ④ 本群归属号是不是当前登录的 QQ

未授权群里机器人只回复"未授权"

正常行为；授权后即恢复，也可在全局配置关闭「未授权群回复提示」让它彻底静默

拿不到绑定码

绑定码需在官方群 327942687 内发送 绑定码 获取，24 小时有效

显示"功能受限" / 高级功能用不了

试用期已过且未绑定，按 3.3 免费绑定

@机器人没反应

确认 AI 服务已配置、聊天女仆开关已开、命令前缀没写错

AI 回复"AI 服务还没配置好呢"

到「AI 中心」填 API 地址 / 密钥 / 模型名，点测试连接

图片识别没反应

需发图并 @机器人；确认所用模型支持多模态传图

问 AI 天气 / 新闻说"不知道"

联网搜索需在 AI 服务开启扩展能力

AI 聊天突然没回复

命中频控冷却，稍等片刻再发

总结指令没反应

需有足够发言记录；「AI 群聊总结」也可在定时任务中配置

让 Agent 添加问答却回一段文字

2.1.6 已修复：配置类指令会真正写库并回执；确认人设是「Agent 智能助手」且 Agent 引擎已开启

切到 Agent 人设但工具都没反应

Agent 引擎开关是独立开关，需在 AI 中心单独开启

AI 技能会不会误触发普通聊天

技能匹配为严格模式，只认「技能全名 / 关键词 + 分隔符」

知识库命中次数一直是 0

需 AI 服务正常且问题属于"功能用法 / 群规 / 指令类"

同一个群在官机里是 19 位数字

那是官方虚拟群 ID，需绑定映射到真实群号

群组下拉框缺少某些官方群

未监听到该群事件，先在官方群发一条消息让框架采集

官机显示已上线，回复却全是普通号发的

检查是否已绑定该群、协作开关是否开启

@官机不回复，普通消息却回复

官机被动窗口可能已过期，或该消息被判定为不支持的类型

官机和普通机器人两边都回复

检查是否重复绑定，或协作开关与「仅授权群」配置冲突

定时任务到点群里没消息

官机被动凭据过期；开启「顺风车」或「准点触发」

改了配置不生效

必须点「保存」或按 Ctrl + S；底部"未保存修改"会提示

窗口显示不全 / 页面被缩放搞乱

恢复窗口大小或按 Ctrl + 0 重置缩放

检测更新有新版但一键更新后没变化

更新后需重启 UniQQ；确认插件目录没有被写成只读

检查更新弹窗太打扰

「设置 → 外观」关闭自动检查更新

作者

薇薇

作者 QQ

939921104

官方群

327942687

官方网站 / 帮助文档

https://blog.zxiaolin.com

控制台快捷帮助

首页 → 快捷操作 →「使用帮助」