目录与快速上手
本篇是 ZL-资料卡插件的总览入口:一分钟完成安装与启用,认识常用指令,并按目录快速定位所需篇章。
📌 插件信息
ZL-资料卡插件是运行于 UniQQ 平台的群资料卡生成插件:群成员发送一句指令,机器人即在本地渲染一张融合 QQ 资料、群身份与活跃数据的专属图片卡片。
| 项目 | 信息 |
|---|---|
| 安装包 | XiaoLin.ZLProfileCard.uniqq |
| 作者 | 小林&薇薇 |
| 作者 QQ | 939921104 |
| 官方群 | 327942687 |
| 官网 | https://blog.zxiaolin.com |
✨ 核心能力一览
| 能力 | 说明 |
|---|---|
| 群资料卡查询 | 查询自己、@群友或按 QQ 号查询,图片直接发送、不引用触发消息 |
| 个人名片卡 | 一条指令生成含头像、昵称、等级与联系方式的个人名片 |
| 真实资料读取 | 读取 QQ 昵称、性别、个性签名与个人 QQ 等级,并展示群名片、群身份与群专属头衔 |
| 等级图标展示 | 使用星星、月亮、太阳、皇冠 PNG 图标换算展示 QQ 等级 |
| 多套模板 | 群资料卡内置九套模板,个人名片卡提供四款专属模板,支持成员个人切换样式 |
| 活跃数据统计 | 自动统计累计发言、当月发言、活跃天数与最后发言时间 |
| 可视化控制台 | 基础设置、卡片外观、群组范围等页面实时预览,保存即生效 |
| 本地渲染 | 图片全部由插件本地绘制,不调用 AI 生图接口,不产生 AI 接口费用 |
⚡ 一分钟快速上手
- 在 UniQQ 插件管理中导入
XiaoLin.ZLProfileCard.uniqq; - 启用「ZL-资料卡插件」;
- 打开插件设置,进入「群组范围」;
- 点击「刷新群列表」,确认机器人已加入的群已经显示;
- 选择「默认全部开启」,或选择「仅开启所选群」并打开需要使用的群;
- 点击右上角「保存并生效」;
- 在已启用的群内发送
资料卡。
机器人应直接发送一张 PNG 图片,不会引用触发消息。
⌨️ 常用指令速查
| 指令 | 用途 |
|---|---|
资料卡 / 我的资料卡 | 查询自己的群资料卡 |
资料卡 @某人 | 查询指定群友的资料卡 |
资料卡 QQ号 | 按 QQ 号查询本群成员的资料卡 |
名片卡 微信号 [邮箱] | 生成个人名片卡 |
资料卡帮助 | 查看当前支持的查询方式 |
全部指令、查询权限与模板切换的完整说明见群内指令与查询方式。
📚 教程目录
| 篇章 | 内容概要 |
|---|---|
| 安装与首次配置 | 运行要求、安装步骤与首次配置建议 |
| 群内指令与查询方式 | 全部群内指令、查询方式与权限说明 |
| 资料字段与数据来源 | 卡片各字段的读取来源与回退规则 |
| 卡片外观与实时预览 | 配色、模板、头像位置与显示字段开关 |
| 群组范围与独立开关 | 逐群开关、两种默认策略与批量操作 |
| 活跃统计与缓存机制 | 活跃数据口径、备用等级与缓存清理 |
| 控制台页面详解 | 控制台导航、工具栏与各页面功能 |
| 常见问题FAQ | 高频问题与解答 |
| 故障排查 | 加载失败、页面打不开等故障处理 |
| 升级备份与版本记录 | 升级前备份、迁移步骤与配置兼容 |
| 个人名片卡与自定义模板 | 名片卡指令、图层编辑器与自定义模板 |
⚠️ 使用前须知
- 插件只响应群消息,不会在私聊中生成资料卡;
- 本月发言数和活跃天数从插件启用后开始记录,不会自动读取全部历史聊天记录;
- QQ 昵称、性别、个性签名和 QQ 等级依赖当前协议端可返回的数据;
- 图片由本地渲染,不调用 AI 生图接口,不产生 AI 接口费用。
问题反馈、功能建议与版本通知可加入官方群 327942687 联系作者。
📚 下一节:安装与首次配置
