SillyTavern 快速上手教程：10 分钟装好你的第一个 AI 角色扮演前台
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
SillyTavern 是一款开源的角色扮演前端（Roleplay Frontend）。它本身不生成回答，而是通过 API 对接 OpenAI、Claude 等 AI 服务或本地模型，把你熟悉的 AI 聊天变成有角色卡、有表情、有场景的沉浸式角色扮演体验。适合已经拿到 API Key、想快速搭建私有对话环境的新手；本教程覆盖从安装到角色定制的完整路径。
安装前置条件
开始前确认两件事：
- 已安装Node.js：项目要求 Node 版本不低于 20，直接装最新 LTS 即可，避免后续出现奇怪的启动报错。
- 本地有一个空闲目录存放项目，注意不要放进系统保护目录（例如 Windows 的
Program Files）。
满足后，在终端里克隆仓库并进入目录安装依赖：
git clone https://gitcode.com/GitHub_Trending/si/SillyTaverncd SillyTavern && npm install安装完成后，依赖全部就绪，不需要额外配置环境变量。
首次启动与第一个要做的设置
在终端运行启动命令：
npm start服务起来后浏览器会自动打开本地页面。第一次进入你会看到一个欢迎界面，旁边已经自带了一张默认角色卡Seraphina（素材在 default/content/ 目录，含头像和一套完整表情）。
第一个必须完成的设置是接入 AI 后端：在设置面板里选择服务商（OpenAI、Claude、KoboldAI、Ollama 等），填入 API Key 或服务地址。这一步没做好，后面所有对话按钮都会没反应，所以下面"避坑指南"会专门讲它。
项目自带大量 预设配置，按用途分了目录：context/和instruct/是不同模型的提示词模板，sysprompt/是系统提示词，quick-replies/是快捷回复组。新手不用逐个研究，选与模型匹配的 Default 即可。
从模板到成品的角色定制路径
角色定制不必从零写起，可以沿着"模板 → 设定 → 外观"一条主线走：
第一步，拿模板。要么直接克隆内置的 Seraphina 卡片修改，要么导入你自己写好的角色卡 JSON。卡片决定了角色的名字、人格描述和开场白。
第二步，写设定。把角色的性格、说话方式、背景故事填进描述字段，写得越具体，回复越稳定。
第三步，配外观。给角色挂上表情和背景。仓库内置的 表情素材 覆盖 27 种情绪（joy、anger、surprise 等），配合聊天中的表情切换功能，角色回复会跟着剧情换脸；背景素材目录 则提供了从酒馆、卧室到海边、雪景的 1920x1080 横版场景图，可以直接选用：
这样走下来，一个有头像、有表情、有场景的完整角色就成型了，全程不需要碰一行代码。
进阶玩法：三个最常用的高性价比技巧
💡 以下功能都已在仓库中预置，按需开启即可。
想让对话不冷场 → 用快捷回复。聊天框上方有一组可自定义的快捷按钮，quick-replies 预设 提供了一套默认文案，你可以改成自己的常用动作（"点头""叹气""拿出信"），长对话推进速度会明显加快。
想让世界观前后一致 → 用世界书。仓库内置了一份示例世界书 Eldoria.json，它按关键词触发，把地名、NPC 设定注入上下文。你把自己的设定拆成条目挂上去，角色就不会在长篇对话里"忘事"。
想让界面更舒服 → 换主题。themes 目录 内置 Dark Lite、Cappuccino 等数套配色，设置里一键切换；配合背景图，整体氛围如下：
启动失败的排查思路
遇到问题时按"现象 → 原因 → 解决"的顺序排查，比盲目重装更快：
现象：npm start直接报错或页面空白。通常是 Node.js 版本低于 20。执行node -v确认版本，不满足就升级到最新 LTS 后重试。
现象：npm install中途失败。多数是安装位置在系统保护目录导致无写入权限，把项目移到普通用户目录再装；若仍失败，清一次 npm 缓存后重装。
现象：服务正常启动，但 AI 不回复。先查 API Key 是否拼写完整、服务商地址是否填对；再检查当前模型是否匹配了对应的提示词模板（presets/context/和presets/instruct/里按模型名分了文件），模板不匹配时部分模型会拒绝输出。
下一步
现在你可以回到终端确认服务仍在运行，打开浏览器进入设置面板填好 API Key，然后对着内置的 Seraphina 角色卡发出第一句对话——从这一刻起，角色、表情、场景的调优都可以直接在界面上边聊边改。
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
