酒馆助手安卓教程:SillyTavern + JS-Slash-Runner 安装与排错

酒馆助手安卓教程:SillyTavern + JS-Slash-Runner 安装与排错

酒馆助手安卓教程:SillyTavern + JS-Slash-Runner 安装与排错

Contents

在安卓手机上用酒馆助手,核心是先部署 SillyTavern,再安装 JS-Slash-Runner 扩展。部署可走 Termux 手动方案,也可用 TauriTavern 原生应用;前者适合想控制和排错的人,后者免命令行、适合新手。

简介

本文面向 Android 手机/平板用户,讲清 SillyTavern 的两条部署路径,以及酒馆助手(JS-Slash-Runner)的安装、API 配置和常见排错。

前置准备

分步教程

先选部署方式。两种 Android 路径的对比如下:

方式入口是否需要命令行适合谁注意点
Termux 手动部署Termux + Git/Node.js是想控制过程、方便排错的人不同教程命令有分歧,任选一套,不要混用
TauriTavern 原生应用GitHub Releases / 官网 APK否不想碰命令行、想直接安装的人来源称其非官方、独立维护,AGPL-3.0

方案 A:Termux 手动部署

  1. 安装 Termux。来源 1 推荐从 F-Droid 下载;来源 5 也给出 GitHub Releases 的 APK。安装后按来源 2 提示授予存储权限。
  2. 更新环境并安装依赖。来源 1 的写法是:pkg update && pkg upgrade -y,然后 pkg install git nodejs -y。来源 2 的写法是:apt update && apt upgrade -y,然后 pkg install -y nodejs-lts git,并可执行 npm config set registry https://registry.npmmirror.com。注意:两套命令来自不同教程,二选一即可。
  3. 克隆 SillyTavern 并安装依赖。来源 1:git clone https://github.com/SillyTavern/SillyTavern.git,cd SillyTavern,npm install。来源 2:git clone https://ghfast.top/https://github.com/SillyTavern/SillyTavern -b release,cd SillyTavern,npm install。注意:镜像和分支写法不同,不要混用。
  4. 启动酒馆。来源 1 用 node server.js;来源 2 用 bash start.sh。随后在浏览器打开 http://127.0.0.1:8000。若页面加载异常,来源 2 建议换 Edge 试试。
  5. 可选:设置快捷命令。来源 1 给出 qidong、gengxin、chongqi 三个 alias,可写入 ~/.bashrc 后执行 source ~/.bashrc,以后用短命令启动、更新、重启。
  6. 可选:来源 1 提到 CandyBox Proxy 反代安装脚本;来源 5 提醒,Termux 要执行其他命令时,先按 q 退出酒馆启动页。来源 5 还给出 JH-SillyTavern-Manager 一键脚本路径,安装后输入 1 可打开酒馆;第三方脚本请自行判断。

方案 B:TauriTavern 原生应用

  1. 从来源 3/4 给出的地址下载 Android 版:GitHub Releases 或 tauritavern.github.io/downloads/。
  2. 安装并打开。来源称它不需要 Node.js、不需要命令行,角色卡、聊天记录、预设、世界书与前端扩展兼容。
  3. 来源 3/4 说明:TauriTavern 前端已同步上游 1.18.0,后端由 Node.js 重构为 Rust(Tauri v2);它是独立维护的开源项目,并非 SillyTavern 官方客户端,遵循 AGPL-3.0。
  4. 即使使用 TauriTavern,仍建议继续安装酒馆助手和提示词模板,并配置 API。

如何安装酒馆助手(JS-Slash-Runner)

  1. 打开 SillyTavern,点击顶部扩展图标(拼图形状;来源 5 描述为“三个方块”)。
  2. 点击 Install Extension / “安装扩充功能”,粘贴:https://github.com/N0VI028/JS-Slash-Runner。
  3. 若有“为所有使用者安装”选项,按来源 5 选择它;安装完成后刷新页面。
  4. 手动安装备用方案(Termux):执行 cd ~/SillyTavern/data/default-user/extensions,再执行 git clone https://github.com/N0VI028/JS-Slash-Runner,刷新页面。
  5. 可选但常用:提示词模板 ST-Prompt-Template。来源 3/4 给的是 https://github.com/zonde306/ST-Prompt-Template,来源 5 给的是 https://codeberg.org/zonde306/ST-Prompt-Template/。两个地址在来源中都出现,优先选能正常访问的地址,不要重复装两份。
  6. 若使用正则:来源 5 说明可在“酒馆助手 → 脚本库 → 导入”安装压缩包,安装后记得手动打开;成功后左下角魔法棒区域会出现上传正则入口。

如何配置 API 并开始聊天

  1. 打开酒馆页面,点击左上角插头图标,选择“聊天补全 / Chat Completion”。
  2. 选择来源。来源 5 以 Google API 为例;来源 2 以自定义 OpenAI 兼容端点为例。
  3. 来源 2 的示例参数:端点 https://ai.juguang.chat/,填写密钥,模型可填 gemini-2.5-pro 或 gemini-2.5-flash。这只是来源示例,不代表唯一选择。
  4. 发送测试消息。来源 2 提到,底部显示“有效”即表示配置成功。

去哪找角色卡

本站不托管、不转载任何第三方角色卡,下面只给外部渠道,请自行下载并遵守各站条款。

档位渠道一句话定位外链
优先推荐aicharactercards.com审核较严、SFW 友好,适合先找干净卡。aicharactercards.com
优先推荐RisuRealm每张卡可带 CC 授权,支持多格式/导入 ID。realm.risuai.net
优先推荐character-tavern.com偏策展、界面体验较好。character-tavern.com
最大但偏成人chub.ai库最大,默认偏 NSFW,务必开 SFW 过滤和年龄验证。chub.ai
最大但偏成人JanitorAI目录大,成人内容需 ID 验证。JanitorAI
中文社区类脑/旅程等 Discord、cards.sillytavern.one中文社区和卡库,内容混合;类脑 wiki 可查入口。类脑 wiki / cards.sillytavern.one
进阶/创作者Hugging Face卡和预设仓库,按仓库 license 使用。huggingface.co
进阶/创作者Pygmalion社区渠道之一,使用前看清条款。pygmalion.chat
进阶/创作者r/SillyTavern英文社区讨论与资源线索。r/SillyTavern

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

常见问题排查

现象可能原因处理
浏览器打不开 127.0.0.1:8000Termux 进程被终止,或启动脚本没运行保持 Termux 前台运行,重新执行 node server.js 或 bash start.sh;可换 Edge
手机热点/局域网访问失败防火墙或 Termux 网络权限限制检查 Termux 网络权限,关闭热点防火墙限制
npm install 报错npm 源、缓存或 Node 版本问题设置 npmmirror 镜像、清理缓存、重跑 apt update;来源 2 提到可尝试 pkg install nodejs-18
扩展装完不显示没刷新、装错用户、手动路径不对刷新页面;确认“为所有使用者安装”;手动装确认路径是 ~/SillyTavern/data/default-user/extensions
正则/脚本没生效导入后未启用到酒馆助手脚本库中手动打开,再刷新页面
思考过程外露未开自动解析按来源 5 打开自动解析/显示隐藏内容,并把 think 改为 thinking 后保存
预设修改丢失未保存,或切换预设后恢复修改后保存,并定期备份预设
手机和 PC 资料不同步来源 5 提醒手机与 PC 资料默认不互通跨设备前自行备份/迁移;TauriTavern 支持多平台不等于自动同步
Termux 反代命令冲突酒馆启动页占用终端先按 q 退出启动页,再执行其他命令

FAQ

问:安卓一定要用 Termux 吗?
不一定。来源 3/4 给出 TauriTavern 原生应用方案,不需要 Node.js 和命令行;Termux 更适合想控制部署过程、方便排错的人。

问:酒馆助手和提示词模板必须一起装吗?
来源 3/4 说“几乎所有角色卡都需要两个扩展”,来源 5 也把两者列为常装项。实际使用中,部分角色卡会依赖提示词模板、正则或预设,建议先装酒馆助手,再按卡片说明补装。

问:安装扩展后没反应怎么办?
先刷新页面;再检查是否选择了“为所有使用者安装”。手动安装时确认目录是 ~/SillyTavern/data/default-user/extensions,并确认扩展文件夹已完整克隆。

问:TauriTavern 是官方客户端吗?
不是。来源 3/4 明确说它是独立维护的开源项目,并非 SillyTavern 官方客户端,遵循 AGPL-3.0。

问:手机和电脑的数据能同步吗?
来源 5 提醒手机和 PC 资料不互通;TauriTavern 虽覆盖多平台,但来源并未说数据会自动同步。跨设备使用前应自行备份和迁移。

问:酒馆助手能直接导入角色卡吗?
角色卡在 SillyTavern 的角色库导入;酒馆助手是前端扩展,不负责托管角色卡。常见格式为 V2/V3 的内嵌 PNG 或 JSON。

问:API 配置后不回话怎么办?
检查 API 来源、端点、密钥和模型名;来源 2 说测试后显示“有效”才算配置成功。延迟高时可换端点,或降低 max_tokens。

问:酒馆适合写小说吗?
来源 3/4 的讨论认为酒馆主要面向角色扮演,写小说不如 Cherry Studio、denova 等专用工具顺手;若坚持用酒馆,可先把设定、世界书和提示词组织好再试。

CTA

如果你已经按上面的对比表选定方案,接下来把酒馆助手扩展和 API 配好即可开始。更多安卓酒馆与酒馆助手教程整理,可访问 tuniang.ai。

Sources

这篇有帮助吗?