获取变量

提示

请务必先阅读如何正确使用酒馆助手

点击查看对应类型定义文件 (可发给 AI 或 IDE 使用, 酒馆助手界面中提供了打包下载)

getVariables

获取变量表

getVariables

function getVariables(option: VariableOption): Record<string, any>

参数

option

要操作的变量类型

返回值

• 变量表: Record<string, any>

示例

获取所有聊天变量并弹窗输出结果

const variables = getVariables({type: 'chat'});
alert(variables);

获取所有全局变量

const variables = getVariables({type: 'global'});
// 酒馆助手内置了 lodash 库, 你能用它做很多事, 比如查询某个变量是否存在
if (_.has(variables, "神乐光.好感度")) {
  /* ... */
}

获取特定消息楼层的变量

// 获取倒数第二楼层的聊天变量
const variables = getVariables({type: 'message', message_id: -2});

获取脚本变量

// 在脚本内获取该脚本绑定的变量
const variables = getVariables({type: 'script', script_id: getScriptId()});

在提示词中获取变量

你可以通过以下格式在提示词中获取变量:

变量示例

const 全局变量 = {
  神乐光: {
    好感度: 50,
  },
};

const 聊天变量 = {
  商品: [{ 内容: '...' }, { 内容: '...' }],
};

const 消息楼层变量 = {
  当前剧情阶段: '...',
};

你可以通过以下格式在提示词中获取他们:

• 全局变量: {{get_global_variable::神乐光.好感度}}
• 预设变量: {{get_preset_variable::略}}
• 角色卡变量: {{get_character_variable::略}}
• 聊天变量: {{get_chat_variable::商品.1.内容}}
• 消息楼层变量, 将会获取到最新绑定的消息楼层变量: {{get_message_variable::当前剧情阶段}}

获取到的结果与 JSON.stringify(变量) 一致, 例如:

• {{get_global_variable::神乐光.好感度}}: '50';
• {{get_global_variable::神乐光}}: '{"好感度":50}';
• {{get_chat_variable::商品}}: '[{"内容":"..."},{"内容":"..."}]';