安装与首次配置
本篇覆盖 ZL-资料卡插件的运行要求、安装步骤、控制台首次打开与首次配置建议,帮助新用户一次性完成部署。
🧰 运行要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows |
| 框架版本 | UniQQ 1.0.0 或更高兼容版本 |
| 机器人账号 | 已登录并正常在线的 QQ 机器人账号 |
| 控制台依赖 | Microsoft Edge WebView2 Runtime,用于打开插件控制台 |
📦 安装插件
- 打开 UniQQ 的插件管理页面;
- 选择导入或安装本地插件;
- 选择
XiaoLin.ZLProfileCard.uniqq安装包; - 等待 UniQQ 完成加载;
- 在插件列表中启用「ZL-资料卡插件」。
启用成功后,日志中会出现插件已启用以及默认触发指令的信息。
安装包完整性
请使用完整的 .uniqq 安装包安装,不要只复制 DLL 等程序文件。安装包残缺可能导致插件加载失败或控制台资源缺失,处理方式参见故障排查。
🖥️ 首次打开控制台
- 在插件列表中找到「ZL-资料卡插件」;
- 点击「设置」;
- 首次打开时等待 WebView2 初始化;
- 确认左下角显示「插件运行中」。
WebView2 启动失败
如果提示 WebView2 启动失败,请安装或修复 Microsoft Edge WebView2 Runtime,然后重启 UniQQ。更多处理步骤参见故障排查。
🛠️ 首次配置建议
基础设置
- 保持「启用插件」为开启;
- 建议开启「允许查询他人」,允许群成员互相查询资料卡;
- 触发冷却建议设置为 8 至 15 秒,防止群内连续刷图;
- 默认触发指令可以保留「资料卡」和「我的资料卡」。
群组范围
| 使用场景 | 推荐策略 |
|---|---|
| 机器人只在少量群使用 | 仅开启所选群 |
| 机器人所有群都需要使用 | 默认全部开启 |
选择策略后点击「刷新群列表」,再逐群确认开关状态。两种策略的详细行为差异见群组范围与独立开关。
卡片外观
- 初次使用建议保留默认配色;
- 点击「应用当前设置到预览」检查文字和颜色;
- 确认无误后点击「保存并生效」。
✅ 首次测试
在已启用的群内发送:
text
资料卡机器人应直接发送一张 PNG 图片,不会引用触发消息。
📋 安装完成检查清单
| 检查项 | 预期结果 |
|---|---|
| 插件列表状态 | 「ZL-资料卡插件」已启用 |
| UniQQ 日志 | 出现插件已启用与默认触发指令信息 |
| 控制台左下角 | 显示「插件运行中」 |
群内发送 资料卡 | 直接返回 PNG 资料卡图片 |
📚 下一节:群内指令与查询方式
