消息模板与占位符变量 · {{cur_date}}、{{model_name}} 等
什么是占位符变量
占位符变量让你在系统提示词、消息模板、模式注入、知识库 中使用动态值。RikkaHub 在每条消息发送时会自动替换为当前的实时值。
语法
支持两种等价语法：
{{变量名}}（推荐，更清晰）{变量名}
完整变量列表
| 变量 | 替换为 |
|---|---|
{{cur_date}} | 当前日期（按你的区域设置格式化） |
{{cur_time}} | 当前时间（按你的区域设置格式化） |
{{cur_datetime}} | 当前日期 + 时间 |
{{model_id}} | 当前活跃模型的模型 ID 字符串 |
{{model_name}} | 当前活跃模型的显示名称 |
{{locale}} | 设备当前区域设置（如 "English (United States)"） |
{{timezone}} | 设备当前时区名称（如 "Asia/Shanghai"） |
{{system_version}} | Android 系统版本（如 "Android 14"） |
{{device_info}} | 设备品牌和型号（如 "Xiaomi 14"） |
{{battery_level}} | 当前电池电量百分比（如 "85"） |
{{nickname}} | 你的显示昵称（设置 → 显示） |
{{user}} | 同 {{nickname}} |
{{char}} | 当前助手的名称 |
最常用的几个变量
{{model_name}}
让模型知道自己用的是什么模型。很多人用这个来解决"模型不知道自己是谁"的问题：
你是 {{model_name}}，运行在 RikkaHub 上。{{cur_datetime}}
模型训练数据有截止日期，不知道当前是什么时间。在系统提示词里加上：
当前日期时间：{{cur_datetime}}。回答关于时事、价格、时间敏感的问题时，请参考此日期。{{device_info}} + {{system_version}}
让编程助手知道目标设备环境，给出更精准的代码示例：
目标设备：{{device_info}}，Android 版本：{{system_version}}。{{battery_level}}
让助手感知到你的电量状态。比如在低电量时提醒"建议切换到省电模式"。
消息模板
消息模板（Message Template）在每条用户消息发送给模型之前对其进行包装。默认值是 {{message}}——即原样发送。
修改消息模板的场景
- 想在每条消息前自动添加一个前缀
- 想统一格式化你的输入
示例
默认模板：
{{message}}添加前缀：
[来自用户 {{nickname}}] {{message}}模板中必须包含
{{message}}占位符，否则用户的实际消息会丢失。RikkaHub 会在编辑器中标记这个错误。
占位符变量的插入方式
- 在系统提示词编辑器或任何模板编辑器中，下方会显示所有可用变量的标签
- 点击标签即可将变量插入到光标位置
- 也可以手动输入
{{变量名}}或{变量名}
变量替换时机
占位符在发送给模型的瞬间被替换。这意味着：
- 如果助手留空了模型覆盖，用的是对话中当前选择的模型 →
{{model_name}}反映对话模型 - 如果助手固定了模型覆盖 →
{{model_name}}反映助手的固定模型 {{cur_datetime}}反映发送时刻的时间（不是打开对话时的时间）
无法获取时的表现
极少数变量可能无法获取（比如某些设备 API 不暴露电池电量）。RikkaHub 会将它们替换为空字符串而不是报错。你的提示词可以安全地包含所有变量。