07 · 常见问题 FAQ

适用版本:ZL-综合插件 2.1.2(2026-10-08 校准) 遇到问题先来这里找答案,按类别排查。


📦 一、安装与启动

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

  • 确认包是 .uniqq 后缀,放到 UniQQ 的 Plugins 文件夹(不是手动解压)

  • 重启 UniQQ,在插件管理里手动启用

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

  • 你的电脑缺少 WebView2 运行时

  • 解决:安装 WebView2 Runtime(微软官网免费下载)后重新打开控制台

❓ 装了新包还是旧行为

插件有运行时缓存,按这个顺序处理:

  1. 关闭 UniQQ(彻底退出)

  2. 删除 UniQQ 目录下 Data\PluginRuntime 里的旧缓存

  3. 重新打开 UniQQ

⚠️ 注意:插件管理里"停用再启用"不能完全重载包,必须重启 UniQQ。

❓ 如何确认当前加载的版本

  • 控制台右上角「设置」→「维护」看版本号

  • 群里发 运行状态 也能看版本


🔑 二、授权与绑定

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

按顺序检查:

  1. 群是否已授权?→ 主人在群里发 授权本群

  2. 群是否被关闭(关机)?→ 发 开启本群 或控制台「授权群组」开启

  3. 发消息的是不是机器人自己的QQ?机器人消息会被忽略(防循环)

  4. 你是否在黑名单里?

  5. 全局「插件总开关」是否开启?

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

这是正常设计。主人发 授权本群 即可;不希望它回复任何内容可以在全局配置里清空"未授权提示"。

❓ 绑定码发到官方群没人回 / 拿不到绑定码

  • 绑定码需要在官方群 327942687 内发送「绑定码」触发

  • 同一QQ 24小时内重复请求返回同一个码

  • 绑定码24小时有效、一次性使用

  • 实在拿不到 → 联系作者(blog.zxiaolin.com)

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

  • 试用7天结束未绑定 → 免费绑定官方群即可恢复

  • 机器人退出官方群超48小时 → 回群 + 等待心跳同步(最长6小时,打开控制台立即同步)


🤖 三、AI 功能

❓ @机器人没反应

  1. 控制台「AI服务」页是否启用AI服务

  2. API地址和 API Key 是否已填并保存

  3. 本群「AI辅助」是否被关闭?→ 群里发 开启AI辅助

  4. 是否处于冷却期(默认15秒)?冷却内静默忽略

  5. 当天额度是否用完(默认50次/人)

  6. 未绑定且试用结束 → AI受限

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

API Key 没填或没保存。去控制台「AI服务」页填好 → 点保存 → 用页面上的「测试连接」验证。

❓ 图片识别没反应 / 提示识别不了

  1. 必须发图 + @机器人(纯发图不@不响应)

  2. 视觉模型未配置 → AI服务页填视觉模型(推荐 glm-4v-flash,免费)

  3. 闪照/本地缓存图拿不到链接 → 识别不了,属正常限制

  4. 超8MB大图会拒绝处理

  5. 确认"图片识别"开关开着(默认开)

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

  • 在AI服务页开启「联网搜索」(支持智谱GLM、阿里千问)

  • 开启后问时效性问题时AI会自动联网

  • 用页面「测试联网」按钮验证

❓ AI聊天突然没回复,立刻再发也没用

  • 上一次请求可能失败,失败会自动回滚冷却,等几秒重试即可

  • 若持续失败,看AI服务页「连通状态」的错误信息(超80字会截断显示)

  • DeepSeek 用户:确认模型是 deepseek-chat,不要用 deepseek-reasoner(响应慢易超时)

❓ 总结指令没反应 / 说没有发言记录

  1. 需要 AI 服务已配置

  2. 群里近期要有发言(缓冲不足会自动拉历史,最多100条)

  3. 总结 是全群总结;总结@某人 才是定向总结,别混用

  4. 机器人自己不纳入总结范围

❓ 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、问答、提示和执行结果等所有可见回复。

  • 普通机器人静默执行禁言、踢人、撤回、管理员、群名片等真实群动作。

  • 没有官机或官机发送失败时,普通机器人自动回退回复。

❓ 官机回复了“已禁言”,但成员没有被禁言

  1. 普通机器人是否在线并在对应真实群。

  2. 普通机器人是否有群主/管理员权限。

  3. 官方虚拟群是否绑定到正确真实群。

  4. 目标成员虚拟 ID 是否已映射到真实 QQ。

  5. 查看运行日志中的执行机器人、真实群号和目标 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)

  • 检查是否安装了其他音乐插件造成重复响应(卸载或停用它们)

❓ 签到了金币没变 / 排行看不到自己

  • 每日签到需在「分群配置→每日签到」开启

  • 签到按群隔离记录,每个群独立排行

❓ 定时任务不执行 / 任务消失了怎么办

  1. 任务列表默认只显示当前分群的任务——以为"任务消失了"时,先切到「全部任务」筛选,就能看到所有群的任务

  2. 任务添加后立即自动保存,重启不会丢(2.0.6 起添加/修改/删除/开关切换都实时落盘)

  3. 看控制台运行日志,搜索「定时任务跳过」,日志会写明原因:群未授权 未启用 不在配置 / 内容为空

  4. 未绑定官方群或试用结束:AI 群聊总结类定时任务会被跳过(高级功能限制,绑定后恢复)

  5. 表格里点「立即执行」失败时会提示具体原因,按提示排查即可

  6. 任务是否启用(开关打开)、执行周期是否符合预期(每天/工作日/每周几/每月N日)

  7. 电脑睡眠错过的任务:30分钟内会自动补跑,超过就不补

  8. "全部群"任务有幂等保护,插件多实例也不会重复发(这是特性不是bug)

❓ 违禁词触发但不撤回

  • 检查策略:发 禁言词策略 撤回=开 警告=开 禁言=关 时间=60

  • 白名单成员豁免检测

  • 机器人需要群管理员权限才能撤回/禁言

❓ 新人进群没欢迎 / 验证码流程卡住

  1. 「群聊提示→新人进群提示」和「入群验证」都要开启对应开关

  2. 开了验证码时不要同时开新人禁言(新人没法打字)

  3. 验证码通过后才会发进群提示,两个功能内容别重复配置

❓ 回复「同意101」没反应 / 提示没有待批项

好友申请的审批代号(101、102…递增)曾与框架内置审批编号冲突,纯数字回复可能被框架截走。

2.0.5 起好友申请审批代号已改为 F 前缀格式,请按私聊通知里给出的代号回复:

  • 好友申请:回复「同意F101」/「拒绝F101 理由」

  • 头衔申请:回复「同意头衔 101」/「拒绝头衔 101 理由」(头衔审核本身就是这个格式,不带 F)

💡 好友审批老格式「同意101」可能没反应或提示没有待批项,加上 F 前缀就好了。

❓ 头衔申请后没动静 / 金币问题

  • 申请后没动静 → 确认主人是否收到私聊审核通知,回复「同意头衔 代号」或「拒绝头衔 代号 理由」(发「头衔申请」可查待审列表)

  • 审核拒绝会全额退币,并在群里 @申请者 说明原因

  • 头衔设置失败会自动退款,不用担心金币白花

❓ AI 审核(原内容安全/鉴黄)不工作

  1. 控制台「AI 服务」页是否已开启并配置 API Key 与接口地址(AI 审核复用该通道,无需开通任何云平台)

  2. 控制台「AI 审核」页点「测试连接」确认 AI 精判通道可用;看图审核需渠道支持多模态模型

  3. 消息是否命中送审范围——普通模式只审核链接/裸域名/连续数字串/字母混合串/名片/导流词/图片;开启「全量语义审核」后会审核所有有效消息,但纯标点、纯表情和无害短回复仍会直接放行

  4. 每日送审额度是否用完——达到上限自动暂停并私聊通知主人,次日 0 点恢复;每分钟超限的当条消息直接放行

  5. AI 偶发失败会自动放行并记日志(保证群聊可用性),频繁失败请检查 AI 服务配置或网络

  6. 到页面底部查看 AI 执行日志:按消息 ID 查看候选送审、首次精判、二次确认、延迟复核和策略执行的完整过程

❓ 为什么 AI 判了违规却没有撤回

2.0.18 不再把模型的一次回答直接当处罚命令,出现以下任一情况都会放行:

  • 首次结果只是 Review(疑似)

  • 风险严重度不足,或置信度低于默认 88% 阈值

  • 处罚前第二次确认返回 Pass Review 失败

  • 今日额度不足,无法完成二次确认

  • 撤回开关未开启,或者机器人没有群管理员权限

具体原因请查看「内容安全 → AI 执行日志」对应消息 ID 的最后一行。

❓ “?”“问号”或表情为什么不会再误撤回

2.0.18 已加入确定性安全旁路:纯标点、纯 Emoji 和常见无害短回复不进入无意义的全量审核。即使其他消息进入 AI,Review 也只会延迟复核,不会直接执行处罚。


🖥️ 六、控制台问题

❓ 改了配置不生效

99%是没点保存。 所有页面改完必须点保存按钮;底部状态栏会显示未保存数量。

❓ 窗口显示不全 / 太小

  • 窗口支持自由拉伸和最大化,页面内容自适应铺满

  • 任何分辨率和系统缩放下都会完整显示

❓ 页面被缩放搞乱了

Ctrl/Alt+滚轮缩放已被禁用,若仍异常重启控制台即可。

❓ 顶部机器人信息显示"未登录机器人"

UniQQ 里没有登录中的QQ账号,先登录机器人QQ。


🔁 七、更新问题

❓ 检测更新显示有新版,但一键更新后没变化

  1. 更新包下载后需重载插件生效;若插件自动重载失败,手动关闭 UniQQ → 清理 Data\PluginRuntime → 重启

  2. 确认新包 SHA256 与公告一致(下载损坏会校验失败,重试即可)

❓ 检查更新弹窗太多打扰

  • 自动检查是静默模式:无更新零打扰,有新版只亮铃铛 🔔

  • 只有点击「检查更新」按钮才弹结果窗

  • 可在设置弹窗「外观」里关闭自动检查


🆘 八、还是没解决?

💡 提问模板:

  1. 插件版本(运行状态里看)

  2. 做了什么操作

  3. 期望结果 vs 实际结果

  4. 控制台首页日志相关截图

共 27 篇 ZL-综合插件知识库 / 常见问题 FAQ 0 字 0 行 zhangxiaolin
创建 2026-09-22T09:40:44.708692534Z 更新 2026-10-07T19:22:20.798176173Z