如何 5 分钟跑通 SillyTavern AI 角色扮演:新手完整搭建教程
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
SillyTavern 是一款免费开源的 AI 角色扮演前端,它能把 OpenAI、Claude、Ollama 等主流大模型接进一个统一的聊天界面,让你给角色写设定、建世界观、换背景换表情,专注和虚拟角色对话这件事本身。你不需要会写代码,也不需要部署复杂的后端——一条命令克隆,两条命令启动,浏览器里就能开始玩。
它到底解决什么问题?
很多人体验 AI 角色扮演会遇到三个麻烦:
- 官方聊天窗口太"素":没有角色卡、没有场景背景、没有情绪表情,对话像在读说明书;
- 每个 AI 平台的界面都不统一,换模型就得换一个 App;
- 想改提示词、调上下文结构,却摸不到底层配置。
SillyTavern 把这些事收拢到一个本地网页里:角色设定(character card)、世界观资料(World Info)、提示词预设、聊天背景与表情,全部可视化编辑;同时通过 src/endpoints/backends/ 里封装的接口,统一对接 OpenAI、Anthropic、Google、KoboldAI 以及本地 Ollama、KoboldCpp 等模型。也就是说,前端软件免费,界面随你折腾,模型用你自己已有的账号或本地部署即可。
SillyTavern AI 角色扮演酒馆对话场景背景
3 条命令启动:最快配置方法
准备工作只有一项:安装Node.js 20 及以上版本(官网下载 LTS 安装包即可)。装完后打开终端,依次执行:
git clone https://gitcode.com/GitHub_Trending/si/SillyTavern cd SillyTavern && npm install npm start第一条把源码拉到本地,第二条安装依赖,第三条启动服务。启动成功后,SillyTavern 默认会在浏览器中自动打开localhost:8000,如果没自动打开,手动在地址栏输入这个地址就行。
几个实用细节:
- 端口想换,改 default/config.yaml 里的
port字段,默认是 8000; - 想在同一台机器上用 Docker 跑,项目里已备好 docker/docker-compose.yml;
- Windows 用户也可以直接双击根目录的
Start.bat,省去手动敲命令。
SillyTavern AI 角色扮演日式樱花街道聊天背景
装好后最值的 3 件事
1. 创建或导入你的第一个角色
主界面找到角色管理入口,可以直接新建角色卡(填写名字、头像、人格描述、开场白),也可以导入别人做好的.png/.json格式角色卡。项目自带的内容目录 default/content/ 里就有现成素材可以参照:角色形象Seraphina的头像和 29 张情绪表情都在这里,表情会在对话中随角色情绪切换,聊天的"活人感"主要靠它。
2. 用 World Info 给世界写规则
World Info(世界资料库)是 SillyTavern 最有特色的一块:你把角色所在世界的地名、NPC、魔法体系写成带触发关键词的条目,聊到相关话题时会自动注入上下文。比如设定"酒馆名为银叶,老板叫艾拉",对话中提到酒馆时模型就会记得这套设定,而不是每轮都要你重复。
3. 挑背景、换主题,把界面变成你的
聊天区背景支持整页大图,项目内置了 default/content/backgrounds/ 下 20 多张 1920×1080 的场景图——从酒馆、海滩到赛博朋克卧室,点一下就能换上:
SillyTavern AI 角色扮演赛博朋克卧室聊天背景
提示词方面则不用从零写:default/content/presets/ 按 context、instruct、novel、sysprompt 等类别分好了几十套预设,对应 Llama、Mistral、DeepSeek、Gemini 等常见模型,选一套接近你模型的直接套用,再按需微调。
新手最常踩的 4 个坑
- Node 版本过低:启动报错多半是 Node 版本不够。终端里输入
node -v检查,低于 20 就升级一下。 - 端口被占用:如果 8000 端口被其他程序占了,服务起不来,按上一节改
config.yaml里的端口再重启即可。 - 装依赖失败:清一下 npm 缓存(
npm cache clean --force)后重新执行npm install,多数情况能解决。 - 没有配模型就觉得"不能聊":SillyTavern 本身不带大模型,它只是个前端。你需要在设置页填入一个 API Key(OpenAI、Claude 等),或者指向本地 Ollama / KoboldCpp。配好任意一个,聊天按钮就亮了。
下一步做什么
按这个顺序走,一天之内就能玩得比较顺手:
- 先跑通「启动 → 导入一个角色 → 聊 20 轮」,熟悉发送、重生成、编辑历史这几项基础操作;
- 再去 public/scripts/extensions/ 对应的前端扩展里逛一圈:表情(expressions)、图库(gallery)、稳定扩散(stable-diffusion,可接入 AI 绘图)、翻译(translate)都是可选开关,按需打开;
- 想深挖提示词和角色设定,翻 default/content/presets/ 里的预设 JSON,读几套就比看文档更快建立手感。
把服务跑起来,导入第一个角色卡,今天就能开始你的第一段 AI 角色对话。
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考