SillyTavern 中文教程:从零部署酒馆并接入模型

三步装好酒馆:Node、Git、启动脚本

SillyTavern 是跑在本地的 Node 应用,推理全部走云端 API,老笔记本也能流畅运行。安装只有三步:装 Node.js 18 或更高版本(建议 LTS),用 Git 克隆 release 分支,运行启动脚本。 Windows 用户不想碰命令行,可以用官方 SillyTavern Launcher 一键安装器,效果等价。启动成功后浏览器会自动打开 http://localhost:8000,看到酒馆界面即部署完成。以后更新只需在目录里执行 git pull。

# 前置:安装 Node.js 18+ 与 Git
git clone https://github.com/SillyTavern/SillyTavern -b release
cd SillyTavern

./start.sh        # macOS / Linux
# Windows 用户:双击 Start.bat

界面汉化:自带简体中文,不用打补丁

酒馆内置官方中文语言包,不需要第三方汉化补丁。点击顶部齿轮图标进入 User Settings,把 UI Language 切换为「中文(简体)」,菜单和设置项立即变成中文。 注意区分两件事:UI 语言只影响界面文字;角色的回复语言取决于角色卡和模型本身。想让英文角色卡说中文,在角色卡描述或系统提示里加一句「始终使用简体中文回复」即可,主流模型都能稳定遵守。

接入 API:源选 Custom,Base URL 只填到 /v1

点击顶部插头图标进入 API Connections,照下面的配置逐项填写。两个关键点:Chat Completion Source 必须选 Custom (OpenAI-compatible);Base URL 只填到 /v1 为止,酒馆会自动在后面拼接 /chat/completions,多写反而报 404。 填好密钥点 Connect,酒馆会请求 /v1/models 自动拉取模型列表,下拉框支持搜索,出现绿色 Valid 提示即连接成功。密钥在 kkaiapi 控制台生成,充值走支付宝或微信支付,按量计费没有订阅。另外提醒:JanitorAI 这类要求完整端点的工具才需要填 https://api.kkaiapi.com/v1/chat/completions,酒馆里不要这样写。

API:                    Chat Completion
Chat Completion Source: Custom (OpenAI-compatible)
Custom Endpoint:        https://api.kkaiapi.com/v1
API Key:                sk-xxxxxxxxxxxx
Model:                  deepseek-v4-flash   # 点 Connect 后下拉自动拉取

角色扮演模型怎么选

选型看三个维度:创作自由度、角色一致性、长上下文。社区玩酒馆的主流选择是 DeepSeek V4 系,Flash 版跑高频长对话成本低,Pro 版剧情理解更强。GLM-5 中文语感自然,长对话人设不容易崩。Kimi K2.6 上下文窗口大,适合世界书条目多、群聊卡复杂的场景。 Claude 系文笔公认最好,但 Anthropic 内容政策严格,禁止露骨内容,只适合普通向创作和小说润色。Qwen 系指令味重,不推荐用于角色扮演。grok-4.5 是 xAI 的旗舰通用模型,公开政策对成人向虚构文本相对宽松,具体以官方条款为准。

价格:一张表看完

kkaiapi 是面向中文开发者的 OpenAI-compatible 模型中转,人民币定价如下,与有公开人民币官价的模型同口径对比。充值在 /topup 完成,余额按 token 消耗扣减。

常见报错对照表

连接失败先看酒馆界面的红字提示和终端日志,九成问题出在 Base URL 和密钥上,对照下表逐条排查。

常见问题