故障排查
插件加载失败 0011
如果提示无法加载文件或程序集:
确认使用完整的
.uniqq安装包,而不是只复制 DLL。删除旧版插件后重新导入正式包。
确认包内包含 WebView2 相关 DLL 和
runtimes目录。重启 UniQQ 后再次启用。
设置页面打不开
安装 Microsoft Edge WebView2 Runtime。
确认插件包内存在
Web/index.html、Web/app.js和Web/style.css。检查安全软件是否隔离 WebView2Loader.dll。
重启 UniQQ。
图片生成失败
插件会自动返回文字资料。继续检查:
数据目录是否有写入权限。
磁盘空间是否充足。
头像文件是否损坏。
Assets/qq-level是否包含四种等级图标。UniQQ 日志中的完整异常信息。
图片发送失败
确认机器人有群内发图权限。
确认生成的图片路径存在。
检查协议端是否能发送本地图片。
尝试发送普通图片,判断是否为框架通道问题。
群开关显示开启但不响应
点击“保存并生效”。
重新读取配置,确认开关仍为开启。
检查是否选择了“仅开启所选群”。
检查配置文件中该群是否同时存在于禁用列表。
使用新版控制台重新关闭再开启该群,插件会自动清理冲突。
收集问题信息
联系作者或官方群时,建议同时提供:
UniQQ 版本
插件版本
机器人协议端名称和版本
问题发生时间
相关日志
设置页面截图
是否能够稳定复现
请勿公开发送账号密码、密钥、登录凭证或其他敏感信息。