ZL-自定义报时插件 · 新手使用教程
官网:https://blog.zxiaolin.com 插件 ID:
XiaoLin.ZLTimeAnnouncer(当前版本 1.0.6) 适用范围:UniQQ 群聊自动报时——文字 图片 语音 TTS 音乐卡片,支持天气、节日节气、纪念日、倒计时和分时段主题
📚 教程目录
| 文件 | 主要内容 | 建议阅读对象 |
|---|---|---|
00-目录与快速上手.md | 插件介绍、报时流程、5 分钟快速上手 | 所有人,先看这里 |
01-安装与首次配置.md | 安装、运行环境、控制台、主人权限、数据目录 | 首次安装者 |
02-控制台页面总览.md | 10 个页面各自负责什么 | 控制台管理员 |
03-报时任务详解.md | 五步编辑器、九种时间规则、失败处理 | 控制台管理员 |
04-模板与变量.md | 九种预设、消息段、变量表、条件块、选择策略 | 想个性化内容的人 |
05-素材中心.md | 图片 语音 名句 问候语 音乐、标签体系 | 控制台管理员 |
06-扩展内容.md | 天气、节日节气、纪念日、倒计时、TTS、时段主题 | 进阶用户 |
07-群组设置与限速.md | 分群开关、静默时段、模板覆盖、限速保护 | 多群运营者 |
08-群内指令与权限.md | 五条指令、权限、自定义关键词 | 群主与管理员 |
09-导入导出与发送记录.md | CSV 文件夹 ZIP 备份、发送记录解读 | 迁移与维护人员 |
10-常见问题FAQ.md | 按现象快速排查 | 遇到问题时 |
11-上线验收清单.md | 逐条检查后正式运行 | 正式运营前必读 |
🌟 插件能做什么
ZL-自定义报时插件按你设定的时间,主动向 QQ 群发送报时内容。不只是"现在几点",还能把天气、节日、倒计时、名句、图片和音乐组合成自然的陪伴型消息。
⏰ 灵活时间规则:整点、半点、固定间隔、多时间点、每天、工作日、周末、指定星期、指定日期,九种规则任选。
📝 九种报时预设:纯文字、文字+名句、完整日期、纯图片、图文、本地语音、TTS 语音、音乐卡片、自定义组合,生成后可自由编辑。
🌦️ 天气报时:接入天气接口,自动附带天气、温度、空气质量和出行提醒,失败自动降级为基础报时。
🎊 节日与纪念日:内置公历节日、农历节日和二十四节气,支持自定义纪念日和活动倒计时。
🎨 素材库:图片、语音、名句、问候语、音乐统一管理,按标签随机或轮换抽取,洗牌袋减少重复。
🗓️ 分时段主题:清晨、上午、中午、下午、晚上、深夜自动换语气;工作日、周末、法定节假日自动换模板。
🔊 TTS 动态语音:接入豆包 腾讯云 通用 HTTP 语音服务,按文本缓存,整点不重复请求。
🛡️ 可靠发送:防重复、失败重试、降级链、静默时段、限速保护,电脑休眠恢复后自动补发最近一次。
💾 批量维护:任务、模板、文案、素材全部支持 CSV 文件夹 ZIP 批量导入导出与完整备份。
🖥️ 可视化控制台:10 个页面集中管理,先预览再发送,紫色 ZL 风格与系列插件一致。
🔄 一次报时是怎样完成的
🚀 5 分钟快速上手
第 1 步:安装并打开控制台
获取完整的
XiaoLin.ZLTimeAnnouncer.uniqq插件包,放入 UniQQ 的Plugins目录或在插件管理中直接安装。启动 / 重启 UniQQ,在插件管理中启用 ZL-自定义报时插件。
点击插件的 设置,打开控制台窗口。
⚠️ 运行环境要求 .NET 10 桌面运行时与 Microsoft Edge WebView2 Runtime;控制台空白或加载失败时先检查这两项。
第 2 步:填写主人 QQ
进入 系统设置 页,填写主人 QQ(还可添加插件管理员)。测试报时、开关本群报时等高权限指令只对主人和插件管理员开放。
第 3 步:新建第一个报时任务
进入 报时任务 页 → 新建任务,五步填完:
基本信息:任务名如"整点问候",保持启用。
发送范围:选择机器人 → 勾选目标群。
时间规则:选"整点",分钟填
0(每小时整点发送)。内容规则:模板选默认的"纯文字简约"即可。
失败处理:保持默认(失败重试 2 次,降级为文字)。
点 保存并启用。
第 4 步:测试发送
在任务编辑器底部点 立即测试,选择机器人真实加入的测试群,确认提示"这会真实向 QQ 群发送消息"后发送。群里应立刻收到:
第 5 步:验证与查看
群内发送
报时状态:查看本群开关、关联任务和今日发送统计。群内发送
下次报时:查看下一次计划时间。控制台 首页概览:查看今日成功 / 失败数、下一次报时倒计时。
💡 更多细节:任务配置见
03-报时任务详解.md,变量全表见04-模板与变量.md。