酒馆助手是什么、怎么安装使用?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 生成剧情总结等。
前置准备:安装前需要哪些环境和工具?
- 已安装并能启动 SillyTavern,能打开其 Web 界面。
- 能访问扩展仓库的网络;国内网络访问 GitHub 可能超时,建议准备 GitLab 镜像或代理。
- 如果本地部署,Node.js 建议 18+,避免出现 “Module not found” 一类依赖错误。
- 如果在安卓 Termux 中手动安装,需要先具备
git、nodejs和已部署的 SillyTavern 目录。 - 浏览器可正常访问酒馆页面;Termux 自部署常见地址为
http://127.0.0.1:8000。
分步教程:酒馆助手怎么安装、启用和使用?
安装方式对比
| 安装方式 | 适用场景 | 操作要点 | 注意点 |
|---|---|---|---|
| 扩展管理器 + 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 扩展管理器安装
- 打开 SillyTavern,点击顶部“扩展”图标(拼图形状/四个方块样式)。
- 点击“安装扩展”或 “Install Extension”。
- 在输入框中粘贴仓库地址:GitHub 用
https://github.com/N0VI028/JS-Slash-Runner.git;国内网络可改用 GitLab 镜像https://gitlab.com/novi028/JS-Slash-Runner。 - 安装范围选择 “Install for all users”。来源 5 建议即使只有一个人使用也选这一项。
- 等待安装完成。网络不稳时可能中途失败,清理输入框后重试。
- 刷新页面,在扩展列表中找到 Tavern Helper/酒馆助手,手动勾选启用。
- 打开任意角色对话,在输入框输入
/th help但先不要回车;若出现自动补全或提示,说明扩展已启动。也可按 F12 查看 Console 是否有 Tavern Helper 加载日志。
备选路径:Termux 手动安装
- 进入 SillyTavern 的用户扩展目录:
cd ~/SillyTavern/data/default-user/extensions。 - 执行:
git clone https://github.com/N0VI028/JS-Slash-Runner。 - 返回酒馆页面刷新,并在扩展列表中勾选启用。
- 如果手动安装后仍不生效,优先检查目录位置、Node.js 版本和是否已启用扩展。
启用后怎么用?
- 先用
/th help验证扩展是否工作。 - 在角色卡或预设中加入自定义 JavaScript,可实现发送前改写输入、接收后隐藏关键词等操作。
- 可定义自定义 Slash 命令,例如用
/summary总结最近对话、/save备份当前对话、/mode dark切换主题;这些是来源 5 给出的用法示例。 - 高级玩法包括:AI 回复后提取“好感度+1”并更新表格,或检测关键词触发文生图。
- 需要连接外部程序时,可通过 socket.io-client 与外部服务器通信。
安全提醒:酒馆助手允许执行自定义 JavaScript,恶意脚本可能窃取 API 密钥、聊天记录,修改酒馆设置或发送未经授权请求。执行任何脚本前先检查来源和功能;来源不明时不要运行。
去哪找角色卡?
酒馆助手是扩展底座,装好后通常还要配合角色卡使用。本站不托管、不转载任何第三方角色卡,以下仅提供获取渠道,请自行下载并遵守各站条款。
- 优先推荐(相对干净/授权清晰):aicharactercards.com —— 审核较严、SFW 友好;RisuRealm —— 每张卡可带 CC 授权,支持多格式/导入 ID;character-tavern.com —— 策展与 UX 较好。
- 最大但偏成人(务必注意分级):chub.ai —— 库最大,默认偏 NSFW,请开启 SFW 过滤和年龄验证;JanitorAI —— 目录大,成人内容需 ID 验证。
- 中文社区:类脑 / 旅程等 SillyTavern 中文 Discord;cards.sillytavern.one —— 中文卡库,混合内容;类脑 Wiki —— 社区入口之一。
- 进阶/创作者:Hugging Face 上的卡/预设仓库(按仓库 license)、Pygmalion、r/SillyTavern。
以上多为用户生成内容、含成人分级(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 查看相关教程与工具整理。