Skip to content

常见问题FAQ ​

本篇汇总 ZL-资料卡插件的高频问题与解答,按「指令响应、资料显示、卡片外观」分类排列,遇到异常时建议先从这里查起。

📭 指令与响应 ​

发送「资料卡」没有反应 ​

依次检查以下项目:

  1. 插件是否已经启用;
  2. 当前群是否在「群组范围」中开启;
  3. 指令是否仍在触发指令列表中;
  4. 机器人是否能够正常接收群消息;
  5. UniQQ 日志中是否有插件异常。

图片为什么没有引用我的消息 ​

这是正常设计。资料卡图片使用直接发送方式,避免聊天界面出现大块引用内容。

群列表为空 ​

  • 确认至少有一个机器人账号在线;
  • 确认机器人已经加入 QQ 群;
  • 点击「刷新群列表」;
  • 重新打开插件设置;
  • 查看 UniQQ 是否能够正常调用群列表接口。

提示冷却中 ​

冷却时间按「群号 + 发起查询的用户」计算,同一个人在冷却时间内重复调用会收到剩余等待秒数提示。等待倒计时结束再发送即可,也可由管理在「基础设置 → 触发冷却」中调整时长。

新加入的群没有反应 ​

选择「仅开启所选群」策略时,新加入的群默认关闭,需要进入「群组范围」手动开启;「默认全部开启」策略下新群默认开启。群列表未显示新群时,先点击「刷新群列表」。

👤 资料显示 ​

昵称显示成 QQ 号 ​

通常表示协议端没有返回昵称。插件已经设置多级回退,但所有昵称来源都为空时只能显示 QQ 号。回退规则见资料字段与数据来源。

QQ 等级不正确 ​

确认看到的是个人 QQ 等级还是群活跃等级。插件优先读取个人 qqLevel,接口不返回时才使用群等级或本地备用等级。

不显示等级图标 ​

  • 确认「等级」和「QQ 等级图标」均已开启;
  • 重新安装完整插件包,避免 Assets/qq-level 资源缺失;
  • 查看安装包是否被安全软件拦截或解压不完整。

不显示性别或个性签名 ​

用户可能在 QQ 中隐藏了信息,或者当前协议端没有返回对应字段。此时插件会显示未知性别或备用签名。

本月发言数很少 ​

插件只统计启用后收到的消息,不会扫描安装前的历史聊天记录。

🖼️ 卡片外观 ​

头像与背景仍有明显边界 ​

  • 确认安装的是正式完整安装包;
  • 停用旧插件后再安装并启用新版;
  • 等待成品图片缓存失效;
  • 如果头像图片本身带有白色圆形边缘,该白色区域属于用户头像内容,插件无法恢复被裁掉的原图部分。

可以关闭某个字段吗 ​

可以。在「卡片外观」中关闭对应字段,再点击「保存并生效」。全部字段开关见卡片外观与实时预览。

问题仍未解决

请转至故障排查按故障现象逐项处理,并了解联系作者前需要准备哪些信息。


📚 下一节:故障排查

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