酒馆助手安卓教程:SillyTavern + JS-Slash-Runner 安装与排错
酒馆助手安卓教程:SillyTavern + JS-Slash-Runner 安装与排错
Contents
在安卓手机上用酒馆助手,核心是先部署 SillyTavern,再安装 JS-Slash-Runner 扩展。部署可走 Termux 手动方案,也可用 TauriTavern 原生应用;前者适合想控制和排错的人,后者免命令行、适合新手。
简介
本文面向 Android 手机/平板用户,讲清 SillyTavern 的两条部署路径,以及酒馆助手(JS-Slash-Runner)的安装、API 配置和常见排错。
前置准备
- Android 手机或平板。
- Termux 方案:Termux(来源 1 推荐 F-Droid;来源 5 也给出 GitHub APK)、存储权限、Git、Node.js/npm。
- TauriTavern 方案:Android APK,不需要 Node.js 和命令行。
- 能访问 GitHub、npm 等资源的网络;可选 Discord 账号,用于进入中文社区查教程和资源。
- 浏览器;来源 2 提到页面加载异常时可尝试 Edge。
- 一个可用的模型 API。来源中出现的示例包括 Google、DeepSeek、聚光AI 等,费用和额度以平台为准。
- 可选:角色卡、预设、正则、世界书文件。
分步教程
先选部署方式。两种 Android 路径的对比如下:
| 方式 | 入口 | 是否需要命令行 | 适合谁 | 注意点 |
|---|---|---|---|---|
| Termux 手动部署 | Termux + Git/Node.js | 是 | 想控制过程、方便排错的人 | 不同教程命令有分歧,任选一套,不要混用 |
| TauriTavern 原生应用 | GitHub Releases / 官网 APK | 否 | 不想碰命令行、想直接安装的人 | 来源称其非官方、独立维护,AGPL-3.0 |
方案 A:Termux 手动部署
- 安装 Termux。来源 1 推荐从 F-Droid 下载;来源 5 也给出 GitHub Releases 的 APK。安装后按来源 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。注意:两套命令来自不同教程,二选一即可。 - 克隆 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。注意:镜像和分支写法不同,不要混用。 - 启动酒馆。来源 1 用
node server.js;来源 2 用bash start.sh。随后在浏览器打开http://127.0.0.1:8000。若页面加载异常,来源 2 建议换 Edge 试试。 - 可选:设置快捷命令。来源 1 给出
qidong、gengxin、chongqi三个 alias,可写入~/.bashrc后执行source ~/.bashrc,以后用短命令启动、更新、重启。 - 可选:来源 1 提到 CandyBox Proxy 反代安装脚本;来源 5 提醒,Termux 要执行其他命令时,先按
q退出酒馆启动页。来源 5 还给出 JH-SillyTavern-Manager 一键脚本路径,安装后输入1可打开酒馆;第三方脚本请自行判断。
方案 B:TauriTavern 原生应用
- 从来源 3/4 给出的地址下载 Android 版:GitHub Releases 或
tauritavern.github.io/downloads/。 - 安装并打开。来源称它不需要 Node.js、不需要命令行,角色卡、聊天记录、预设、世界书与前端扩展兼容。
- 来源 3/4 说明:TauriTavern 前端已同步上游 1.18.0,后端由 Node.js 重构为 Rust(Tauri v2);它是独立维护的开源项目,并非 SillyTavern 官方客户端,遵循 AGPL-3.0。
- 即使使用 TauriTavern,仍建议继续安装酒馆助手和提示词模板,并配置 API。
如何安装酒馆助手(JS-Slash-Runner)
- 打开 SillyTavern,点击顶部扩展图标(拼图形状;来源 5 描述为“三个方块”)。
- 点击
Install Extension/ “安装扩充功能”,粘贴:https://github.com/N0VI028/JS-Slash-Runner。 - 若有“为所有使用者安装”选项,按来源 5 选择它;安装完成后刷新页面。
- 手动安装备用方案(Termux):执行
cd ~/SillyTavern/data/default-user/extensions,再执行git clone https://github.com/N0VI028/JS-Slash-Runner,刷新页面。 - 可选但常用:提示词模板 ST-Prompt-Template。来源 3/4 给的是
https://github.com/zonde306/ST-Prompt-Template,来源 5 给的是https://codeberg.org/zonde306/ST-Prompt-Template/。两个地址在来源中都出现,优先选能正常访问的地址,不要重复装两份。 - 若使用正则:来源 5 说明可在“酒馆助手 → 脚本库 → 导入”安装压缩包,安装后记得手动打开;成功后左下角魔法棒区域会出现上传正则入口。
如何配置 API 并开始聊天
- 打开酒馆页面,点击左上角插头图标,选择“聊天补全 / Chat Completion”。
- 选择来源。来源 5 以 Google API 为例;来源 2 以自定义 OpenAI 兼容端点为例。
- 来源 2 的示例参数:端点
https://ai.juguang.chat/,填写密钥,模型可填gemini-2.5-pro或gemini-2.5-flash。这只是来源示例,不代表唯一选择。 - 发送测试消息。来源 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:8000 | Termux 进程被终止,或启动脚本没运行 | 保持 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。