Skip to content

故障排查 ​

本篇按故障现象给出逐项处理步骤,覆盖插件加载、控制台打开、图片生成与发送、群开关异常等场景。

🧭 排查速查 ​

现象对应章节
提示加载失败 0011插件加载失败 0011
设置页面打不开 / WebView2 启动失败设置页面打不开
群内返回文字资料而非图片图片生成失败
图片发送不出来图片发送失败
群开关开启但无响应群开关显示开启但不响应

一般性疑问(如显示为 QQ 号、等级不符)请先查阅常见问题FAQ。

🧩 插件加载失败 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 版本;
  • 插件版本;
  • 机器人协议端名称和版本;
  • 问题发生时间;
  • 相关日志;
  • 设置页面截图;
  • 是否能够稳定复现。

信息安全

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

官方支持渠道


📚 下一节:升级备份与版本记录

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