酒館助手是什麼、怎麼安裝使用?SillyTavern 擴充套件完整教程

酒館助手是什麼、怎麼安裝使用?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 生成劇情總結等。

前置準備:安裝前需要哪些環境和工具?

分步教程:酒館助手怎麼安裝、啟用和使用?

安裝方式對比

安裝方式適用場景操作要點注意點
擴充套件管理器 + 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 擴充套件管理器安裝

  1. 開啟 SillyTavern,點選頂部“擴充套件”圖示(拼圖形狀/四個方塊樣式)。
  2. 點選“安裝擴充套件”或 “Install Extension”。
  3. 在輸入框中貼上倉庫地址:GitHub 用 https://github.com/N0VI028/JS-Slash-Runner.git;國內網路可改用 GitLab 映象 https://gitlab.com/novi028/JS-Slash-Runner。
  4. 安裝範圍選擇 “Install for all users”。來源 5 建議即使只有一個人使用也選這一項。
  5. 等待安裝完成。網路不穩時可能中途失敗,清理輸入框後重試。
  6. 重新整理頁面,在擴充套件列表中找到 Tavern Helper/酒館助手,手動勾選啟用。
  7. 開啟任意角色對話,在輸入框輸入 /th help 但先不要回車;若出現自動補全或提示,說明擴充套件已啟動。也可按 F12 檢視 Console 是否有 Tavern Helper 載入日誌。

備選路徑:Termux 手動安裝

  1. 進入 SillyTavern 的使用者擴充套件目錄:cd ~/SillyTavern/data/default-user/extensions。
  2. 執行:git clone https://github.com/N0VI028/JS-Slash-Runner。
  3. 返回酒館頁面重新整理,並在擴充套件列表中勾選啟用。
  4. 如果手動安裝後仍不生效,優先檢查目錄位置、Node.js 版本和是否已啟用擴充套件。

啟用後怎麼用?

  1. 先用 /th help 驗證擴充套件是否工作。
  2. 在角色卡或預設中加入自定義 JavaScript,可實現傳送前改寫輸入、接收後隱藏關鍵詞等操作。
  3. 可定義自定義 Slash 命令,例如用 /summary 總結最近對話、/save 備份當前對話、/mode dark 切換主題;這些是來源 5 給出的用法示例。
  4. 高階玩法包括:AI 回覆後提取“好感度+1”並更新表格,或檢測關鍵詞觸發文生圖。
  5. 需要連線外部程式時,可通過 socket.io-client 與外部伺服器通訊。

安全提醒:酒館助手允許執行自定義 JavaScript,惡意指令碼可能竊取 API 金鑰、聊天記錄,修改酒館設定或傳送未經授權請求。執行任何指令碼前先檢查來源和功能;來源不明時不要執行。

去哪找角色卡?

酒館助手是擴充套件底座,裝好後通常還要配合角色卡使用。本站不託管、不轉載任何第三方角色卡,以下僅提供獲取渠道,請自行下載並遵守各站條款。

以上多為使用者生成內容、含成人分級(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 檢視相關教程與工具整理。

Sources

這篇有幫助嗎?