酒馆助手是什么、怎么安装使用?SillyTavern 扩展完整教程

酒馆助手是什么、怎么安装使用?SillyTavern 扩展完整教程

酒馆助手是什么、怎么安装使用?SillyTavern 扩展完整教程

Contents

酒馆助手(Tavern Helper,仓库名 JS-Slash-Runner)是 SillyTavern 的扩展底座,为其他扩展提供 JavaScript、数据读写、界面组件和 AI 交互能力。安装时在“扩展→安装扩展”粘贴仓库地址,装完勾选启用并刷新;国内网络可用 GitLab 镜像。它不是独立安卓 App。

简介:酒馆助手是什么?

这篇教程教你判断酒馆助手是什么、为什么很多高级扩展依赖它,以及在 SillyTavern 中安装、启用、验证和排查问题的完整流程。适合刚接触 SillyTavern、准备安装扩展或遇到“扩展报错”的用户。

酒馆助手本身几乎不直接提供具体玩法,更像“地基”:让其他扩展能运行 JavaScript、读写酒馆数据、创建按钮/菜单/弹窗、与 AI 交互。来源 5 称,约 80% 的高级扩展依赖它;没有它,记忆增强、表格记忆、文生图、QR 助手等扩展可能无法运行。

它可实现或支撑的能力包括:渲染交互式前端界面、把消息里的代码块状态栏美化为 HTML 状态栏、监听酒馆事件做 meta 游戏、播放多媒体、通过 socket.io-client 连接外部程序,以及每 20 楼调用一次 LLM 生成剧情总结等。

前置准备:安装前需要哪些环境和工具?

分步教程:酒馆助手怎么安装、启用和使用?

安装方式对比

安装方式适用场景操作要点注意点
扩展管理器 + GitHub能访问 GitHub 的常规 SillyTavern扩展→安装扩展,粘贴 https://github.com/N0VI028/JS-Slash-Runner.git国内可能超时,失败可重试或换镜像
扩展管理器 + GitLab 镜像国内网络更稳粘贴 https://gitlab.com/novi028/JS-Slash-Runner来源 5 称其内容与 GitHub 仓库一致
Termux 手动 clone安卓 Termux 自部署进入扩展目录后 git clone 仓库地址需先有 SillyTavern、git、nodejs;装完刷新页面

推荐路径:在 SillyTavern 扩展管理器安装

  1. 打开 SillyTavern,点击顶部“扩展”图标(拼图形状/四个方块样式)。
  2. 点击“安装扩展”或 “Install Extension”。
  3. 在输入框中粘贴仓库地址:GitHub 用 https://github.com/N0VI028/JS-Slash-Runner.git;国内网络可改用 GitLab 镜像 https://gitlab.com/novi028/JS-Slash-Runner。
  4. 安装范围选择 “Install for all users”。来源 5 建议即使只有一个人使用也选这一项。
  5. 等待安装完成。网络不稳时可能中途失败,清理输入框后重试。
  6. 刷新页面,在扩展列表中找到 Tavern Helper/酒馆助手,手动勾选启用。
  7. 打开任意角色对话,在输入框输入 /th help 但先不要回车;若出现自动补全或提示,说明扩展已启动。也可按 F12 查看 Console 是否有 Tavern Helper 加载日志。

备选路径:Termux 手动安装

  1. 进入 SillyTavern 的用户扩展目录:cd ~/SillyTavern/data/default-user/extensions。
  2. 执行:git clone https://github.com/N0VI028/JS-Slash-Runner。
  3. 返回酒馆页面刷新,并在扩展列表中勾选启用。
  4. 如果手动安装后仍不生效,优先检查目录位置、Node.js 版本和是否已启用扩展。

启用后怎么用?

  1. 先用 /th help 验证扩展是否工作。
  2. 在角色卡或预设中加入自定义 JavaScript,可实现发送前改写输入、接收后隐藏关键词等操作。
  3. 可定义自定义 Slash 命令,例如用 /summary 总结最近对话、/save 备份当前对话、/mode dark 切换主题;这些是来源 5 给出的用法示例。
  4. 高级玩法包括:AI 回复后提取“好感度+1”并更新表格,或检测关键词触发文生图。
  5. 需要连接外部程序时,可通过 socket.io-client 与外部服务器通信。

安全提醒:酒馆助手允许执行自定义 JavaScript,恶意脚本可能窃取 API 密钥、聊天记录,修改酒馆设置或发送未经授权请求。执行任何脚本前先检查来源和功能;来源不明时不要运行。

去哪找角色卡?

酒馆助手是扩展底座,装好后通常还要配合角色卡使用。本站不托管、不转载任何第三方角色卡,以下仅提供获取渠道,请自行下载并遵守各站条款。

以上多为用户生成内容、含成人分级(NSFW),请开启 SFW 过滤并遵守年龄验证;角色卡版权归原作者,下载与使用请遵循各站条款。角色卡格式常见 V2/V3,可能是内嵌 PNG 或 JSON。

常见问题排查:安装失败或报错怎么办?

现象可能原因处理办法
安装时提示仓库地址无效URL 少了 .git、多了空格或复制不完整清空输入框,重新精确粘贴仓库地址
一直转圈或安装超时GitHub 网络不通改用 GitLab 镜像,或开代理后重试
报 “Module not found”本地 Node.js 版本过旧或依赖缺失升级 Node.js 到 18+,再重装扩展
装完没有任何反应扩展未启用到扩展面板手动勾选 Tavern Helper/酒馆助手,刷新页面
某个扩展报错缺少酒馆助手,或版本不兼容先装酒馆助手;再检查该扩展要求的版本
卸载后仍残留问题扩展目录未清理干净停酒馆,删除 public/scripts/extensions/third-party/JS-Slash-Runner 一类目录后重装;目录名以实际安装为准
更新后异常酒馆助手不会自动更新,新旧版本冲突在扩展面板更新或重装;核对其他扩展的兼容说明

来源冲突提示:来源 3 将“Silly Tavern 酒馆助手”列为安卓应用,标注版本 1.3.8、大小 16.18MB、更新 2026-08-06;来源 1 和来源 5 则把酒馆助手描述为 SillyTavern 扩展(JS-Slash-Runner),不是独立 App。两者所指形态不一致,遇到同名 APK 应先核对来源、权限和仓库信息,不要直接混用。

FAQ:酒馆助手常见问题

酒馆助手和 JS-Slash-Runner 是同一个东西吗?
是。按来源 5 的说法,JS-Slash-Runner 是仓库名,酒馆助手/Tavern Helper 是中文社区常用叫法,装一次即可。

不装酒馆助手会怎样?
基础聊天仍可用,但依赖它的高级扩展可能无法运行。来源 5 称,很多“某某扩展报错”的问题,根源就是没装这个底座。

安装后怎么快速验证?
输入 /th help 看是否出现补全或提示;也可打开浏览器 Console 查看是否有 Tavern Helper 加载日志。

酒馆助手会自动更新吗?
不会自动更新。作者发布新版本后,需要在扩展面板更新或重新安装。

手机能安装吗?
可以,但通常是在手机上的 SillyTavern 环境里安装扩展;Termux 手动安装是其中一种方式。它本身不是独立安卓 App。

国内网络安装失败怎么办?
优先尝试 GitLab 镜像 https://gitlab.com/novi028/JS-Slash-Runner,或使用代理;安装后仍要手动勾选启用。

酒馆助手安全吗?
它允许执行自定义 JavaScript,存在脚本风险。不要运行来源不明的脚本,安装前确认仓库和脚本内容可信。

用 SillyTavern 写小说合适吗?
来源 2 的讨论中,多位用户认为 SillyTavern 更偏角色扮演,写小说可另选专用写作工具;酒馆助手是扩展底座,不直接解决小说工作流。

CTA

如果你想继续排查 SillyTavern 扩展、角色卡和安装配置问题,可到 tuniang.ai 查看相关教程与工具整理。

Sources

这篇有帮助吗?