04 · 模板与变量
目标:用变量和消息段组合出个性化报时内容,一份模板覆盖全天。
🎭 九种报时预设
| 预设 | 内容示例 |
|---|---|
| 纯文字简约 | {问候语},现在是 {短时间}。 |
| 文字+名句 | 问候+时间+按时段匹配的随机名句 |
| 完整日期 | 时间 日期 星期 / 农历逐行展示(缺失项不输出空行) |
| 纯图片 | 素材库图片或动态生成的报时图片 |
| 文字+图片 | 问候文字 → 图片 → 日期详情,顺序可调 |
| 本地语音 | 按时段标签从语音库抽取 |
| TTS 动态语音 | 渲染文字后合成语音,按文本缓存 |
| 音乐报时 | QQ 音乐 网易云 酷狗 酷我 自定义卡片 |
| 自定义组合 | 消息段自由编排 |
预设只负责生成初始内容,生成后可自由编辑。
🧱 消息段类型(自定义组合)
| 类型 | 说明 |
|---|---|
text | 文字,支持变量与条件块 |
image | 素材库图片或按标签随机 |
voice | 本地语音或 TTS |
music | 平台音乐或自定义音乐卡片 |
delay | 多条消息之间的短延迟(300–3000ms),不产生消息 |
发送模式两种:
单条组合:文字和图片段合并为一条消息发送。
多条连续:按段拆成多条消息,段间延迟 300–3000ms。
语音和音乐卡片建议独立成段发送;多消息中途失败时不会重发已成功的段,防止重复刷屏。
📝 模板变量表
时间变量
| 变量 | 示例 |
|---|---|
{短时间} | 18:30 |
{当前时间} | 2026-09-29 18:30:00 |
{小时} | 18 |
{分钟} | 30 |
{时段} | 晚上 |
{问候语} | 晚上好 |
{日期} | 2026年9月29日 |
{短日期} | 09-29 |
{星期} | 星期二 |
日历变量
{农历}、{农历年}、{生肖}、{节气}、{节日}、{纪念日}
群与机器人变量
{群号}、{群名}、{机器人QQ}、{机器人昵称}
天气变量
{城市}、{天气}、{温度}、{体感温度}、{最低温}、{最高温}、{湿度}、{风向}、{风力}、{降水概率}、{空气质量}、{出行提醒}
内容变量
{随机名句}、{名句作者}、{随机问候}、{倒计时名称}、{倒计时}、{倒计时天数}
💡 模板编辑器为三栏布局:左栏管理消息段(添加 复制 删除 / 拖动排序),中栏编辑当前段,右栏实时预览。预览可选模拟时间、天气和节日;变量插入面板点击即插入光标位置。未知变量会在预览时报错,不会原样发到群里。
🔀 条件块(避免空行)
只支持"变量有值才输出"的判断,不支持复杂表达式;天气没拿到数据时整块自动隐藏。复杂的内容切换交给主题规则完成(见 06-扩展内容.md)。
🎲 素材选择策略
| 策略 | 行为 |
|---|---|
| 固定内容 | 永远用指定素材 |
| 随机 | 符合标签的素材中随机选 |
| 洗牌袋 | 全部轮完前尽量不重复(默认推荐) |
| 顺序循环 | 按排序依次轮播 |
| 权重随机 | 按权重高低偏向抽取 |
系统先按时段、日期、主题筛选候选素材,再执行抽取;候选不足时自动放宽风格标签,但不会放宽生效日期或内容类型。
💡 实用组合示例
早安图报(多时间点)
整点陪伴(一份文案全天用)
💡 变量取不到值的时段(如未配天气),建议全部用条件块包裹,避免出现空行或残留变量名。