Skip to content

目录与快速上手 ​

本篇是 ZL-自定义报时插件使用教程的总目录,先了解插件定位与报时执行流程,再按五步完成第一次报时发送。

📚 教程目录 ​

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

🌟 插件能做什么 ​

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

能力说明
⏰ 灵活时间规则整点、半点、固定间隔、多时间点、每天、工作日、周末、指定星期、指定日期,九种规则任选
📝 九种报时预设纯文字、文字+名句、完整日期、纯图片、图文、本地语音、TTS 语音、音乐卡片、自定义组合,生成后可自由编辑
🌦️ 天气报时接入天气接口,自动附带天气、温度、空气质量和出行提醒,失败自动降级为基础报时
🎊 节日与纪念日内置公历节日、农历节日和二十四节气,支持自定义纪念日和活动倒计时
🎨 素材库图片、语音、名句、问候语、音乐统一管理,按标签随机或轮换抽取,洗牌袋减少重复
🗓️ 分时段主题清晨、上午、中午、下午、晚上、深夜自动换语气;工作日、周末、法定节假日自动换模板
🔊 TTS 动态语音接入豆包 / 腾讯云 / 通用 HTTP 语音服务,按文本缓存,整点不重复请求
🛡️ 可靠发送防重复、失败重试、降级链、静默时段、限速保护,电脑休眠恢复后自动补发最近一次
💾 批量维护任务、模板、文案、素材全部支持 CSV / 文件夹 / ZIP 批量导入导出与完整备份
🖥️ 可视化控制台10 个页面集中管理,先预览再发送,紫色 ZL 风格与系列插件一致

🔄 一次报时是怎样完成的 ​

text
到达计划时间(每 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 群发送消息」提示后发送。群里应立刻收到:

text
晚上好,现在是 18:30。

第 5 步:验证与查看 ​

操作作用
群内发送 报时状态查看本群开关、关联任务和今日发送统计
群内发送 下次报时查看下一次计划时间
控制台 首页概览查看今日成功 / 失败数与下一次报时倒计时

📚 下一节:安装与首次配置

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