SillyTavern 酒馆入门：3.5 万星的本地 AI 角色扮演前端，到底怎么用
在中文 AI 圈子里，「酒馆」是一个出现频率很高、但很少被正经解释的词。它指的是 SillyTavern——一个跑在你自己电脑上的开源 AI 角色扮演前端。截至 2026 年 11 月，它在 GitHub 上有 35229 个星、6634 个 fork，最近一次正式版 1.19.0 发布于 2026 年 9 月 14 日。
很多人第一次打开它会被劝退：界面老旧、设置项密密麻麻、还得自己去搞一个模型 API 才能说话。但它也有一个别的地方给不了的东西——你对自己对话的每一个字都有控制权：角色怎么设定、世界观怎么注入、历史记录留多长、温度调到多少，全都在你手上。
这篇不是安装教程，而是把它讲清楚：酒馆到底是什么、那套「角色卡 / 世界书 / 预设」的术语体系怎么理解、它为什么自己不卖模型、以及什么人用了会觉得很值、什么人用了纯属浪费时间。
一句话结论：SillyTavern 是免费的「壳」，模型要你自己接
- 它是什么：本地运行的网页界面（默认
localhost:8000），官方定位是「给高级用户的 LLM 前端」。 - 它不是什么：不是模型、不是云服务、不是「下载就能聊天」的成品 App。它必须外接一个推理后端才能工作。
- 出身：2023 年 2 月从 TavernAI 1.2.8 分叉而来，现在有 300 多位贡献者，许可证是 AGPL-3.0。
- 门槛：装个 Node.js 20 以上就能跑，硬件要求极低；真正花时间的是调提示词和写角色卡，不是装机。
- 花钱的地方：软件本身免费。钱花在模型上——要么接云 API 按 token 计费，要么本地跑开源模型吃自己的显卡。
1）它凭什么值 3.5 万个星
市面上能跟 AI 角色聊天的产品不缺：Character.ai、各种角色扮演 App、各家大模型自带的对话界面。但它们有一个共同点——提示词是平台写的，不是你的。你能挑选角色，不能决定这个角色在后台被描述成什么样、记多久前的事、遇到特定情节时该不该提起某段设定。
SillyTavern 反过来：它把发给模型的整个请求拆开摆在你面前。角色描述、性格摘要、场景、示例对话、世界书条目、作者注释、历史消息裁剪策略、采样参数——每一项你都能改，也都能看到它最终拼成了什么。这在角色扮演里是决定性的差异，因为模型「像不像那个角色」，八成取决于提示词怎么组织，而不是取决于用了哪个模型。
代价是复杂。它默认假设你知道自己在干什么，第一次打开会被几十个下拉框和折叠面板劝退。这是「给高级用户」这句定位的真实含义——不是营销话术，是字面意思。
2）搞懂五个概念，酒馆就通了一半
酒馆的术语体系是它最大的认知门槛。其实就是五个东西：
| 概念 | 是什么 | 解决什么问题 |
|---|---|---|
| 角色卡（Character） | 一份提示词集合，规定模型扮演谁：名字、外貌描述、性格、场景、开场白、示例对话 | 让模型稳定地扮演同一个角色，而不是每轮重新自由发挥 |
| 人物（Persona） | 你自己的身份设定，会作为「用户」一侧注入 | 让角色知道「你在跟谁说话」，避免它把你当空气 |
| 世界书（World Info） | 一堆带触发关键词的设定条目，命中关键词时才注入提示词 | 用最少的 token 维持世界观一致性，而不是把设定全塞进上下文 |
| 预设（Preset / 提示词管理） | 一整套采样参数与提示词结构的组合 | 换风格、换模型时不用重调一遍参数，直接切换 |
| 数据银行（Data Bank） | 内置的检索增强，把长文档切块存储，按相关度取回 | 喂给角色大段背景资料，又不炸上下文窗口 |
另外还有两个高频功能：群聊可以同时让多个角色在场并互相回应；扩展则把能力往外扩——表情立绘、自动总结、界面翻译、图片生成（Stable Diffusion / FLUX / DALL·E）、TTS 语音、联网搜索，都有现成扩展。
把这五个概念理顺，剩下的就只是熟练度问题了。
3）角色卡为什么是一张 PNG
这是酒馆生态里最容易被误解的一点：你从社区下载的「角色卡」，通常是一张图片。一张角色立绘，右键另存，拖进酒馆就能用——设定藏在图里。
做法是把 JSON 序列化成 base64，写进 PNG 的元数据字段（Chara）里。这样一张图既是卡面也是数据，转发方便、也不会跟图片分离。这是 V1 卡规范的三条嵌入方式之一；另外两条是纯 JSON 文件（规范本身评价为「对用户不够友好」）和 WEBP（规范因技术歧义未纳入）。
V2 规范（2023 年 5 月定稿）在 V1 的基础上加了一层 data 包裹，并补充了 creator_notes（创作者备注）、system_prompt（覆盖系统提示词）、post_history_instructions（历史之后追加的指令）、alternate_greetings（多套开场白）、character_book（内嵌世界书）、标签、作者、版本号等字段。对使用者来说最实际的变化是：好卡可以直接把世界书一起打包，导入即用，不用再单独找设定文件。
顺带一句实用提醒：卡是别人写的提示词，等于别人在你的对话里说话。从不明来源导入角色卡，先看看它的 system_prompt 和 post_history_instructions 里到底写了什么——这不是危言耸听，提示词注入在角色卡生态里是真实存在的问题。
4）它不卖模型，模型要你自己接
这是理解酒馆成本结构的关键。软件免费、开源、本地跑，但它一句对话都生成不了——所有文字都来自你外接的那个后端。官方文档支持的接入面很宽，大致分两类：
| 类型 | 代表 | 特点 |
|---|---|---|
| 本地推理 | KoboldCpp、llama.cpp、Ollama、Text Generation WebUI、TabbyAPI、KoboldAI Classic | 一次性投入显卡，之后零边际成本；官方建议本地推理用 3000 系 NVIDIA 显卡、至少 6GB 显存起步 |
| 云端 API | OpenAI、Anthropic（Claude）、Google AI Studio / Vertex、DeepSeek、Mistral、OpenRouter、NovelAI、Perplexity、AI Horde 等 | 免部署、质量上限高，但按 token 计费，长对话烧钱很快 |
接口分两种结构，这点也影响选型：Chat Completion 把提示词组织成 user / assistant / system 三种角色消息，是 OpenAI 之后主流的形态；Text Completion 则是一条长文本让模型往下续写。不同模型对两种结构的适配程度不一样，酒馆分别做了两套配置界面。
这里必须说清一件事，因为它是最常见的误解：SillyTavern 需要的是 API key，不是你的 ChatGPT 或 Claude 订阅账号。订阅制账号本身不附带公开的 API 额度，第三方把订阅凭证逆向下转给普通接口使用，属于违反服务条款的用法，随时可能被封。想省心就用官方 API key 按量付费，或者干脆本地跑。
从花费上看，角色扮演是很「吃 token」的用法：上下文要长（角色设定 + 世界书 + 历史记录全在里面），对话轮数也多。同样是接 Claude 或 GPT，把它当聊天助理用和把它当角色扮演引擎用，账单差好几倍。这也是为什么社区里大量讨论落在「怎么裁历史」「怎么让世界书少占位置」上——在酒馆里，token 管理本身就是一门手艺。
5）1.19.0 更新了什么
2026 年 9 月 14 日发布的 1.19.0，是目前最新的正式版。官方稳定分支（release）大约每月更新一次，staging 分支则更新很频繁、但不保证不崩——新手建议留在 release。
- 模型接入大扩容：新增 Claude Fable 5 / 5.1、Claude Opus 4.8 / 5、Claude Sonnet 5，GPT-5.6 系列与 GPT-6 Astra，Gemini 3.5 / 3.6 / 3.7 Flash，GLM-5.2，DeepSeek V4 Flash Vision Exp 等。
- 模型列表抓取修复：Google AI Studio 现在会翻完所有分页；Fireworks AI、OpenRouter、NanoGPT、Pollinations 的 provider 列表也做了更新。
- 世界书改进：「应用当前排序」支持升/降序、可配置起始值与步长、并带实时校验；重命名世界书会同步更新聊天、角色、人物里的引用链接；条目排序去掉了平方级查找。
- 宏与扩展：宏变量支持访问数组与对象属性，新增角色表情相关宏；引入
MessageFormatter钩子，允许扩展在正则处理前、后或 Markdown 转换后改写消息内容。 - 安全修复：堵住
localhost与.localhost别名绕过私有地址检查的路径（/api/search/visit），给账号重置加了限流，收紧 npm 包来源规则。
从这份更新清单能看出它的重心在哪：不是加更炫的功能，而是把「接得上新模型」和「设定管理别出错」这两件事做扎实。对这类工具来说，这才是用户真正在意的东西。
6）谁该用，谁别碰
适合用的人：
- 愿意花几个小时调提示词，并且享受这个过程的人。酒馆的回报完全和投入成正比。
- 有明确创作需求的人——写小说要角色稳定人设、跑长期剧情、做 TRPG 跑团主持，这类用法别的产品替代不了。
- 在意数据留在本地的人。所有聊天记录都在你自己机器上的
data目录里。 - 手上已有 API key，或者有显卡愿意跑本地模型的人。这两类人接上就能用，成本最低。
不建议碰的人：
- 只想「下载一个 App 聊两句」的人。装环境、配 API、导卡、调预设这一串，对这类需求来说性价比是负的。
- 指望用现有订阅账号免费跑的人。前面说过，这条路要么走不通，要么违反条款。
- 没有显卡、又怕按量计费的人。长上下文角色扮演的账单，比大多数人预期的贵。
小结：酒馆的本质是一个「提示词工作台」
把酒馆当成聊天软件，它又丑又难用；把它当成一个提示词工作台，它是目前开源生态里最完整的一个。它不提供模型、不提供算力、不提供内容，只提供「让你精确控制一个模型怎么扮演」的全部工具——而这恰好是别的产品最不愿意开放的部分。
所以决定要不要用酒馆，本质上不是决定要不要玩角色扮演，而是决定你愿不愿意自己动手调。
如果你打算接云端模型跑酒馆，先算清楚 token 预算：角色扮演的长上下文会明显放大开销。俱乐部有整合了主流 AI 服务额度的拼车方案，可以按实际用量选用，比单独开几个订阅更划算。
1 条评论