SillyTavern AI角色扮演聊天前端快速上手指南
项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern 你有一个写好的虚拟角色设定，想让 AI 照着设定跟你长时间聊天，SillyTavern 就是这个界面：它是专为角色扮演设计的 LLM 聊天前端，把角色卡、对话界面、采样参数和世界观设定整合在一个浏览器页面里，你只需要再准备一个能用的 AI API。
🚀 把项目跑起来
1. 克隆源码：
git clone https://gitcode.com/GitHub_Trending/si/SillyTavern
这一步把整个项目下载到本地，进去后你会看到 src/（服务端代码）、public/（界面文件）和 default/（内置内容）三个目录。
2. 安装依赖：
npm install
这一步按 package.json 的声明下载全部运行依赖，需要 Node.js 20 或更高版本，跑完会生成 node_modules 目录。
3. 启动服务：
npm start
服务在本地 8000 端口启动，终端会打印访问地址并尝试自动打开浏览器，打开后看到欢迎页，注册一个用户名就能进入主界面。
👀 打开界面后的第一眼：先看这三处
角色选择栏（顶部）：下拉框列出所有已导入的角色，第一次运行时这里有一个内置示例角色 Seraphina，选中它才会加载对应的头像和背景。
主聊天区（中间）：上方是消息记录，下方是输入框。你在这里输入内容，AI 以所选角色的身份回复，角色说的话会以头像加气泡的形式展示，背景图来自 default/content/backgrounds/ 目录。
角色信息面板（右侧）：展开后能看到头像、姓名、性格、场景和开场白这几个字段，它们通常来自角色卡文件，决定了 AI 每次对话时"是谁"。
⚙️ 把默认配置调成你自己的样子
聊天背景：在主菜单里找到背景设置项，把默认的 default/content/backgrounds/tavern day.jpg 换成你喜欢的场景，目录里有二十多张现成的图可以直接选。改完保存后，聊天区背景立刻换成所选图片，长时间对话时视觉疲劳会明显减少。
采样参数预设：打开高级设置里的预设管理器，content/presets/ 目录按 API 类型分了文件夹，比如 openai/、textgen/、kobold/，每种后端都有匹配的参数模板。选中对应预设后，温度、Top-P 这些数值由模板统一接管，你不用逐个手填，回复风格的稳定性会比手动调参好很多。
生成条数：在高级设置的生成参数里找到 amount_gen，默认是 350。它限制单次回复的最大 token 数，调小后回复更短、出词更快，调大则允许角色写更长的段落，按你习惯的阅读节奏改即可。
🛠 新手最容易卡住的两个地方
npm start 后浏览器没有自动打开
服务其实已经在跑，直接在浏览器地址栏输入 http://127.0.0.1:8000 就能进。如果终端报版本错误，说明 Node.js 低于 20，升级 Node 后重新执行 npm install 再启动。
配好 API 后角色不回复
SillyTavern 本身只是前端，不带模型，必须在高级设置里添加一个真实可用的 AI 端点（OpenAI、KoboldAI、Ollama 等都有对应表单），填好地址和密钥并保存连接，选中角色后再发消息才会触发请求。
下一步很简单：在 API 表单里填入你已有的一个可用密钥，保存连接，然后选中内置的 Seraphina 发一句开场白，看它如何按设定回话。第一次对话不用追求效果，先确认消息能正常往返，再慢慢调角色卡和预设。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
