脚本库

提示

要使用这一功能的作者请务必先阅读如何正确使用酒馆助手, 里面有详细的编写 说明和应用提示.

酒馆助手的脚本库允许你在后台运行 JavaScript 脚本, 你因而可以做到每 20 楼自动调用一次 AI 来生成对之前剧情的总结等各种功能 , 且可以让这些功能与预设、角色卡等绑定.

和渲染器一样, 酒馆助手脚本也能使用 "功能详情" 中的各种功能, 如修改世界书、修改预设、设置变 量、注入提示词等.

绑定机制

脚本库分为全局、预设和角色脚本库:

• 全局脚本库: 适用于酒馆所有聊天
• 预设脚本库: 适用于当前预设, 会随预设一同导出
• 角色脚本库: 适用于当前角色卡, 会随角色卡一同导出

如何在脚本关闭时执行函数

使用下面的方法从而在脚本关闭时执行函数:

$(window).on('pagehide', () => {
  // 在这里编写脚本关闭时的逻辑
});

注意

如果想要在酒馆页面加载完时执行函数, 不要使用 DOMContentLoaded, 而是使用 $(() => { /* 在这里编写函数 */ }), 因为 DOMContentLoaded 发出时酒馆页面可能还没有加载完.

脚本按钮

你可以为脚本添加按钮, 则用户点击按钮时会触发脚本内指定功能.

绑定方法

按键绑定功能需要配合 getButtonEvent 使用, 在脚本中添加以下代码:

eventOn(getButtonEvent('按钮名称'), () => {
  // 在这里编写按键触发后的具体逻辑
  console.log('按键被点击');
});

'按钮名称' 需要与设置的按键名称一致. :::

将酒馆快速回复迁移成酒馆助手脚本

脚本按钮让酒馆助手脚本成为了酒馆快速回复的完全上位替代:

• 相比起写快速回复, AI 对于酒馆助手脚本的知识库更全面, 且我们专门提供 了如何正确使用酒馆助手让 AI 了解如何使用酒馆助手.
• 酒馆助手脚本其实对标的是酒馆插件, 在编写体验上甚至比酒馆插件更好; 而无论酒馆助手脚本还是酒馆插件, 它们所能做的大多数事 情是快速回复做不到的.

大多数快速回复都能直接写成酒馆助手脚本, 例如快速回复 /send 推进剧情 | /trigger 可以写成:

eventOn(getButtonEvent('推进'), () => {
  triggerSlash('/send 推进剧情 | /trigger');
});