多彩编程 多彩编程MZPH · CODE BLOG
ARTICLE DETAIL

文章详情

深耕前端与后端开发技术的一线实战笔记与踩坑复盘。

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

SillyTavern 部署指南:3 步跑起本地 AI 角色扮演前端 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 ≥ 20package.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下的默认内容——建议选是里面含示例角色 Seraphina28 张表情立绘、20 多张 1920x1080 背景图和 30 套上下文预设。用 Docker 的话在docker/目录执行docker-compose up -d注意config.yaml默认whitelistMode: true且白名单只有127.0.0.1所以只有本机浏览器能访问这属于默认安全策略而非故障。![SillyTavern 默认内置的中世纪酒馆场景背景图](https://raw.gitcode.com/GitHub_Trending/si/SillyTavern/raw/51ad27fb86d39a3daca3adaa970375c9670c12df/default/content/backgrounds/tavern day.jpg?utm_sourcegitcode_repo_files) 核心能力按你能直接感知的 4 件事拆角色即图片导入一张角色卡 PNG服务端解析出设定与对话示例立绘同时充当头像不存在图和设定分离的问题表情自动切换示例角色 Seraphina 配了 28 种情绪立绘neutral、joy、sadness、surprise等配合表情扩展AI 回复的情绪会被识别并自动换头像场景背景库default/content/backgrounds/内置 20 张 1920x1080 横版背景从赛博卧室到日式校园按主题挑选即可多后端统一接入src/endpoints/下按协议分了backends/chat-completions.jsOpenAI 兼容、backends/kobold.jsKoboldAI、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 说一句愤怒的话头像自动换成怒脸。坑点文件命名必须和扩展里的情绪名称严格一致否则识别不到立绘会一直停在默认图。![SillyTavern 内置赛博朋克卧室背景图](https://raw.gitcode.com/GitHub_Trending/si/SillyTavern/raw/51ad27fb86d39a3daca3adaa970375c9670c12df/default/content/backgrounds/bedroom cyberpunk.jpg?utm_sourcegitcode_repo_files)玩法二本地模型省成本——接 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 后端升级成一个带角色资产管理的沉浸对话台。建议按这个顺序走按上面的三步把服务跑起来确认浏览器打开了角色列表导入一张现成的 V2/V3 角色卡 PNG发一句话试试回复启用表情扩展给角色配上情绪立绘把常用后端Ollama 或 API配好开始正式使用更多细节可查 src/ 目录下的端点源码和config.yaml内逐行注释那是最权威的文档。【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表