酒馆 SillyTavern

最流行的角色扮演 / 聊天前端。通过 OpenAI 兼容接口接入本站，只需填一个端点和一把密钥。

没碰过命令行？先看 命令行入门（3 分钟）。酒馆需要先装 Node.js，再在终端里执行两条命令。

启动成功的标志：终端提示服务已启动，浏览器打开 http://localhost:8000 能看到酒馆界面。

酒馆不是编程工具。 它是本地运行的聊天前端（角色卡、世界书、群聊、正则等）。 接入思路和编程客户端完全不同：不用改配置文件，全部在界面里点。

无需写代码：酒馆是本地聊天前端，全部在界面里点——接入时选 OpenAI 兼容、填本站端点和一个密钥、选模型即可，不用改配置文件。下面「第二步」讲的就是界面里的填写操作。

第一步：安装酒馆

三选一（都已装好的跳过）：

方式做法
Windows（最简单） 到 GitHub Releases 下载 SillyTavern-Release.zip，解压后双击 Start.bat
Mac / Linux 见下方 git 命令，运行 ./start.sh
Docker 见下方 docker 命令，映射 8000 端口 
git clone https://github.com/SillyTavern/SillyTavern -b release && cd SillyTavern && ./start.sh
docker run -p 8000:8000 ghcr.io/sillytavern/sillytavern:latest

启动后浏览器打开 http://localhost:8000（Docker 是 8000，脚本默认也是 8000）。

  • Node.js 要求：18 或更高（官方建议装最新 LTS）。先执行 node -v 确认；没有的话见 命令行入门。
  • 上面命令里的 -b release 是官方推荐的稳定分支，新手别用开发分支。
  • Docker 方式建议把 config 和 data 两个目录挂载出来（官方 docker-compose 示例里就是这么写的），否则删掉容器 = 角色卡和聊天记录全丢。
  • 首次启动要下载依赖，慢是正常的，看到大量文字滚动别慌。

第二步：填入接口信息

在酒馆界面最上排点「插头」图标（API 连接），然后：

  1. API 类型：选「聊天补全」（Chat Completion）
  2. 聊天补全来源：选「自定义（OpenAI 兼容）」——不要选「OpenAI」官方
  3. 填入下面两行，点「连接」
字段填写
自定义端点（Base URL）https://api.juheai.shop/v1
API 密钥sk-xxxxxxxx（在「API 密钥」页创建）
 
自定义端点: https://api.juheai.shop/v1
API 密钥:  sk-xxxxxxxx

端点只写到 /v1 为止，不要加 /chat/completions 之类的后缀（这是官方文档特别强调的）。 缺了 /v1 会一直连不上；多写后缀同样会失败。

密钥创建后立即复制保存，离开页面就无法再看完整内容。连接成功后状态会变绿色（valid）；红色（invalid）说明地址或密钥不对。

如果明明能用却一直提示状态异常，可勾选界面上的 Bypass API status check（跳过接口状态检查）， 或点 Test Message 实际发一条消息验证。

第三步：选模型

连接成功后，点「连接」旁边的刷新按钮拉取模型列表，然后选一个。推荐：

模型适合说明
gemini-3.1-pro角色扮演首选长上下文、文风细腻；>200K 长上下文有阶梯计费
claude-sonnet-5-5剧情 / 文笔CCMAX-企业版分组，创作能力强
deepseek-v4-pro性价比剧情高稳国模分组，中文表现好
gemini-3.8-flash日常闲聊速度快、便宜

以上是站内已配置的模型；完整列表与单价见 模型广场。

常见问题

点「连接」报错 / 红灯

  • 401 / Unauthorized：密钥填错，或复制时带了空格。回「API 密钥」页重新复制。
  • 模型列表是空的：端点忘了带 /v1，补上再点刷新。
  • 选了「OpenAI」官方来源：会连到 OpenAI 官方而不是本站，必须选「自定义（OpenAI 兼容）」。

回复变慢 / 费用涨得快

  • 长对话会把全部历史发给模型，token 用量随轮次增长。在「AI 回复设置」里适当调小上下文长度，或定期开新对话。
  • 正则 / 世界书很大时也会显著增加输入 token。单价见模型广场，消费明细可在控制台「用量」页查看。

提示。 酒馆版本更新频繁，如果界面位置对不上，找带「插头 / API 连接」字样的入口即可， 字段名与本页一致。请遵守当地法律法规使用。

还是搞不定？把这三样发给客服，基本一看就知道问题在哪：① 终端里最后 5～10 行文字（可截图，注意别拍到密钥）② 你在本页做到第几步 ③ 报错的原文或截图。密钥属于隐私，发送前可以先给后几位打码。