ZL-自定义报时插件 · 新手使用教程

官网:https://blog.zxiaolin.com 插件 ID:XiaoLin.ZLTimeAnnouncer(当前版本 1.0.6) 适用范围:UniQQ 群聊自动报时——文字 图片 语音 TTS 音乐卡片,支持天气、节日节气、纪念日、倒计时和分时段主题


📚 教程目录

文件主要内容建议阅读对象
00-目录与快速上手.md插件介绍、报时流程、5 分钟快速上手所有人,先看这里
01-安装与首次配置.md安装、运行环境、控制台、主人权限、数据目录首次安装者
02-控制台页面总览.md10 个页面各自负责什么控制台管理员
03-报时任务详解.md五步编辑器、九种时间规则、失败处理控制台管理员
04-模板与变量.md九种预设、消息段、变量表、条件块、选择策略想个性化内容的人
05-素材中心.md图片 语音 名句 问候语 音乐、标签体系控制台管理员
06-扩展内容.md天气、节日节气、纪念日、倒计时、TTS、时段主题进阶用户
07-群组设置与限速.md分群开关、静默时段、模板覆盖、限速保护多群运营者
08-群内指令与权限.md五条指令、权限、自定义关键词群主与管理员
09-导入导出与发送记录.mdCSV 文件夹 ZIP 备份、发送记录解读迁移与维护人员
10-常见问题FAQ.md按现象快速排查遇到问题时
11-上线验收清单.md逐条检查后正式运行正式运营前必读

🌟 插件能做什么

ZL-自定义报时插件按你设定的时间,主动向 QQ 群发送报时内容。不只是"现在几点",还能把天气、节日、倒计时、名句、图片和音乐组合成自然的陪伴型消息。

  • ⏰ 灵活时间规则:整点、半点、固定间隔、多时间点、每天、工作日、周末、指定星期、指定日期,九种规则任选。

  • 📝 九种报时预设:纯文字、文字+名句、完整日期、纯图片、图文、本地语音、TTS 语音、音乐卡片、自定义组合,生成后可自由编辑。

  • 🌦️ 天气报时:接入天气接口,自动附带天气、温度、空气质量和出行提醒,失败自动降级为基础报时。

  • 🎊 节日与纪念日:内置公历节日、农历节日和二十四节气,支持自定义纪念日和活动倒计时。

  • 🎨 素材库:图片、语音、名句、问候语、音乐统一管理,按标签随机或轮换抽取,洗牌袋减少重复。

  • 🗓️ 分时段主题:清晨、上午、中午、下午、晚上、深夜自动换语气;工作日、周末、法定节假日自动换模板。

  • 🔊 TTS 动态语音:接入豆包 腾讯云 通用 HTTP 语音服务,按文本缓存,整点不重复请求。

  • 🛡️ 可靠发送:防重复、失败重试、降级链、静默时段、限速保护,电脑休眠恢复后自动补发最近一次。

  • 💾 批量维护:任务、模板、文案、素材全部支持 CSV 文件夹 ZIP 批量导入导出与完整备份。

  • 🖥️ 可视化控制台:10 个页面集中管理,先预览再发送,紫色 ZL 风格与系列插件一致。

🔄 一次报时是怎样完成的

到达计划时间(每 15 秒扫描一次计划槽位)
    ↓
展开目标群,逐群校验:插件开关、机器人在线、群启用、静默时段、每日上限
    ↓
抢占防重复执行锁(同一群同一槽位只发一次)
    ↓
选择模板:群组覆盖 → 特殊日期 → 法定节假日 → 工作日/周末 → 时段主题 → 默认
    ↓
获取天气 / 农历 / 倒计时数据,按策略抽取素材,替换变量
    ↓
发送消息(失败重试 2 次后按降级链处理,如语音失败转文字)
    ↓
写入发送记录(成功 / 降级成功 / 失败,均可在控制台查询)

🚀 5 分钟快速上手

第 1 步:安装并打开控制台

  1. 获取完整的 XiaoLin.ZLTimeAnnouncer.uniqq 插件包,放入 UniQQ 的 Plugins 目录或在插件管理中直接安装。

  2. 启动 / 重启 UniQQ,在插件管理中启用 ZL-自定义报时插件。

  3. 点击插件的 设置,打开控制台窗口。

⚠️ 运行环境要求 .NET 10 桌面运行时与 Microsoft Edge WebView2 Runtime;控制台空白或加载失败时先检查这两项。

第 2 步:填写主人 QQ

进入 系统设置 页,填写主人 QQ(还可添加插件管理员)。测试报时、开关本群报时等高权限指令只对主人和插件管理员开放。

第 3 步:新建第一个报时任务

进入 报时任务 页 → 新建任务,五步填完:

  1. 基本信息:任务名如"整点问候",保持启用。

  2. 发送范围:选择机器人 → 勾选目标群。

  3. 时间规则:选"整点",分钟填 0(每小时整点发送)。

  4. 内容规则:模板选默认的"纯文字简约"即可。

  5. 失败处理:保持默认(失败重试 2 次,降级为文字)。

点 保存并启用。

第 4 步:测试发送

在任务编辑器底部点 立即测试,选择机器人真实加入的测试群,确认提示"这会真实向 QQ 群发送消息"后发送。群里应立刻收到:

晚上好,现在是 18:30。

第 5 步:验证与查看

  • 群内发送 报时状态:查看本群开关、关联任务和今日发送统计。

  • 群内发送 下次报时:查看下一次计划时间。

  • 控制台 首页概览:查看今日成功 / 失败数、下一次报时倒计时。


💡 更多细节:任务配置见 03-报时任务详解.md,变量全表见 04-模板与变量.md。

共 12 篇 ZL-自定义报时 / 目录与快速上手 0 字 0 行 zhangxiaolin
创建 2026-09-29T06:00:41.703034652Z 更新 2026-09-29T06:00:55.549299726Z