变量提示词: 让 AI 理解变量

变量提示词: 让 AI 理解变量#

在上一章节, 我们在 [initvar] 条目中设置了初始化变量, 但该条目处于禁用状态并未发送给 AI. 那么, 如何让AI "看" 到并根据我们的意图去操作这些变量呢? 答案是在其他条目中编写相应的提示词.

所有已初始化的变量都存放在一个名为 stat_data 的数据块中 (你可以在变量编辑器里确认这一点). 要向 AI 展示这些变量的当前状态, 我们可以使用酒馆助手的一个强大宏: {{get_message_variable::stat_data}}.

这个宏能将 stat_data 中的所有内容以 JSON 格式直接插入到它所在的位置. 例如, 如果我们已经成功设置和初始化了变量, 则在开启的蓝灯条目中书写 {{get_message_variable::stat_data}} 将会发送给 AI 以下结果:

角色:
  络络:
    好感度: 30
    心情: 开心
  青空莉:
    好感度: 60
    心情: 郁闷
世界:
  日期: 2025-07-26
  时间: 21:00

虽然 AI 能够理解这样发送的 JSON, 但这样直接抛一整个数据块并不方便我们控制.

编写#

为了实现更精准的控制, 我们推荐一种更结构化的方法. 请看下面的示例 (仅仅是示例!), 它与我们之前设置的变量一一对应:

---
<status_description>
# 以下内容是当前的状态数值，你可以通过命令进行操作修改，但绝对不要将以下内容直接输出在你的回复中
角色:
  络络:
    好感度: {{get_message_variable::stat_data.角色.络络.好感度}} # 0-100
    心情: {{get_message_variable::stat_data.角色.络络.心情}} # 仅有开心、难过、哭泣、生气四种心情
  青空莉:
    好感度: {{get_message_variable::stat_data.角色.青空莉.好感度}}
    心情: {{get_message_variable::stat_data.角色.青空莉.心情}}
世界:
  日期: {{get_message_variable::stat_data.世界.日期}}
  时间: {{get_message_variable::stat_data.世界.时间}}
</status_description>
rule: 你必须在下次回复的末尾输出变量更新分析
check list:
  - 如果角色注意到了<user>的行为，根据他们的态度将'好感度'更新±(1~4)
  - 根据剧情和人设适当地调整'心情'
  - 根据当前日期时间更新'日期'和'时间'
format: |-
  <update>
  <update_analysis>/*使用不超过120个英语单词*/
  - ${计算经过的时间: ...}
  - ${根据当前情节是否足够特殊、时间跨度是否远超正常情况，判断是否允许变量值发生戏剧性变化: 是/否}
  - ${根据`check list`中列出的对应规则，分析每个变量是否需要更新: ...}
  </update_analysis>
  _.set('${变量, 例如'角色.络络.好感度'}', ${旧值}, ${新值}); // ${简述更新原因}
  _.set('${变量}, ${新值}); // ${简述更新原因}
  ...
  </update>

这个示例清晰地告诉了 AI 三件事: 当前的变量情况、更新规则和输出格式; 其中只有输出格式必须是 _.set('变量', 值), 而其他部分都是高度可自定义的.

为了完全理解上述提示词，你需要掌握

  • 酒馆助手宏 {{get_message_variable::变量}}

  • 我们的输出格式提示词 (format 部分) 写法

解释#

酒馆助手宏 {{get_message_variable::变量}}#

这一部分在视频中讲解的可能更清晰

要在酒馆中插入动态变化的内容, 我们通常会使用"宏".
一个每个人都用过的宏是 {{user}} (我更建议你用等效的 <user>): 当发送给 ai 时, 它会被替换为我们的玩家角色名. 同理, {{char}} 会被替换为角色卡名.
你可以通过在酒馆输入框输入 /help macros 并 回车 来了解酒馆提供了哪些宏.

为了扩展酒馆的功能、更好地支持变量, 酒馆助手允许你自己注册酒馆助手宏, 并提供了 {{get_message_variable::变量}} 宏.

我们前面提到过 {{get_message_variable::stat_data}} 可以将整个 stat_data "文件夹" 以 JSON 格式插入到世界书中:

角色:
  络络:
    好感度: 30
    心情: 开心
  青空莉:
    好感度: 60
    心情: 郁闷
世界:
  日期: 2025-07-26
  时间: 21:00

这其实是我们将 {{get_message_variable::变量}} 的 变量 部分填写为 stat_data, 因而酒馆助手会将该宏替换为 stat_data "文件夹" 下的所有变量.

显然我们也可以只指定某个部分, 假设络络的好感度现在是 30、心情是 开心:

  • {{get_message_variable::stat_data.角色.络络}} 将会替换为 {"好感度":30,"心情":"开心"}

  • {{get_message_variable::stat_data.角色.络络.好感度}} 将会替换为 30

可对于数组呢? 我们该如何选择其中第一个元素?

角色:
  络络:
    心情:
      - 60  <-- 我们怎么选择它?
      - 开心

要获取数组中的其中一个, 我们使用中括号加上序号. 序号从 0 开始计数, [0] 代表数组中的第一个元素:

  • {{get_message_variable::stat_data.角色.络络.心情[0]}} 将会替换为 60

  • {{get_message_variable::stat_data.角色.络络.心情[1]}} 将会替换为 开心

由此, 在前面的变量提示词中, 我们无非是依次列举了变量名和对应的值, 并在其后 "偷懒地" 用 YAML 风格注释 # 对其值进行说明.

---
<status_description>
# 以下内容是当前的状态数值，你可以通过命令进行操作修改，但绝对不要将以下内容直接输出在你的回复中
角色:
  络络:
    好感度: {{get_message_variable::stat_data.角色.络络.好感度}} # 0-100
    心情: {{get_message_variable::stat_data.角色.络络.心情}} # 仅有开心、难过、哭泣、生气四种心情
  青空莉:
    好感度: {{get_message_variable::stat_data.角色.青空莉.好感度}}
    心情: {{get_message_variable::stat_data.角色.青空莉.心情}}
世界:
  日期: {{get_message_variable::stat_data.世界.日期}}
  时间: {{get_message_variable::stat_data.世界.时间}}
</status_description>

输出格式提示词写法#

在书写输出格式提示词 (format 部分) 时, 我采用了我们惯用而 AI 能听懂的几种特殊格式:

  • ${描述}: AI 需要根据 "描述" 将它替换为对应的内容. 例如 衣着: ${具体描述角色当前衣着} 可能输出 衣着: 粉金色宽松T恤睡裙;

  • /*要求*/: AI 仅会听从 "要求" 而不对它进行输出. 例如 /*以下内容应该按英文输出*/ 会让 AI 更倾向于用英文输出下面的内容;

  • ...: AI 需要仿照之前给定的规则和内容补充输出. 例如 其他角色: ... 会让 AI 根据前面给定的 络络 输出格式, 补充其他角色的输出;

  • 其他内容原封不动地进行输出.

format: |-
  <update>
  <update_analysis>/*使用不超过120个英语单词*/
  - ${计算经过的时间: ...}
  - ${根据当前情节是否足够特殊、时间跨度是否远超正常情况，判断是否允许变量值发生戏剧性变化: 是/否}
  - ${根据`check list`中列出的对应规则，分析每个变量是否需要更新: ...}
  </update_analysis>
  _.set('${变量, 例如'角色.络络.好感度'}', ${旧值}, ${新值}); // ${简述更新原因}
  _.set('${变量}, ${新值}); // ${简述更新原因}
  ...
  </update>

这只是提示词#

当前的变量情况、更新规则和输出格式等只是提示词, 写法只取决于你的想象; 这里只是列了一种方便讲解的变量更新提示词.
如果你熟悉 MVU 原帖下的提示词或 Nova Creator 写卡预设, 你可以发现这里提示词与它们有很大区别: 这里的提示词引入了 checklist、recall 和更多的思维链 (Chain of Thought, CoT) 要求, 并且没在 format 之后还补充一个变量更新输出示例 example.

你还能在以下地方看到完全不同的提示词写法:

  • 所有变量提示词都在 D1

  • 补充一个 D0 recall 来稳定格式

../../../../_images/%E5%8F%98%E9%87%8F%E6%8F%90%E7%A4%BA%E8%AF%8D_%E6%97%A5%E8%AE%B0%E7%BB%9C%E7%BB%9C.png

酒馆正则: 不发送变量更新文本#

有了变量提示词, AI 将会在回复时输出 <update> 部分, 在其中先对变量该如何更新进行分析, 然后输出 _.set(...) 语句.
而 MVU 脚本将会读取 AI 回复和用户输入中的 _.set(...), 对变量在该楼层的值进行实际更新.

也就是说:

重复一遍, 变量提示词的写法只取决于你的想象

你甚至不必拘泥于放在 <update> 中, 因为 MVU 脚本会读取 AI 回复和用户输入中任意位置的 _.set(...).

你可以为不同开局设置不同的初始变量

"MVU 脚本会读取 AI 回复和用户输入中的 _.set(...)". 也就是说, 你写在开局消息中的 _.set(...) 也会被读取.

AI 输出的 <update> 没必要再发给 AI

<update> 已经被 MVU 脚本使用了, 而 AI 在后续回复中不需要参考它: 我们会发给 AI 变量更新规则, 不是吗?

如果我们保留所有楼层的 <update> 还发给 AI:

  • 首先, 这浪费了 token

  • 其次, AI 可能不必要地花费注意力去学习之前的 <update> 而更少地将注意力放在剧情上

  • 最后, AI 可能偷懒直接照抄之前的 <update> 而不真的分析思考该如何更新变量!

因此, 我们需要在后续生成时不发送 <update> 部分给 AI——这就用到了酒馆正则.

酒馆正则能够捕获 AI 回复和用户输入中的特定文本, 让它在某些用途下被替换为指定内容:

  • 仅格式提示词: 在发送给 AI 时被替换为指定内容

  • 仅格式显示: 在酒馆中显示时被替换为指定内容

  • 两个都不勾选: 在 AI 输出接收到时或用户输入发送出去时就被永久替换掉

../../../../_images/%E9%85%92%E9%A6%86%E6%AD%A3%E5%88%99.png

提示

如果你还不够理解以上说明, 也许可以看看自己酒馆中的预设配套正则或者角色卡里的美化正则.

为了便于大家操作, 青空莉已经提前制作了可作用于 <update> 和 MVU 原帖的 <UpdateVariable> 风格变量更新输出的酒馆正则, 你只需下载导入其中一个版本即可:

回顾#

至此, 我们的变量环境已搭建完毕:

  • 我们在 [initvar] 条目中正确设置了变量和它们的初始值

  • AI 通过 <status_description> 了解了当前的变量状态

  • AI 通过 check list 了解了变量更新规则

  • AI 通过 format 知晓了更新变量所需的输出格式

  • 我们用酒馆正则让 AI 之前输出的变量更新文本不会再发送给 AI, 防止 AI 过拟合

这套环境已经能有效替代传统的、需要每层都完整输出所有文本的状态栏, 能够精准地提醒 AI 当前的剧情状态.

但是玩家还看不到这些. 也许我们想为玩家显示好感度数值, 或者更好地, 根据当前好感度数值所在区间, 显示一个特殊的好感度阶段名称. 这要怎么做呢?

心语:
  associated variable: 心语好感度({{getvar::心语好感度}})
  stage name:
    阶段1: 甜蜜试探(24以下)
    阶段2: 甘甜陷阱(25~49)
    阶段3: 虚实交错(50~74)
    阶段4: 坦诚相见(75~99)
    阶段5: 完美恋人(100以上)