企业官网建设流程全解析

SillyTavern 怎么装？免费 AI 角色扮演前端完整教程，新手 5 分钟跑通

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

想象这样一个场景：你手里有一个 OpenAI 或本地 LLM 的接口，但打开原生对话框，看到的只是一片白底黑字，没有角色头像、没有背景氛围、没有世界观设定——聊起来毫无代入感。SillyTavern就是为这个问题而生的开源免费前端：它本身不是大模型，而是套在模型外面的一层「AI 角色扮演」舞台，负责管理角色卡、人设、世界书、背景图和对话记录，让同一个模型在不同角色下演得活灵活现。

这篇文章适合谁

• 想本地玩角色扮演的个人用户：你有一台电脑和一个模型接口，但不知道去哪找趁手的前端，读完可以直接开聊。
• 喜欢折腾的 AI 爱好者：想把 Ollama、OpenAI、Claude 等多家后端接进同一套界面，统一管理提示词和预设。
• 内容创作者与测试玩家：需要快速换背景、换人设、批量管理角色卡，用来试写故事线或调试 prompt。

动手前的准备

只需两样东西，都装好就能开工：

• Node.js 20 及以上版本（package.json中明确声明node >= 20，建议直接装最新 LTS），终端执行node -v可确认；
• 随 Node 自带的npm，用于安装项目依赖。

配置方面不用提前操心，仓库里的 default/config.yaml 已经给出端口（默认 8000）、自动打开浏览器等合理默认值，新手保持原样即可。

几分钟完成安装与启动

整个过程拆成四个动作，每步一行命令，终端依次执行即可。

动作一 · 拉取项目代码

git clone https://gitcode.com/GitHub_Trending/si/SillyTavern

克隆完成后进入项目根目录，你会看到public/（前端页面）、src/（服务端）、default/（默认素材与配置）三大块。

动作二 · 安装依赖

npm install

这一步会下载全部 Node 依赖，视网速大约需要几分钟，等待它跑完。

动作三 · 启动服务

npm start

服务启动后会自动在浏览器打开默认端口（8000），首次访问会引导你创建管理员账号，设好密码即可进入主界面。

动作四 · 挂上你的模型

进入 Power User 设置页，选择后端（OpenAI 兼容、Ollama、NovelAI 等），填入 API 地址与密钥。SillyTavern 内置的提供商列表覆盖 src/endpoints/ 下几乎所有主流服务，绝大多数情况填两个字段就能连通。


第一次上手体验：跑通第一段对话

目标很简单——让一个角色开口说话，看到效果：

1. 打开左侧角色栏，先导入或新建一张角色卡（名字、简介、开场白三栏填上即可）。项目自带一个现成示范角色 Seraphina，直接选中它是最快路线。
2. 在设置里挑一张聊天背景。仓库预置了二十多张场景图，从 default/content/backgrounds/ 里挑一个顺眼的，聊天窗口立刻有氛围。
3. 点开预设（Preset）下拉框，default/content/presets/context/ 里按模型家族分好了提示词模板，选与你模型匹配的一项（比如 Ollama 选 Llama 系模板）。
4. 回到聊天框，发一句「你好」，看着角色带着头像和背景图回你第一句话——恭喜，你的 AI 角色扮演环境已经跑起来了。


高频实用功能速览

• 表情切换系统：角色在对话中会随情绪自动切换立绘，内置角色已配好几十种表情帧，素材存放在 default/content/Seraphina/，让回复从「文字气泡」变成「有脸的角色」。
• 世界书（World Info）：把故事设定、地点、规则写进条件触发的知识库条目，聊到相关关键词时才注入上下文，省 token 又不丢设定，详见 public/scripts/world-info.js。
• 快捷回复与扩展面板：常用台词一键发送，表情、翻译、语音等能力以扩展形式挂载在 public/scripts/extensions/，按需启用，界面不臃肿。

避坑指南

• Q：启动后浏览器没自动打开？属正常现象（部分系统不自动拉起浏览器）。手动访问终端里打印的地址，通常是http://127.0.0.1:8000；也可修改 default/config.yaml 中browserLaunch段控制行为。

• Q：npm install报错或装到一半失败？先确认 Node 版本 ≥ 20；仍失败就删掉node_modules与锁文件缓存后重装，或更换 npm 镜像源。

• Q：装到了系统目录/保护目录后无法写入数据？SillyTavern 会在项目下创建data/目录存放用户数据（见config.yaml的dataRoot），请把整个项目放在有完整读写权限的普通目录里，避开系统盘受保护位置。

• Q：连上模型后回复格式很怪、角色乱跑人设？十有八九是提示词模板（Preset）选错了——换成本模型对应的模板，比调 temperature 之类参数见效快得多。

下一步往哪走

第一次对话跑通之后，建议先去逛一遍 Power User 设置里的 Preset、Sysprompt 和 Quick Replies 三个区域，它们决定了角色「说得像不像」。想深入原理，README.md 与 CONTRIBUTING.md 是最好的延伸阅读；想玩 Docker 部署，docker/ 目录里已备好 compose 配置。现在，打开终端，让第一个角色开口吧。

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