SillyTavern 使用教程：连接模型并开始角色对话
SillyTavern 本身不运行大模型，它更像一个角色扮演聊天前端：启动本地 Web 服务后，在浏览器里连接 OpenAI 兼容接口或本地推理服务，再导入角色卡就能开始对话。
下面按实际使用顺序讲清楚启动、模型配置、角色卡导入和验证方法。
启动前先确认 Node.js 和访问方式
SillyTavern 依赖 Node.js 运行，建议使用官方仓库当前说明的 Node.js 版本。
先检查本机环境：
node -v
npm -v
git --version如果 node -v 没有输出或版本过低，先安装 Node.js 再继续。
接着获取程序并安装依赖：
git clone https://github.com/SillyTavern/SillyTavern.git
cd SillyTavern
npm install安装完成后用启动脚本运行。
Linux 或 macOS 一般执行 ./start.sh，Windows 双击 Start.bat。
默认会在本机启动 Web 服务，终端会打印访问地址，通常是 http://127.0.0.1:8000。
如果要从局域网其他设备访问，需要修改 config.yaml 中的监听设置，并确认防火墙放行对应端口。
只在本机使用则保持默认即可，不要为了省事直接把服务暴露到公网。
在 API 设置里接上模型
打开浏览器进入 SillyTavern 后，点击顶部或侧边栏的 API 连接图标，进入接口配置页。
这里的关键是选对“聊天补全来源”并填写正确的接口地址和密钥。
如果使用 OpenAI 兼容服务，选择对应来源后填写：
API 地址：服务商控制台给出的完整地址，通常以/v1结尾；本地推理服务则填本机地址，例如http://127.0.0.1:11434/v1。API 密钥：服务商生成的密钥；本地无鉴权的服务可以留空或填任意占位值。模型名称：必须与服务端实际加载的模型名一致，不能凭感觉填写。
填完后点击连接或刷新模型列表。
如果列表能正常返回模型名称，说明网络和鉴权基本通了；
如果提示 401，优先检查密钥；
如果提示连接超时，先确认模型服务本身是否在运行，再检查地址和端口。
导入角色卡并开始第一次对话
SillyTavern 的角色卡通常是 PNG 或 JSON 文件。
在角色管理面板点击导入，选择角色卡文件，导入后角色会出现在列表中。
选中角色进入聊天界面后，先发一条简单消息测试。
能正常收到回复，说明从浏览器到模型接口的链路已经通了。
此时再按需调整上下文长度、回复长度和预设参数。
需要留意的是，角色卡里的开场白和示例对话会占用上下文。
如果模型上下文窗口较小，导入长角色卡后可能出现回复被截断或报上下文超限，这时应减少历史消息或换用上下文更大的模型。
常见问题与避坑
页面能打开但对话一直转圈：多数是接口地址或模型名称错误。
回到 API 设置页确认地址是否带 /v1、模型名是否与服务端列表一致。
终端启动时报端口占用：说明 8000 端口已被其他程序使用。
可以结束占用进程，或在 config.yaml 中修改端口后重新启动。
局域网设备打不开页面：检查服务是否监听在 0.0.0.0，以及系统防火墙是否放行端口。
不要在没有鉴权的情况下把端口直接暴露到公网。
更新后配置失效：升级前备份 data 目录和 config.yaml，升级后对照新版本说明检查配置项，不要直接覆盖旧配置。
怎么确认已经配置成功
按顺序做三项检查：终端启动无报错且能看到访问地址；
API 设置页能拉取到模型列表；
聊天界面发送消息后能收到符合角色设定的回复。
三项都通过，就说明 SillyTavern 使用教程里的核心链路已经跑通。
后续再按需要调整预设、世界书和扩展功能即可。
