酒馆助手 (Tavern Helper)
简介
酒馆助手是一个为 SillyTavern 设计的多功能扩展. 它不仅能在对话中渲染交互式的前端界面, 还能实现与 SillyTavern 本身的深度交互, 以及作为中间层连接 SillyTavern 与外部应用程序. 通过这个扩展, 你可以:

🖥️ 为角色卡提供更好的 UI 显示: 如将消息楼层中原本只是代码块纯文本的状态栏美化为有动态效果、有交互的 html 状态栏
🎮 实现非纯文本的游玩体验: 如监听现实时间或酒馆事件来实现 meta 游戏、播放多媒体文件、自制游玩界面并与酒馆交互
🔧 优化酒馆使用体验: 如用 jQuery 为预设提示词条目新增复制按钮, 监听酒馆接收到消息事件并判断是否需要重新生成本楼层消息
🔌 连接外部应用程序: 如通过 socket.io-client 连接外部服务器, 进而实现外部应用程序与酒馆的通信
🎁 新增额外功能: 如每 20 楼在后台调用一次 LLM 来生成对之前剧情的总结
...
指引
根据你的需求, 可以查看以下内容:

💾 安装与更新 - 如何安装和配置酒馆助手
📖 基本用法 - 学习酒馆助手在 SillyTavern 中的基本用法
🔍 功能详情 - 作为角色卡编写者/开发者, 深入了解所有可用功能
❓ 常见问题解答 - 作为角色卡游玩者, 解决使用中遇到的问题
安全风险
酒馆助手允许执行自定义 JavaScript 代码, 这可能会带来安全风险:

恶意脚本可能会窃取你的 API 密钥、聊天记录等敏感信息; 修改或破坏你的 SillyTavern 设置
某些脚本可能会执行危险操作, 如发送未经授权的请求
请在执行任何脚本前:

仔细检查脚本内容, 确保其来源可信
理解脚本的功能和可能的影响
如有疑问, 请勿执行来源不明的脚本
我们不为第三方脚本造成的任何损失负责

参考项目
【SillyTavern / ST酒馆】html代码注入器 - 参考了使用捕捉代码块的方式来替换渲染界面的思路
Dynamic Audio - 参考了播放器布局

Views: 179363
Last updated: 2025/12/29 16:18

安装与更新
安装方法
安装失败了？
安装中遇到问题请看安装与更新问题

仅支持 1.12.14 版本及以上酒馆

在线安装
点击 SillyTavern 顶部的扩展图标, 选择安装扩展, 在弹出框内二选一任选一个链接填入:

https://github.com/n0vi028/JS-Slash-Runner (推荐, 需要开梯子)
https://gitlab.com/novi028/JS-Slash-Runner
然后点击保存即可.

图片示意:安装方法

视频演示:

手动安装
注意
手动安装的扩展无法在 SillyTavern 内一键更新, 需要手动删除并重新安装.

确保为国外网络环境
访问 N0VI028/JS-Slash-Runner
点击页面右上角绿色按钮 Code, 选择 Download ZIP 下载压缩包
解压并重命名为 JS-Slash-Runner
移动到相应的扩展目录
如果想要为酒馆所有用户安装, 移动到 SillyTavern/public/scripts/extensions/third-party 目录
如果想为指定用户安装, 移动到 SillyTavern/data/default-user/extensions 目录 (酒馆多用户使用者请将 default-user 替换为实际用户名)
安装指定版本
注意
注意安装指定版本前, 先卸载酒馆助手

在线安装
点击 SillyTavern 顶部的扩展图标, 选择安装扩展, 在弹出框中的下方输入框填入版本号:

安装指定版本

手动安装
与最新版本的手动安装方法基本一致, 只需要先在 github 仓库页面先切换到特定版本的 tag, 然后下载对应版本的压缩包.

安装指定版本-手动

更新方法
更新失败了？
更新中遇到问题请看安装与更新问题

扩展自带的更新按钮
有新版本时
检测到新版本时, 在扩展界面上会出现提示新版本的横幅, 点击更新即可.

扩展内更新
无新版本时
无新版本时, 点击右上角的扩展信息按钮, 在弹出的窗口中点击"查看日志"可以手动更新.

查看更新日志
SillyTavern 内更新
点击 SillyTavern 顶部的扩展图标, 然后点击 "管理扩展". 此时将会弹出一个界面, 查看弹出界面下方, 若扩展有版本更新, 则其名称会显示为绿色, 并额外有一个更新按钮.

更新方法1更新方法2
Views: 417550
Last updated: 2026/3/12 18:09

Pager
Previous page
介绍
Next page
安装与更新问题