信息层级：【有据可查】= 附官方文档或可信来源链接；【社区共识】= 社区用户普遍经验，未经官方确认；【待考察/推测】= 推测或暂未能核实，请谨慎对待。
🍺 酒馆是什么：一个本地安装的前端界面，用来和文本大模型（以及图像生成、TTS 语音模型）进行角色扮演式对话。它本身不带模型，需要连接云端 API 或本地后端（如 Ollama 入门：下载模型、对话、API 与 Modelfile 的 Ollama）。
1. 基本事实【有据可查】
| 项目 | 内容 |
|---|---|
| 许可证 | AGPL-3.0，免费开源 |
| 起源 | 2023 年 2 月从 TavernAI 1.2.8 分叉 |
| 运行要求 | 能跑 Node.js 20+ 的设备即可（Windows 7 不行）；只有在本机跑模型时才需要显卡 |
| 平台 | Windows、Linux、macOS、Android（Termux）、Docker |
| 默认端口 | 8000；默认 listen: false（只接受本机访问） |
| 分支 | release（稳定）与 staging（尝鲜） |
2. 安装（Windows 示例）【有据可查：Windows 安装文档】
- 安装 Node.js（推荐最新 LTS）与 Git for Windows。
- 新建一个不受系统/同步盘监控的文件夹（例如
C:\MySpecialFolder）。 - 在该文件夹打开命令行：
git clone https://github.com/SillyTavern/SillyTavern -b release - 双击
Start.bat，等待依赖安装完成，浏览器会自动打开。
Linux/macOS 用 start.sh；也可 node server.js --port 8000 --listen false 显式启动。【有据可查：config.yaml 文档】
3. 主界面图解
上图为示意简图（非官方截图），图标与位置可能随版本和主题变化。
3.1 顶栏九个按钮（红色编号）
| # | 面板 | 干什么 | 新手必看程度 |
|---|---|---|---|
| ① | AI 回复配置（AI Response Configuration） | 采样参数（温度、Top P、重复惩罚…）、上下文长度、最大回复长度、预设；Chat Completion 模式下包含 Prompt Manager（提示词管理器） | ⭐⭐⭐⭐⭐ |
| ② | API 连接（API Connections） | 选择 API 类型（Chat Completion / Text Completion 等）、填地址与 Key、选模型、保存连接配置 | ⭐⭐⭐⭐⭐ |
| ③ | 高级格式化（Advanced Formatting） | Text Completion 模式下的上下文模板、指令模板（Instruct）、系统提示词、分词器 | ⭐⭐⭐（用本地 Text Completion 后端时必看） |
| ④ | 世界信息 / 世界书（World Info / Lorebook） | 按关键词自动插入设定条目 | ⭐⭐⭐⭐ |
| ⑤ | 用户设置（User Settings） | 界面主题、聊天样式（平铺/气泡/文档）、显示 Token 数与生成耗时、自定义 CSS 等 | ⭐⭐ |
| ⑥ | 背景（Backgrounds） | 聊天背景图 | ⭐ |
| ⑦ | 扩展（Extensions） | 安装/管理扩展：摘要、向量记忆、图像生成、TTS、翻译等 | ⭐⭐⭐ |
| ⑧ | 人设管理（Persona Management） | "你"是谁：名字、头像、描述；可绑定到特定角色或聊天 | ⭐⭐⭐ |
| ⑨ | 角色管理（Character Management） | 角色列表、创建/导入/导出角色卡、群聊 | ⭐⭐⭐⭐⭐ |
3.2 聊天区（蓝色字母）
| 标记 | 元素 | 说明 |
|---|---|---|
| A | 消息头 | 角色名、消息序号、生成耗时、Token 数（可在用户设置中开关） |
| B | 滑动（Swipe） | 点 ▶ 让 AI 对同一位置重新生成另一个回答，◀ ▶ 在多个版本间切换 |
| C | ≡ 选项菜单 | 新建聊天、管理聊天文件、作者注释（Author's Note）、重新生成、继续等 |
| D | 🪄 扩展菜单 | 各扩展的快捷入口（如生成图片、摘要） |
| — | 消息操作 | 编辑、复制、删除、从此处分支等 |
| — | 输入框 | 支持 / 斜杠命令（如 /bubble 切换气泡样式） |
4. 发送一条消息时，背后发生了什么？
最关键的理解：模型没有记忆，每次发送都是"整份剧本重新读一遍"。角色"失忆"、"人设崩坏"，几乎都能从"这一次到底发了什么"里找到原因。【社区共识】
💡 排查技巧：酒馆提供查看本次实际发送提示词的功能（如 Prompt Itemization/提示词检查，位置随版本变化），先看它再调参数。【待考察：具体入口名】
5. 角色卡：一个角色由什么组成？
【有据可查】角色卡通常以 PNG 图片（JSON 数据嵌入图片元数据）或 JSON 文件分享；社区有公开的 Character Card V2 规范。
| 字段 | 作用 | 写作建议【社区共识】 |
|---|---|---|
| 名字 Name | 显示名 | — |
| 描述 Description | 外貌、背景、能力——每次都会发送 | 精炼，别写成长篇小说，会一直占用上下文 |
| 性格 Personality | 性格摘要 | 用具体行为描述，少用抽象形容词 |
| 场景 Scenario | 当前情境 | — |
| 首条消息 First Message | 开场白，强烈影响后续文风 | 用你期望的长度与风格写 |
| 示例对话 Examples | 示范说话方式 | 2–3 段足够 |
| 绑定世界书 | 角色专属设定 | 大量设定放这里，而不是描述里 |
⚠️ 导入别人的角色卡前：卡里可能含有你不需要的系统提示、绑定的正则脚本或世界书；先看一遍内容。【社区共识】
6. 世界书（World Info）：按需"翻设定集"
| 设置 | 含义 |
|---|---|
| 关键词 Keys | 出现这些词才触发 |
| 常驻 Constant | 总是插入（慎用，占上下文） |
| 扫描深度 | 往回看多少条消息找关键词 |
| 插入位置 | 角色描述前/后、作者注释附近、指定深度等 |
| 预算 Budget | 世界书最多占多少上下文 |
用法建议：把"地名、组织、人物关系、规则"拆成多条短条目，各配关键词——比把所有设定塞进角色描述更省 Token、更稳定。【社区共识】
7. 两种 API 模式：选哪个？
| Chat Completion | Text Completion | |
|---|---|---|
| 典型后端 | OpenAI 兼容云 API、Claude、DeepSeek 等 | KoboldCpp、llama.cpp 服务、Ollama 原生、Tabby 等本地后端 |
| 提示词怎么拼 | 用 ① 里的 Prompt Manager | 用 ③ 高级格式化里的模板 |
| 关键设置 | 各块顺序与开关 | 指令模板必须与模型匹配，否则输出混乱 |
| 新手推荐 | ✅ | 熟悉后再用 |
来源：Prompt Manager、Advanced Formatting
8. 长对话"失忆"怎么办？
| 方法 | 原理 | 代价 |
|---|---|---|
| 调大上下文长度 | 能塞更多历史 | 更贵、更慢；不能超过模型上限 |
| 摘要扩展（Summarize） | 定期把旧对话压缩成摘要 | 摘要可能遗漏细节 |
| 向量记忆（Vector Storage） | 按相关性检索旧消息插入 | 需要 embedding 来源 |
| 世界书记录关键事件 | 手动维护"剧情备忘" | 需要手动 |
| 作者注释 | 在靠近末尾的位置提醒当前状态 | 少量 Token |
9. 安全与合规
| 项目 | 建议 | 层级 |
|---|---|---|
| 远程/手机访问 | 默认 listen: false；若开启监听，务必使用白名单（whitelist）和/或基础认证，不要暴露到公网 |
有据可查（配置项）/ 社区共识 |
| API Key | 存在本地数据目录；不要分享整个数据文件夹或截图设置页 | 社区共识 |
| 第三方扩展 | 扩展会在你的浏览器/服务器中运行代码，只装可信来源 | 社区共识 |
| 内容政策 | 使用云端 API 时仍受该厂商使用政策约束；本文不提供任何绕过模型内容安全限制（俗称"破限"）的预设或方法——这类做法可能违反服务条款并导致封号 | 社区共识 |
| 未成年人保护 | 严禁任何涉及未成年人的不当内容 | 法律要求 |
| 费用 | 长上下文 + 频繁滑动重抽会迅速消耗 Token，记得在 API 平台设预算 | 社区共识 |
10. 新手 30 分钟上手路线
11. 本篇无法核实/需谨慎的点
- 界面图标位置、面板中文译名随版本与语言包变化；示意图非官方截图。
- "查看实际发送提示词"功能的具体入口名称。
- 第三方角色卡/扩展/预设的安全性与合规性：尚未审核。
图解与代码示例中的相关教程：ComfyUI 入门：安装、节点、模型文件与第一张图。
小白练习：把本文流程逐项走通
练习目标：从一份自己创建的简单角色卡完成对话。
上文已介绍概念、配置和操作示例。下面侧重第一次实际操作时的顺序、检查点和结果核对；需要查具体参数时回到对应小节。命令逐条输入，看到上一条的结果后再继续。
-
先检查 Node 和 Git，再用原文的 release 分支安装。启动脚本运行时保持终端打开。
-
进入 API 连接面板，先选择 Chat Completion，再填来源、地址和凭据，测试一个实际可用模型。
-
新建自己的简单角色，只写姓名、简短描述和首条消息；先不导入带扩展或脚本的第三方卡。
-
设定自己的 Persona，发送一句话，确认角色回复与连接测试都正常。
-
尝试一次 Swipe，再查看当前回答版本。重新生成可能再次产生 API 费用。
-
最后添加两条有明确关键词的世界书条目，查看实际发送的提示词是否插入它们，再测试上下文和摘要。