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