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

這篇有幫助嗎?