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 就会从刚才断掉的地方接着往下写。