常见问题FAQ
按现象快速排查,先找相似问题再动手;未能覆盖的情况请携带发送记录的错误原因反馈。
🖥️ 控制台类
Q1:控制台打开是空白?
缺少 .NET 10 桌面运行时或 WebView2 Runtime。安装 Microsoft Edge WebView2 Runtime 后重启 UniQQ。
Q2:改动保存了吗?
顶部有未保存标记,关闭窗口前会二次确认。修改配置后记得点 保存配置。
⏰ 发送类
Q3:到了时间没有发送?
按顺序检查:
- 任务是否启用;
- 机器人是否在线且在目标群;
- 群是否在群组设置中启用;
- 是否落在静默时段;
- 是否超出每日发送上限;
- 到 发送记录 页看有没有失败记录及原因。
Q4:电脑休眠 / 重启后会重复发送吗?
不会。每个「任务+群+计划时间」有唯一执行锁,数据库层面防重;重启后只补发最近一个有效槽位(默认 10 分钟内),不会补齐所有历史任务。
Q5:同一群配了多个任务会刷屏吗?
每个任务独立按计划发送。建议合理分配时间规则(如整点+半点错开),并用静默时段、每日上限兜底;限速器也会自动控制频率。
Q6:工作日任务在法定假日也发了?
未维护节假日日历时,工作日 / 周末规则仅按星期判断。在配置中补充 日期:holiday / 日期:workday 日历后即可识别调休(见扩展内容)。
🎨 素材类
Q7:语音发不出来或没声音?
确认语音格式是当前 QQ 通道支持的格式;不支持的格式可在系统设置配置 FFmpeg 路径自动转码。发送失败会自动降级为文字,可在发送记录中看到降级标记。
Q8:GIF 图片发出去不动了?
GIF 是否为动图取决于当前 UniQQ / QQ 通道能力,插件无法保证。需要动图效果时先小范围实测。
Q9:音乐卡片每次报时唱的歌不一样?
检查音乐条目是否保存了确定的「歌曲 ID」而非搜索关键词;平台音乐必须落库到具体条目。
Q10:素材删不掉?
被模板引用的素材默认禁止删除。可选择「替换引用」换新素材,或强制删除(模板会进入异常状态,需重新配置);批量删除先进回收站保留 7 天。
🌦️ 扩展类
Q11:天气一直不显示?
- 检查 API 密钥是否有效、每日请求上限是否用完;
- 城市名建议改用城市编码;
- 接口失败时若无有效缓存会自动去掉天气段——这是保护机制,不是故障。
Q12:TTS 合成失败?
- 豆包确认 API Key 有效;腾讯云确认 SecretId / SecretKey 正确;
- 文本长度是否超上限;
- 服务失败会自动降级为文字,不影响整点报送。可先用「试听」在本机验证。
📝 模板类
Q13:想一天只维护一份文案?
用变量+时段主题代替复制 24 份:{问候语} 自动按时段变化;需要换模板时用时段主题 / 工作日周末模板覆盖(见模板与变量与扩展内容)。
Q14:报时里出现空行或残留的 {xxx}?
- 空行:用 {{if 变量}}…{{end}} 条件块包裹可能为空的内容。
- 残留变量:变量名写错或该功能未启用(如未配天气),预览会报错,按提示修正。
💾 数据类
Q15:迁移到新电脑怎么搬数据?
旧机 导入导出 → 导出完整备份 ZIP → 新机安装插件并导入 → 重新填写天气 / TTS 密钥即可(见导入导出与发送记录)。
Q16:群内指令没反应?
先确认:① 关键词没被改过;② 对应指令开关是否关闭;③ 操作人是否有权限(测试 / 开关类仅主人和插件管理员)。
📚 下一节:上线验收清单
