前端AI 应用本地部署【免费下载链接】FluentReadAn open-source browser extension for bilingual translation. 一款开源的浏览器双语翻译插件。项目地址https://gitcode.com/gh_mirrors/fl/FluentRead点击查看免费下载本文是 FluentRead开源浏览器双语翻译插件翻译服务配置的技术指南围绕 docs/en/config/translation-engines.md 展开。读完本文你将掌握如何从服务目录中选择并配置机器翻译、云厂商、AI 服务与本地模型理解多 API Key 轮换、免费翻译自动均衡、DeepLX 端点模板、本地模型资源占用等底层机制并能独立完成「配置 → 检查连接 → 设为默认服务」的完整接入流程。先弄清一个关键概念配置服务 ≠ 切换默认服务FluentRead 的翻译服务目录按分类排列并支持搜索。点击某个服务条目只会打开它的配置页不会立刻改变网页翻译所用的服务真正决定网页翻译去向的是「常规设置」或扩展菜单中的默认服务选择。文档translation-engines.md对此有专门提示文档、字幕和翻译卡片还有各自独立的服务选择配置时不要混淆。服务详情中的高级设置默认折叠展开后按四个分组组织Keys and authentication密钥与认证管理多 Key 轮换Translation preferences翻译偏好调整模型思考与提示词Request settings请求设置调整等待时间与请求频率、代理地址Custom requests自定义请求补充自定义请求头与 JSON 参数。云服务在详情中会默认展示免费额度、开通步骤以及控制台/接口文档链接免费额度是否可用、超额如何处理取决于服务商与当前套餐。五步完成一次服务接入文档给出的标准流程如下进入「设置 → 翻译服务」在目录中选中要配置的服务按服务商提供的信息填写密钥与地址AI 服务还需选择模型。即使 API Key 留空也可以先点检查连接——需要凭据的服务会在检查结果中提示缺少凭据或认证失败源码 connectionTest.ts 即负责这类探测点击服务详情标题栏右侧的检查连接确认能返回译文。检查会发送一条短请求可能产生少量用量回到常规设置或扩展菜单将该项选为默认服务翻译一句话验证效果。内置服务无需额外添加即可配置已有配置与自定义接口会保留。需要接入不在目录中的 OpenAI 兼容接口时点击目录顶部的自定义服务。免费翻译服务零密钥起步与自动均衡免费翻译服务通过多个免密钥端点生成译文是「安装后直接翻译」的默认路径。参与服务的端点默认启用且无需密钥的有Microsoft、腾讯交互翻译Tencent TranSmart、火山翻译、Google、有道网页翻译、金山词霸ICIBA、Yandex、DeepLX、MyMemory可选启用 Sogou、Reverso、Lingva三者仍为实验候选以及 Apertium暂无中文语言对。这一目录与源码 freeTranslation.ts 中的FREE_TRANSLATION_PROVIDERS定义一一对应其中 MyMemory 与 Apertium 标记为官方接口official: true其余为网页接口official: false默认权重各不相同微软 5、腾讯交互/火山/谷歌/有道/金山词霸 3、Yandex 2、DeepLX/MyMemory 1。自动均衡与优先顺序两种模式默认模式为自动均衡balanced微软排在首位并优先尝试。后台调度器依据成功率、响应耗时与近期错误动态分配请求某一路失败时自动切换。调度所需信号全部由后台自动维护可见 freeRoutingPolicy.ts 中observeFreeProviderPerformance用指数移动平均维护可靠性reliability与延迟latencyMs并随时间衰减旧观测避免一次历史故障永久压低服务用户只需配置启用状态与模式。你可以停用某些端点或切换为**优先顺序sequential**模式按列表顺序依次尝试至少要保留一个启用项。限流与恢复节奏免费端点的暂停策略在 freeRoutingPolicy.ts 的getFreeFailureCooldown中可查到精确实现额度耗尽quota暂停约 1 天访问受阻blocked从 6 小时起退避、上限 1 天限流rate-limit从 5 分钟起退避、上限 6 小时如果服务端给出了retryAfter等待时间则优先遵循。恢复记录保存在本地后台重启后继续生效。每路默认最多等待 5 秒DEFAULT_FREE_TRANSLATION_TIMEOUT_MS 5_000超时即换路。免费服务可用性与额度会变化公共接口和第三方中转有各自的数据政策。若只希望请求流向某一家就只保留那一个端点或直接选用对应的独立服务。MyMemory匿名翻译的官方选项选择MyMemory后可直接点击检查连接联系邮箱可留空。连接检查会翻译一句固定的英文到中文短句因此不需要先修改源语言或目标语言已保存的语言与邮箱设置会保留。源码 freeTranslation.ts 标注 MyMemory 为官方 API匿名每天约 5,000 字符额度。日常翻译仍使用你选择的语言自动检测无法确定短文本的源语言时请手动选择源语言后重试。DeepL 与 DeepLX从官方 API 到自建端点DeepL选择 API Free 或 API Pro 套餐填入对应密钥即可。注意 DeepL 网页翻译器的订阅与 API 套餐是不同产品不能直接互换。DeepLX的配置重点是端点地址服务地址需填写完整翻译接口路径例如https://deeplx.example.com/translate只填域名不会自动补全/translate留空则使用默认公共匿名端点源码 deeplx.ts 中默认端点由DEFAULT_DEEPLX_ENDPOINT决定且自由服务内的 DeepLX 也固定使用公共匿名端点用户单独配置的地址不会带入免费链无需鉴权的端点可以留空 API Key 直接检查连接需要鉴权时API Key 只填站点提供的Token 值本身不加Bearer前缀——请求默认通过请求头发送 Token若站点要求在 URL 中携带 Token使用{{apiKey}}占位符模板查询参数https://deeplx.example.com/translate?token{{apiKey}} URL 路径https://deeplx.example.com/{{apiKey}}/translate保留{{apiKey}}原样发送时会被替换为已保存的 API Key。若配置了代理地址代理优先也需要在其中填写完整路径和站点要求的 Token 格式。配置了多个端点时留空的 Key 会跳过含{{apiKey}}/{{token}}的地址只用有效的匿名地址如果所有地址都需要 Token需先填写 Key——未解析的占位地址不会悄悄回落到默认公共端点。从源码看DeepLX 适配器deeplx.ts会把语言码规范化为 DeepL 协议格式auto → AUTO、zh-hans/zh-cn → ZH、zh-hant → ZH-HANT对每个候选端点设置 8 秒单次超时、20 秒总预算并在端点间做有序故障转移HTTP 4xx/5xx 状态会被保留供外层免费链判断是否熔断。云服务厂商稳定免费额度与区域一致性云服务厂商分组收录六大云平台的官方机器翻译 API与「机器翻译」分组里的免费网页端点相互独立免费端点无需密钥但可能限流云厂商接口需要控制台签发密钥换来稳定服务和明确的免费额度。服务官方免费额度需要填写Google Cloud Translation每月 500,000 字符API KeyAzure TranslatorF0 免费层每月 2,000,000 字符Key regionAlibaba Cloud Machine Translation通用版每月 1,000,000 字符AccessKey ID AccessKey Secret regionTencent Cloud Translate每月 5,000,000 字符SecretId SecretKeyBaidu Translate标准版每月 50,000 字符APP ID 密钥Volcengine Translation每月 2,000,000 字符Access Key ID Secret Access Key region在设置页选中任一云厂商后服务详情默认展开免费额度、三步开通指引以及控制台/接口文档链接按指引拿到密钥填入表单点击检查连接即可。免费额度、开通条件与超额处理以厂商控制台与当前套餐为准。区域一致性是关键Azure、阿里云与火山引擎的区域会参与请求签名或决定请求域名源码 aliyun-translation.ts、azure-translator.ts、volc-translation.ts 各自的签名实现均依赖区域参数。选错区域通常表现为 401/403 或签名不匹配请保持与控制台中资源所在区域一致。两段式密钥AccessKey Secret、SecretKey 等与 API Key 一样只保存在当前设备公开分享的配置与配置历史不包含它们完整备份才会保留。本地模型翻译完全离线的浏览器内翻译在「设置 → 翻译服务 → 本地模型翻译」选择模型并下载显示可离线使用后即可试译并切换为默认服务。整个过程无需 API Key也不需要单独启动本地服务器翻译文字始终在当前设备处理。模型下载大小适用范围Chinese / English 轻量语言包约 239 MB中英双向简单日常句子专业术语与复杂表达需复核Hunyuan Hy-MT2 1.8B约 1.13 GB中文、英语、日语等多种语言更适合复杂表达内存要求更高Japanese / English 轻量语言包约 214 MB主要用于日译英阅读英译日质量有限建议改用混元模型目录在源码 localTranslation.ts 中定义与文档一一对应中英/日英语言包基于 OPUS-MTXenova/opus-mt-en-zh、opus-mt-zh-en、opus-mt-ja-en等引擎为opusHy-MT2 1.8B 来自tencent/Hy-MT2-1.8B-GGUF引擎为hunyuan其语言范围在HUNYUAN_LANGUAGE_NAMESlocalTranslation.ts中覆盖中文、英文、日文、韩文、泰文、阿拉伯文等 30 余种。模型下载为 q8 量化格式LOCAL_TRANSLATION_DTYPE q8文件来自 Hugging Face校验完成前不可用——接近 100% 时请留意状态不要只看百分比。关于下载与运行文档明确了几个重要事实下载中可暂停切换设置页不中断重启浏览器后可继续已保存的进度删除模型需二次确认只影响所选模型模型文件属于当前浏览器不包含在设置备份中下载大小不等于运行内存轻量语言包也可能短暂占用约 1–2 GB 额外内存载入时 CPU 升高源码memoryMb: [500, 2000]与混元的[1500, 2500]印证了这一区间模型空闲 30 秒后释放该功能需要支持扩展内本地运行的浏览器油猴版userscript不提供模型下载与运行不兼容混元时页面会提示更换浏览器或选择轻量包本地混元与需要账户密钥的混元云端服务是两回事模型来源与许可可从卡片信息入口查看。本地翻译的实现路径在 local-translation.ts请求经 provider 层转换后交给 Offscreen WorkerlocalTranslationOffscreenAdapter推理全程不上传云端不支持的语言或未下载模型会映射为对应的本地化错误文案。AI 服务轻量模型默认与自定义端点新配置默认使用适合日常翻译的轻量模型服务默认模型DeepSeekdeepseek-flashV4.1 FlashOpenAIgpt-5.4-miniGeminigemini-3.5-flash-liteQwenqwen3.8-flashClaudeclaude-haiku-4-5StepFunstep-2-miniOpenRoutergoogle/gemini-3.5-flash-lite聚合平台与接口分组还收录了 Mistral AI、Cohere、Cerebras、Together AI、Fireworks AI、DeepInfra、Perplexity 等 OpenAI 兼容平台配置方式与普通 AI 服务相同填平台密钥、选模型。目录更新不会覆盖已保存的有效模型或自定义模型。DeepSeek 默认关闭思考模型思考开关实现见 modelThinking.ts无法完全关闭思考的模型使用其支持的最低档。更大的模型仍可手动选择费用以服务商为准。DeepSeek 新编号见其官方更新记录旧的deepseek-v4-flash仍是兼容别名已下线的混元hy3-preview会自动迁移为hy3。使用 Azure 时模型栏填写实际的部署名称地址栏填写资源地址或服务商给出的完整接口地址。自定义服务的 Base URL 规则自定义服务使用OpenAI Chat Completions协议可填完整端点或 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-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源码 hunyuan-translation.ts。旧版本若报Failed to fetch可在「请求设置 → 代理地址」填入https://api.hunyuan.cloud.tencent.com/v1/chat/completions后重新检查连接自建代理或 TokenHub 则使用对应平台提供的完整端点与密钥。AI 精翻与多段翻译AI 精翻允许翻译参考网页标题与部分正文帮助理解术语与指代会发送更多上下文可能增加用量与等待时间AI 多段翻译把相邻短段一起交给 AI可能减少请求次数结果异常时仍可能重试。两者默认关闭、可独立开启。改变设置后对已有译文先恢复原文再重新翻译需要术语一致时可配合术语库。Ollama 与本地聚合平台Ollama 需先安装、启动并下载模型再接入 FluentRead。在聚合平台与接口中选择Ollama本地默认连接http://127.0.0.1:11434无需 API Key模型栏填写本机已拉取的模型名如qwen3:8bOllama 运行在其他机器或非默认端口时在服务地址填写完整的/v1/chat/completions地址浏览器扩展访问 Ollama 需允许来源启动时设置OLLAMA_ORIGINS*否则请求会被 CORS 拒绝。该分组的 Mistral AI、Cohere、Cerebras、Together AI、Fireworks AI、DeepInfra、Perplexity 按普通 AI 服务方式配置。选择本地模型只决定对应翻译请求的去向朗读、查词、下载等独立功能仍可能使用网络服务详见数据与隐私。多 API Key 轮换与批量检查支持 API Key 的服务可在「高级设置 → 密钥与认证」中启用 Key 轮换点击列表底部「添加 Key」每行填写一个无需分隔符原来保存的单个 Key 继续保留。所有 Key 共用该服务的地址、模型、区域与自定义请求头——这些设置不同时请分别创建自定义服务。轮换机制在 apiKeyRotation.ts 中实现开始时各 Key 均衡分担请求实际按轮询租约挑选请求失败自动尝试其他 Key 并降低失败 Key 的使用频率鉴权失败或额度用尽的 Key 可能暂停。失败 Key 的默认恢复等待为 1 分钟可在「设置 → 高级 → 请求限制」调整为 1–60 分钟服务端给出明确限流等待时间时遵循该时间。轮换不绕过已配置的请求频率与总超时限制。健康状态是临时状态扩展后台进程重启后重置。「检查全部」按顺序测试每个已填写且不重复的 Key结果与汇总同区显示点开失败状态可查看原因或用行末按钮单独重测检查期间可停止。一个 Key 失败不会中断其余检查空白行与重复 Key 不额外发请求。检查会发送短测试文本可能消耗少量服务额度通过只代表这次检查不保证后续始终可用。值得注意的实现细节redactApiKeyError会把错误信息中的明文密钥替换为[已隐藏的密钥]确保密钥不会泄漏进运行时错误或日志。连接失败排查先核对密钥、地址、模型与账号额度能翻译短句却无法处理长文章时减少同时请求数或更换服务有道网页翻译与金山词霸目前支持简体中文和英文方向Yandex 暂不支持繁体中文目标不支持的语言方向会交给其他候选处理免费网页接口可能限流或失效可在设置中停用不要把真实密钥放进截图或反馈中。更完整的排查流程见常见问题。小结FluentRead 的翻译服务体系覆盖了从「零密钥即用」到「完全离线」的全部路径免费翻译靠多端点自动均衡与本地健康记录保证可用性云厂商接口以区域签名换取稳定免费额度本地模型在浏览器内完成推理AI 服务与 OpenAI 兼容自定义端点则提供模型级灵活性。多 Key 轮换、请求头、代理与请求限制共同构成了可精细调校的连接层。无论选择哪条路径核心流程始终一致配置服务 → 检查连接 → 从常规设置或扩展菜单设为默认。赞分享前端AI 应用本地部署【免费下载链接】FluentReadAn open-source browser extension for bilingual translation. 一款开源的浏览器双语翻译插件。项目地址https://gitcode.com/gh_mirrors/fl/FluentRead点击查看免费下载相关推荐LunaTranslatorGalgame 实时翻译5 分钟跑通LunaTranslatorGalgame 实时翻译5 分钟跑通 打开一款日文 VN对话框里的字你根本看不懂。开源的 LunaTranslator 实时翻桌面应用OCR人工智能Easydict 服务总览词典、AI 模型与通用翻译服务的接入与配置指南Easydict 服务总览词典、AI 模型与通用翻译服务的接入与配置指南 Easydict 是一款开源的 macOS 词典翻译应用其核心能力在于将词典查询桌面应用AI 应用免密钥翻译接口与自动降级FluentRead 的免费翻译服务池深度解析免密钥翻译接口与自动降级FluentRead 的免费翻译服务池深度解析 导读 本文以 FluentRead 仓库中的 免密钥翻译接口与自动降级 https:前端AI 应用本地部署创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
