常见问题
本页整理了常见问题及解决方法。请先确认扩展已开启，并刷新普通网页后重试。
本地翻译模型保存在哪里？卸载扩展会清理吗？
本地翻译模型保存在哪里？卸载扩展会清理吗？
在 FluentRead 的“本地模型翻译”中下载的模型保存在当前浏览器属于扩展的本地缓存中。下载按钮边框内的 ⓘ 图标支持悬停或键盘聚焦，可查看存储与卸载清理说明。
正常卸载插件时，浏览器会自动清除插件所属的存储，包括下载的模型和相关缓存；仅停用插件会保留这些数据。也可以直接删除模型，保留插件继续使用。Chrome 内置翻译的语言包由 Chrome 自己管理；手动下载的插件压缩包或解压目录需要另行清理。
点击“翻译页面”后没有变化
点击“翻译页面”后没有变化
- 安装或更新后，先刷新原来打开的网页。
- 确认扩展主开关已开启，目标语言符合预期。
- 浏览器设置页、扩展商店等受保护页面不能翻译，换一篇普通文章试试。
- 到翻译服务设置点击“检查连接”。免费服务忙碌时，可以稍后再试或换服务。
页面只翻译了一部分
页面只翻译了一部分
默认会随阅读位置逐步翻译，向下滚动查看后续段落。想一次翻译整页，可以修改全文翻译范围。
如果漏掉的是菜单、按钮或特殊正文区域，参考网站阅读范围。图片和图表里的文字请用图片或圈选翻译。
为什么中文译文里出现日文？
为什么中文译文里出现日文？
个别翻译服务可能把段落译成错误的语言。对明确属于整段日文的结果，免费翻译会尝试下一条已启用线路；单独选择服务时会重试一次。连续返回错误语言时会显示失败，不会把这段结果作为译文或写入缓存。正常中文译文中的短日语名称、术语或引用会保留。
如果仍遇到混合语言，请确认目标语言，并在恢复原文后重试；反馈时附上所选服务、扩展版本及已去除隐私信息的截图。
网页邮箱的正文能翻译吗？
网页邮箱的正文能翻译吗？
QQ 邮箱旧版阅读页，以及网易 163、126、yeah 免费邮箱的 JS6 阅读页有独立的邮件正文 frame 处理。打开具体邮件后尝试全文或划词翻译，必要时刷新邮件页面。写信编辑器不会作为邮件正文翻译。不同版本的邮箱页面结构可能不同；若仍有漏译，请反馈邮箱域名、网页版路径（删去 sid 等参数）、浏览器版本与经过隐私处理的截图，不要提交完整邮件或登录信息。
图片翻译一直在准备
图片翻译一直在准备
使用本地 OCR 时需要下载文字识别语言包。检查图片上的提示，按需点击下载并等待完成；确认源语言与图片文字匹配。圈选翻译也可以开启“优先模型识图”：模型支持时直接识别选区图片，无需语言包。图片过于模糊或无法读取时，可以换清晰原图或只圈选一小块。
API Key 填在哪里？为什么连接失败？
API Key 填在哪里？为什么连接失败？
在 设置 → 翻译服务 对应服务的连接配置中填写。检查地址、密钥、模型和账号额度。网页聊天会员不一定包含 API 用量。
Ollama 连接失败时，确认本地服务正在运行，模型已下载，并允许扩展连接。详见服务指南。
与 Font Rendering 字体渲染脚本一起使用时，译文为什么会消失？
与 Font Rendering 字体渲染脚本一起使用时，译文为什么会消失？
部分旧版 FluentRead 会把字体脚本添加的粗体修正标记误判为译文被改写，反复修复后撤掉译文。兼容修复会保留这些字体标记，同时继续检查真实的内容和结构变化。遇到此问题，请更新到包含该修复的版本并刷新网页；商店版尚未包含修复时，可暂时关闭字体脚本的粗体修正功能。
旧版备份还能导入吗？
旧版备份还能导入吗？
支持旧版配置 JSON 和 FluentRead 备份文件，可在设置页的“备份与恢复 → 本地备份”中导入。这里也可将设置、单词本和模型用量导出为文件；备份包含 API Key 等私密信息，且未加密，请妥善保存，不要公开分享。旧备份缺少后来新增的配置项时，会按兼容规则补齐，已有 API Key 也会迁移。
若遇到“完整备份配置的精确凭据快照无效”，请保留原文件。这可能是部分版本对新增密钥字段的校验遗漏了旧备份兼容处理；该问题已修复。如果更新后仍失败，请反馈扩展版本与报错文字，无需公开完整备份。
仍然无法解决
到 GitHub Issues 反馈，附上浏览器与扩展版本、可公开的网址、复现步骤，以及隐藏隐私内容的截图。请勿提供密钥、Cookie 或账号资料。