Skip to Content

变量面板

这是什么?

变量面板是一个可视化的变量管理工具。它让您可以直观地查看和编辑聊天中使用的各种变量,而不需要手动输入复杂的命令。

简单来说,变量就像是”记事本”——角色卡或脚本可以在里面存储信息(比如角色的好感度、物品数量、故事进度等),这个面板让您能看到这些信息并进行修改。


如何打开面板?

启用后,聊天消息旁边会出现一个 按钮,点击即可打开变量面板。


面板布局

面板分为两个区域:

区域图标说明
本地变量只属于当前聊天的变量,换个聊天就看不到了
全局变量所有聊天都能用的变量,全局共享

操作按钮说明

顶部工具栏(每个变量区域都有)

按钮功能
从 JSON 文件导入变量
把变量导出为 JSON 文件
添加新变量
展开或折叠所有变量
清除该区域所有变量(谨慎使用!)

单个变量的操作

将鼠标悬停在变量上(或在触屏设备上点击),会显示操作按钮:

按钮功能
编辑这个变量的名称和值
在这个变量下添加子变量(用于嵌套结构)
复制变量路径(单击)或复制宏命令(长按)
删除这个变量

表单按钮

按钮功能
保存保存您的修改
取消放弃修改并关闭表单

变量规则徽章

有些变量旁边会显示小图标,表示该变量有特殊规则:

徽章含义
只读变量,不能修改
有结构策略(控制能否增删子项)
有约束规则(如数值范围、枚举选项等)

鼠标悬停在徽章上可以看到具体的规则说明。


实用技巧

  1. 搜索功能:每个区域都有搜索框,输入关键词可以快速找到变量

  2. 复制宏命令:长按 按钮会复制可直接使用的宏命令(如 {{getvar::变量名}}),方便粘贴到消息中使用;短按则复制为该变量的.路径

  3. 支持 JSON 格式:添加或编辑变量时,值可以是普通文本,也可以是 JSON 格式的复杂数据

  4. 自动监测变化:面板会自动检测变量的变化并刷新显示,无需手动刷新

  5. 嵌套结构:点击有子内容的变量可以展开查看内部结构,不同层级会用不同颜色标记


常见用途

  • 查看角色卡存储的数据(好感度、状态等)
  • 调试脚本时检查变量值是否正确
  • 手动修改某些变量来调整故事走向
  • 备份和恢复变量数据(导出/导入功能)