SillyTavern（酒館）新手教學：安裝、API Key、角色卡一次搞懂
這是一篇純文字教學，不靠截圖——所有步驟都是指令與明確的檔名，照著打就能完成。 寫給完全沒碰過 SillyTavern 的新手：從它是什麼、怎麼裝、API Key 去哪拿，到裝完之後怎麼開始玩。
目錄
一、酒館是什麼？
SillyTavern（社群暱稱「酒館」）是一套裝在自己電腦或手機上的 AI 角色扮演前端。 它本身不會產生文字——你要另外準備一組 AI 服務的 API Key（例如 Gemini、DeepSeek、OpenAI）， 酒館負責把你的角色卡、世界書（lorebook）、對話歷史組合成提示詞送給 AI，再把回覆漂亮地呈現出來。
它的最大優點是自由度：提示詞、模型參數、擴充功能、介面主題，每一層都能自己調。 代價則是所有東西都要自己來：自己安裝、自己更新、自己接 API、自己管費用。 這篇教學會把「自己來」的部分一步步講清楚。
二、開始前要準備什麼
- 一台電腦（Windows 10/11）或 Android 手機。酒館是本地程式，跑在誰身上就得裝在誰身上。Windows 7 無法安裝（跑不動它需要的 Node.js 版本）。
- Node.js。酒館用它執行，裝最新 LTS（長期支援）版即可；下面各平台步驟會帶到。
- 一組 AI 服務的 API Key。這是多數新手卡最久的一步——要去 AI 供應商網站註冊、 （多半）綁信用卡、拿到一串金鑰。第五節會專門講。
- 基本的資料夾與命令列概念。不用會寫程式，但要敢開「命令提示字元」貼上指令。
三、Windows 安裝
官方提供三種裝法，新手建議走「Git 安裝」——之後更新最省事。
- 安裝 Node.js：到
nodejs.org下載 LTS 版，一路下一步。 - 安裝 Git for Windows：到
git-scm.com下載，同樣一路下一步。 - 挑一個普通資料夾（例如
C:\ST或D:\Games）， 在檔案總管的路徑列輸入cmd按 Enter，開出命令提示字元。 - 貼上這行指令下載酒館（release 是穩定版）：
git clone https://github.com/SillyTavern/SillyTavern -b release - 進入下載好的
SillyTavern資料夾，雙擊Start.bat。 第一次啟動會自動安裝依賴，跑完瀏覽器會自己打開酒館介面（預設網址http://127.0.0.1:8000）。
三條官方紅字警告，先記起來可以省掉九成疑難雜症：
- 不要裝進
Program Files、System32等系統資料夾。 - 不要用「以系統管理員身分執行」跑
Start.bat。 - Windows 7 裝不起來，不用試。
之後要更新：在 SillyTavern 資料夾開命令提示字元，執行git pull 再重開 Start.bat 即可。
四、Android（Termux）安裝
手機版靠 Termux（一個 Android 終端機模擬器）來跑。第一個坑就在下載來源：不要從 Google Play 商店裝 Termux（那個版本已停止維護，套件會裝不起來）， 要從 F-Droid（f-droid.org）或 Termux 的 GitHub Releases 頁下載 APK。
- 裝好 Termux 後打開，先換套件庫並更新（跳出詢問一律按 Enter 用預設值）：
termux-change-repo pkg update && pkg upgrade - 安裝需要的工具：
pkg install git nodejs-lts - 下載並啟動酒館：
git clone https://github.com/SillyTavern/SillyTavern -b release cd SillyTavern bash start.sh - 啟動完成後，開手機瀏覽器連
http://127.0.0.1:8000就能看到介面。
之後要更新，在 Termux 裡執行：
cd ~/SillyTavern
git pull --rebase --autostash提醒：手機跑酒館，Termux 得一直掛在背景，切出去久了可能被系統回收、要重新啟動； 老舊或 32 位元的手機還會遇到額外的相容性問題。手機黨請先有心理準備。
五、申請 API Key 與費用概念
酒館裝好只是空殼，要接上 AI 才會動。常見選擇：Google 的 Gemini（AI Studio 申請）、 DeepSeek、OpenAI，或聚合平台 OpenRouter（一把 Key 用多家模型）。流程大同小異： 註冊該服務的帳號 → 到後台建立 API Key → 把那串金鑰貼進酒館的 API 連線設定。
兩個新手最常誤解的觀念：
- 計費單位是 token（詞元）。你送出的整段上下文（角色卡＋世界書＋歷史對話） 加上 AI 的回覆，全都按量計費。角色卡塞得越肥、對話越長，每一句話就越貴。
- 「免費額度」別抱太高期待。各家免費層政策變動非常頻繁， 實測常常是額度極低、排隊限速，或新帳號根本拿不到可用額度。 想穩定玩，基本上要準備綁卡付費。
六、角色卡與世界書
接上 AI 之後，你需要「內容」——這就是角色卡與世界書：
- 角色卡：一張內嵌了角色設定的 PNG 圖片（外觀是立繪，資料藏在圖檔裡）， 這是社群通用格式。把別人分享的卡片檔匯入酒館，就能直接跟那個角色開始對話。
- 世界書（lorebook）：一組「關鍵字 → 設定條目」的資料。對話提到關鍵字時， 對應設定會自動塞進提示詞，讓 AI 記得你的世界觀細節。
新手起步可以先到社群論壇找公開分享的角色卡試玩，再學著自己寫。 順帶一提：酒館格式的 PNG 角色卡是通用資產——世界書網頁版也能直接匯入， 你在酒館做的卡、或社群下載的卡，兩邊都能用，先在哪邊玩都不浪費。
七、常見問題
- Start.bat 一閃就關 / 裝完打不開？
- 九成是裝錯位置或權限問題：確認沒有裝在
Program Files等系統資料夾、 沒有用系統管理員身分執行，且 Node.js 是官方 LTS 版。搬到C:\ST這類普通資料夾重跑一次。 - Termux 一直說套件裝不起來？
- 檢查 Termux 是不是從 Google Play 裝的——那個版本已停止維護，請改從 F-Droid 或 GitHub Releases 下載後重裝，並先跑
termux-change-repo與pkg update。 - 啟動了，但瀏覽器打不開介面？
- 確認終端機視窗還開著（關掉它酒館就停了），然後手動連
http://127.0.0.1:8000。 被防火牆詢問時要允許 Node.js。 - AI 一直不回話或回一半斷掉？
- 先看酒館終端機視窗的錯誤訊息：多半是 API Key 貼錯、額度用完，或該模型限速。 換一組 Key 或換模型測試就能定位問題。
- 怎麼更新酒館？
- Windows：在安裝資料夾開命令提示字元執行
git pull。 Termux：cd ~/SillyTavern && git pull --rebase --autostash。更新後重新啟動即可。
八、覺得太麻煩？免安裝的替代方案
看完整篇還是覺得「我只是想玩個故事，怎麼要先當半個工程師」——這很正常， 也是我們做世界書（world-book-ai.com）的原因：把安裝、接 API、 維護狀態這些工程活收進引擎，讓你開網頁就能玩長篇 AI 互動小說。兩邊的差異老實列給你：
| SillyTavern（酒館） | 世界書（本站） | |
|---|---|---|
| 安裝 | 自己裝、自己更新 | 開網頁就玩，免安裝 |
| AI 來源 | 必須自己申請 API Key | 註冊即可免費獲得 30 天試用方案（5000 墨量 AI 運算量）；也可自帶 API Key |
| 狀態欄（血量／背包／任務） | 靠提示詞請 AI 輸出，容易漂移、吃 token | 遊戲引擎記帳，AI 只負責寫故事 |
| 擲骰與數值 | 要自己裝擴充、調提示詞 | 內建 D100 對難度值，大成功大失敗 |
| 長篇記憶 | 上下文有限，長對話要自己管理摘要 | 平台維護分層記憶與伏筆表，可連載數百章 |
| 角色卡 | 社群 PNG 格式 | 同格式可直接匯入 |
| 內容尺度 | 取決於你接的 AI 供應商政策 | 全年齡平台，有平台層內容規範 |
| 自由度 | 最高：每一層提示詞都能自己控制 | 世界內自由；想改設定就 fork 一份世界書來改 |
說句公道話：如果你想完全掌控每一段提示詞、把調教本身當樂趣，酒館仍然是最好的選擇， 這篇教學照著做就能入門。但如果你要的是「現在就開始玩一場會記得你所有選擇的長篇冒險」， 我們已經把機器調好了。
免安裝，開網頁就玩 →註冊完成信箱驗證即可免費獲得 30 天試用方案（5000 墨量 AI 運算量），不需要 API Key想先逛逛有什麼可玩：世界書市集（三國、修仙、中世紀、盛唐都有官方世界）， 或先讀本站新手指南了解玩法。 另外，如果你想不裝任何東西、直接用 ChatGPT 或 Gemini 跑團， 我們也寫了一篇AI 跑團教學。