酒館助手安卓教程: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。