常见问题 FAQ
遇到问题先来本篇按类别排查,覆盖安装启动、授权绑定、AI 功能、官方机器人协作与各功能模块的高频疑问。
📦 安装与启动
❓ 双击插件包没反应 / UniQQ 里看不到插件
- 确认插件包为
.uniqq后缀,放入 UniQQ 的 Plugins 文件夹(不要手动解压); - 重启 UniQQ,在插件管理里手动启用。
❓ 打开控制台报错 Unable to load DLL 'WebView2Loader.dll'
电脑缺少 WebView2 运行时,到微软官网免费下载安装 WebView2 Runtime 后重新打开控制台。
❓ 装了新包还是旧行为
插件有运行时缓存,按以下顺序处理:
- 彻底退出 UniQQ;
- 删除 UniQQ 目录下
Data\PluginRuntime里的旧缓存; - 重新打开 UniQQ。
WARNING
插件管理里「停用再启用」不能完全重载插件包,必须重启 UniQQ。
❓ 如何确认当前加载的版本
控制台右上角「设置 → 维护」查看版本号,或群里发 运行状态 查看。
🔑 授权与绑定
❓ 机器人在我的群完全不说话
按顺序检查:
- 群是否已授权?主人在群里发
授权本群; - 群是否被关闭(关机)?发
开启本群或在控制台「授权群组」开启; - 发消息的是不是机器人自己的 QQ?机器人消息会被忽略(防循环);
- 你是否在黑名单里;
- 全局「插件总开关」是否开启。
❓ 未授权群里机器人只回复「未授权」
这是正常设计,主人发 授权本群 即可;不希望回复任何内容,可在全局配置里清空「未授权提示」。
❓ 拿不到绑定码
- 绑定码需在官方群 327942687 内发送「绑定码」触发;
- 同一 QQ 24 小时内重复请求返回同一个码;
- 绑定码 24 小时有效、一次性使用;
- 实在拿不到可联系作者(blog.zxiaolin.com)。
❓ 显示「功能受限」/ 高级功能用不了
- 试用期 3 天结束未绑定 → 免费绑定官方群即可恢复;受限期间普通群友发 AI、点歌等消息机器人静默,主人可用但回复末尾带绑定提醒;
- 机器人退出官方群超 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、阿里千问、DeepSeek),开启后问时效性问题时会自动联网,可用页面「测试联网」按钮验证。
❓ AI 聊天突然没回复
上一次请求可能失败,失败会自动回滚冷却,等几秒重试即可;若持续失败,查看 AI 服务页「连通状态」的错误信息。DeepSeek 用户确认模型为 deepseek-chat,不要用 deepseek-reasoner(思考模型响应慢,易超时)。
❓ 总结指令没反应 / 说没有发言记录
- 需要 AI 服务已配置,且群已绑定(群聊总结属高级功能);
- 群里近期要有发言,缓冲不足会自动拉取历史(最多 100 条);
总结是全群总结,总结@某人才是定向总结;- 机器人自己不纳入总结范围。
❓ AI 说能做但没做
请先确认版本已升级到 2.1.1 及以上:Agent 必须真实调用工具才会报告完成,未调工具不会虚报结果。
❓ 问功能用法,AI 回答不对照
2.1.1 新增知识库:AI 回答功能用法类问题前会强制检索知识库并按原文回答(内置 42 条知识,可自行扩充)。控制台「知识库」页可自建词条(支持全局 / 本群范围),群里问「知识库里有什么」可查看词条概览;统计每 30 秒自动刷新。
❓ 技能缩写怎么用
群里直接发「技能缩写+内容」,如「互译晚上好」等同「中英互译 晚上好」;使用完整技能名时建议带上分隔符(空格 / # / : / :),识别更稳。
❓ 查数据 / 执行操作不执行了,只回一句引导
2.1.5 起新设计:只有「Agent 智能助手」人设能调用插件全部工具与技能,其余四套是纯陪聊人设。两种解决方式任选:
- 切换人设(推荐):控制台「AI 中心 → 聊天女仆」把该群角色改成
Agent 智能助手;或主人 / 管理员在群里发人设 Agent; - 关闭限制:控制台「AI 中心 → Agent」页取消勾选「仅 Agent 智能助手人设可调用工具与技能」,恢复所有角色都能执行工具。
❓ 换了人设为什么语气还是差不多
2.1.5 已改进:四套人设各自扩写为独立的行为描述与排版风格,切换人设时自动清空本群会话记忆。若仍觉得像,多半是自定义人设文本覆盖了内置默认——在控制台人设预设框点「恢复默认」即可。
❓ 让 Agent 添加问答,却没有真正加进去
请确认:
- 当前群角色是 Agent 智能助手(陪聊人设会被拦成纯陪聊);
- 发言人有副主权限;
- 写法正确,两种方式任选:
- 指令写法:
添加问答+你好|你好呀~(带|,可加|精确); - Agent 口语:
@机器人 帮我添加一个问答 用户问你好回答你好呀~(带「帮我」等口语词,落到 Agent 处理)。
- 指令写法:
配置类请求由插件直接识别并写库回执,不经过模型、不消耗额度。
❓ Agent 人设下查询 / 执行工具全没反应
先发 AI状态 查看「Agent 引擎」一行(2.1.8 起展示)。若显示关闭,说明本群的 Agent 引擎开关没打开——角色只是说话方式,工具能力全挂在这个开关下。到控制台「AI 中心 → Agent」选择本群,打开「启用 Agent」即可。
❓ AI 技能会不会误触发普通聊天
2.2.9 起,群内技能必须先 @机器人,并且只认「技能全名或无歧义关键词 + 标准分隔符 + 内容」或由 Agent 根据明确任务匹配。未 @机器人、单个字和普通聊天都不会触发技能;若仍出现错误匹配,请把完整消息与机器人回复截图提交排查,并在控制台把该技能触发词调整得更长、更专属。
🤝 官方机器人协作
❓ 为什么同一个群在官机里是一串很长的数字
这是 QQ 官方机器人使用的虚拟群 ID,不是真实 QQ 群号。请在控制台「官方协作」把它绑定到真实群;授权、分群配置和群管动作仍以真实群号为准。
❓ 群组下拉框缺少一些官方群
框架必须先收到该群的官方事件才能采集。在缺失的官方群里 @一次官方机器人或发送一条能触发它的消息,然后回到「官方协作」页点击刷新。
❓ 官机和普通机器人分别做什么
- 官机负责菜单、AI、问答、提示和执行结果等所有可见回复;
- 普通机器人静默执行禁言、踢人、撤回、管理员、群名片等真实群动作;
- 没有官机或官机发送失败时,普通机器人自动回退回复。
❓ 官机回复了「已禁言」,但成员没有被禁言
- 普通机器人是否在线并在对应真实群;
- 普通机器人是否有群主 / 管理员权限;
- 官方虚拟群是否绑定到正确真实群;
- 目标成员虚拟 ID 是否已映射到真实 QQ;
- 查看运行日志中的执行机器人、真实群号和目标 QQ。
群管动作通常由普通机器人执行;只有官机时,仅会在官方接口支持该动作且映射均已确认时执行,条件不足会明确报告未执行。
❓ 为什么提示「本群没有找到该成员」
官机提供的是成员虚拟 ID,执行动作需要真实 QQ。让目标成员在绑定群内发言或艾特机器人,系统会自动采集映射;仍无法识别时,在「官方协作 → 成员身份映射」手动绑定。
❓ @官机不回复,普通消息却回复
确认艾特的是当前登录的官机,并升级到 2.1.4 及以上;再检查日志中的官方消息是否包含 at 段、群是否已绑定、AI / 问答功能是否开启。
❓ 为什么艾特别人也触发了 AI
2.1.4 已区分「艾特当前机器人」和「艾特其他成员」,升级后重启 UniQQ;若仍出现,检查是否有旧版插件实例仍在响应。
❓ 引用的文字或图片为什么 AI 看不到
- 引用后需要 @官机并写明问题;
- 开启图片识别并配置视觉模型;
- 闪照、失效图片或无法下载的链接不能识别;
- 2.1.4 起会同时解析当前消息和引用消息。
❓ 为什么官机和普通机器人两边都回复
- 确认群绑定只有一条且指向正确真实群;
- 确认没有两个 UniQQ 实例同时运行,所有实例都升级到同一版本;
- 官机成功时普通机器人应静默,只有官机失败才会回退。
完整配置流程见「官方机器人协作教程」篇章。
🎵 点歌与其他功能
❓ 点歌串台 / 显示错的平台来源
- 发
点歌状态或换一首确认当前平台; - 确认 UniQQ 加载的是新版本;
- 检查是否安装了其他音乐插件造成重复响应,卸载或停用它们。
❓ 签到了金币没变 / 排行看不到自己
- 每日签到需在「分群配置 → 每日签到」开启;
- 签到按群隔离记录,每个群独立排行。
❓ 定时任务不执行 / 任务消失了
- 任务列表默认只显示当前分群的任务,先切到「全部任务」筛选查看所有群;
- 任务添加后立即自动保存,重启不会丢(2.0.6 起实时落盘);
- 看控制台运行日志搜索「定时任务跳过」,日志会写明原因:群未授权 / 未启用 / 不在配置 / 内容为空;
- 未绑定官方群或试用结束:AI 群聊总结类定时任务会被跳过,绑定后恢复;
- 表格里点「立即执行」失败时会提示具体原因;
- 检查任务开关与执行周期是否符合预期;
- 电脑睡眠错过的任务 30 分钟内会自动补跑,超过就不补;
- 「全部群」任务有幂等保护,多实例也不会重复发送。
❓ 违禁词触发但不撤回
- 检查策略:发
禁言词策略 撤回=开 警告=开 禁言=关 时间=60; - 白名单成员豁免检测;
- 机器人需要群管理员权限才能撤回 / 禁言。
❓ 新人进群没欢迎 / 验证码流程卡住
- 「群聊提示 → 新人进群提示」和「入群验证」都要开启对应开关;
- 开了验证码时不要同时开新人禁言(新人没法打字);
- 验证码通过后才会发进群提示,两个功能内容别重复配置。
❓ 回复「同意101」没反应
好友申请审批代号曾与框架内置审批编号冲突,2.0.5 起改为 F 前缀格式:
- 好友申请:回复「同意F101」/「拒绝F101 理由」;
- 头衔申请:回复「同意头衔 101」/「拒绝头衔 101 理由」(头衔审核本身不带 F)。
❓ 头衔申请后没动静 / 金币问题
- 确认主人是否收到私聊审核通知,回复「同意头衔 代号」或「拒绝头衔 代号 理由」,发
头衔申请可查待审列表; - 拒绝会全额退币并在群里 @申请者说明原因;
- 设置失败会自动退款,不用担心金币白花。
❓ AI 审核不工作
- 控制台「AI 服务」页是否已开启并配置 API Key 与接口地址(AI 审核复用该通道,无需开通云平台);
- 控制台「AI 审核」页点「测试连接」确认通道可用,看图审核需渠道支持多模态模型;
- 消息是否命中送审范围——普通模式只审核链接、裸域名、连续数字串、字母混合串、名片、导流词、图片;开启「全量语义审核」后审核所有有效消息,但纯标点、纯表情和无害短回复仍直接放行;
- 每日送审额度是否用完——达到上限自动暂停并私聊通知主人,次日 0 点恢复;
- AI 偶发失败会自动放行并记录日志,频繁失败请检查 AI 服务配置或网络;
- 到页面底部查看 AI 执行日志,可按消息 ID 查看完整审核过程。
❓ 为什么 AI 判了违规却没有撤回
出现以下任一情况都会放行:
- 首次结果仅为 Review(疑似);
- 风险严重度不足,或置信度低于默认 88% 阈值;
- 处罚前二次确认返回 Pass / Review / 失败;
- 当日额度不足,无法完成二次确认;
- 撤回开关未开启,或机器人没有群管理员权限。
具体原因可在「内容安全 → AI 执行日志」按消息 ID 查看最后一行。
🖥️ 控制台问题
| 问题 | 解答 |
|---|---|
| 改了配置不生效 | 绝大多数情况是没点保存,所有页面改完必须点保存按钮,底部状态栏会显示未保存数量 |
| 窗口显示不全 / 太小 | 窗口支持自由拉伸和最大化,页面内容自适应铺满,任何分辨率与缩放下完整显示 |
| 页面被缩放搞乱了 | Ctrl / Alt + 滚轮缩放已被禁用,若仍异常重启控制台即可 |
| 顶部显示「未登录机器人」 | UniQQ 里没有登录中的 QQ 账号,先登录机器人 QQ |
🔁 更新问题
| 问题 | 解答 |
|---|---|
| 检测到新版,一键更新后没变化 | 更新包下载后需重载插件生效;若自动重载失败,手动关闭 UniQQ → 清理 Data\PluginRuntime → 重启;同时确认新包 SHA256 与公告一致,校验失败重试下载 |
| 检查更新弹窗太多打扰 | 自动检查是静默模式:无更新零打扰,有新版只亮铃铛 🔔;只有点「检查更新」按钮才弹结果窗,可在设置「外观」里关闭自动检查 |
🆘 仍未解决
- 👥 官方群:327942687(提问请附:插件版本、控制台日志截图、复现步骤)
- 🌐 作者博客:https://blog.zxiaolin.com
提问模板
- 插件版本(
运行状态里查看); - 做了什么操作;
- 期望结果与实际结果;
- 控制台首页相关日志截图。
📚 下一节:文字转图片功能详解
