10 · 常见问题 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 日历后即可识别调休(见 06-扩展内容.md)。

🎨 素材类

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 份:{问候语} 自动按时段变化;需要换模板时用时段主题 / 工作日周末模板覆盖(见 04-模板与变量.md、06-扩展内容.md)。

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

  • 空行:用 {{if 变量}}...{{end}} 条件块包裹可能为空的内容。

  • 残留变量:变量名写错或该功能未启用(如未配天气),预览会报错,按提示修正。

💾 数据类

Q15:迁移到新电脑怎么搬数据? 旧机 导入导出 → 导出完整备份 ZIP → 新机安装插件并导入 → 重新填写天气 / TTS 密钥即可(见 09-导入导出与发送记录.md)。

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

共 12 篇 ZL-自定义报时 / 常见问题FQA 0 字 0 行 zhangxiaolin
创建 2026-09-29T06:06:15.830965869Z 更新 2026-09-29T06:06:29.238785172Z