跳到主要内容

酒馆(SillyTavern)配置

SillyTavern(酒馆)是开源的国产/国际通用角色扮演与前端界面, 支持自定义 OpenAI 兼容后端,常用于长上下文和角色卡场景。

桌面版​

下载:https://github.com/SillyTavern/SillyTavern/releases

解压后运行 Start.bat(Windows)或 start.sh(macOS / Linux)。

手机版(Termux)​

不要从 Google Play 商店安装 Termux

那个版本已停止维护,会导致安装失败。 从 F-Droid 或 GitHub releases 下载 APK。

termux-change-repo # 换到离你最近的镜像,连续回车即可
pkg update && pkg upgrade
pkg install git nodejs-lts

32 位系统可能还要:

pkg install esbuild

安装酒馆:

git clone https://github.com/SillyTavern/SillyTavern -b release
cd SillyTavern
npm install
./start.sh

看到 SillyTavern is running on http://127.0.0.1:8000 就成功了。 用手机浏览器打开该地址(页面异常时试试 Edge),滚到底部点「连接」。

配置后端​

第一步:打开 API 连接设置​

酒馆界面 → 顶部 「API 连接」(API Connections)。

第二步:选后端类型​

选 Chat Completion(OpenAI 兼容),不要选 Text Completion。

第三步:填写​

字段填什么
Chat Completion SourceCustom (OpenAI-compatible)
Custom Endpoint (Base URL)https://api.yzgz.cn/v1
API Keysk-你的密钥
Modelclaude-opus-4-5 或 MiniMax-M3.1-Flash
Base URL 末尾带 /v1

酒馆会自己拼 /chat/completions。地址写 https://api.yzgz.cn 会变成 https://api.yzgz.cn/chat/completions —— 少一层 /v1,直接 404。

第四步:连接​

点「连接 / Connect」,状态变成绿色即成功。

排错​

现象原因处理
Connect 后报 404Base URL 少了 /v1补上
报 401密钥错重新复制
一直转圈首次拉模型列表慢等几秒
手机打开页面异常浏览器兼容换 Edge 浏览器

相关:Cherry Studio 配置 · 客户端接入总览 · [常见问题](../reference/faq/overview