常见问题排查 (FAQ)

整理了 API 连通性测试报错、动态网页增量补翻、数据安全存储与跨设备配置迁移的常见疑问与排查步骤。

点击“测试连通性”提示报错或超时？

检查端点 URL、API Key、模型 ID 和账户额度。第三方兼容端点应填写完整路径（通常以 /v1/chat/completions 结尾）。本地服务请继续查看下方 Ollama 排查。

为什么某些动态页面的部分内容没有翻译？

动态内容通常会由页面观察器自动处理。若滚动后仍有遗漏，可先恢复原文，再重新开启翻译。Alt + A 是翻译/恢复切换键：已译页面按一次会恢复原文，不会只补翻新内容。

我的 API Key 和翻译数据存储在哪里，安全吗？

API Key 和配置保存在浏览器的 chrome.storage.local 中；扩展未对密钥额外加密。翻译文本直接发送到您配置的服务端，由该服务商处理。请保护浏览器配置文件及导出的配置备份；备份可能包含 API Key。

更换电脑时，如何迁移配置和翻译记录？

在“设置中心 → 备份与恢复”中，分别使用“导出配置 (.json)”和“导出记录 (.json)”。在新设备上通过对应的“导入配置”和“导入记录”恢复；这两类文件不能互换。配置备份可能包含 API Key，请妥善保管。

💡 遇到其他疑难问题？

可在已安装扩展的设置中测试 API 连通性或查看本地词库状态。如需报告翻译或网页排版问题，请使用所安装应用商店详情页中的支持或反馈入口。

本地 Ollama 连接与跨域排查

先确认服务已启动，且模型 ID 与本地安装的模型一致。将 OLLAMA_ORIGINS 设置为您扩展的来源（chrome-extension://扩展ID），重启 Ollama 后重试。按操作系统配置环境变量的方法见 Ollama 官方 FAQ。