SillyTavern零基础入门：从安装到跑通你的第一个AI角色，15分钟搞定-育师

SillyTavern零基础入门：从安装到跑通你的第一个AI角色，15分钟搞定

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

SillyTavern 是一个开源的 AI 聊天前端（LLM Frontend），你可以把它理解成一个"壳"：它自己不生成回答，而是把你配置好的 AI 模型 API（OpenAI、Claude、Gemini、Ollama 等）接进一个为角色扮演和长对话深度优化的界面里——角色卡、人设、世界信息库、聊天历史管理都是现成的。整个过程不用写代码，从克隆仓库到在浏览器里和角色对话，顺利的话 15 分钟以内能跑通。

动手前，先备好这三样

Node.js ≥ 20：版本要求写死在 package.json 的engines字段里，低于 20 会跑不起来。在官网下载 LTS 版安装即可
git：用来获取源码，Windows 装 git 时勾选"Add to PATH"
至少一个模型 API 密钥：先用 OpenAI 的密钥最省事；如果你用本地 Ollama 也可以，后面在界面里填，不影响安装
磁盘空间 500MB 左右，端口 8000 空闲（这是默认端口）

四步主线，把服务跑起来

1. 克隆仓库

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

预期结果：当前目录下能看到server.js、public/、src/ 等文件，说明源码完整。

2. 安装依赖

npm install

预期结果：终端滚动一段时间后输出added xxx packages，无红色ERR字样。这一步会连带下载 tokenizer、前端打包等全部依赖，耐心等待。

3. 启动服务

npm start

首次运行会自动在 default/config.yaml 基础上初始化配置，并生成你的data/用户数据目录。

预期结果：终端打印启动日志、监听端口，浏览器被自动打开。如果没自动打开，手动访问http://localhost:8000。

4. 进入界面

默认配置开启白名单模式，只允许本机 IP（127.0.0.1 / ::1）访问，你自己用不需要改。打开后你会看到主聊天界面，内置角色 Seraphina 已经可用，直接选中它开始第一句对话。

怎么确认真的跑通了

终端日志里没有持续刷红的报错，且能看到listening相关字样
浏览器打开http://localhost:8000能正常渲染界面，而不是"拒绝连接"
打开"设置 → AI 连接"填入你的 API 密钥并测试连接，选一个模型发起对话，能收到回复

三条都满足，说明前端、服务端、模型链路全部打通。

跑通之后，它主要能干什么

SillyTavern 聊天界面内置酒馆场景背景

角色扮演：在角色面板新建或导入角色卡，给它写人设、开场白、对话示例。之后每次对话它都会按设定回应，还能通过"编辑历史"分支剧情——改一句重聊一句，不用从头再来。内置的 Seraphina 和 Eldoria（见 default/content/）可以直接拿来当模板参考。

世界信息库：给角色挂一个 lorebook，把背景设定拆成一条条关键词触发的条目。对话中出现相关关键词时，设定会自动注入上下文，适合做长篇故事或游戏世界观，不用把所有设定硬塞进人设。

多模型管理：界面里维护多个 AI 连接，不同对话切换不同模型。default/content/presets/ 下按模型族（Llama、Mistral、Gemma 等）提供了大量现成提示格式预设，接上对应模型后选一个就能用。

遇到问题时

问题	解法
启动报端口占用	打开 default/config.yaml 改`port`后重启，同时记得用新端口访问
浏览器打不开页面	默认白名单只放行本机 IP；换设备访问需先在配置里加白名单并开启`listen: true`
发送消息没有回复	多半是没填 API 密钥或模型名写错，去设置页用"测试连接"定位
npm install 报 engines 错误	升级 Node.js 到 20 以上，再删掉`node_modules`重装
聊天记录想找回	聊天有自动备份（配置里`backups`一节），实在丢数据可用根目录的 recover.js 恢复