常见问题
点击“翻译页面”后没有变化
先确认当前标签页是普通网页，并且页面中确实有可见的文本段落。浏览器内部页面、扩展商店、部分 PDF 阅读器和受保护的编辑器可能禁止扩展注入内容。
如果网页正常，再检查翻译服务是否启用、密钥是否有效、目标语言是否正确。建议先选中一句话测试服务，再尝试整页翻译。
页面只翻译了一部分
这是长页面中最常见的情况，可能与请求超时、服务额度、频率限制、页面动态加载或文本节点结构有关。可以恢复原文后分段翻译，也可以在页面加载完成后再执行一次。
如何恢复原文？
打开 FluentRead 弹窗，使用“恢复原文”。恢复操作只移除 FluentRead 插入的双语内容，不会把网页原本的文本写回其他位置。
如果修改了目标语言或翻译服务，建议先恢复原文，再重新翻译。
为什么选区翻译可用，但整页翻译不工作？
选区翻译只需要处理你选中的文本，整页翻译还需要识别页面结构、过滤导航和控件，并面对动态内容。遇到特殊网站时，可以先使用选区翻译，或在 GitHub 提交页面链接和复现步骤。
Ollama 无法连接
请按顺序确认：
- Ollama 服务已经在本机运行，并且目标模型已安装。
- FluentRead 中填写的地址与本机实际地址一致。
- 浏览器控制台没有 CORS 或网络错误。
- 本地接口允许来自扩展页面的请求。
不同系统、模型和 Ollama 版本的启动方式可能不同，请以 Ollama 当前官方文档为准。若本地接口能用 curl 请求但扩展不能访问，通常是浏览器跨域策略或扩展权限问题。
API Key 应该放在哪里？
只填写在 FluentRead 设置页的服务配置中，不要放进网页、截图、Issue、聊天记录或 Git 仓库。若怀疑已经泄露，请立即在服务商控制台撤销并重新生成。
翻译结果看起来重复或排版异常
先恢复原文，再重新翻译一次。对于会动态更新内容的网站，等待页面完全加载后再翻译；如果仍然重复，请刷新页面并确认没有同时运行两个翻译扩展。
如何报告问题？
在 GitHub Issues 中提供：
- 浏览器及版本；
- FluentRead 版本；
- 网页类型或可公开访问的链接；
- 复现步骤和预期结果；
- 控制台错误的脱敏截图或文字。
请删除 API Key、Cookie、个人信息和受版权或隐私保护的原文后再提交。