阅读示例

阅读示例#

让我们导入示例角色卡, 来理解脚本和前端界面的作用和区别.

导入角色卡后, 我们通过扩展设置, 可以在酒馆助手 ‣ 脚本库和正则中分别看到该角色卡有以下角色脚本和局部正则:

这分别对应了酒馆助手所支持的两类向酒馆注入代码的方式, 与模板文件夹中的 src/脚本示例 和 src/界面示例 文件夹一一对应.

我们首先启用 脚本-发布给玩家, 将会收到一条弹窗提示:

这反映了脚本的功能: 在启用时执行一段代码, 可能上图那样的弹窗提示, 也可能是开始监听某些事件从而在事件发生时执行某段代码……

脚本可以在启用时执行一段代码. 除了上图那样的弹窗外, 你还能看到脚本新增了两个消息楼层:

脚本可以监听酒馆事件和酒馆助手事件. 例如, 让我们启用这个脚本, 然后通过铅笔尝试修改一下第 0 楼的内容.
当我们点击保存时, 脚本将会监听到 "消息楼层被修改" 事件:

脚本也可以监听自己的按钮点击事件. 例如, 我们启用脚本后会在输入框上方看见晚上好按钮, 点击它后, 脚本将会监听到 "玩家点击了晚上好按钮" 事件:

脚本还能监听自己的开关情况. 例如, 我们关闭脚本, 脚本会监听到 "脚本被关闭" 事件:

如果你点击酒馆助手 ‣ 脚本库 ‣ 内置库并添加预设防误触脚本, 就会发现你在开启脚本时不能修改预设设置, 关闭脚本后可以修改. 这其实就是脚本在启用时执行了一段代码, 让你不能修改预设设置; 而又监听 "脚本被关闭" 事件, 在脚本关闭时执行代码重新允许你修改预设设置.

总的来说, 脚本的作用就是:

如此, 你也许能理解 MVU 变量框架脚本做了什么: 启用它后, 它将监听 "接收到了新的消息楼层" 事件, 当事件发生时根据这个新楼层中的 _.set(...) 等命令来更新变量.

我们关闭脚本, 启用正则中的界面-发布给玩家正则, 将会收到整整三条弹窗提示:

为什么是三条弹窗提示? 让我们关掉这个正则, 来仔细理解一下它是怎么起作用的.

实际上, 酒馆助手支持前端界面的方式很简单: 如果消息楼层中某个代码块内存在 html 代码 (尤其是 <body></body> 标签), 那么酒馆助手会自动将这个 html 代码渲染成前端界面.
例如, 如果我们在消息楼层中添加以下代码块, 它会被渲染成一个超大的红色 "你好":

代码块由以下部分组成:

```text
<body>
  <span class="text-9xl text-red-600">你好</span>
</body>
```

但我们显然不想 AI 直接输出整个 html 代码块, 这既浪费 token 又容易出错. 有没有什么办法让 AI 只输出前端界面必要的剧情信息 (如角色当前穿着情况、所在位置等), 却又在酒馆页面上显示出 html 代码块从而渲染出前端界面呢? 酒馆正则的仅格式显示功能正能实现这个功能.

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

仅格式提示词: 在发送给 AI 时被替换为指定内容. 例如预设的[不发送]思维链正则将 <thinking> 块替换为空字符串, 从而不让 AI 收到之前消息中的思维链内容.
仅格式显示: 在酒馆中显示时被替换为指定内容. 例如预设的[隐藏]思维链正则将 <thinking> 块替换为空字符串, 从而不让玩家在酒馆页面中看到思维链部分.
两个都不勾选: 在 AI 输出接收到时或用户输入发送出去时就被永久替换掉