Skip to content

常见问题 FAQ ​

遇到问题先来本篇按类别排查,覆盖安装启动、授权绑定、AI 功能、官方机器人协作与各功能模块的高频疑问。

📦 安装与启动 ​

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

  • 确认插件包为 .uniqq 后缀,放入 UniQQ 的 Plugins 文件夹(不要手动解压);
  • 重启 UniQQ,在插件管理里手动启用。

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

电脑缺少 WebView2 运行时,到微软官网免费下载安装 WebView2 Runtime 后重新打开控制台。

❓ 装了新包还是旧行为 ​

插件有运行时缓存,按以下顺序处理:

  1. 彻底退出 UniQQ;
  2. 删除 UniQQ 目录下 Data\PluginRuntime 里的旧缓存;
  3. 重新打开 UniQQ。

WARNING

插件管理里「停用再启用」不能完全重载插件包,必须重启 UniQQ。

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

控制台右上角「设置 → 维护」查看版本号,或群里发 运行状态 查看。

🔑 授权与绑定 ​

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

按顺序检查:

  1. 群是否已授权?主人在群里发 授权本群;
  2. 群是否被关闭(关机)?发 开启本群 或在控制台「授权群组」开启;
  3. 发消息的是不是机器人自己的 QQ?机器人消息会被忽略(防循环);
  4. 你是否在黑名单里;
  5. 全局「插件总开关」是否开启。

❓ 未授权群里机器人只回复「未授权」 ​

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

❓ 拿不到绑定码 ​

  • 绑定码需在官方群 327942687 内发送「绑定码」触发;
  • 同一 QQ 24 小时内重复请求返回同一个码;
  • 绑定码 24 小时有效、一次性使用;
  • 实在拿不到可联系作者(blog.zxiaolin.com)。

❓ 显示「功能受限」/ 高级功能用不了 ​

  • 试用期 3 天结束未绑定 → 免费绑定官方群即可恢复;受限期间普通群友发 AI、点歌等消息机器人静默,主人可用但回复末尾带绑定提醒;
  • 机器人退出官方群超 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、阿里千问、DeepSeek),开启后问时效性问题时会自动联网,可用页面「测试联网」按钮验证。

❓ AI 聊天突然没回复 ​

上一次请求可能失败,失败会自动回滚冷却,等几秒重试即可;若持续失败,查看 AI 服务页「连通状态」的错误信息。DeepSeek 用户确认模型为 deepseek-chat,不要用 deepseek-reasoner(思考模型响应慢,易超时)。

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

  1. 需要 AI 服务已配置,且群已绑定(群聊总结属高级功能);
  2. 群里近期要有发言,缓冲不足会自动拉取历史(最多 100 条);
  3. 总结 是全群总结,总结@某人 才是定向总结;
  4. 机器人自己不纳入总结范围。

❓ AI 说能做但没做 ​

请先确认版本已升级到 2.1.1 及以上:Agent 必须真实调用工具才会报告完成,未调工具不会虚报结果。

❓ 问功能用法,AI 回答不对照 ​

2.1.1 新增知识库:AI 回答功能用法类问题前会强制检索知识库并按原文回答(内置 42 条知识,可自行扩充)。控制台「知识库」页可自建词条(支持全局 / 本群范围),群里问「知识库里有什么」可查看词条概览;统计每 30 秒自动刷新。

❓ 技能缩写怎么用 ​

群里直接发「技能缩写+内容」,如「互译晚上好」等同「中英互译 晚上好」;使用完整技能名时建议带上分隔符(空格 / # / : / :),识别更稳。

❓ 查数据 / 执行操作不执行了,只回一句引导 ​

2.1.5 起新设计:只有「Agent 智能助手」人设能调用插件全部工具与技能,其余四套是纯陪聊人设。两种解决方式任选:

  1. 切换人设(推荐):控制台「AI 中心 → 聊天女仆」把该群角色改成 Agent 智能助手;或主人 / 管理员在群里发 人设 Agent;
  2. 关闭限制:控制台「AI 中心 → Agent」页取消勾选「仅 Agent 智能助手人设可调用工具与技能」,恢复所有角色都能执行工具。

❓ 换了人设为什么语气还是差不多 ​

2.1.5 已改进:四套人设各自扩写为独立的行为描述与排版风格,切换人设时自动清空本群会话记忆。若仍觉得像,多半是自定义人设文本覆盖了内置默认——在控制台人设预设框点「恢复默认」即可。

❓ 让 Agent 添加问答,却没有真正加进去 ​

请确认:

  1. 当前群角色是 Agent 智能助手(陪聊人设会被拦成纯陪聊);
  2. 发言人有副主权限;
  3. 写法正确,两种方式任选:
    • 指令写法:添加问答+你好|你好呀~(带 |,可加 |精确);
    • Agent 口语:@机器人 帮我添加一个问答 用户问你好回答你好呀~(带「帮我」等口语词,落到 Agent 处理)。

配置类请求由插件直接识别并写库回执,不经过模型、不消耗额度。

❓ Agent 人设下查询 / 执行工具全没反应 ​

先发 AI状态 查看「Agent 引擎」一行(2.1.8 起展示)。若显示关闭,说明本群的 Agent 引擎开关没打开——角色只是说话方式,工具能力全挂在这个开关下。到控制台「AI 中心 → Agent」选择本群,打开「启用 Agent」即可。

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

2.2.9 起,群内技能必须先 @机器人,并且只认「技能全名或无歧义关键词 + 标准分隔符 + 内容」或由 Agent 根据明确任务匹配。未 @机器人、单个字和普通聊天都不会触发技能;若仍出现错误匹配,请把完整消息与机器人回复截图提交排查,并在控制台把该技能触发词调整得更长、更专属。

🤝 官方机器人协作 ​

❓ 为什么同一个群在官机里是一串很长的数字 ​

这是 QQ 官方机器人使用的虚拟群 ID,不是真实 QQ 群号。请在控制台「官方协作」把它绑定到真实群;授权、分群配置和群管动作仍以真实群号为准。

❓ 群组下拉框缺少一些官方群 ​

框架必须先收到该群的官方事件才能采集。在缺失的官方群里 @一次官方机器人或发送一条能触发它的消息,然后回到「官方协作」页点击刷新。

❓ 官机和普通机器人分别做什么 ​

  • 官机负责菜单、AI、问答、提示和执行结果等所有可见回复;
  • 普通机器人静默执行禁言、踢人、撤回、管理员、群名片等真实群动作;
  • 没有官机或官机发送失败时,普通机器人自动回退回复。

❓ 官机回复了「已禁言」,但成员没有被禁言 ​

  1. 普通机器人是否在线并在对应真实群;
  2. 普通机器人是否有群主 / 管理员权限;
  3. 官方虚拟群是否绑定到正确真实群;
  4. 目标成员虚拟 ID 是否已映射到真实 QQ;
  5. 查看运行日志中的执行机器人、真实群号和目标 QQ。

群管动作通常由普通机器人执行;只有官机时,仅会在官方接口支持该动作且映射均已确认时执行,条件不足会明确报告未执行。

❓ 为什么提示「本群没有找到该成员」 ​

官机提供的是成员虚拟 ID,执行动作需要真实 QQ。让目标成员在绑定群内发言或艾特机器人,系统会自动采集映射;仍无法识别时,在「官方协作 → 成员身份映射」手动绑定。

❓ @官机不回复,普通消息却回复 ​

确认艾特的是当前登录的官机,并升级到 2.1.4 及以上;再检查日志中的官方消息是否包含 at 段、群是否已绑定、AI / 问答功能是否开启。

❓ 为什么艾特别人也触发了 AI ​

2.1.4 已区分「艾特当前机器人」和「艾特其他成员」,升级后重启 UniQQ;若仍出现,检查是否有旧版插件实例仍在响应。

❓ 引用的文字或图片为什么 AI 看不到 ​

  • 引用后需要 @官机并写明问题;
  • 开启图片识别并配置视觉模型;
  • 闪照、失效图片或无法下载的链接不能识别;
  • 2.1.4 起会同时解析当前消息和引用消息。

❓ 为什么官机和普通机器人两边都回复 ​

  • 确认群绑定只有一条且指向正确真实群;
  • 确认没有两个 UniQQ 实例同时运行,所有实例都升级到同一版本;
  • 官机成功时普通机器人应静默,只有官机失败才会回退。

完整配置流程见「官方机器人协作教程」篇章。

🎵 点歌与其他功能 ​

❓ 点歌串台 / 显示错的平台来源 ​

  • 发 点歌状态 或换一首确认当前平台;
  • 确认 UniQQ 加载的是新版本;
  • 检查是否安装了其他音乐插件造成重复响应,卸载或停用它们。

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

  • 每日签到需在「分群配置 → 每日签到」开启;
  • 签到按群隔离记录,每个群独立排行。

❓ 定时任务不执行 / 任务消失了 ​

  1. 任务列表默认只显示当前分群的任务,先切到「全部任务」筛选查看所有群;
  2. 任务添加后立即自动保存,重启不会丢(2.0.6 起实时落盘);
  3. 看控制台运行日志搜索「定时任务跳过」,日志会写明原因:群未授权 / 未启用 / 不在配置 / 内容为空;
  4. 未绑定官方群或试用结束:AI 群聊总结类定时任务会被跳过,绑定后恢复;
  5. 表格里点「立即执行」失败时会提示具体原因;
  6. 检查任务开关与执行周期是否符合预期;
  7. 电脑睡眠错过的任务 30 分钟内会自动补跑,超过就不补;
  8. 「全部群」任务有幂等保护,多实例也不会重复发送。

❓ 违禁词触发但不撤回 ​

  • 检查策略:发 禁言词策略 撤回=开 警告=开 禁言=关 时间=60;
  • 白名单成员豁免检测;
  • 机器人需要群管理员权限才能撤回 / 禁言。

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

  1. 「群聊提示 → 新人进群提示」和「入群验证」都要开启对应开关;
  2. 开了验证码时不要同时开新人禁言(新人没法打字);
  3. 验证码通过后才会发进群提示,两个功能内容别重复配置。

❓ 回复「同意101」没反应 ​

好友申请审批代号曾与框架内置审批编号冲突,2.0.5 起改为 F 前缀格式:

  • 好友申请:回复「同意F101」/「拒绝F101 理由」;
  • 头衔申请:回复「同意头衔 101」/「拒绝头衔 101 理由」(头衔审核本身不带 F)。

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

  • 确认主人是否收到私聊审核通知,回复「同意头衔 代号」或「拒绝头衔 代号 理由」,发 头衔申请 可查待审列表;
  • 拒绝会全额退币并在群里 @申请者说明原因;
  • 设置失败会自动退款,不用担心金币白花。

❓ AI 审核不工作 ​

  1. 控制台「AI 服务」页是否已开启并配置 API Key 与接口地址(AI 审核复用该通道,无需开通云平台);
  2. 控制台「AI 审核」页点「测试连接」确认通道可用,看图审核需渠道支持多模态模型;
  3. 消息是否命中送审范围——普通模式只审核链接、裸域名、连续数字串、字母混合串、名片、导流词、图片;开启「全量语义审核」后审核所有有效消息,但纯标点、纯表情和无害短回复仍直接放行;
  4. 每日送审额度是否用完——达到上限自动暂停并私聊通知主人,次日 0 点恢复;
  5. AI 偶发失败会自动放行并记录日志,频繁失败请检查 AI 服务配置或网络;
  6. 到页面底部查看 AI 执行日志,可按消息 ID 查看完整审核过程。

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

出现以下任一情况都会放行:

  • 首次结果仅为 Review(疑似);
  • 风险严重度不足,或置信度低于默认 88% 阈值;
  • 处罚前二次确认返回 Pass / Review / 失败;
  • 当日额度不足,无法完成二次确认;
  • 撤回开关未开启,或机器人没有群管理员权限。

具体原因可在「内容安全 → AI 执行日志」按消息 ID 查看最后一行。

🖥️ 控制台问题 ​

问题解答
改了配置不生效绝大多数情况是没点保存,所有页面改完必须点保存按钮,底部状态栏会显示未保存数量
窗口显示不全 / 太小窗口支持自由拉伸和最大化,页面内容自适应铺满,任何分辨率与缩放下完整显示
页面被缩放搞乱了Ctrl / Alt + 滚轮缩放已被禁用,若仍异常重启控制台即可
顶部显示「未登录机器人」UniQQ 里没有登录中的 QQ 账号,先登录机器人 QQ

🔁 更新问题 ​

问题解答
检测到新版,一键更新后没变化更新包下载后需重载插件生效;若自动重载失败,手动关闭 UniQQ → 清理 Data\PluginRuntime → 重启;同时确认新包 SHA256 与公告一致,校验失败重试下载
检查更新弹窗太多打扰自动检查是静默模式:无更新零打扰,有新版只亮铃铛 🔔;只有点「检查更新」按钮才弹结果窗,可在设置「外观」里关闭自动检查

🆘 仍未解决 ​

  • 👥 官方群:327942687(提问请附:插件版本、控制台日志截图、复现步骤)
  • 🌐 作者博客:https://blog.zxiaolin.com

提问模板

  1. 插件版本(运行状态 里查看);
  2. 做了什么操作;
  3. 期望结果与实际结果;
  4. 控制台首页相关日志截图。

📚 下一节:文字转图片功能详解

薇薇官机平台 · ZL 系列插件