深色模式
酒館助手（JS-Slash-Runner）安裝與使用教學
酒館助手是一個「執行環境」——它讓酒館能跑 JavaScript、做前端注入。很多進階的變量卡、劇情系統卡、UI 卡都內建一段程式碼，這段程式碼要靠酒館助手才跑得起來。簡單講：卡下載回來按不動，十之八九就是因為沒裝它。
這是什麼？為什麼你會需要它
酒館本身不能直接跑卡片裡夾帶的 JavaScript。酒館助手補的就是這個洞：它用 iframe 把卡片的腳本隔在一個受限環境裡執行，讓那些「會自己算數值、會跳出面板、會即時改畫面」的卡能正常運作。
你會需要它，通常是因為下載了某張卡，卡的說明寫著「請先安裝酒館助手 / JS-Slash-Runner / Tavern Helper」。如果你只是單純聊天、用一般角色卡，其實用不到它。
它只是「環境」，不是「功能」
裝了酒館助手本身不會讓酒館多出什麼看得到的功能。真正的功能來自你裝的那張卡。把它想成「播放器」，卡片才是「影片」——沒播放器影片播不出來，但光有播放器也沒東西看。
怎麼安裝
最簡單的方式就是用酒館內建的擴充安裝器：
- 開啟酒館，點上方的「擴充功能」→「安裝擴充功能」
- 貼上網址：
https://github.com/N0VI028/JS-Slash-Runner - 點安裝，等它跑完，重新整理頁面
版本需求：酒館本體建議在 1.12.14 以上。版本太舊可能裝了不顯示，先把酒館更新到新版再試。
安裝中途失敗？
酒館助手安裝時會去抓一些第三方函式庫，網路不通就會卡住。如果一直失敗，換個網路、開個 VPN 再試一次通常就過了。真的不行就改用手動安裝：把整個 repo 下載解壓到 SillyTavern/public/scripts/extensions/third-party/JS-Slash-Runner/，再重啟酒館。
安裝後推薦關閉的設定
酒館助手預設會開啟兩個「優化」選項，但實際上容易跟你自己的設定打架，建議安裝後馬上去關掉：
- 强制使用推荐的世界书全局设置：會覆蓋你自己調的世界書設定，關掉才不會被它改回去
- 最大化预设上下文长度：會自動把上下文拉到最大，跟你在推薦設定裡調好的值衝突，關掉
到擴充功能 → 酒館助手的設定面板裡，把這兩個開關關掉就好。
內建腳本庫
酒館助手裡有一個內建的腳本庫，裡面已經預載了一些實用的腳本可以直接安裝使用，不用自己去外面找。裝好酒館助手之後可以去翻翻看有沒有你需要的。
裝完之後呢？卡還是不動怎麼辦
這是新手最常卡住的地方。正常流程是這樣：
- 裝好酒館助手、重整頁面
- 把你下載的變量卡（
.json或.png）匯入酒館 - 選那張卡、直接開始聊天——多數卡到這步就會動了，不用再開什麼特殊開關
如果還是不動，按這個順序排查：
| 症狀 | 多半是 | 怎麼救 |
|---|---|---|
| 卡的數值/面板完全沒反應 | 酒館助手沒載入成功 | 按 F5 重整，確認擴充面板裡酒館助手是啟用的 |
| 更新擴充後還是舊的樣子 | 瀏覽器快取沒清 | 清快取（含 Cookie）再重整，手機可試無痕視窗 |
| 卡說還要另一個擴充 | 那張卡額外依賴別的工具 | 照卡片說明把相依的擴充也裝上（常見的是下面講的 ST-Prompt-Template） |
| 跳出紅色錯誤 | 卡的程式跟你的酒館版本衝突 | 更新酒館、清快取重啟，或換一個版本的卡 |
八成的「裝好卻不動」都是快取
遇到怪問題，先做這兩件事：F5 重整 ＋ 清瀏覽器快取。這能解掉大部分「明明裝好就是沒反應」的狀況，再不行才往卡片相依、版本衝突的方向查。
安全須知（這段一定要看）
它能跑任意程式碼，等於把卡片的權限放到最大
酒館助手會執行卡片裡的 JavaScript，也就是說，惡意的卡理論上可以讀你的 API 金鑰、偷聊天紀錄、亂改酒館設定，甚至把資料送到外部伺服器。官方也明講對第三方卡造成的損害不負責。
保護自己的幾個原則：
- 只裝來路明確、社群驗證過的卡，別隨手貼陌生人的卡片
- 不放心的卡，安裝前把它的 GitHub 連結或檔案丟給 AI（Gemini、GPT）幫你看一下程式碼在做什麼
- 玩過一堆陌生卡之後，記得定期換 API 金鑰
- 重要帳號在用的酒館，不要拿來亂試卡
更完整的安全觀念在課程第七幕（安全須知）。
進階：跟 ST-Prompt-Template、變量卡的關係
你常會聽到「玩變量卡要裝酒館助手＋ST-Prompt-Template」，這三個東西的分工是這樣：
- 酒館助手（JS-Slash-Runner）：前端執行環境，跑卡片的 JavaScript、撐起變量系統。多數變量卡的基礎。
- ST-Prompt-Template：讓你在提示詞、角色卡、世界書裡寫邏輯跟管變量（用 EJS 語法）。偏「後端模板」，比較進階。
- 變量卡（例如 mvu 那套）：卡片本身，是「內容」，通常會在說明裡指定它需要上面哪些工具。
它們不是「一定要三個一起裝」，而是看卡片要求按需組合：玩基礎變量卡多半只要酒館助手＋卡本身；卡片如果用到動態提示詞、複雜變量運算，才會再叫你裝 ST-Prompt-Template。
照卡片說明走就對了
不用自己猜要裝哪些。每張正經的變量卡都會在說明裡寫清楚「需要哪些前置擴充」，照著裝即可。這頁先讓你搞懂酒館助手是什麼、為什麼非它不可。