07 · 常见问题 FAQ
适用版本:ZL-综合插件 2.1.2(2026-10-08 校准) 遇到问题先来这里找答案,按类别排查。
📦 一、安装与启动
❓ 双击插件包没反应 / UniQQ 里看不到插件
确认包是
.uniqq后缀,放到 UniQQ 的 Plugins 文件夹(不是手动解压)重启 UniQQ,在插件管理里手动启用
❓ 打开控制台报错 Unable to load DLL 'WebView2Loader.dll'
你的电脑缺少 WebView2 运行时
解决:安装 WebView2 Runtime(微软官网免费下载)后重新打开控制台
❓ 装了新包还是旧行为
插件有运行时缓存,按这个顺序处理:
关闭 UniQQ(彻底退出)
删除 UniQQ 目录下
Data\PluginRuntime里的旧缓存重新打开 UniQQ
⚠️ 注意:插件管理里"停用再启用"不能完全重载包,必须重启 UniQQ。
❓ 如何确认当前加载的版本
控制台右上角「设置」→「维护」看版本号
群里发
运行状态也能看版本
🔑 二、授权与绑定
❓ 机器人在我的群完全不说话
按顺序检查:
群是否已授权?→ 主人在群里发
授权本群群是否被关闭(关机)?→ 发
开启本群或控制台「授权群组」开启发消息的是不是机器人自己的QQ?机器人消息会被忽略(防循环)
你是否在黑名单里?
全局「插件总开关」是否开启?
❓ 未授权群里机器人只回复"未授权"
这是正常设计。主人发 授权本群 即可;不希望它回复任何内容可以在全局配置里清空"未授权提示"。
❓ 绑定码发到官方群没人回 / 拿不到绑定码
绑定码需要在官方群 327942687 内发送「绑定码」触发
同一QQ 24小时内重复请求返回同一个码
绑定码24小时有效、一次性使用
实在拿不到 → 联系作者(blog.zxiaolin.com)
❓ 显示"功能受限" / 高级功能用不了
试用7天结束未绑定 → 免费绑定官方群即可恢复
机器人退出官方群超48小时 → 回群 + 等待心跳同步(最长6小时,打开控制台立即同步)
🤖 三、AI 功能
❓ @机器人没反应
控制台「AI服务」页是否启用AI服务
API地址和 API Key 是否已填并保存
本群「AI辅助」是否被关闭?→ 群里发
开启AI辅助是否处于冷却期(默认15秒)?冷却内静默忽略
当天额度是否用完(默认50次/人)
未绑定且试用结束 → AI受限
❓ AI回复"AI 服务还没配置好呢"
API Key 没填或没保存。去控制台「AI服务」页填好 → 点保存 → 用页面上的「测试连接」验证。
❓ 图片识别没反应 / 提示识别不了
必须发图 + @机器人(纯发图不@不响应)
视觉模型未配置 → AI服务页填视觉模型(推荐
glm-4v-flash,免费)闪照/本地缓存图拿不到链接 → 识别不了,属正常限制
超8MB大图会拒绝处理
确认"图片识别"开关开着(默认开)
❓ 问AI天气/新闻说"不知道"
在AI服务页开启「联网搜索」(支持智谱GLM、阿里千问)
开启后问时效性问题时AI会自动联网
用页面「测试联网」按钮验证
❓ AI聊天突然没回复,立刻再发也没用
上一次请求可能失败,失败会自动回滚冷却,等几秒重试即可
若持续失败,看AI服务页「连通状态」的错误信息(超80字会截断显示)
DeepSeek 用户:确认模型是
deepseek-chat,不要用deepseek-reasoner(响应慢易超时)
❓ 总结指令没反应 / 说没有发言记录
需要 AI 服务已配置
群里近期要有发言(缓冲不足会自动拉历史,最多100条)
总结是全群总结;总结@某人才是定向总结,别混用机器人自己不纳入总结范围
❓ AI 群聊总结发不出来
AI 群聊总结属于高级功能,受官方群绑定限制:未绑定官方群或试用期结束时无法使用
解决:加入官方群获取绑定码,在控制台右上角「设置」完成免费绑定(流程见 01-基础概念与权限体系)
其余排查见上一条「总结指令没反应」
❓ AI 说能做但没做?
这是 2.0.x 旧版偶发的问题。2.1.1 已修复:Agent 必须真实调用工具才会承认完成,没调工具就不会谎报结果。若仍遇到,请先确认版本已升到 2.1.1。
❓ 问功能用法,AI 回答不对照?
2.1.1 新增知识库:AI 回答功能用法类问题前会强制检索知识库并按原文回答(内置 42 条知识包),不再自由发挥。控制台「知识库」页可自建词条(支持全局/本群范围),群里问「知识库里有什么」可查看词条概览。
❓ 技能缩写怎么用?
群里直接发「技能缩写+内容」即可,如「互译晚上好」等同「中英互译 晚上好」。使用完整技能名直发时建议带上分隔符(空格/#/:/:),识别更稳。
❓ 问「群里有谁」同时出现两条提示?
旧版联网提示与工具提示会重叠。2.1.1 已修复:联网与工具调用提示互斥,同一时间只会出现一条提示。
❓ 知识库命中次数一直是 0?
2.1.1 起改为强制检索:功能用法类问题必查知识库,命中次数会正常累计;控制台「知识库」页的统计每 30 秒自动刷新,稍等片刻再看。
❓ AI 不理我的管理指令?
Agent 工具按发言人身份动态注入:普通成员看不到管理类工具,AI 会提示权限不足。请确认自己是插件管理员/群主/群管,或让有权限的成员操作。
🤝 四、官方机器人协作
❓ 为什么同一个群在官机里是 19 位数字
这是 QQ 官方机器人使用的虚拟群 ID / openid,不是真实 QQ 群号。请在控制台「官方协作」把它绑定到真实群;授权、分群配置和群管动作仍以真实群号为准。
❓ 群组下拉框为什么缺少一些官方群
框架必须先收到该群的官方事件才能采集。请在缺失的官方群里 @一次官方机器人或发送一条能触发它的消息,然后回到「官方协作」页点击刷新。
❓ 官机和普通机器人分别做什么
官机负责菜单、AI、问答、提示和执行结果等所有可见回复。
普通机器人静默执行禁言、踢人、撤回、管理员、群名片等真实群动作。
没有官机或官机发送失败时,普通机器人自动回退回复。
❓ 官机回复了“已禁言”,但成员没有被禁言
普通机器人是否在线并在对应真实群。
普通机器人是否有群主/管理员权限。
官方虚拟群是否绑定到正确真实群。
目标成员虚拟 ID 是否已映射到真实 QQ。
查看运行日志中的执行机器人、真实群号和目标 QQ。
官机本身不执行群管动作;实际动作必须由普通机器人完成。
❓ 为什么提示“本群没有找到该成员”
官机提供的是成员虚拟 ID,普通机器人需要真实 QQ。先让目标成员在绑定群内发言或艾特机器人,让系统自动采集映射;仍无法识别时,在「官方协作 → 成员身份映射」手动绑定。
❓ @官机不回复,普通消息却回复
确认艾特的是当前登录官机,并升级到 2.1.2。再检查日志中的官方消息是否包含 at 段、群是否已绑定、AI/问答功能是否开启以及官机被动回复凭据是否有效。
❓ 为什么艾特别人也触发了 AI
2.1.2 已区分“艾特当前机器人”和“艾特其他成员”。升级后重启 UniQQ;若仍出现,检查是否有旧版插件实例或另一台电脑上的机器人仍在线响应。
❓ 引用的文字或图片为什么 AI 看不到
引用后需要 @官机并写明问题。
开启图片识别并配置视觉模型。
闪照、失效图片或无法下载的链接不能识别。
2.1.2 会解析当前消息和引用消息;旧版只读取本次输入文字。
❓ 官机菜单显示原始标签,不是 Markdown
升级到 2.1.2 并清理 Data\PluginRuntime 旧缓存。新版内置菜单使用标准 Markdown,不再依赖可能被客户端原样显示的 <qqbot-cmd-input> 扩展标签。
❓ 为什么官机和普通机器人两边都回复
确认群绑定只有一条且指向正确真实群。
确认没有两个 UniQQ 实例同时运行。
所有实例都应升级到 2.1.2。
官机成功时普通机器人应静默,只有官机失败才会回退。
完整配置流程见:13-官方机器人协作教程.md。
🎵 五、点歌与其他功能
❓ 点歌串台 / 显示错的平台来源
先
换个平台确认当前平台确认 UniQQ 加载的是新版本(旧版有串台bug)
检查是否安装了其他音乐插件造成重复响应(卸载或停用它们)
❓ 签到了金币没变 / 排行看不到自己
每日签到需在「分群配置→每日签到」开启
签到按群隔离记录,每个群独立排行
❓ 定时任务不执行 / 任务消失了怎么办
任务列表默认只显示当前分群的任务——以为"任务消失了"时,先切到「全部任务」筛选,就能看到所有群的任务
任务添加后立即自动保存,重启不会丢(2.0.6 起添加/修改/删除/开关切换都实时落盘)
看控制台运行日志,搜索「定时任务跳过」,日志会写明原因:群未授权 未启用 不在配置 / 内容为空
未绑定官方群或试用结束:AI 群聊总结类定时任务会被跳过(高级功能限制,绑定后恢复)
表格里点「立即执行」失败时会提示具体原因,按提示排查即可
任务是否启用(开关打开)、执行周期是否符合预期(每天/工作日/每周几/每月N日)
电脑睡眠错过的任务:30分钟内会自动补跑,超过就不补
"全部群"任务有幂等保护,插件多实例也不会重复发(这是特性不是bug)
❓ 违禁词触发但不撤回
检查策略:发
禁言词策略 撤回=开 警告=开 禁言=关 时间=60白名单成员豁免检测
机器人需要群管理员权限才能撤回/禁言
❓ 新人进群没欢迎 / 验证码流程卡住
「群聊提示→新人进群提示」和「入群验证」都要开启对应开关
开了验证码时不要同时开新人禁言(新人没法打字)
验证码通过后才会发进群提示,两个功能内容别重复配置
❓ 回复「同意101」没反应 / 提示没有待批项
好友申请的审批代号(101、102…递增)曾与框架内置审批编号冲突,纯数字回复可能被框架截走。
2.0.5 起好友申请审批代号已改为 F 前缀格式,请按私聊通知里给出的代号回复:
好友申请:回复「同意F101」/「拒绝F101 理由」
头衔申请:回复「同意头衔 101」/「拒绝头衔 101 理由」(头衔审核本身就是这个格式,不带 F)
💡 好友审批老格式「同意101」可能没反应或提示没有待批项,加上 F 前缀就好了。
❓ 头衔申请后没动静 / 金币问题
申请后没动静 → 确认主人是否收到私聊审核通知,回复「同意头衔 代号」或「拒绝头衔 代号 理由」(发「头衔申请」可查待审列表)
审核拒绝会全额退币,并在群里 @申请者 说明原因
头衔设置失败会自动退款,不用担心金币白花
❓ AI 审核(原内容安全/鉴黄)不工作
控制台「AI 服务」页是否已开启并配置 API Key 与接口地址(AI 审核复用该通道,无需开通任何云平台)
控制台「AI 审核」页点「测试连接」确认 AI 精判通道可用;看图审核需渠道支持多模态模型
消息是否命中送审范围——普通模式只审核链接/裸域名/连续数字串/字母混合串/名片/导流词/图片;开启「全量语义审核」后会审核所有有效消息,但纯标点、纯表情和无害短回复仍会直接放行
每日送审额度是否用完——达到上限自动暂停并私聊通知主人,次日 0 点恢复;每分钟超限的当条消息直接放行
AI 偶发失败会自动放行并记日志(保证群聊可用性),频繁失败请检查 AI 服务配置或网络
到页面底部查看 AI 执行日志:按消息 ID 查看候选送审、首次精判、二次确认、延迟复核和策略执行的完整过程
❓ 为什么 AI 判了违规却没有撤回
2.0.18 不再把模型的一次回答直接当处罚命令,出现以下任一情况都会放行:
首次结果只是 Review(疑似)
风险严重度不足,或置信度低于默认 88% 阈值
处罚前第二次确认返回 Pass Review 失败
今日额度不足,无法完成二次确认
撤回开关未开启,或者机器人没有群管理员权限
具体原因请查看「内容安全 → AI 执行日志」对应消息 ID 的最后一行。
❓ “?”“问号”或表情为什么不会再误撤回
2.0.18 已加入确定性安全旁路:纯标点、纯 Emoji 和常见无害短回复不进入无意义的全量审核。即使其他消息进入 AI,Review 也只会延迟复核,不会直接执行处罚。
🖥️ 六、控制台问题
❓ 改了配置不生效
99%是没点保存。 所有页面改完必须点保存按钮;底部状态栏会显示未保存数量。
❓ 窗口显示不全 / 太小
窗口支持自由拉伸和最大化,页面内容自适应铺满
任何分辨率和系统缩放下都会完整显示
❓ 页面被缩放搞乱了
Ctrl/Alt+滚轮缩放已被禁用,若仍异常重启控制台即可。
❓ 顶部机器人信息显示"未登录机器人"
UniQQ 里没有登录中的QQ账号,先登录机器人QQ。
🔁 七、更新问题
❓ 检测更新显示有新版,但一键更新后没变化
更新包下载后需重载插件生效;若插件自动重载失败,手动关闭 UniQQ → 清理
Data\PluginRuntime→ 重启确认新包 SHA256 与公告一致(下载损坏会校验失败,重试即可)
❓ 检查更新弹窗太多打扰
自动检查是静默模式:无更新零打扰,有新版只亮铃铛 🔔
只有点击「检查更新」按钮才弹结果窗
可在设置弹窗「外观」里关闭自动检查
🆘 八、还是没解决?
📖 完整文档站:https://blog.zxiaolin.com/docs
🧭 指令大全:https://blog.zxiaolin.com/docs/share/vbxjUEhajFVj?docSlug=DOC20260922174002388475
👥 官方群:327942687(提问请附:插件版本、控制台日志截图、复现步骤)
🌐 作者博客:https://blog.zxiaolin.com
💡 提问模板:
插件版本(运行状态里看)
做了什么操作
期望结果 vs 实际结果
控制台首页日志相关截图