200 条离线词库不能用

1. 先输入一个已收录示例，例如 RAG、MVP 或 上下文窗口。
2. 确认 App 没有停留在设置页，按回车让浮卡翻面。
3. 离线词库不需要订阅，也不需要 API Key；如果示例词仍无结果，请重新启动 App。

已订阅，但在线解释不可用

1. 打开侧栏“订阅”，确认当前 Apple 账户显示有效订阅或账单宽限期。
2. 点击“恢复购买”，等待状态刷新后再试一次。
3. 如果界面提示购买状态未确认、服务暂时繁忙或请求太快，按提示稍后重试；不要连续快速提交。

输入多个词，只命中其中一个

例如输入“pi agent”时，本地词库可能只识别到 Agent。BuzzTrans 会先让你确认：可以查看本地词条，也可以选择“按原词联网解释”。在你确认前不会发送当前输入。

Dev API 连接失败

1. 确认当前安装的是官网 Dev 版，并在“Dev API”页保存了有效 Key。
2. 确认接口地址与模型名称和供应商文档一致；默认使用 OpenAI Chat Completions 兼容格式。
3. 身份验证失败通常要重新检查 Key；计费不可用要检查供应商余额；请求太快时请稍后再试。

API Key 保存在 macOS 钥匙串。不要把 Key、完整查询正文或私人补充包发给任何支持人员。

补充包无法导入或更新

• 文件需为 UTF-8 编码的 MD 或 TXT。
• 有效订阅与 Dev 版可以新增、导入和更新补充包。
• 订阅到期后，已经导入本机的包会永久保留，可继续查询、启停和删除，但不能新增或更新。

请求人工帮助前

请准备 App 版本、macOS 版本、Apple 芯片或 Intel、问题发生在哪个页面，以及界面显示的错误类型。不要提供 API Key、Apple 账户信息、查询正文或私人补充包。

官网 Dev 用户请通过取得下载码的原联系渠道联系 Su。App Store 常规版上线后，产品页会同步提供面向普通用户的开发者联系入口。