200 条离线词库不能用

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

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

1. 打开侧栏“黑话翻译”，确认当前 Apple 账户显示有效订阅或账单宽限期。
2. 如果你更换过设备、重新安装过 App，或当前权益没有出现，再主动点击“恢复购买”。
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 账户信息、查询正文或私人补充包。

仍需人工帮助时，请发送邮件至 792127521@qq.com。开发者版用户也可以通过购买或取得优惠码时的原联系渠道寻求帮助。