故障排查

插件加载失败 0011

如果提示无法加载文件或程序集:

  1. 确认使用完整的 .uniqq 安装包,而不是只复制 DLL。

  2. 删除旧版插件后重新导入正式包。

  3. 确认包内包含 WebView2 相关 DLL 和 runtimes 目录。

  4. 重启 UniQQ 后再次启用。

设置页面打不开

  1. 安装 Microsoft Edge WebView2 Runtime。

  2. 确认插件包内存在 Web/index.html、Web/app.js 和 Web/style.css。

  3. 检查安全软件是否隔离 WebView2Loader.dll。

  4. 重启 UniQQ。

图片生成失败

插件会自动返回文字资料。继续检查:

  • 数据目录是否有写入权限。

  • 磁盘空间是否充足。

  • 头像文件是否损坏。

  • Assets/qq-level 是否包含四种等级图标。

  • UniQQ 日志中的完整异常信息。

图片发送失败

  • 确认机器人有群内发图权限。

  • 确认生成的图片路径存在。

  • 检查协议端是否能发送本地图片。

  • 尝试发送普通图片,判断是否为框架通道问题。

群开关显示开启但不响应

  1. 点击“保存并生效”。

  2. 重新读取配置,确认开关仍为开启。

  3. 检查是否选择了“仅开启所选群”。

  4. 检查配置文件中该群是否同时存在于禁用列表。

  5. 使用新版控制台重新关闭再开启该群,插件会自动清理冲突。

收集问题信息

联系作者或官方群时,建议同时提供:

  • UniQQ 版本

  • 插件版本

  • 机器人协议端名称和版本

  • 问题发生时间

  • 相关日志

  • 设置页面截图

  • 是否能够稳定复现

请勿公开发送账号密码、密钥、登录凭证或其他敏感信息。

共 11 篇 ZL-资料卡插件 / 故障排查 0 字 0 行 zhangxiaolin
创建 2026-09-23T09:22:14.362419135Z 更新 2026-09-23T09:25:12.901075350Z