补档，以下是教程（帮我部署的AI生成）
🍺` SillyTavern（酒馆）Windows 本地搭建完全教程
面向零基础用户，手把手从零搭建 AI 角色扮演聊天环境。
📦 一、准备工作
1.1 下载安装 Node.js（必需）
SillyTavern 基于 Node.js 运行。
- 打开浏览器访问：https://nodejs.org/
- 下载 LTS 版本（左侧按钮，推荐 18.x 或 20.x）
- 双击安装包，一路点 Next，务必勾选：
- ✅
Automatically install the necessary tools
- ✅
Add to PATH
- 安装完成后，按
Win + R，输入 cmd 回车
- 输入以下命令验证安装成功：
node -v
npm -v
看到版本号（如 v20.11.0、10.2.4）即成功。
1.2 下载 Git（可选但推荐）
部分用户需要用 Git 更新酒馆。
- 访问：https://git-scm.com/download/win
- 下载并安装，全部默认选项即可
- 验证：
git --version
🚀 二、安装 SillyTavern
2.1 下载 SillyTavern
方法 A：Git 克隆（推荐，方便更新）
cd C:\
git clone https://github.com/SillyTavern/SillyTavern.git
方法 B：直接下载 ZIP
- 访问：https://github.com/SillyTavern/SillyTavern/releases
- 下载最新版本的
Source code (zip)
- 解压到
C:\SillyTavern 或任意目录（路径不要含中文）
2.2 安装依赖
打开命令提示符（CMD）或 PowerShell，进入酒馆目录：
cd C:\SillyTavern
npm install --no-audit --no-fund
⏳ 这一步会下载几百个依赖包，视网速可能需要 15 分钟。
如果报错，先尝试：npm cache clean --force 再重试。
2.3 启动酒馆
cd C:\SillyTavern
node server.js
看到如下输出即启动成功：
SillyTavern v1.12.x Server is running on port 8000
打开浏览器访问：http://localhost:8000 🎉
首次启动注意：如果 Windows 防火墙弹窗，点击 允许访问。
⚙️ 三、基础配置
3.1 切换语言为中文
- 打开 SillyTavern 网页（http://localhost:8000）
- 点击左下角 ⚙️ 设置 图标
- 找到 User Settings → Language
- 选择 Chinese (中文)
- 点击页面顶部的 ✨ 应用更改 按钮
- 页面自动刷新，界面变成中文
3.2 配置界面
- 主题：在设置 → 用户设置 → 主题，可选
暗色 / 浅色 / Midnight
- 字体大小：同一页面可调
- 自动保存：默认开启，聊天记录实时保存
🔌 四、后端接入（连接 AI 模型）
SillyTavern 本身只是一个前端界面，需要连接一个"后端"来真正生成对话。以下是几种常见方式：
4.1 接入 OpenAI（ChatGPT / GPT-4）
适合人群：有海外信用卡，愿意付费使用最成熟的闭源模型。
- 打开 https://platform.openai.com/api-keys
- 点击 Create new secret key，复制生成的 Key（
sk-...）
- 回到酒馆，点击顶部 API 连接 按钮（插头图标 🔌）
- 选择 Chat Completion（如选 API 则选 OpenAI）
- 填写：
- API Key：粘贴刚才的
sk-...
- API URL：
https://api.openai.com/v1
- 点击 连接，成功后可以在右侧下拉菜单选择模型：
gpt-4o（推荐，最新的全能模型）gpt-4o-mini（便宜、快速、够用）gpt-4（旧版，较贵）
- 点击 保存并应用
💰 费用：充值 $5~$10 可以用很久，日常聊天用 gpt-4o-mini 很省钱。
4.2 接入 Claude（Anthropic）
- 打开 https://console.anthropic.com/
- 注册并创建 API Key（
sk-ant-...）
- 酒馆中点击 API 连接 → 选择 Claude
- 填入 API Key，API URL 默认：
https://api.anthropic.com/v1
- 连接成功后选择模型：
claude-3.5-sonnet（推荐，角色扮演极好）claude-3-haiku（轻量快速）
- 保存并应用
4.3 接入 DeepSeek（国产，便宜好用）
适合人群：国内用户，性价比极高，支持中文极好。
- 打开 https://platform.deepseek.com/
- 注册 → 充值（几十块够用几个月）
- 创建 API Key
- 酒馆中选 Chat Completion → 自定义
- 填写：
- API URL：
https://api.deepseek.com/v1
- API Key：粘贴你的 Key
- 模型名填：
deepseek-chat
- 连接并保存
或者选预设的 DeepSeek 选项（新版酒馆已内置）。
4.4 接入本地模型（完全免费，但需要好显卡）
方案 A：KoboldCPP（推荐新手）
- 下载 KoboldCPP：https://github.com/LostRuins/koboldcpp/releases
- 下载一个 GGUF 格式模型（如
Mistral-7B-Instruct）
- 运行 KoboldCPP.exe，加载模型文件
- 启动后它会运行在
http://localhost:5001
- 酒馆选 KoboldCPP → 填入
http://localhost:5001 → 连接
方案 B：Oobabooga Text Generation WebUI
- 下载 One-Click Installer：https://github.com/oobabooga/text-generation-webui
- 运行
start_windows.bat，按提示安装
- 启动后加参数：
--api --listen
- 酒馆选 Text Completion → Oobabooga →
http://localhost:5000
⚠️ 本地模型建议显存 ≥ 6GB，推荐 8GB 以上。
4.5 接入中转代理 API（国内用户备选）
很多第三方提供 OpenAI/Claude 的中转服务（便宜、无需翻墙）。
- 酒馆选 Chat Completion → 自定义
- API URL 填中转站给的地址（如
https://xxx.com/v1）
- API Key 填中转站给的 Key
- 模型名填中转站支持的模型名（通常是
gpt-4o 等）
- 连接保存
⚠️ 选择中转站要注意安全，不要选不明来源的。
🃏 五、角色卡使用
角色卡（Character Card / PNG 卡）是酒馆的灵魂，一个角色卡包含人设、性格、对话风格等全部信息。
5.1 获取角色卡
推荐来源：
- Chub.ai（全球最大角色卡社区，需能访问）
- 官方 Discord 的中文频道
- 国内 QQ 群、贴吧分享
- 自己制作（后面会讲）
角色卡通常是 PNG 图片文件，看似普通图片，实际嵌入了角色 JSON 数据。
5.2 导入角色卡
方法 A：拖拽导入（最简单）
- 找到下载的
.png 角色卡文件
- 直接在酒馆聊天界面，拖拽图片 到页面任意位置
- 弹窗确认 → 点击 导入
- 角色出现在左侧角色列表
方法 B：菜单导入
- 点击左侧角色列表顶部的 +" 按钮
- 选择 导入角色
- 选择 从文件导入
- 选择角色卡 PNG 文件
- 导入完成
5.3 创建角色
也可以手搓一个角色：
- 点击左侧 + → 创建新角色
- 填写：
- 名称：角色名
- 描述：简短的外貌性格介绍
- 角色人设（最重要）：详细的性格、背景、说话风格、行为习惯
- 示例对话：示范几轮你和角色之间的对话
- 开场白：角色第一次见面说的话
- 上传头像图片
- 点击 保存
5.4 角色管理
- 切换角色：点击左侧角色列表中的角色
- 编辑角色：鼠标悬停在角色上 → 点击 ✏️ 图标
- 删除角色：编辑页面底部 → 删除角色
- 导出角色卡：点击角色 → 右上角 导出 → 下载 PNG 卡
- 角色搜索：左侧列表顶部搜索框
5.5 角色卡进阶：角色分类和标签
在角色设置中可以为角色添加标签（Tags），方便分类管理：
- 在主界面左栏顶部打开 筛选器
- 可以为角色打上
原神、原创、古风、科幻 等标签
- 点击标签快速筛选
🛠️ 六、常用设置优化
6.1 响应生成设置
在聊天界面右侧的 ✨ 设置 面板：
| 参数 | 推荐值 | 说明 |
|------|--------|------|
| 温度 | 0.81.2 | 越高越有创意，越低越稳定 |
| 重复惩罚 | 1.01.1 | 避免车轱辘话 |
| 最大 token | 5001500 | 每次回复的最大长度 |
| 上下文长度 | 40968192 | 模型能记住的对话历史长度 |
6.2 角色扮演风格
在同一个设置面板中：
- 系统提示词：可自定义角色扮演的规则
- 预设：酒馆内置了多种聊天预设（Roleplay、Chat、Instruct 等）
- NSFW 开关：在用户设置中开启/关闭 NSFW 内容
6.3 世界书（Lorebook）
世界书是酒馆的"背景百科"，适合搭建复杂世界观：
- 点击顶部 📖 世界信息 按钮
- 创建新世界书 → 添加条目
- 每个条目设置 关键词触发，当聊天中出现关键词时自动插入该设定
❓ 七、常见问题
Q：启动报错 port 8000 already in use
# 指定其他端口启动
node server.js --port 9000
然后访问 http://localhost:9000
Q：npm install 很久或报错
# 换淘宝源重试
npm config set registry https://registry.npmmirror.com
npm install --no-audit --no-fund
Q：API 连接失败/超时
- 检查 API Key 是否正确
- OpenAI/Claude 需要网络环境（你懂的）
- DeepSeek 国内直连没问题
- 检查 API URL 末尾是否带了
/v1
Q：角色回复太敷衍/重复
- 降低 温度 到 0.70.9
- 增加 重复惩罚 到 1.051.15
- 检查角色卡的人设是否详细
- 尝试换更强模型（GPT-4o / Claude 3.5 Sonnet）
Q：如何更新酒馆
cd C:\SillyTavern
git pull
npm install --no-audit --no-fund
（如果是 ZIP 安装的，重新下载覆盖，保留 data/ 文件夹）
💡 八、推荐路线图
| 阶段 | 目标 | 推荐方案 |
|------|------|----------|
| 入门 | 先跑起来玩玩 | DeepSeek API（便宜）+ 默认设置 |
| 进阶 | 更好的角色扮演体验 | Claude 3.5 Sonnet / GPT-4o，调参 |
| 深入 | 本地模型 / 离线 | KoboldCPP + Mistral-7B GGUF |
| 高级 | 搭建世界观 | 学习世界书（Lorebook）、多角色群聊 |
| 折腾 | 完全自定义 | 插件、TTS语音、Stable Diffusion 生图联动 |
📝 九、快速启动备忘录
以后每次使用只需要两步：
cd C:\SillyTavern
node server.js
然后浏览器打开 http://localhost:8000
