常见问题
欢迎来到 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/檔案夹中。