常见问题FAQ
本篇汇总 ZL-资料卡插件的高频问题与解答,按「指令响应、资料显示、卡片外观」分类排列,遇到异常时建议先从这里查起。
📭 指令与响应
发送「资料卡」没有反应
依次检查以下项目:
- 插件是否已经启用;
- 当前群是否在「群组范围」中开启;
- 指令是否仍在触发指令列表中;
- 机器人是否能够正常接收群消息;
- UniQQ 日志中是否有插件异常。
图片为什么没有引用我的消息
这是正常设计。资料卡图片使用直接发送方式,避免聊天界面出现大块引用内容。
群列表为空
- 确认至少有一个机器人账号在线;
- 确认机器人已经加入 QQ 群;
- 点击「刷新群列表」;
- 重新打开插件设置;
- 查看 UniQQ 是否能够正常调用群列表接口。
提示冷却中
冷却时间按「群号 + 发起查询的用户」计算,同一个人在冷却时间内重复调用会收到剩余等待秒数提示。等待倒计时结束再发送即可,也可由管理在「基础设置 → 触发冷却」中调整时长。
新加入的群没有反应
选择「仅开启所选群」策略时,新加入的群默认关闭,需要进入「群组范围」手动开启;「默认全部开启」策略下新群默认开启。群列表未显示新群时,先点击「刷新群列表」。
👤 资料显示
昵称显示成 QQ 号
通常表示协议端没有返回昵称。插件已经设置多级回退,但所有昵称来源都为空时只能显示 QQ 号。回退规则见资料字段与数据来源。
QQ 等级不正确
确认看到的是个人 QQ 等级还是群活跃等级。插件优先读取个人 qqLevel,接口不返回时才使用群等级或本地备用等级。
不显示等级图标
- 确认「等级」和「QQ 等级图标」均已开启;
- 重新安装完整插件包,避免
Assets/qq-level资源缺失; - 查看安装包是否被安全软件拦截或解压不完整。
不显示性别或个性签名
用户可能在 QQ 中隐藏了信息,或者当前协议端没有返回对应字段。此时插件会显示未知性别或备用签名。
本月发言数很少
插件只统计启用后收到的消息,不会扫描安装前的历史聊天记录。
🖼️ 卡片外观
头像与背景仍有明显边界
- 确认安装的是正式完整安装包;
- 停用旧插件后再安装并启用新版;
- 等待成品图片缓存失效;
- 如果头像图片本身带有白色圆形边缘,该白色区域属于用户头像内容,插件无法恢复被裁掉的原图部分。
可以关闭某个字段吗
可以。在「卡片外观」中关闭对应字段,再点击「保存并生效」。全部字段开关见卡片外观与实时预览。
问题仍未解决
请转至故障排查按故障现象逐项处理,并了解联系作者前需要准备哪些信息。
📚 下一节:故障排查
