Tavern Studio Docs · 02

快速开始

恭喜你启动 Tavern Studio！本篇“快速开始”指南旨在帮助你以最快的速度跨过配置门槛，在 5 分钟内完成模型对接、角色卡导入，并顺利发送你的第一条消息，开启沉浸式的角色聊天体验。

适合谁阅读

当你首次下载并双击运行 Tavern Studio 客户端时，系统会为您准备好一个干净、无污染的本地工作区。

默认语言：客户端会自动检测你的系统语言，如果你看到的是英文界面，可以点击屏幕底部 TabBar 最右侧的 Settings（设置） 图标（如果此时在聊天等非导航界面而看不到 TabBar，可以使用触摸板双指左右滑动来快速切换），在第一项语言设置中选择“简体中文（Chinese Simplified）”。
界面初探：你会注意到，角色列表区域是空的。Tavern Studio 的角色展示采用极富视觉效果的瀑布流布局，我们马上就会让这里热闹起来。

要让你的角色开口说话，你需要给 Tavern Studio 提供推理算力。目前最快、最方便的方案是配置云端 API。

点击屏幕底部 TabBar 最右侧的 Settings（设置） 按钮，或者使用触摸板双指左右滑动切换到设置页，找到 API 选项卡（或点击顶部状态栏的“模型未连接”提示）。
在 API Provider（服务商） 下拉菜单中，选择你拥有的服务商。对于初学者，我们推荐选择 OpenAI-compatible API（兼容 OpenAI 的接口），这使你可以接入大多数中转服务或国内如 DeepSeek 等服务。
输入你的 Base URL。例如，如果你使用第三方中转，请输入对应的服务商网关地址；如果使用官方 OpenAI，可保持默认。
输入你的 API Key（密钥）。
点击下方 Refresh Models（刷新模型列表） 按钮。如果连接成功，下方的“模型列表”下拉框中会自动列出你账号可用的所有模型。
在模型列表中选择一个用于角色扮演的模型（如 gpt-4o-mini 或 deepseek-chat），最后点击 Connect（连接） 或保存设置。

如果你打算使用纯本地离线模型，可以跳过此步骤，直接参考本地 GGUF 模型入门教程。

Tavern Studio 并没有内置庞大的角色市场，但它支持常见的通用 Character Card（角色卡）。

现在，算力已经准备就绪，角色的灵魂也已导入，是时候开始对话了。

在瀑布流列表中点击你刚刚导入的角色卡，系统会为你打开并进入与其对应的 Chat 窗口（在桌面分栏模式下，你可以在屏幕左侧继续查看角色瀑布流，在右侧进行聊天）。
Chat 窗口与设置切换：在屏幕宽度足够时，Chat 窗口会自动分出右侧的 Chat Settings 面板；若宽度不够，你只需要在屏幕上向左滑动，即可从 Chat 聊天页切换至 Chat Settings 面板。
角色通常会发送一条由角色卡作者预设好的 Greeting（问候语）（例如：“（它靠在吧台旁，抬头看着你）又见面了，今天想喝点什么？”）。
在底部的输入框中输入你的回复（例如：“来一杯红茶，顺便跟我讲讲这附近发生的新鲜事。”），然后按下回车键或点击发送图标。
大模型将开始生成回复。你会看到文字逐字流式输出在屏幕上。

完成了第一次聊天后，你已经成功踏入了 Tavern Studio 的大门。为了获得更沉浸、更高拟真度的对话，你可以在接下来的探索中尝试：

应用生成预设（Preset）：如果你觉得 AI 说话过于死板，或生成的动作描述不够多，可以在 Chat Settings 面板中切换或绑定更适合 Roleplay 的预设（宽屏时在 Chat 右侧并列显示，窄屏时左右滑动切换）。
绑定世界书（World Book）：如果你们聊天的世界观很宏大，包含特定的国家设定或奇幻魔法规则，记得创建一个世界书并绑定给该角色，防止 AI 随时失忆。

这通常是由于 API 配置错误引起的。请返回设置页，检查以下几项：

这说明该 PNG 图片不是标准格式的 AI 角色卡，或者图片被社交软件压缩过导致隐写数据丢失（如微信传输原图未勾选原图）。请尝试从专门的角色卡分享网站重新下载标准的角色卡图片，并确保它是原图。

这通常是因为触发了最大输出长度限制。你只需点击输入栏上方的 Continue（继续生成） 按钮，AI 就会从刚才断掉的地方接着往下写。