变量面板
这是什么?
变量面板是一个可视化的变量管理工具。它让您可以直观地查看和编辑聊天中使用的各种变量,而不需要手动输入复杂的命令。
简单来说,变量就像是”记事本”——角色卡或脚本可以在里面存储信息(比如角色的好感度、物品数量、故事进度等),这个面板让您能看到这些信息并进行修改。
如何打开面板?
启用后,聊天消息旁边会出现一个 按钮,点击即可打开变量面板。
面板布局
面板分为两个区域:
| 区域 | 图标 | 说明 |
|---|---|---|
| 本地变量 | 只属于当前聊天的变量,换个聊天就看不到了 | |
| 全局变量 | 所有聊天都能用的变量,全局共享 |
操作按钮说明
顶部工具栏(每个变量区域都有)
| 按钮 | 功能 |
|---|---|
| 从 JSON 文件导入变量 | |
| 把变量导出为 JSON 文件 | |
| 添加新变量 | |
| 展开或折叠所有变量 | |
| 清除该区域所有变量(谨慎使用!) |
单个变量的操作
将鼠标悬停在变量上(或在触屏设备上点击),会显示操作按钮:
| 按钮 | 功能 |
|---|---|
| 编辑这个变量的名称和值 | |
| 在这个变量下添加子变量(用于嵌套结构) | |
| 复制变量路径(单击)或复制宏命令(长按) | |
| 删除这个变量 |
表单按钮
| 按钮 | 功能 |
|---|---|
| 保存 | 保存您的修改 |
| 取消 | 放弃修改并关闭表单 |
变量规则徽章
有些变量旁边会显示小图标,表示该变量有特殊规则:
| 徽章 | 含义 |
|---|---|
| 只读变量,不能修改 | |
| 有结构策略(控制能否增删子项) | |
| 有约束规则(如数值范围、枚举选项等) |
鼠标悬停在徽章上可以看到具体的规则说明。
实用技巧
-
搜索功能:每个区域都有搜索框,输入关键词可以快速找到变量
-
复制宏命令:长按 按钮会复制可直接使用的宏命令(如
{{getvar::变量名}}),方便粘贴到消息中使用;短按则复制为该变量的.路径 -
支持 JSON 格式:添加或编辑变量时,值可以是普通文本,也可以是 JSON 格式的复杂数据
-
自动监测变化:面板会自动检测变量的变化并刷新显示,无需手动刷新
-
嵌套结构:点击有子内容的变量可以展开查看内部结构,不同层级会用不同颜色标记
常见用途
- 查看角色卡存储的数据(好感度、状态等)
- 调试脚本时检查变量值是否正确
- 手动修改某些变量来调整故事走向
- 备份和恢复变量数据(导出/导入功能)