SillyTavern AI对话引擎:10分钟搭好自己的角色扮演搭档完整指南
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
📦 项目速览:SillyTavern 到底是什么
SillyTavern 是一款开源 AI 对话引擎与角色扮演前端,把 OpenAI、Claude、Gemini 和本地 Ollama 等大模型接入同一个界面。它解决的痛点是:不必在不同官网页面之间来回切换试用模型,而是把多模型、角色卡、场景背景、知识库统一装进一个页面管理。最大亮点是内置扩展生态,开箱即带语音朗读、翻译、图像生成等能力。
SillyTavern 对话界面默认场景背景
⚙️ 环境准备:装机前核对三样依赖
- Node.js ≥ 20(项目 package.json 声明的最低版本,推荐 LTS 发行版)
- Git(安装第三方扩展时需要,可选)
- 磁盘可用空间 ≥ 500MB
- 一个模型服务的 API 密钥(OpenAI / Claude / Gemini 任选其一),或一台已跑通 Ollama 的机器
⚠️ 最常见的坑:默认监听 8000 端口。启动前先用命令确认端口空闲;被占用就改 config.yaml 里的port参数,不要强杀来路不明的进程。
🚀 部署实战:3 步在本地跑通服务
路径一:轻量体验(验证链路)
- 克隆源码并进入目录:
# 克隆 SillyTavern 源码仓库 git clone https://gitcode.com/GitHub_Trending/si/SillyTavern # 进入项目根目录 cd SillyTavern- 安装依赖并启动:
# 安装全部运行时依赖,实测约需 3-5 分钟 npm install # 启动服务,首次运行会在 default 目录自动生成配置文件 npm start- 打开浏览器访问 http://localhost:8000 ,设置账号密码后即可使用。
路径二:本地完整部署(长期使用推荐)
- 完成路径一的克隆与启动
- 在连接设置里选择后端(OpenAI 兼容 / Claude / Gemini 等),填入 API 密钥
- 用内置角色 Seraphina 发起第一轮对话,验证完整链路
- 可选:修改 config.yaml 的whitelist加入设备 IP,让手机或局域网内其他设备访问
⚠️ 默认白名单只放行 127.0.0.1 与 ::1,局域网其他设备直接访问会被拦截。确需对外暴露时,务必同步开启基本认证,避免裸奔。
⚠️ 不要把项目装进系统保护目录(如 Windows 的 Program Files),依赖安装和权限写入都会出问题。
进阶部署方式怎么选
| 部署方式 | 适用场景 | 优点 | 缺点 |
|---|---|---|---|
| 源码部署(npm start) | 个人电脑、开发调试 | 简单直接、改配置零门槛 | 依赖与 Node 版本需手动维护 |
| Docker 容器 | 家庭服务器、云主机 | 环境隔离、仓库已带现成 compose 文件 | 需基本容器知识 |
| 云服务器 + 反向代理 | 多人共享访问 | 支持 HTTPS 与域名 | 要持续维护安全配置 |
💡 功能上手:3 个核心玩法快速体验
玩法一:导入角色卡,把人设装进对话
使用场景:你手里有一张打磨好的角色卡(JSON 或内嵌 PNG),想立刻"见到"这个角色。
操作步骤:
- 在角色管理入口选择导入,选中角色卡文件
- 确认设定文本与开场白正常载入
- 选中模型后端,发送第一句话
预期效果:SillyTavern 内置 V1 / V2 / V3 三代角色卡规范的校验器,格式正确的卡片导入后立即可对话;实测连续几十轮下来,角色口吻能保持稳定不跑偏。
中世纪市集场景用于中世纪题材角色扮演
玩法二:一键切换场景背景
使用场景:对话推进到新地点,画面也要跟上,沉浸感才完整。
操作步骤:
- 打开 default/content/backgrounds/ 目录,里面有约 20 张 1920x1080 预置图:中世纪集市、日式樱花道、雪夜湖边小屋等
- 在聊天界面的背景设置中按名称选取
- 对话过程中可随时切换,不打断上下文
预期效果:一套背景图即可覆盖日常、奇幻、末日等多条故事线,切换只影响画面、不改动对话内容。
日式樱花道场景适合恋爱与日常题材角色
玩法三:角色表情随语气切换
使用场景:AI 回复的情绪变了,头像也应该跟着变,而不是永远同一张脸。
操作步骤:
- 在扩展面板打开内置的 expressions 表情扩展
- 默认角色已配好 28 张表情图(joy、surprise、sadness 等,见 default/content/Seraphina/ 目录)
- 发送消息后观察头像随回复情绪自动切换
预期效果:约每轮回复即可触发一次表情匹配,长对话里角色的"表情管理"肉眼可见地丰富,阅读成本降低不少。
🧩 进阶拓展:3 个开箱即用的扩展
TTS 语音扩展 一句话功能:把 AI 回复自动朗读出来,文字对话变"有声对话"。 获取方式:内置于 public/scripts/extensions/tts/,在扩展面板开启并配置即可。 典型使用场景:听书式阅读、语言学习磨耳朵、通勤路上跟读。
Stable Diffusion 图像扩展 一句话功能:依据对话内容调用本地 SD 服务生成角色与场景图。 获取方式:内置于 public/scripts/extensions/stable-diffusion/,连上本地 SD 接口。 典型使用场景:写作时让 AI 顺手产出配图插画。
向量知识库扩展 一句话功能:把长篇设定切块向量化,命中关键词时自动注入提示词。 获取方式:内置于 public/scripts/extensions/vectors/,配合 public/scripts/extensions/memory/ 使用。 典型使用场景:超长篇故事保持数百轮后的设定一致性。
📋 问题速查:高频 5 连问
| 问题 | 解决方案 |
|---|---|
| 启动提示 8000 端口被占用 | 修改 config.yaml 中的port参数,或释放原端口 |
| 本地正常,局域网设备访问被拒 | 默认白名单仅放行回环地址,把设备 IP 加入whitelist列表 |
| npm install 速度很慢 | 为 npm 切换到国内镜像源后重新执行安装命令 |
| 模型回复报 401 类鉴权错误 | 核对 API 密钥拼写与后端选择是否一致,必要时重新粘贴 |
| 角色或聊天记录疑似丢失 | 检查 data 目录下的备份归档,必要时重新导入角色卡 |
💬 收尾:轮到你上场了
你用这套 AI 对话引擎捏出过什么有意思的角色?欢迎到社区把你的角色卡和设定分享出来。
本文基于 SillyTavern 1.18.0 版本编写,兼容 Node.js 20+ 环境,支持源码直装与 Docker 两种部署形态。
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考