企业官网建设流程全解析

SillyTavern 部署指南：3 步跑起本地 AI 角色扮演前端

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

如果你用 API 聊天，能做的只有发文字、收文字，角色形象、场景背景、情绪反应全得自己脑补。SillyTavern 就是解决这个问题的：它把 LLM 从"对话框"变成"可扮演的对象"，角色卡、立绘、场景、表情都在一个浏览器界面里管理。适合已经接入 Ollama、OpenAI、KoboldAI 等任意后端，想要把角色扮演做到沉浸感的人——装完你会得到一个带角色库、表情系统和多场景背景的完整前端。

📍 项目定位：管理"角色"而不是"对话"的 LLM 前端

一句话：SillyTavern（当前版本 1.18.0）是一个面向高级用户的 LLM 前端，核心差异点在于——角色数据直接嵌在 PNG 图片元数据里。角色设定、示例对话、示例图片打包成一张 PNG，文件到哪，角色到哪，比纯 JSON 配置方便分享得多。解析逻辑在 src/character-card-parser.js，兼容 V2/V3 角色卡标准。

🚀 快速上手：最短路径打开界面

环境要求只有一个硬指标：Node.js ≥ 20（package.json中engines明确声明）。默认监听端口8000（见config.yaml中port: 8000）。

传统方式，三条命令：

git clone https://gitcode.com/GitHub_Trending/si/SillyTavern cd SillyTavern && npm install node server.js

启动后会自动打开浏览器（config.yaml里browserLaunch.enabled: true）。首次启动会询问是否复制default/content下的默认内容——建议选是，里面含示例角色 Seraphina（28 张表情立绘）、20 多张 1920x1080 背景图和 30+ 套上下文预设。

用 Docker 的话在docker/目录执行：

docker-compose up -d

注意：config.yaml默认whitelistMode: true且白名单只有127.0.0.1，所以只有本机浏览器能访问，这属于默认安全策略而非故障。


🎭 核心能力：按你能直接感知的 4 件事拆

• 角色即图片：导入一张角色卡 PNG，服务端解析出设定与对话示例，立绘同时充当头像，不存在"图和设定分离"的问题
• 表情自动切换：示例角色 Seraphina 配了 28 种情绪立绘（neutral、joy、sadness、surprise等），配合表情扩展，AI 回复的情绪会被识别并自动换头像
• 场景背景库：default/content/backgrounds/内置 20+ 张 1920x1080 横版背景，从赛博卧室到日式校园，按主题挑选即可
• 多后端统一接入：src/endpoints/下按协议分了backends/chat-completions.js（OpenAI 兼容）、backends/kobold.js（KoboldAI）、backends/text-completions.js，外加 Ollama、Anthropic、Gemini 等独立端点，前端一套界面通吃

扩展系统装在public/scripts/extensions/，开箱即有的包括 TTS 语音、实时翻译、Stable Diffusion 生图、快捷回复、向量搜索等 13 个模块。

🧪 进阶玩法：3 个能出效果的配置

玩法一：让角色"演戏"——启用表情扩展进入扩展面板启用 Expressions（源码 public/scripts/extensions/expressions/），把角色立绘按情绪命名（如joy.png、anger.png）。效果：AI 说一句愤怒的话，头像自动换成怒脸。坑点：文件命名必须和扩展里的情绪名称严格一致，否则识别不到，立绘会一直停在默认图。


玩法二：本地模型省成本——接 Ollama后端选 Ollama，填本地地址即可。config.yaml里ollama.keepAlive控制模型请求后驻留内存的时长，默认-1常驻；显存紧张就改成0，请求完立刻卸载。坑点：改完配置要重启服务才生效。

玩法三：大角色库提速角色卡多到界面卡顿时，把config.yaml的performance.lazyLoadCharacters改为true（懒加载角色卡），并保持useDiskCache: true。坑点：官方注释提醒懒加载可能和个别扩展有兼容问题，开之前先关掉不用的扩展。

⚠️ 常见问题与避坑

• 本机能用、手机/局域网访问被拒：大概率是白名单挡的。改config.yaml的whitelist加入你的 IP；需要远程正式使用时再开listen: true，并同时把basicAuthMode设为true配好账号密码，两者别只开一半
• 端口 8000 被占用：改config.yaml的port后重启，Docker 用户改docker-compose.yml的端口映射
• 改了背景图浏览器没更新：缩略图缓存导致。thumbnails.format支持 jpg/png，删掉用户数据里的 thumbnails 目录可强制重建
• 依赖安装报错：确认 Node 版本 ≥ 20，低版本下npm install会装出残缺依赖，症状五花八门，先升版本再说

写在最后

SillyTavern 的本质是把你手里现成的 LLM 后端，升级成一个带角色资产管理的沉浸对话台。建议按这个顺序走：

1. 按上面的三步把服务跑起来，确认浏览器打开了角色列表
2. 导入一张现成的 V2/V3 角色卡 PNG，发一句话试试回复
3. 启用表情扩展，给角色配上情绪立绘
4. 把常用后端（Ollama 或 API）配好，开始正式使用

更多细节可查 src/ 目录下的端点源码和config.yaml内逐行注释，那是最权威的文档。

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