前端AI 应用本地部署【免费下载链接】FluentReadAn open-source browser extension for bilingual translation. 一款开源的浏览器双语翻译插件。项目地址https://gitcode.com/gh_mirrors/fl/FluentRead点击查看免费下载FluentRead 通过“翻译服务”这一统一抽象把网页、文档、字幕等场景的翻译请求交给所选的翻译引擎处理。本篇指南基于官方配置文档 docs/config/translation-engines.md并结合 src/providers/translation 与 src/core/config 下的源码实现完整讲解免费翻译、云厂商机器翻译、AI 大模型、本地模型与 Ollama 的选型逻辑、配置步骤和底层运行机制。读完你将能够根据使用场景快速选定服务、正确填写各类密钥与地址、理解多 Key 轮换与免费服务故障转移的内部原理并独立排查连接失败。如何选择适合你的翻译服务FluentRead 不强制绑定某一家翻译商官方文档给出了一张按“使用诉求”划分的选型表你希望怎样使用可以选择安装后直接翻译免费翻译服务无需填写密钥已有翻译服务账号对应的 Microsoft、Google、DeepL 等服务按页面要求配置用云厂商密钥换取稳定的免费额度云服务厂商中的谷歌云、Azure、阿里云、腾讯云、百度或火山引擎各家每月都有免费字符额度解释长句、语气或专业表达AI 服务需要可用模型及服务凭据在本机处理翻译文字本地模型翻译、Ollama本地或可用的 Chrome 本地翻译几点需要提前明确的事实FluentRead 本身免费开源但第三方服务可能单独收费。服务商的订阅、接口额度与网页聊天会员往往不是一回事请确认你购买的是可用于接口调用的服务而不是网页版会员。免费翻译服务、云厂商接口、AI 服务、本地模型在架构上是并列的独立 provider。从 src/providers/translation/registry.ts 可以看到注册表把服务分成几组传统机器翻译MyMemory、微软、DeepL、DeepLX、谷歌、有道、Chrome 翻译、云厂商机器翻译腾讯、谷歌云、Azure、阿里云、百度、火山、大模型翻译通义、智谱、Gemini、Claude、DeepSeek、混元、本地翻译以及按AI_SDK_SERVICE_IDS批量绑定到共享 transport 的 OpenAI 兼容平台。配置并开始使用以扩展设置页为入口首次接入任意服务都遵循同一条路径进入设置 → 翻译服务。服务目录按分类排列也可以在列表顶部搜索。按界面填写密钥、地址AI 服务同时选择模型。不确定的信息从该服务的官网获取。即使 API Key 留空也可以先点击检查连接需要凭据的服务会在检查结果中提示缺少凭据或认证失败。点击检查连接确认能返回结果。检查会发送一条短请求可能产生少量用量。回到常规设置或扩展菜单选择这个服务作为默认服务再翻译一句话。官方文档特别强调了一个容易混淆的点点击服务目录只是在编辑这项服务不会立刻更改网页翻译使用的服务。检查连接位于服务详情标题栏右侧完成配置后请从常规设置或扩展菜单选择默认服务。文档、字幕和翻译卡片请检查各自的服务选择。也就是说“配置服务”与“切换默认服务”是两个独立动作。内置服务无需添加即可配置已有配置和自定义接口会保留需要接入其他接口时点击列表顶部的自定义服务。服务详情中的高级设置默认折叠展开后按四组划分密钥与认证管理多个 API Key 与鉴权凭据翻译偏好调整模型思考与提示词请求设置调整等待时间与请求频率自定义请求补充请求头与 JSON 参数。修改会自动保存但注意填写过密钥不代表连接检查成功最终以“检查连接”的返回为准。翻译服务目录界面先配置连接再在常规设置或扩展菜单中选择要使用的服务。使用多个 API Key多 Key 轮换支持 API Key 的服务可以在高级设置 → 密钥与认证中启用多 Key 轮换然后点击列表底部的“添加 Key”每行填写一个无需分隔符。原来保存的单个 Key 会继续保留。所有 Key 共用当前服务的接口地址、模型、区域与自定义请求头如果这些设置需要不同请分别创建自定义服务。轮换的工作机制可以概括为“均衡分配 失败摘除”开始时各 Key 均衡分担请求请求失败后会自动尝试其他 Key并暂时降低失败 Key 的使用频率鉴权失败或额度用尽的 Key 可能被暂停使用失败 Key 的默认恢复等待为 1 分钟可在设置 → 高级 → 请求限制中调整为 1–60 分钟服务明确给出限流等待时间时遵循该时间轮换仍受你设置的请求频率和总超时限制健康状态是临时状态扩展后台重新启动后会重置。“检查全部”功能会按顺序检测每个已填写且不重复的 Key结果与汇总显示在同一区域。点击“检查失败”可展开原因使用行末的检查按钮可以单独重测检查期间可停止后续检查。一个 Key 失败不会中断其余检查空白行与重复 Key 不会额外发送请求。检查会发送一小段测试文本可能消耗少量服务额度。勾选表示这次检查通过并不代表后续请求始终可用。免费翻译如何工作免费翻译服务通过多个免密钥接口生成译文是安装后“开箱即译”的基础。其配置层在 src/core/config/freeTranslation.ts 中维护了完整的服务池服务 ID名称默认权重说明microsoft微软翻译5Edge 网页接口非官方公开 APItransmart腾讯交互翻译3免密钥网页接口与腾讯云翻译不同volcengineFree火山翻译3免密钥网页接口无需火山云账号google谷歌翻译3网页接口非官方公开 APIyoudaoFree有道网页翻译3与有道智云不同icibaFree金山词霸3自动处理网页签名yandexFreeYandex2暂不支持繁体目标语言deeplxDeepLX1非官方公共接口无需密钥myMemoryMyMemory1官方 API匿名每天 5,000 字符sogouFree搜狗翻译2实验性网页接口reversoFreeReverso1实验性网页接口可能触发访问验证lingvaFreeLingva1实验性公共实例使用谷歌翻译上游apertiumFreeApertium1开放翻译服务暂无中译接口卡片按页面宽度排列可选择参与调用的接口实验候选单独展示已启用项会显示在摘要中。默认启用微软、腾讯交互翻译、火山、谷歌、有道网页翻译、金山词霸、Yandex、DeepLX 和 MyMemory无需填写密钥搜狗、Reverso、Lingva 与 Apertium 可另行启用前三项仍属实验候选Apertium 暂无中文语言对。这一默认顺序与源码中DEFAULT_FREE_TRANSLATION_ORDER完全一致。自动均衡与优先顺序默认使用自动均衡模式微软排在第一位并优先尝试。后台会根据服务成功率、响应耗时和近期错误动态分配请求服务失败时自动换一路。你也可以停用某项或改成按列表依次尝试的优先顺序模式至少保留一项。这些分配参数由后台自动维护用户不需要设置权重仅服务启用状态和模式属于用户设置。用于动态分配的健康与性能记录保存在本地。从源码看免费链的实现位于 src/providers/translation/free-translation.ts 与 src/services/translation/freeFallback.ts请求在第一次 await 之前冻结一份配置快照且免费链只使用匿名公共服务不会带入独立 provider 已保存的 Key、代理或自定义请求头见prepareRequest单个服务请求的默认超时是5 秒DEFAULT_FREE_TRANSLATION_TIMEOUT_MS 5000整段文本的总预算默认20 秒FREE_TRANSLATION_TOTAL_TIMEOUT_MS 20000等待超时也会换服务批量翻译时最多3 路并发FREE_TRANSLATION_BATCH_CONCURRENCY微软服务自身并发上限为 2最小请求间隔为 100msMyMemory 与 DeepLX 为 1000ms其余为 300ms见candidatesFor。失败分类与恢复窗口src/services/translation/freeRoutingPolicy.ts 定义了五类失败rate-limit限流、quota额度、blocked访问受阻、unavailable不可用、request请求类错误并按类别给出基准恢复时间限流429 等默认暂停约5 分钟随后指数退避上限 6 小时访问受阻401/403/404/410 等默认暂停约6 小时上限 1 天每日额度耗尽402/456 等默认暂停约1 天服务明确给出retryAfter时遵循服务端时间恢复时间带有最多 20% 的随机抖动只延后恢复、不提前消费等待窗口连续失败次数按base * 2^exponent退避最长不超过 7 天MAX_FREE_COOLDOWN_MS。健康状态是有界持久化的暂停记录保存在本地重启后台后继续生效性能数据以指数移动平均维护可靠性按 0.75 衰减动态权重由baseWeight * reliability² * 延迟因子计算且一天内未使用会逐渐回到默认先验避免历史故障永久压低恢复后的服务。最后必须说明的边界免费服务的可用性与额度会变化不能保证始终连接成功。公共接口与第三方中转服务也有各自的数据政策。只希望使用其中一家时请只保留那一家或直接选择独立服务。另外有道网页翻译与金山词霸当前支持简体中文和英文方向Yandex 暂不支持繁体中文目标不支持的语言方向会交给其他候选处理也可以在设置中停用这些接口。使用 MyMemory选择MyMemory后即可点击检查连接联系邮箱可留空。检查使用固定的英文到中文短句不需要先修改源语言或目标语言已保存的语言和邮箱设置会保留。日常翻译仍使用你选择的语言自动识别无法确定短文本的源语言时请手动选择源语言后重试。源码中邮箱会经过格式校验normalizeMyMemoryEmail合法的邮箱同时参与免费链的连接身份哈希providerIdentity用于健康记录隔离。使用 DeepL 与 DeepLX选择DeepL API Free或API Pro填写对应套餐的密钥再检查连接。注意 DeepL 网页翻译器的订阅与 API 套餐不同不能直接互换。DeepLX是独立的免密钥方案适配器实现见 src/providers/translation/deeplx.ts配置要点服务地址需要填写完整翻译接口路径例如https://deeplx.example.com/translate只填域名不会自动补全/translate。留空时使用默认公共接口。无需验证的 DeepLX 接口可以留空 API Key并直接点击检查连接。需要验证时API Key 中只填站点提供的 Token 值不加Bearer前缀。默认通过请求头发送 Token如果站点要求在网址中携带 Token保留{{apiKey}}占位符原样填入地址发送时会自动替换为已填写的 API Key查询参数https://deeplx.example.com/translate?token{{apiKey}} 路径https://deeplx.example.com/{{apiKey}}/translate若地址使用占位符且没有可用的免 Key 地址需要先填写 Key不会悄悄转到默认公共接口。配置了代理地址时优先使用代理地址因此也要在那里填写完整路径和站点要求的 Token 格式。源码层面DeepLX 适配器会把AUTO、ZH、ZH-HANT等语言代码规范化后随请求体发送单次尝试超时 8 秒、总预算 20 秒并支持多端点按序故障转移只有所有备用站点都失败才会抛出聚合错误且语言/参数类错误不会熔断其他文本。这些设置仅用于单独的 DeepLX 服务免费翻译服务中的 DeepLX 使用默认公共匿名接口。使用云服务厂商云服务厂商分组收录的是各家云平台的官方机器翻译接口谷歌云翻译、Azure 翻译、阿里云机器翻译、腾讯云翻译、百度翻译和火山引擎翻译。它们与“机器翻译”分组里的免费网页端点如谷歌翻译、微软翻译互相独立免费端点无需密钥但可能限流云厂商接口需要你在控制台签发密钥换来稳定的服务和明确的免费额度。对应适配器位于 src/providers/translation 下的google-cloud-translation.ts、azure-translator.ts、aliyun-translation.ts、tencent.ts、baidu-translation.ts、volc-translation.ts。服务官方免费额度需要填写谷歌云翻译每月 50 万字符API KeyAzure 翻译F0 免费层每月 200 万字符密钥 区域阿里云机器翻译通用版每月 100 万字符AccessKey ID AccessKey Secret 地域腾讯云翻译每月 500 万字符SecretId SecretKey百度翻译标准版每月 5 万字符APP ID 密钥火山引擎翻译每月 200 万字符Access Key ID Secret Access Key 地域在设置页选中任一云厂商后服务详情会默认展开免费额度、三步开通指引以及控制台和接口文档或计费说明链接按指引拿到密钥后填入下方表单再点击检查连接。免费额度、开通条件和超额处理以厂商控制台与当前套餐为准。区域要和资源一致Azure、阿里云与火山引擎的区域会参与请求签名或决定请求域名。选错区域通常表现为 401/403 或签名不匹配请与控制台中资源所在区域保持一致。阿里云连接测试失败时请查看提示中的错误码InvalidAccessKeyId.InactiveAccessKey 已停用请在 RAM 控制台检查密钥状态确认可恢复后启用或改用另一组有效密钥SignatureDoesNotMatch签名校验失败请核对 AccessKey ID 和 Secret 是否来自同一组密钥InvalidTimeStamp.Expired需要校准设备时间10009检查 RAM 用户的机器翻译权限10010、10013检查服务是否开通和账号是否欠费。只有 HTTP 400 还不能确定原因反馈问题时提供错误码即可请勿发送密钥或完整请求。具体的接口要求可以核对官方文档阿里云通用翻译接口文档、百度通用文本翻译接入说明官方文档链接均列于各服务卡片中。隐私方面两段式密钥AccessKey Secret、SecretKey 等与 API Key 一样只保存在当前设备公开分享的配置和配置历史不包含它们完整备份会保留。本地模型翻译本地模型翻译把翻译计算放到当前设备适合隐私敏感或需要离线工作的场景。入口为设置 → 翻译服务 → 本地模型翻译选择模型并下载显示“可离线使用”后可以先在下方试译再从扩展菜单切换到这个服务无需密钥或另外启动本地服务器。模型下载大小适用范围中英轻量语言包约 239 MB中英双向的简单日常句子专业术语和复杂表达需要复核混元 Hy-MT2 1.8B约 1.13 GB中文、英语、日语等多种语言更适合复杂表达但需要更多内存日英轻量语言包约 214 MB主要用于日译英阅读英译日质量有限建议改用混元模型目录在 src/core/config/localTranslation.ts 中登记中英、日英轻量包基于 OPUS-MTHugging Face 上 Xenova 的 ONNX 权重混元则使用tencent/Hy-MT2-1.8B-GGUF量化q8另有 M2M100 418M 与 NLLB-200 Distilled 600M 作为legacy旧模型保留项其下载大小与内存区间如中英包 500–2000MB、混元 1500–2500MB同样记录在该配置中。下载过程中的实用细节下载过程中可以暂停切换设置页不会中断下载重启浏览器后点击“继续”或“重试”会使用已经保存的进度文件校验完成前还不能翻译接近 100% 时请留意状态不要只看百分比点击删除图标后需要再次确认只删除所选模型不影响其他模型或翻译设置模型文件保存在当前浏览器中不包含在设置备份里。资源占用需要理性评估下载大小不等于运行内存。轻量语言包也可能短暂占用约 1–2 GB 额外内存载入时 CPU 会升高模型连续空闲 30 秒后释放。较长文本、浏览器与显卡都会影响实际资源占用。浏览器不兼容混元时页面会提示更新浏览器或选择轻量包。本功能需要支持扩展内本地运行的浏览器油猴版不提供模型下载与运行不要把本地混元与需要账户和密钥的混元云端服务混淆。具体模型来源与许可可从卡片的信息入口查看。使用 AI 服务AI 服务适合解释长句、语气或专业表达。新配置优先使用适合日常翻译的轻量模型服务默认模型DeepSeekdeepseek-flashV4.1 FlashOpenAIgpt-5.4-miniGeminigemini-3.5-flash-lite通义千问qwen3.8-flashClaudeclaude-haiku-4-5阶跃星辰step-2-miniOpenRoutergoogle/gemini-3.5-flash-lite除上表外聚合平台与接口分组还收录了 Mistral AI、Cohere、Cerebras、Together AI、Fireworks AI、DeepInfra 与 Perplexity 等 OpenAI 兼容平台配置方式与其他 AI 服务相同填写平台密钥并选择模型。更新模型列表不会覆盖你已保存的有效模型或自定义模型。DeepSeek 默认关闭思考部分模型无法完全关闭思考时使用其支持的最低档。更大的模型仍可手动选择实际费用以服务商为准。已下线的混元hy3-preview会更新为hy3。选择已配置的服务和模型常用列表里没有你的模型时可以使用自定义模型模型名称从服务商提供的信息中复制。第三方提供兼容接口时可在自定义服务中添加地址和模型。使用 Azure 时模型一栏填写实际的部署名称地址填写自己的资源地址或服务商给出的完整接口地址。自定义服务的 Base URL自定义服务使用OpenAI Chat Completions协议可填写完整接口地址也可以填写以/v1等版本路径结尾的 Base URLhttps://opencode.ai/zen/v1会请求https://opencode.ai/zen/v1/chat/completions仅填写域名和端口时会补上/v1/chat/completions其他非标准路径按完整接口使用高级设置中的代理地址仍优先于服务地址并按填写的完整接口请求不自动补全查询参数会保留。以 OpenCode Zen 与 Go 为例两者的 Base URL 分别为https://opencode.ai/zen/v1和https://opencode.ai/zen/go/v1需从官方模型表中选择支持/chat/completions的模型并填写 API 的模型 ID而非 OpenCode 配置中的opencode/或opencode-go/前缀。仅提供/responses、/messages或 Gemini 原生接口的模型不能直接用于此自定义服务。如果检查连接提示 HTTP 404 并返回 HTML 网页请核对接口地址和模型协议——这类返回不能证明 API Key 无效。JSON 格式的模型错误会继续显示服务商的具体说明。请勿在反馈中公开 API Key。自定义请求头在服务列表中选择自定义 OpenAI 兼容服务展开高级设置 → 自定义请求 → 自定义请求头按服务商要求填写 JSON例如{x-opencode-session: a71a2ad6-1d1f-4e92-a30e-e35c8fd623ab}规则要点名称和值都必须是字符串请求头只用于这项自定义服务同名头会覆盖默认值名称不区分大小写留空恢复默认行为需要稳定会话标识时保存同一个值即可每次请求不会重新生成可用于额外鉴权、HTTP-Referer、X-Title等参数使用自定义鉴权且无需默认 Bearer Token 时可关闭该模型的 API Key 要求浏览器限制的请求头仍受浏览器规则约束请求头按凭据保存公开分享配置与配置历史不包含它完整备份会保留它更换接口或代理地址后需重新填写。腾讯混元连接失败选择腾讯混元时填写混元控制台创建的 API Key默认使用官方混元接口注意腾讯混元翻译是另一项服务需要 SecretId 和 SecretKey。旧版遇到Failed to fetch时可以在请求设置 → 代理地址填入https://api.hunyuan.cloud.tencent.com/v1/chat/completions再点击检查连接使用自建代理或 TokenHub 时请填写对应平台提供的完整接口地址和配套密钥。接口与密钥申请方式见腾讯官方的第三方软件集成混元指南链接位于服务卡片中。Gemini 代理地址Gemini 代理需要完整请求地址也支持模板形式https://myproxy.example/v1beta/models/{model}:generateContent?key{key}{model}使用本次请求的模型{key}使用 Gemini 设置中保存的密钥两者会经过 URL 编码。已有的完整地址可以继续使用只填写域名或/v1beta/models不会自动补全请求路径。包含{key}的地址会收到保存的密钥导入配置或更换代理地址会保留该密钥请确认代理可信。没有{key}的代理地址不会自动附加密钥留空代理地址时使用官方接口通过请求头发送密钥。AI 精翻与多段翻译AI 精翻允许翻译参考网页标题和部分正文帮助理解术语与指代。会发送更多上下文可能增加用量和等待时间。AI 多段翻译把相邻短段一起交给 AI可能减少请求次数。结果异常时仍可能重试。两项默认关闭可分别开启。改变设置后对已有译文先恢复原文再重新翻译。专业词需要保持一致时可以配合术语库。使用本地模型OllamaOllama 需要先在电脑上安装、启动并下载模型再将本地服务接入 FluentRead。翻译速度取决于模型和电脑性能。在聚合平台与接口中选择Ollama本地默认连接http://127.0.0.1:11434无需 API Key模型列表可直接填写本机已下载的模型名如qwen3:8bOllama 运行在另一台电脑或非默认端口时在服务地址填写完整的/v1/chat/completions地址浏览器扩展访问 Ollama 需要允许来源启动时设置OLLAMA_ORIGINS*否则请求会被跨域拒绝。选择本地模型只决定对应翻译请求的去向。朗读、查词和其他独立功能可能仍使用网络服务详见数据与隐私。连接失败排查连接失败时按以下顺序排查先检查密钥、地址、模型和账号额度能翻译短句却无法处理长文章时可以减少同时请求或换一个服务不要把真实密钥放进截图或反馈中。更多排查见常见问题。附翻译服务的源码地图如果希望深入理解 FluentRead 的翻译引擎编排可以沿着下面的路径阅读src/providers/translation/registry.ts所有翻译服务标识到 provider 函数的映射是 background 路由和连接测试查找适配器的唯一目录src/providers/translation/free-translation.ts免费翻译链的装配、配置快照冻结与批量并发调度src/services/translation/freeFallback.ts加权均衡、自动回退、错误退避、恢复单探测与健康持久化src/services/translation/freeRoutingPolicy.ts失败分类、冷却时长与动态权重策略src/core/config/freeTranslation.ts免密钥服务池、默认顺序与请求预算的合法范围src/core/config/localTranslation.ts本地模型目录、下载状态契约与语言码映射src/providers/translation/deeplx.tsDeepLX 适配器与多端点故障转移。对应功能的行为契约还可以在 tests 目录下找到覆盖例如freeFallback.test.ts、freeRoutingPolicy.test.ts、freeTranslationConfig.test.ts、cloudVendorProviders.test.ts、localTranslation.test.ts等测试文件可用于验证本文所述的轮换、退避与额度处理逻辑。赞分享前端AI 应用本地部署【免费下载链接】FluentReadAn open-source browser extension for bilingual translation. 一款开源的浏览器双语翻译插件。项目地址https://gitcode.com/gh_mirrors/fl/FluentRead点击查看免费下载相关推荐FluentRead 翻译服务接入实战从免费接口、云厂商到本地模型与 AI 服务的完整配置指南FluentRead 翻译服务接入实战从免费接口、云厂商到本地模型与 AI 服务的完整配置指南 本文是 FluentRead开源浏览器双语翻译插件翻译服务前端AI 应用本地部署免密钥翻译接口与自动降级FluentRead 的免费翻译服务池深度解析免密钥翻译接口与自动降级FluentRead 的免费翻译服务池深度解析 导读 本文以 FluentRead 仓库中的 免密钥翻译接口与自动降级 https:前端AI 应用本地部署FluentRead 翻译引擎完全指南免费降级链、云端服务与多 Key 轮询配置FluentRead 翻译引擎完全指南免费降级链、云端服务与多 Key 轮询配置 FluentRead 是一款开源的浏览器双语翻译插件其翻译服务层采用多引前端AI 应用本地部署创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考