SillyTavern 新手上手教程：把 AI 角色扮演跑在自己的模型上
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
想象这样一个画面：打开浏览器，屏幕上不是干巴巴的 API 测试框，而是一间带着背景图的酒馆，对面的角色主动跟你搭话，回复时头像还会换表情。这就是 SillyTavern——一个面向 AI 角色扮演的聊天前端（官方定位是 LLM Frontend for Power Users）。它自己不出模型，负责的是角色卡、背景、提示词和对话流程这些"前端"工作，模型由你接，云端 API 或本地部署都行。
开始之前：确认两件事
Node 版本。项目 package.json 里声明了"node": ">= 20"，这是硬门槛。用node -v查一下，低于 20 的话先去装新版，后面所有报错大概率都出在这。
模型来源。SillyTavern 本身不含模型，你需要准备其中一种：云厂商的 API Key（OpenAI、Claude、Google 等，仓库的 src/endpoints/ 目录里能看到它支持的大致范围），或者本地跑一个 Ollama 之类的推理服务。仓库配置里也预留了对应的连接项，两种路线都能走通。
另外一个小建议：项目别放在系统保护目录（如 Windows 的系统盘受控路径）下，权限问题会让安装和写入变得很麻烦。
安装与启动
整个流程就三条命令。先克隆仓库到本地：
git clone https://gitcode.com/GitHub_Trending/si/SillyTavern进入目录后安装依赖：
npm install依赖装完，启动服务：
npm start这条命令实际执行的是node server.js（见 package.json 的 scripts 段）。默认端口是 8000，且配置里开启了启动后自动拉起浏览器，所以命令跑完页面一般会自己弹出来。Windows 用户也可以直接双击仓库根目录的Start.bat，Linux/macOS 有对应的start.sh，效果相同。
连接你的第一个模型
页面打开后，在设置面板里找到 API 相关配置，填入你的 Key 和模型名即可，不用写任何代码。这一步值得多说一句：仓库的 default/content/presets/ 目录下自带了几十个现成的上下文预设，按 Llama、Mistral、DeepSeek、Gemma 等模型系列分好类，每种还分 context / instruct / novel 等用途。如果你接的模型恰好有对应预设，直接选一个，比从零手调提示词省心得多。
本地 Ollama 的接法类似：起好服务后，在连接配置里把地址指向本机推理端口就行。
让角色真正开口说话
第一次对话不用自己造角色。仓库内置了现成素材：
- 示例角色：
default/content/下有 Seraphina 角色卡和头像，可以直接导入开聊； - 表情包：default/content/Seraphina/ 里按情绪拆了 27 张表情图（joy、anger、curiosity……），角色回复时能根据情绪切换表情，这是"角色有反应"观感的主要来源；
- 场景背景：default/content/backgrounds/ 里有一批 1920x1080 的背景图，酒馆、海滩、日式街景、赛博朋克卧室都有，随时可换。
流程就是：导入角色 → 选个背景 → 发消息 → 换预设试不同模型下的回复风格。对话历史和快速回复都在界面里现成可用，长对话不用手动维护上下文。
卡住了怎么办
打不开页面 / 启动即报错：九成是 Node 版本不够 20，先查这个。
npm install失败：清一下缓存再重装（npm cache clean --force后重新npm install），网络受限的话换个可用的镜像源。
局域网其他设备访问被拒：仓库默认配置 default/config.yaml 里whitelistMode是开启的，白名单只放了本机地址（127.0.0.1 / ::1）。想让别的设备连进来，需要改这份配置里的监听与白名单项，改完重启服务。
浏览器弹错但终端正常：确认你访问的端口是 8000，而不是顺手改过的其他端口。
下一步建议：先把内置的 Seraphina 跑通一轮完整对话，再挑一个自己的模型接上对比回复差异；跑顺之后，再去看预设目录里和自己模型匹配的模板，从那里开始改出自己的提示词风格。
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
