群内指令与查询方式
本篇汇总 ZL-资料卡插件的全部群内指令:基础查询、模板切换、触发指令自定义,以及查询权限与冷却规则。
🔍 基础查询指令
| 指令 | 说明 |
|---|---|
资料卡 / 我的资料卡 | 查看自己的资料卡;未指定用户时,插件默认查询发送指令的人 |
资料卡 @某位群友 | 通过 @ 查询群友,推荐使用,可减少 QQ 号输入错误 |
资料卡 QQ号 | 通过 QQ 号查询群友,例如 资料卡 939921104 |
资料卡帮助 | 查看帮助,插件会返回当前支持的查询方式 |
通过 QQ 号查询时,目标 QQ 必须是当前群成员,否则插件会提示没有找到用户。
🎨 个人模板切换
查看可选模板和当前模板:
text
资料卡模板切换切换自己的资料卡模板:
text
资料卡模板切换 蓝晶星轨
资料卡模板切换 冰蓝城堡
资料卡模板切换 默认| 写法 | 效果 |
|---|---|
资料卡模板切换 | 查看可选模板与当前模板 |
资料卡模板切换 模板名 | 切换到指定模板,如 资料卡模板切换 蓝晶星轨 |
资料卡模板切换 默认 | 恢复后台设置的默认模板 |
可选模板共九套:蓝晶星轨、冰蓝城堡、玫瑰柔光、星河心语、街头潮绘、经典融合、霓虹星河、柔光玫瑰、潮流拼贴,各模板风格说明见个人名片卡与自定义模板。
模板偏好作用范围
个人模板偏好持久保存,且不会更改其他用户的样式。自 0.1.0 起,群资料卡模板与个人名片卡模板完全独立:资料卡模板切换 指令只影响群资料卡,个人名片卡模板始终由后台统一设置。
✏️ 自定义触发指令
进入控制台「基础设置」,在「触发指令」文本框中每行填写一个指令,例如:
text
资料卡
我的资料卡
个人名片
profile保存后新指令立即生效,插件会自动保留有效且不重复的指令。
指令命名建议
不要使用过短或日常聊天中经常出现的词语,避免误触发。默认的 资料卡、我的资料卡 语义明确,通常无需修改。
🔐 查询他人权限
「允许查询他人」开关位于控制台「基础设置」,行为如下:
| 开关状态 | 行为 |
|---|---|
| 开启 | 群成员可以使用 @ 或 QQ 号查询其他成员 |
| 关闭 | 资料卡 仍可查询自己;查询其他成员时会收到权限提示 |
关闭后,群主和管理员也遵循该全局开关。
⏱️ 指令冷却
- 冷却时间按「群号 + 发起查询的用户」计算,不同群、不同用户互不影响;
- 同一个人在冷却时间内重复调用,会收到剩余等待秒数提示;
- 冷却时长在「基础设置 → 触发冷却」中调整,建议 8 至 15 秒。
💼 个人名片卡指令
名片卡 微信号 [邮箱] 用于生成不含群信息的个人名片卡,仅限指令发送者本人:
text
名片卡 ZL_Profile
名片卡 ZL_Profile 939921104@qq.com微信号是必填参数,邮箱省略时自动使用「当前QQ号@qq.com」。名片卡的完整规则、自定义联系方式与专属模板见个人名片卡与自定义模板。
📚 下一节:资料字段与数据来源
