常见问题
欢迎来到 Tavern Studio 故障排查中心与常见问题（FAQ）汇总。本篇文档收集了新老用户在使用客户端过程中较常遇到的关于 API 连接、资产导入、本地大模型运行以及数据管理的阻塞点。如果在阅读后仍未解决您的问题，请在设置中检查您的选项是否正确。
适合谁阅读
- 遇到了“点击发送无回复”、“角色卡导入报错”或“软件报错闪退”的具体故障排查用户。
- 想弄清楚 Tavern Studio 数据文件物理存储在哪里、是否有账号系统的安全保障倾向用户。
- 对本地 GGUF 推理硬件优化和世界书动态匹配规则有疑问的高级创作者。
你将学会什么
- 排查并定位云端 API 连接和 OpenAI-compatible 协议的报错。
- 修复角色卡在导入和解密时的常见问题。
- 优化本地 GGUF 大语言模型运行时的 GPU 显存分配以防止崩溃。
- 理解客户端的数据隐私边界与离线运作逻辑。
核心 FAQ 汇总
Q1：我必须注册账号或登录才能使用 Tavern Studio 吗？
不需要。Tavern Studio 是一款本地优先（local-first）的独立客户端。我们没有中央在线账号体系，您不需要填写任何手机号或邮箱注册，安装后即可使用。您的角色设定、世界书以及对话记录，都保存在您个人设备的本地数据库中。
Q2：为什么我的 API 连接一直失败，状态指示球是红色的？
这是较常见的故障，请逐步检查：
- 检查 Base URL 格式：请确认您的接口地址是否拼写正确。大多数 OpenAI 兼容接口要求 Base URL 必须以
/v1结尾（例如：https://api.example.com/v1）。如果刷新模型无反应，请尝试添加或去掉这个后缀。 - 校验 API Key：检查密钥复制时是否夹带了多余的空格或换行符，且账户内确实还有充足的余额。
- 网络与代理问题：如果您调用的是海外原生大模型接口（如 Claude 或 OpenAI），请检查您的本地代理网络设置，确保在设置的“网络配置”中，正确绑定了本地代理软件的端口。
Q3：为什么导入的角色卡没有头像，或者提示 "No character data found"（未找到角色数据）？
- 原因 A：您下载的 PNG 图片不是标准的 AI 角色卡，或者图片在社交传输过程中（如直接在微信中发送而未勾选原图）被压缩算法破坏了隐写数据块。请确保您的卡片是从专门的角色卡分享网站通过 Download 按钮下载的原图。
- 原因 B：有些图片其实是 JSON 格式导出的外置卡，被手动改了后缀，需要使用底部的“+”按钮通过“统一导入管理器”选择导入以自动解析。
Q4：为什么我导入的加密角色卡在输入密码后提示“Decryption failed”（解密失败）？
- 请仔细确认作者提供的密码的大小写是否匹配，密码前后不能有空格。
- 该 PNG 图片在下载传输时可能已经发生了损坏，导致即使输入正确密码也无法解密数据。请尝试重新获取卡片原文件后再次导入。
Q5：为什么在聊天中我触发了世界书的关键词，AI 好像还是记不住设定？
- 检查关键词匹配：词条匹配是按照字面精确匹配的。如果您在 Keys 里写的是
红宝石，但在对话中只说那颗宝石，则不会自动触发注入。 - 检查 Chat Settings 绑定：请确保您在 Chat 窗口（宽屏并列右侧面板，窄屏向左滑动拉出）中，已经在 World Book Binding 栏里选中了对应的那本世界书。
- 优化扫描深度：在设置中可以调大“检索扫描深度（Scan Depth）”，让系统能够检索更久之前的聊天历史来匹配关键词。
Q6：在本地运行 GGUF 模型时，为什么引擎总是闪退，或者加载进度到一半软件崩溃？
这通常是因为触发了 显存溢出（Out of Memory）。
- 解决办法：请在 API 设置页面的本地引擎参数中，降低 GPU Layers / Offload（GPU 显存卸载层数） 的值（例如：从
35降为15），让多余的模型权重留给系统内存与 CPU 运算。 - 检查显存资源：在拉起本地模型前，尽量关闭电脑中的高资源游戏或多媒体编辑软件，确保显卡上有充足的空闲显存（VRAM）可用。
Q7：我在全局设置里换了新的生成预设（Preset），但对话风格没有任何改变？
请在 Chat 窗口中，向左滑动（或查看宽屏右侧）展开 Chat Settings（聊天设置） 面板。检查您当前聊天的 Generation Preset（生成预设） 是否勾选了“覆盖全局”或绑定了其他的预设包。如果是，则全局预设的修改在此聊天中是不生效的，您需要将此处的绑定调整为您刚刚修改的那套预设。
Q8：我的本地聊天记录、角色卡物理保存在我电脑的哪里？
Tavern Studio 的全部本地资产默认保存在应用专属的本地应用数据文件夹中：
- Windows 平台：通常位于
C:\Users\您的用户名\AppData\Local\TavernStudio\。 - macOS 平台：通常位于
/Users/您的用户名/Library/Application Support/TavernStudio/。 - 便携模式：如果您的版本支持并启用了 Portable（便携模式），数据则会全部保存在软件主程序同目录下的
data/文件夹中。