FluentRead 翻译引擎完全指南：免费降级链、云端服务与多 Key 轮询配置

前端AI 应用本地部署【免费下载链接】FluentReadAn open-source browser extension for bilingual translation. 一款开源的浏览器双语翻译插件。项目地址https://gitcode.com/gh_mirrors/fl/FluentRead点击查看免费下载FluentRead 是一款开源的浏览器双语翻译插件其翻译服务层采用多引擎 自动降级的架构不绑定单一翻译提供商用户可以先用免密钥的免费服务立即开始再按需接入 OpenAI 兼容 API、Azure、DeepL 等云端引擎或使用 Ollama 本地模型并根据阅读场景随时切换。本文以 docs/maintainers/product-reference/translation-engines-20260906.md 为骨架结合仓库源码src/services/translation/freeFallback.ts、src/core/config/freeTranslation.ts、src/core/translation/apiKeyPool.ts 等深入讲解服务选择、免密钥自动降级、AI 精翻、云端与本地模型接入以及多 Key 轮询机制读完即可独立完成从首次配置到生产级多引擎混用的完整搭建。服务页会显示可用服务、模型和当前连接状态。怎么选按需求匹配翻译服务FluentRead 的翻译服务目录覆盖三类来源免费翻译服务免密钥、云端引擎与 AI 服务需 API Key、本地模型Ollama。官方文档给出的选择建议如下你的需求可以先尝试想立即开始免费翻译服务使用官方公开且免密钥的 APIMyMemory邮箱也可留空需要上下文、术语和风格OpenAI 兼容 API 或其他 AI 服务不希望内容离开本机Ollama 本地模型需要留意的是免费服务的速度和可用性会随时间变化不能视为稳定 SLA云端服务的价格、额度和数据政策由服务提供方决定使用前应确认服务商的隐私政策和额度规则。从源码看服务目录被集中定义在 src/core/config/freeTranslation.ts 的FREE_TRANSLATION_PROVIDERS中每个条目包含id、label、description、official是否为官方公开 API和defaultWeight默认权重。其中仅myMemoryMyMemory 官方 API与apertiumFreeApertium 开放翻译服务标记为official: true其余如微软 Edge 网页接口、谷歌网页接口、DeepLX 公共接口等均为official: false——这与文档中前三项属于网页接口或非官方服务不能视作有公开 API 保障的官方接口的提示完全一致。第一次配置三步连接一个服务在完整设置 → 翻译服务中完成首次连接打开完整设置进入翻译服务。从列表中选择服务如果是 AI 服务再选择模型。免费翻译服务和 MyMemory 无需填写密钥可以直接检查连接标题旁提供使用说明。其他已有服务按自身要求显示连接字段和官网入口。点击检查连接确认服务可以正常返回结果。两个细节值得注意切换左侧服务只切换正在配置的项目网站入口随之更新但不会改变默认翻译服务MiniMax 的网站入口会跟随已选择的中国版或全球版区域。连接测试会发送一条很短的请求可能产生少量服务用量确认成功后再翻译长页面。免费翻译与自动降级四路免密钥链完整设置 → 翻译服务 → 免费翻译服务是 FluentRead 的核心能力之一用户可以在其中启用、停用或上下移动后备服务默认顺序为微软 → DeepLX → 谷歌 → MyMemory四路均无需密钥至少保留一路。各路服务的关键限制MyMemory无需注册或密钥邮箱可留空匿名每天 5,000 字符自愿填写有效联系邮箱后每天 50,000 字符邮箱会随请求发送给 MyMemory。每次最多 500 UTF-8 字节FluentRead 自动分段。自动源语言使用本地检测短文本无法可靠识别时手动指定源语言。DeepLX免费降级固定使用默认公共匿名地址不继承单独 DeepLX 服务中的自建地址、代理和 Token。Azure Translator、DeepL API Free 等服务虽然有免费额度但仍需 API Key不加入免密钥降级原有独立 DeepL、AI 等服务的配置保持原有用途免费链不会使用这些密钥。降级策略的源码实现免费链的运行时调度由 src/services/translation/freeFallback.ts 中的createFreeFallbackRunner承担它协调总预算、单次超时、服务并发与间隔、错误退避和恢复单探测。关键参数定义在 src/core/config/freeTranslation.ts参数默认值说明freeTranslationTimeoutMs5,000每路单次最多等待 5 秒合法范围 1,000–15,000msnormalizeFreeTranslationTimeoutMsfreeTranslationCooldownMs60,000失败服务暂时跳过 60 秒合法范围 1,000–300,000msnormalizeFreeTranslationCooldownMsFREE_TRANSLATION_TOTAL_TIMEOUT_MS20,000整条链共享的总预算deadline排队与各备用服务共同消费模式balanced可选balanced加权均衡或sequential顺序运行时行为与文档描述一一对应超时、网络故障、限流或配额错误后切换下一路freeFallback.ts中每次尝试通过runAttempt设置独立setTimeout超时抛出AttemptTimeoutErrorclassifyFreeFailuresrc/services/translation/freeRoutingPolicy.ts将错误归类为rate-limit、quota、blocked、unavailable、request五类例如 429 →rate-limit、402/456 →quota、401/403/404/410 →blocked。暂时跳过失败服务 60 秒失败后写入冷却状态state.retryAt Date.now() durationMs冷却期内候选不可用冷却结束后会重新探测。所有后备均不可用时显示失败不无限重试候选全部尝试后抛出免费翻译服务均不可用错误并附带各失败原因。用户取消会中止整条链调用方传入的AbortSignal会同步中止当前尝试并中断排队。冷却状态仅存在当前后台运行期健康快照通过freeTranslationHealthStorage持久化到存储见 src/platform/storage/freeTranslationHealthStorage.ts后台重启后重新加载并重新探测不代表额度已经恢复。值得一提的实现细节是免费链的匿名身份providerIdentitysrc/providers/translation/free-translation.ts只用公共端点、MyMemory 可选邮箱做 SHA-256 哈希生成身份已保存的 Key、代理和独立 DeepLX 地址均不能改变免费链的连接或冷却身份——这与文档中DeepLX 免费降级固定使用默认公共匿名地址的说明互为印证。免费链的批量并发免费翻译还支持批量文本translateFreeBatch使用FREE_TRANSLATION_BATCH_CONCURRENCY 3的并发度src/providers/translation/free-translation.ts同一批次共享截止时间任一失败会中止整个批次并向外传播错误。修改后备顺序后新请求使用对应的新缓存身份新的等待策略只影响后续请求已显示的译文可恢复原文后重新翻译。关于官方来源与更多候选比较可查阅仓库中的免密钥接口核验与接入限制。AzureChat Completions 接入与部署名称选择Azure填写 Azure API Key并在Azure 端点中填入资源地址例如https://YOUR-RESOURCE-NAME.openai.azure.com也支持https://YOUR-RESOURCE-NAME.services.ai.azure.com。FluentRead 使用 Chat Completions 接口。地址处理规则如下填写资源地址或/openai/v1/基础地址时会自动补齐为/openai/v1/chat/completions也可以直接填写完整接口地址v1 无需日期型api-version参数已有的/openai/deployments/部署名称/chat/completions?api-version版本完整地址可以继续使用原有部署路径和版本参数会保留。模型应填写 Azure 中的实际部署名称不一定等于模型的通用名称可通过自定义模型输入。配置会自动保存填写后点击检查连接。从源码看Azure 地址兼容逻辑位于 src/core/config/azure.ts注释明确保留旧版 deployments 路径与自定义网关前缀不替换显式 api-version证实了旧地址格式的向后兼容设计。DeepLAPI Free 与 API Pro 套餐选择DeepL先在DeepL API 套餐中选择套餐再填写对应的 API Key套餐翻译接口API Free免费默认https://api-free.deepl.com/v2/translateAPI Pro付费https://api.deepl.com/v2/translate套餐选择会自动保存当前 API 地址会显示实际使用的地址。已有配置默认沿用 API Free切换官方套餐后需要重新填写对应的 API Key。如果设置了自定义接口地址会优先使用该地址切换套餐不会覆盖它。DeepL 翻译器订阅与 DeepL API 套餐相互独立请使用 API 套餐提供的密钥。AI 上下文与多段翻译两个独立开关这两个选项独立生效默认都关闭AI 精翻AI 智能上下文点击弹窗翻译服务卡片右侧的紧凑入口在展开面板中开启也可在完整设置 → 通用设置调整。翻译时参考网页标题、描述和部分正文帮助理解术语和指代。相关网页内容会发送给当前 AI 服务并可能用于生成摘要可能增加用量和等待时间。AI 多段翻译在完整设置 → 翻译设置 → 全文翻译开启把同批到达的相邻短段合并为一次 AI 请求通常每批不超过 4 个文本槽、2000 字符。一个段落中的多个可翻译文本节点也会占用槽位因此不等同于固定 4 个段落。它不要求开启 AI 智能上下文。AI 精翻的状态机AI 精翻与翻译服务共用一行入口只显示名称及状态已关闭、已开启、待配置、当前不适用、当前不可用或已暂停。悬停可查看简短提示点击可展开开关、功能、用量与隐私以及生效方式。需要配置服务时可直接前往翻译服务设置。其展示状态由 src/ui/view-model/aiContext.ts 的resolveAIContextPresentation计算依次检查插件暂停、站点停用、当前不可用、服务不支持、缺少凭据最终落到off/ready/needs-setup/unsupported/unavailable/paused。开关偏好会自动保存切换到不支持的服务或模型不会清除偏好也不会立即开始翻译——开启只代表保存的偏好供后续新翻译使用。开启后用于后续新翻译网页已有译文时可恢复原文后重新翻译以应用新设置。回显检测与降级重译若译文出现上下文标签、明显夹带参考材料或大部分内容复制了原文中没有的长上下文片段会去掉页面上下文和摘要重译一次。普通术语重合只作为重试线索重试后仍明确回显参考内容的结果不会展示或写入缓存。多段结果按槽位还原批次格式完整时只有夹带上下文的段落会单独进行无上下文重译其余正确译文继续复用无法解析批次格式时才降级为逐段翻译。需要明确的是回显检测是保守的文本匹配无法识别所有改写后的参考材料也不把专名、代码或原样输出直接判定为翻译失败。多段翻译可以减少常规全文请求数量但服务返回异常时重试和降级仍会产生额外请求。悬浮、划词和输入框翻译继续使用各自的请求方式。云端服务与本地模型隐私与运行前提云端服务通常更容易开始但待翻译内容会发送到对应服务使用前请确认服务商的隐私政策和额度规则。Ollama 适合希望在本机处理内容的用户需要提前在本机安装并运行 Ollama同时准备一个可用模型。模型越大不一定越适合翻译速度、质量和电脑性能需要一起考虑。自定义服务OpenAI 兼容接口如果使用的服务提供 OpenAI 兼容接口可以在我的服务中添加它并单独保存地址、模型和凭据。自定义服务的请求格式、计费方式和数据处理由服务商负责。自定义服务和 New API 的访问网站会打开已配置地址的网站首页保留端口不会携带 API 路径、查询参数或账号凭据地址为空或无效时入口改为使用说明。连接失败时的排查清单先用短句测试确认地址、模型和凭据没有填错。检查服务商账号是否还有额度区域或版本是否匹配。AI 服务返回空结果时尝试换一个模型或减少请求内容。如果使用本地模型确认 Ollama 正在运行并允许浏览器扩展访问。API Key 只应填写在 FluentRead 设置中不要放进截图、Issue、聊天记录或仓库。多 Key 轮询一个服务多个密钥的动态加权当一个服务配置了多个 API Key 时FluentRead 会按服务、端点、模型等身份隔离进行动态加权轮询其算法位于 src/core/translation/apiKeyPool.ts。凭据模型apiKeys 与 token 的兼容服务的完整凭据列表使用apiKeys[service]旧token[service]是首个非空值的兼容镜像。配置保存、导入、备份、历史恢复和地址绑定同时处理两者公开导出和历史不包含 Key 列表。旧单 Key 按原值迁移不按逗号拆分。相关纯函数实现在 src/core/config/apiKeys.tsgetServiceApiKeys优先读取apiKeys缺失时才回退到旧token的单 Key 来源src/core/config/apiKeys.ts。动态权重的运行规则动态权重只存在于当前运行进程使用摘要scope隔离服务、端点、模型与 Key不记录明文凭据。各 Key 初始权重相同API_KEY_POOL_DEFAULT_WEIGHT 4src/core/translation/apiKeyPool.ts。鉴权、配额和限流使其暂停auth、quota、rate-limit类失败将权重直接置 0进入冷却transient、network、server类失败将权重减半。网络/服务暂时失败逐步降低权重成功提高权重成功后权重 1直到恢复初始权重。默认恢复窗口为 1 分钟DEFAULT_API_KEY_RECOVERY_MS 60_000src/core/config/scheduling.ts用户可在高级请求限制中调整为 1–60 分钟以整分钟保存见normalizeApiKeyRecoveryMs。明确的 Retry-After 至少等待 1 秒并优先于默认值reportFailure传入的retryAfterMs优先于恢复窗口。取消、模型及公共配置错误不惩罚 Keyconfig、cancelled属于NON_PENALIZING_FAILURESsrc/core/translation/apiKeyPool.ts。每次请求每个唯一 Key 最多尝试一次各次尝试都受原调度器与共享 deadline 限制。阅读/写作流仅在建立前失败时切换开始输出后不重放。连接检测与界面勾选连接检测按原始行索引执行且绕过自动切换空行与重复值不参与批量检查。界面中的勾选只代表该次检查结果编辑或服务配置变化会使结果失效。后台还专门提供了仅对设置页开放的权重快照接口src/app/background/handlers/freeTranslationWeights.ts通过isOptionsUrl校验调用来源快照只包含服务身份摘要和时间/性能数据不暴露连接身份哈希。小结FluentRead 的翻译服务层是一个典型的多引擎 策略调度系统免费链通过加权均衡与错误分类实现 5 秒超时、60 秒冷却、整链 20 秒预算的自动降级云端接入Azure、DeepL、OpenAI 兼容自定义服务统一走地址 模型 凭据 检查连接的配置范式AI 精翻与多段翻译以独立开关提供上下文增强多 Key 轮询则用摘要隔离 动态加权保证一个服务多个密钥的稳定分摊。理解这套架构后你可以按免费起步 → 按需接云端 → 敏感内容走本地的思路为不同阅读场景配置最合适的翻译链路。赞分享前端AI 应用本地部署【免费下载链接】FluentReadAn open-source browser extension for bilingual translation. 一款开源的浏览器双语翻译插件。项目地址https://gitcode.com/gh_mirrors/fl/FluentRead点击查看免费下载相关推荐免密钥翻译接口与自动降级FluentRead 的免费翻译服务池深度解析免密钥翻译接口与自动降级FluentRead 的免费翻译服务池深度解析 导读 本文以 FluentRead 仓库中的 免密钥翻译接口与自动降级 https:前端AI 应用本地部署DeepLX完全指南免费享受专业级翻译服务DeepLX完全指南免费享受专业级翻译服务 DeepLX是一款强大的免费DeepL API工具无需令牌即可使用让用户轻松享受专业级翻译服务。它为那些需要高后端DeepLX免费翻译服务完全部署指南DeepLX免费翻译服务完全部署指南 在当今数字化时代语言障碍仍然是许多用户面临的现实问题。传统翻译服务要么收费昂贵要么功能受限DeepLX的出现彻底改变后端上一篇listmonk前端无障碍设计符合WCAG标准的UI实现下一篇终极跨平台WebSocket服务器指南websocketd在Linux/Windows/macOS的完整测试创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考