酒館助手是什麼、怎麼安裝使用?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 檢視相關教程與工具整理。