SillyTavern 完整指南：如何十分钟搭好你的 AI 角色扮演前台-编程实验室

SillyTavern 完整指南：如何十分钟搭好你的 AI 角色扮演前台

【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern

SillyTavern 是一个开源的 LLM 前端，负责把你本地的或云端的大模型接到一套完整的角色扮演界面上：角色卡、表情、背景、多模型切换都在这里管理。它适合想自己搭"AI 聊天伴侣/跑团/剧情"环境、并且愿意花十分钟装一次软件的用户。

SillyTavern 解决的痛点：为什么直接用模型网站不够

如果你一直在官方网页或 API 上调大模型，大概遇到过这些事：角色设定每次都得手动复制进提示词；模型之间来回切换要换三个网站；聊天记录、人设、背景图散落各处，没法沉淀。

SillyTavern 的思路是把自己当成"前台"：模型只是后台，它管住人设、上下文和交互体验。和常见替代方案放在一起看差异更清楚：

维度	SillyTavern	常见替代（模型官网/API 调试页）	差异点
角色管理	角色卡带图导入，设定、示例对话、多套表情全部打包在一张 PNG 里	人设写在临时提示词里，换模型就得重贴	角色是可携带的文件，不是散落的文本
模型接入	内置 OpenAI、Anthropic、Google、Ollama、KoboldAI 等几十种后端，前端统一	每家一套网页和计费页面	换模型不动前端，配置存本地
沉浸体验	表情切换、场景背景、语音、翻译等扩展开箱即用	基本只有纯文本框	体验组件模块化，按需开启
部署方式	Node.js 或 Docker 本地自托管	依赖厂商服务	数据留在自己机器上

角色卡为什么放在 PNG 里？因为图片的元数据块可以塞任意文本，这样一张图就等于一个完整角色，分享、导入都很方便。解析逻辑在 src/character-card-parser.js，校验规则在 src/validator/TavernCardValidator.js，它同时兼容 V2/V3 两种角色卡标准。

SillyTavern 快速安装与部署避坑

最短路径就三步：装 Node.js 20 以上版本，克隆仓库，然后：

npm install npm start

启动后浏览器访问http://120.0.1.1:8000（端口可在 default/config.yaml 里改）。如果你更习惯容器化，仓库里现成了 docker/docker-compose.yml：

docker compose -f docker/docker-compose.yml up -d

几条避坑提示：

仓库要求 Node.js >= 20，旧版本装依赖会报奇怪的错，先node -v看一眼。
默认只监听本机。想让别人访问，改 config.yaml 里listen: true，但这时建议同时配置好认证，别裸奔到公网。
克隆地址用 https://link.gitcode.com/i/c5bec86d93323609f45e51d44220e016（git clone之后流程同上）。

SillyTavern 场景实战：挑个玩法走一遍

界面里自带了一套默认素材可以直接上手，不用先准备任何角色卡。

场景一：中世纪酒馆，跑一段奇幻剧情

SillyTavern 中世纪酒馆角色扮演背景场景

把背景切到"tavern day"，选一个带奇幻设定的角色，就能进入酒馆开局的感觉。可执行的操作：

在设置里把这张图设为默认背景，所有新对话自动用上。
给角色卡配几段"示例对话"，模型会模仿那个口吻说话，比单纯写设定更有效。
多角色同场时用群聊模式，SillyTavern 会按权重决定谁接话，不用你手动@。

场景二：赛博朋克卧室，科幻向日常

SillyTavern 赛博朋克风格卧室角色扮演背景

同样的流程换个皮就是另一个故事：赛博朋克卧室配一个技术系角色，聊未来都市的日常生活。

在背景列表里搜"cyberpunk"即可找到这张图，全部背景都在 default/content/backgrounds/ 目录里，共 20 张 1920x1080 横版图。
打开 TTS 扩展（源码在 public/scripts/extensions/tts/）让角色开口说话，科幻感会强很多。
想加剧情约束可以用正则扩展，把"模型不许跳出角色"这类规则写成自动替换。

场景三：日式校园，轻量级恋爱剧情

SillyTavern 日式樱花小路校园背景

樱花小路、教室、大学教室，仓库里备了一整套日式场景，适合写日常的恋爱向剧情。

角色卡里导入多张表情图，对话时按情绪自动切换头像，仓库自带 28 种情绪示例，见 default/content/Seraphina/。
开"翻译"扩展，角色说外语时界面实时给出译文，不用切页面。
用书签功能把"刚吵完架"这类关键节点存下来，随时回到剧情分支点。

SillyTavern 进阶与调优：性能、安全、扩展点

性能：它本身只是前端加一个轻 Node 服务，重活都在模型侧。真正卡的话优先调上下文长度和表情图数量，服务端口、心跳等运行参数集中在 default/config.yaml。
安全：默认自带 CSRF 保护和请求白名单中间件（src/middleware/whitelist.js），对外暴露时记得用 HTTPS 并配置 basicAuth.js 同级的认证。
扩展点：内置 TTS、翻译、Stable Diffusion 出图、向量记忆等十余个扩展，都在 public/scripts/extensions/；更重的插件由 plugins.js 统一管理，装新插件不碰核心代码。