Skip to content

目录与快速上手 ​

本篇是 ZL-资料卡插件的总览入口:一分钟完成安装与启用,认识常用指令,并按目录快速定位所需篇章。

📌 插件信息 ​

ZL-资料卡插件是运行于 UniQQ 平台的群资料卡生成插件:群成员发送一句指令,机器人即在本地渲染一张融合 QQ 资料、群身份与活跃数据的专属图片卡片。

项目信息
安装包XiaoLin.ZLProfileCard.uniqq
作者小林&薇薇
作者 QQ939921104
官方群327942687
官网https://blog.zxiaolin.com

✨ 核心能力一览 ​

能力说明
群资料卡查询查询自己、@群友或按 QQ 号查询,图片直接发送、不引用触发消息
个人名片卡一条指令生成含头像、昵称、等级与联系方式的个人名片
真实资料读取读取 QQ 昵称、性别、个性签名与个人 QQ 等级,并展示群名片、群身份与群专属头衔
等级图标展示使用星星、月亮、太阳、皇冠 PNG 图标换算展示 QQ 等级
多套模板群资料卡内置九套模板,个人名片卡提供四款专属模板,支持成员个人切换样式
活跃数据统计自动统计累计发言、当月发言、活跃天数与最后发言时间
可视化控制台基础设置、卡片外观、群组范围等页面实时预览,保存即生效
本地渲染图片全部由插件本地绘制,不调用 AI 生图接口,不产生 AI 接口费用

⚡ 一分钟快速上手 ​

  1. 在 UniQQ 插件管理中导入 XiaoLin.ZLProfileCard.uniqq;
  2. 启用「ZL-资料卡插件」;
  3. 打开插件设置,进入「群组范围」;
  4. 点击「刷新群列表」,确认机器人已加入的群已经显示;
  5. 选择「默认全部开启」,或选择「仅开启所选群」并打开需要使用的群;
  6. 点击右上角「保存并生效」;
  7. 在已启用的群内发送 资料卡。

机器人应直接发送一张 PNG 图片,不会引用触发消息。

上手顺序建议

首次部署建议按「安装 → 群组范围 → 卡片外观 → 群内测试」的顺序进行,每一步的详细说明分别见安装与首次配置、群组范围与独立开关与卡片外观与实时预览。

⌨️ 常用指令速查 ​

指令用途
资料卡 / 我的资料卡查询自己的群资料卡
资料卡 @某人查询指定群友的资料卡
资料卡 QQ号按 QQ 号查询本群成员的资料卡
名片卡 微信号 [邮箱]生成个人名片卡
资料卡帮助查看当前支持的查询方式

全部指令、查询权限与模板切换的完整说明见群内指令与查询方式。

📚 教程目录 ​

篇章内容概要
安装与首次配置运行要求、安装步骤与首次配置建议
群内指令与查询方式全部群内指令、查询方式与权限说明
资料字段与数据来源卡片各字段的读取来源与回退规则
卡片外观与实时预览配色、模板、头像位置与显示字段开关
群组范围与独立开关逐群开关、两种默认策略与批量操作
活跃统计与缓存机制活跃数据口径、备用等级与缓存清理
控制台页面详解控制台导航、工具栏与各页面功能
常见问题FAQ高频问题与解答
故障排查加载失败、页面打不开等故障处理
升级备份与版本记录升级前备份、迁移步骤与配置兼容
个人名片卡与自定义模板名片卡指令、图层编辑器与自定义模板

⚠️ 使用前须知 ​

  • 插件只响应群消息,不会在私聊中生成资料卡;
  • 本月发言数和活跃天数从插件启用后开始记录,不会自动读取全部历史聊天记录;
  • QQ 昵称、性别、个性签名和 QQ 等级依赖当前协议端可返回的数据;
  • 图片由本地渲染,不调用 AI 生图接口,不产生 AI 接口费用。

问题反馈、功能建议与版本通知可加入官方群 327942687 联系作者。


📚 下一节:安装与首次配置

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