Skip to content

常见问题FAQ ​

按现象快速排查,先找相似问题再动手;未能覆盖的情况请携带发送记录的错误原因反馈。

🖥️ 控制台类 ​

Q1:控制台打开是空白?

缺少 .NET 10 桌面运行时或 WebView2 Runtime。安装 Microsoft Edge WebView2 Runtime 后重启 UniQQ。

Q2:改动保存了吗?

顶部有未保存标记,关闭窗口前会二次确认。修改配置后记得点 保存配置。

⏰ 发送类 ​

Q3:到了时间没有发送?

按顺序检查:

  1. 任务是否启用;
  2. 机器人是否在线且在目标群;
  3. 群是否在群组设置中启用;
  4. 是否落在静默时段;
  5. 是否超出每日发送上限;
  6. 到 发送记录 页看有没有失败记录及原因。

Q4:电脑休眠 / 重启后会重复发送吗?

不会。每个「任务+群+计划时间」有唯一执行锁,数据库层面防重;重启后只补发最近一个有效槽位(默认 10 分钟内),不会补齐所有历史任务。

Q5:同一群配了多个任务会刷屏吗?

每个任务独立按计划发送。建议合理分配时间规则(如整点+半点错开),并用静默时段、每日上限兜底;限速器也会自动控制频率。

Q6:工作日任务在法定假日也发了?

未维护节假日日历时,工作日 / 周末规则仅按星期判断。在配置中补充 日期:holiday / 日期:workday 日历后即可识别调休(见扩展内容)。

🎨 素材类 ​

Q7:语音发不出来或没声音?

确认语音格式是当前 QQ 通道支持的格式;不支持的格式可在系统设置配置 FFmpeg 路径自动转码。发送失败会自动降级为文字,可在发送记录中看到降级标记。

Q8:GIF 图片发出去不动了?

GIF 是否为动图取决于当前 UniQQ / QQ 通道能力,插件无法保证。需要动图效果时先小范围实测。

Q9:音乐卡片每次报时唱的歌不一样?

检查音乐条目是否保存了确定的「歌曲 ID」而非搜索关键词;平台音乐必须落库到具体条目。

Q10:素材删不掉?

被模板引用的素材默认禁止删除。可选择「替换引用」换新素材,或强制删除(模板会进入异常状态,需重新配置);批量删除先进回收站保留 7 天。

🌦️ 扩展类 ​

Q11:天气一直不显示?

  1. 检查 API 密钥是否有效、每日请求上限是否用完;
  2. 城市名建议改用城市编码;
  3. 接口失败时若无有效缓存会自动去掉天气段——这是保护机制,不是故障。

Q12:TTS 合成失败?

  1. 豆包确认 API Key 有效;腾讯云确认 SecretId / SecretKey 正确;
  2. 文本长度是否超上限;
  3. 服务失败会自动降级为文字,不影响整点报送。可先用「试听」在本机验证。

📝 模板类 ​

Q13:想一天只维护一份文案?

用变量+时段主题代替复制 24 份:{问候语} 自动按时段变化;需要换模板时用时段主题 / 工作日周末模板覆盖(见模板与变量与扩展内容)。

Q14:报时里出现空行或残留的 {xxx}?

  • 空行:用 {{if 变量}}…{{end}} 条件块包裹可能为空的内容。
  • 残留变量:变量名写错或该功能未启用(如未配天气),预览会报错,按提示修正。

💾 数据类 ​

Q15:迁移到新电脑怎么搬数据?

旧机 导入导出 → 导出完整备份 ZIP → 新机安装插件并导入 → 重新填写天气 / TTS 密钥即可(见导入导出与发送记录)。

Q16:群内指令没反应?

先确认:① 关键词没被改过;② 对应指令开关是否关闭;③ 操作人是否有权限(测试 / 开关类仅主人和插件管理员)。


📚 下一节:上线验收清单

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