08 · 常见问题 FAQ
按现象排查。改过配置后记得点"保存配置"。
🚫 机器人不响应指令
| 现象 | 排查步骤 |
|---|
| 所有群都不响应 | ① 插件是否启用 ② 玩法是否全部正常 ③ 指令开关是否被停用 ④ 重启 UniQQ 后再试 |
| 某个群不响应 | ① 分群配置该群总开关是否关闭 ② 是否在黑名单 ③ 白名单模式下群号是否在启用列表 ④ 模块开关是否被关 |
| 某条指令不响应 | ① 指令菜单页该指令是否被停用 ② 触发词是否打对(可用别名试) ③ 是否与综合插件触发词冲突(本插件"菜单"已移除,用"老婆菜单") |
| 被抽不中某人 | ① 是否在活跃窗口天数内发过言 ② 是否被加入全局 / 本群排除用户 |
| 多机器人时某个号不响应 | 玩法配置「机器人接管」名单没包含它:留空(接管所有)或补上该机器人 QQ |
🤖 多机器人场景
| 现象 | 原因与解决 |
|---|
| 两个机器人同时回复同一条指令 | 同一框架登录了多个机器人且都没绑接管名单。只在要玩老婆插件的实例里填「机器人接管」QQ,另一个实例清空绑定或在 UniQQ 停用本插件 |
| 周播报重复发送 / 用错号发送 | 多实例各自跑了定时器。绑定接管名单后,周播报只用名单内第一个机器人发送(0.0.5+) |
| 想换个机器人号来玩 | 玩法配置页「机器人接管」改成新号保存即可,立即生效 |
💬 回复内容异常
| 现象 | 原因与解决 |
|---|
| 回复中出现一长串 JSON 代码 | 超长消息拆分保护已内置(0.0.3+);若仍出现,请更新到最新版 |
| 想要不引用消息 | 玩法配置页关闭"引用回复"(默认关闭,回复时 @ 发送者) |
| 播报里变量没替换 | 变量名写错,对照模板下方变量卡片原样修改 |
| 回复没有 @ 对方 | 确认版本 ≥ 0.0.2(全动作 @ 对方为 0.0.2 新增) |
🖼️ 图片问题
| 现象 | 排查 |
|---|
| 榜单图 / 关系图发不出来 | 插件自动回退文字版;检查磁盘可写空间与数据目录权限 |
| 结婚证书图没有生成 | 结婚播报正常但证书缺失时,重试一次;持续失败查看运行日志 |
| 图片报错但文字正常 | 图片渲染依赖系统字体,确认服务器未精简中文字体 |
⚙️ 配置问题
| 现象 | 排查 |
|---|
| 修改配置不生效 | 是否点了右上角"保存配置";分群覆盖会覆盖全局值(留空=跟随全局) |
| 求婚总是提示好感不够 | 求婚门槛 > 好感上限所致,调低门槛或调高上限 |
| 抢夺永远失败 | 基础成功率被调太低或好感修正过大,检查抢夺配置 |
| 每天都提示次数用完 | 每日限次按自然日计算,次日自动恢复;管理员可用重置类指令应急 |
🖥️ 控制台问题
| 现象 | 排查 |
|---|
| 控制台空白 / 加载失败 | 安装 Microsoft Edge WebView2 Runtime;使用完整插件包 |
| 保存后重开配置丢失 | 确认点的是"保存配置"且提示成功;检查数据目录是否有写权限 |
| 检查更新失败 | 网络 / DNS 问题;手动下载最新 .uniqq 包覆盖安装 |
🔄 更新问题
| 现象 | 排查 |
|---|
| 一键更新卡住 | 更新包被占用时插件会自动重试;仍失败则完全关闭 UniQQ 后重试 |
| 提示 SHA256 校验失败 | 下载不完整或服务器包与 update.json 不匹配,重新上传正确的包 |
| 提示"更新版本不高于当前版本" | 服务器 latestVersion 未更新,先更新服务器 update.json |
💡 仍无法解决?加入官方交流群 327942687 反馈(控制台"关于"页可一键加群)。