Skip to content

变量系统 ​

在聊天中存储和使用动态数据。


📖 基础概念 ​

变量系统允许你在聊天中:

  • 存储数值(如生命值、金币)
  • 存储文本(如状态、位置)
  • 存储列表(如物品栏)
  • 在提示词中使用这些值

🌐 变量类型 ​

全局变量 ​

应用范围内持久存储,所有聊天共享。

本地变量 ​

每个聊天独立存储,切换聊天后变量不同。


🔧 设置变量 ​

语法 ​

{{setvar::变量名::值}}

示例 ​

文字变量:

{{setvar::location::魔法森林}}

数字变量:

{{setvar::hp::100}}
{{setvar::gold::500}}

列表变量:

{{setvar::inventory::["剑","盾","药水"]}}

📖 读取变量 ​

语法 ​

{{getvar::变量名}}

在提示词中使用 ​

{{user}}的当前状态:
- 生命值:{{getvar::hp}}
- 金币:{{getvar::gold}}
- 位置:{{getvar::location}}

➕ 修改变量 ​

添加/拼接 ​

{{addvar::变量名::值}}

效果:

  • 数字:相加
  • 文字:拼接在末尾
  • 列表:追加元素

增加1 ​

{{incvar::变量名}}

减少1 ​

{{decvar::变量名}}

📖 使用示例 ​

游戏化角色扮演 ​

初始化:

{{setvar::hp::100}}
{{setvar::mp::50}}
{{setvar::gold::0}}
{{setvar::inventory::[]}}

战斗后更新:

战斗结束!
{{setvar::hp::75}}
{{addvar::gold::50}}
{{addvar::inventory::["狼皮"]}}

当前状态:
HP: {{getvar::hp}}/100
金币: {{getvar::gold}}

好感度系统 ​

{{setvar::affection::50}}

[角色对你的好感有所提升]
{{incvar::affection}}
当前好感度:{{getvar::affection}}

⚠️ 注意事项 ​

作用域 ​

  • 本地变量仅在当前聊天有效
  • 切换聊天后需重新设置

持久化 ​

变量会随聊天保存,重新打开聊天变量仍在。

类型转换 ​

变量会自动识别类型,但建议保持一致的使用方式。

--- ​

返回功能列表

Released under the MIT License.