# 变量系统

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


# 📖 基础概念

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

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

# 🌐 变量类型

# 全局变量

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

# 本地变量

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


# 🔧 设置变量

# 语法

{{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}}

# ⚠️ 注意事项

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

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

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


返回功能列表
../