SillyTavern(酒馆)
一句话定位:LLM 角色扮演/跑团前端的事实标准——前端壳本身不含模型,对接任意 API 或本地后端,跑团能力来自世界书(lorebook)、掷骰扩展与社区 GM 预设。 类型:LLM 角色扮演前端 · 开源 · 许可:AGPL-3.0 · 仓库:SillyTavern/SillyTavern · Stars:31.5k(star-history.com 快照,以仓库页为准)
1. 项目概述
SillyTavern 的前身是 TavernAI(2023 年初),因社区争议分叉后更名,如今是开源社区最活跃的「AI 角色扮演」前端。它把「前端界面」与「模型后端」彻底解耦:同一套 UI 可以接 OpenAI/Claude/OpenRouter 等云端 API,也可以接 KoboldCpp/Ollama 等本地推理服务,数据(角色卡、世界书、聊天记录)全部保存在本地。
对跑团玩家而言,它是「AI 跑团」自建方案的第一选择:中文社区已有成熟的「SillyTavern + DeepSeek(便宜 API)」跑团教程,以及大量 D&D/COC 向的角色卡与预设分享。
2. 核心功能
- 多后端接入:Chat Completion(OpenAI 兼容,含自定义 base URL)、KoboldAI API、NovelAI、Ollama、OpenRouter 等十余种连接方式。
- 角色卡(Character Card):事实标准的 PNG 内嵌 JSON 卡片格式,社区有海量现成卡(含跑团 NPC/GM 卡)。
- 世界书 / Lorebook:跑团核心功能——关键词触发的世界设定条目(NPC、地点、规则),随对话自动注入上下文,相当于可检索的「规则书+战役笔记」。
- 掷骰扩展:官方 Extension-Dice,
/roll 2d6+3等骰子表达式。 - 社区 GM 预设:ZDOSt/Game-Master、Silly-Map(地图扩展)等,把 ST 改造成 GM 工作台。
- 群聊/多角色:一个会话里跑多个角色卡(玩家 + NPC)。
- 图像/语音外围:角色立绘、ComfyUI 工作流、TTS 插件。
- 中文模型友好:内置 DeepSeek-V2.5、GLM-4、Moonshot、Mistral 等十余种预设(context/instruct 模板),开箱即用。
3. 技术架构
- 前端:纯 Node.js 应用(Express 静态服务 + WebSocket),界面为单页应用;首次启动自动初始化
data/目录(示例角色卡、世界书、各后端预设模板)。 - 数据:全部本地化——角色卡、世界书、聊天记录、预设均存
data/,无云依赖。 - 扩展:插件式 extension API(SillyTavern-Extras 已被官方标记过时,功能并入主仓)。
- 许可:AGPL-3.0(网络服务场景需注意传染性条款)。
4. 本机实测记录(✅ 完整运行)
- 版本 1.18.0;
npm install+node server.js即起,监听http://127.0.0.1:8000(HTTP 200)。 - 首次启动自动初始化:示例角色 Seraphina、世界书 Eldoria.json、KoboldAI/NovelAI/OpenAI/DeepSeek/GLM/Moonshot 预设全套。
- webpack 前端库编译成功(~5.9s);唯一报错是沙箱禁止自动拉起浏览器(
spawn EPERM),不影响服务。 - 环境适配:npm 缓存需指向工作区(
--cache D:\code\AITRPG\.npm-cache),其余零改动。 - 对接本地模型:UI 内「API 连接 → Chat Completion → 自定义端点」填
http://127.0.0.1:5002/v1(KoboldCpp)即可。
5. 如何运行(复现)
git clone https://github.com/SillyTavern/SillyTavern.git
cd SillyTavern
npm install
node server.js # http://127.0.0.1:8000
要求 Node ≥ 18。无模型:界面照常可用,但对话需要接任一后端(API key 或本地 KoboldCpp/Ollama)。
6. 优劣势分析
| 优势 | 劣势 |
|---|---|
| 安装零成本、数据完全本地 | 纯前端,需自备模型/API |
| 生态最大:角色卡、预设、扩展、中文教程 | 界面信息密度高,新手上手有门槛 |
| 跑团向能力(世界书+掷骰+多角色)开箱即用 | AGPL 许可对商业二次开发有限制 |
| 任意模型可换(云端 ↔ 本地无缝) | 非「全自动 GM」,叙事质量取决于模型与预设调教 |
7. 参考链接
- 仓库:https://github.com/SillyTavern/SillyTavern
- 中文教程(SillyTavern + DeepSeek 沉浸式跑团):https://developer.baidu.com/article/detail.html?id=3682045
- 掷骰扩展与 GM 预设:GitHub 搜 ZDOSt/Game-Master、Silly-Map