常见问题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 反馈,控制台「关于」页可一键加群。
📚 下一节:更新记录
