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