Skip to content

安装与首次配置 ​

本篇覆盖 ZL-资料卡插件的运行要求、安装步骤、控制台首次打开与首次配置建议,帮助新用户一次性完成部署。

🧰 运行要求 ​

项目要求
操作系统Windows
框架版本UniQQ 1.0.0 或更高兼容版本
机器人账号已登录并正常在线的 QQ 机器人账号
控制台依赖Microsoft Edge WebView2 Runtime,用于打开插件控制台

📦 安装插件 ​

  1. 打开 UniQQ 的插件管理页面;
  2. 选择导入或安装本地插件;
  3. 选择 XiaoLin.ZLProfileCard.uniqq 安装包;
  4. 等待 UniQQ 完成加载;
  5. 在插件列表中启用「ZL-资料卡插件」。

启用成功后,日志中会出现插件已启用以及默认触发指令的信息。

安装包完整性

请使用完整的 .uniqq 安装包安装,不要只复制 DLL 等程序文件。安装包残缺可能导致插件加载失败或控制台资源缺失,处理方式参见故障排查。

🖥️ 首次打开控制台 ​

  1. 在插件列表中找到「ZL-资料卡插件」;
  2. 点击「设置」;
  3. 首次打开时等待 WebView2 初始化;
  4. 确认左下角显示「插件运行中」。

WebView2 启动失败

如果提示 WebView2 启动失败,请安装或修复 Microsoft Edge WebView2 Runtime,然后重启 UniQQ。更多处理步骤参见故障排查。

🛠️ 首次配置建议 ​

基础设置 ​

  • 保持「启用插件」为开启;
  • 建议开启「允许查询他人」,允许群成员互相查询资料卡;
  • 触发冷却建议设置为 8 至 15 秒,防止群内连续刷图;
  • 默认触发指令可以保留「资料卡」和「我的资料卡」。

群组范围 ​

使用场景推荐策略
机器人只在少量群使用仅开启所选群
机器人所有群都需要使用默认全部开启

选择策略后点击「刷新群列表」,再逐群确认开关状态。两种策略的详细行为差异见群组范围与独立开关。

卡片外观 ​

  • 初次使用建议保留默认配色;
  • 点击「应用当前设置到预览」检查文字和颜色;
  • 确认无误后点击「保存并生效」。

✅ 首次测试 ​

在已启用的群内发送:

text
资料卡

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

📋 安装完成检查清单 ​

检查项预期结果
插件列表状态「ZL-资料卡插件」已启用
UniQQ 日志出现插件已启用与默认触发指令信息
控制台左下角显示「插件运行中」
群内发送 资料卡直接返回 PNG 资料卡图片

测试无响应时

依次确认插件已启用、当前群已在「群组范围」中开启、指令仍在触发指令列表中;仍无响应时参见常见问题FAQ与故障排查。


📚 下一节:群内指令与查询方式

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