前端AI 应用本地部署【免费下载链接】FluentReadAn open-source browser extension for bilingual translation. 一款开源的浏览器双语翻译插件。项目地址https://gitcode.com/gh_mirrors/fl/FluentRead点击查看免费下载本篇技术指南聚焦 FluentRead 浏览器扩展的免费翻译自动均衡能力完整讲解其免密钥服务池构成、微软优先的动态加权分配策略、后台健康状态驱动的冷却与恢复机制以及新增的有道网页翻译、金山词霸、搜狗、Reverso、Lingva、Apertium 六类匿名网页适配器的实现细节。读者读完后将掌握该功能的配置参数、底层调度链路与验证方法并可直接对照仓库源码验证每一项设计决策。一、功能定位与核心设计原则FluentRead 的免费翻译模块面向不配置任何 API Key 也能完成机器翻译的场景。根据 docs/reports/free-balanced-translation-20260912/README.md 的核对说明核对日期 2026-09-12该模块采用默认微软优先、随后按后台维护的近期成功率和响应耗时动态加权分配的策略其设计边界可概括为三点用户只控制策略不控制权重用户只能选择模式自动均衡 / 优先顺序、启停服务、以及在顺序模式下调整优先级不能直接编辑各服务的分配权重——权重完全由后台根据真实请求表现动态计算免费池与独立服务严格隔离免费池不继承独立服务如有道智云、腾讯云、DeepL 等已保存的 Key、Secret、请求头、代理和私有端点保证匿名性与零配置全部走免密钥公共接口13 个候选服务均为匿名网页接口或官方匿名 API其中 MyMemory 是官方 API匿名每天 5,000 字符额度其余多为网页接口的协议适配。二、服务池构成13 个候选、默认启用 9 个服务池的权威定义位于 src/core/config/freeTranslation.ts 的FREE_TRANSLATION_PROVIDERS常量。本轮核对新增了有道网页翻译、金山词霸、搜狗、Reverso、Lingva、Apertium 六个候选使总数达到13 个其中默认启用 9 个服务 ID名称类型说明默认权重默认启用microsoft微软翻译Edge 网页接口非官方公开 API5✅transmart腾讯交互翻译免密钥网页接口与腾讯云翻译不同3✅volcengineFree火山翻译免密钥网页接口无需火山云账号3✅google谷歌翻译网页接口非官方公开 API3✅youdaoFree有道网页翻译免密钥普通文本翻译与有道智云不同3✅icibaFree金山词霸免密钥网页翻译自动处理网页签名3✅yandexFreeYandex免密钥网页接口暂不支持繁体目标语言2✅deeplxDeepLX非官方公共接口无需密钥1✅myMemoryMyMemory官方 API匿名每天 5,000 字符1✅sogouFree搜狗翻译实验性网页接口自动处理临时签名2❌reversoFreeReverso实验性网页接口可能触发访问验证1❌lingvaFreeLingva实验性公共实例使用谷歌翻译上游1❌apertiumFreeApertium开放翻译服务仅支持已提供的语言对暂无中译1❌默认启用的 9 个服务由DEFAULT_FREE_TRANSLATION_ORDERsrc/core/config/freeTranslation.ts定义顺序即优先级微软翻译 → 腾讯交互翻译 → 火山翻译 → 谷歌翻译 → 有道网页翻译 → 金山词霸 → Yandex → DeepLX → MyMemory。搜狗、Reverso、Lingva 以及不支持中文方向的 Apertium 默认关闭在设置页中归入实验候选折叠区见 src/features/settings/ui/services/FreeTranslationSettings.vue。一个容易混淆的细节youdaoFree/icibaFree与独立服务中的有道智云、金山词霸不是一回事——前者是免密钥的网页接口适配后者需要用户自行配置应用凭据。免费池在装配时显式清空凭据见下文源码说明。三、两种选择模式自动均衡与优先顺序用户在设置页只能二选一FreeTranslationSettings.vue自动均衡balanced从下方启用的免费接口中自动分配请求失败时切换。设置页会实时展示每个服务当前的百分比权重与健康状态后台按权重分配尝试机会优先顺序sequential依次调用启用的免费接口用户可使用上移/下移按钮调整服务优先级接口间按顺序逐个尝试首个失败即切换下一个。两种模式由FreeTranslationMode类型定义默认值为balancedsrc/core/config/freeTranslation.ts。无论哪种模式用户都不能编辑权重数值设置页中权重以只读的百分比形式展示output元素且通过FREE_TRANSLATION_WEIGHT_REFRESH_INTERVAL_MS 5 * 60_000每 5 分钟从后台刷新一次src/services/translation/freeWeights.ts。3.1 权重快照的展示语义后台通过getFreeTranslationWeightSnapshotsrc/providers/translation/free-translation.ts向设置页提供权重快照每个服务携带status字段取值包括ready健康可服务cooling处于冷却期retryAt在将来本轮不参与分配recovering曾失败、正在通过成功探测恢复disabled用户未启用。快照计算src/services/translation/freeWeights.ts使用最大余数法把精确权重四舍五入为一位小数并保证总和恰为 100%避免界面出现 99.9% 或 100.1% 的尴尬数字全部服务都在冷却时total为 0。该快照只含服务 ID 与健康信息不含连接身份哈希且后台 handler 仅允许 options 页面访问src/app/background/handlers/freeTranslationWeights.ts。四、动态加权与故障处理的底层原理这是本模块技术含量最高的部分全部实现集中在 src/services/translation/freeRoutingPolicy.ts 与 src/services/translation/freeFallback.ts。4.1 性能观测指数移动平均每次请求成功后后台会更新该服务的指数移动平均EMA性能记录observeFreeProviderPerformance可靠性newReliability old * 0.75 (success ? 0.25 : 0)耗时newLatencyMs old * 0.75 min(60000, max(1, latency)) * 0.25。观测数据不包含待译内容只记录成功率与延迟src/services/translation/freeRoutingPolicy.ts。4.2 动态权重公式getDynamicFreeProviderWeightfreeRoutingPolicy.ts把基础权重、可靠性和延迟合成为一个动态权重weight baseWeight * reliability² * min(1, 1000 / max(1, latencyMs))其中老观测在一天内逐渐回归默认先验age min(1, max(0, now - observedAt) / 86400000)避免一次历史故障永久压低恢复后的服务。实际请求调度中freeFallback会对每个候选应用该公式后再做加权随机选择freeFallback.ts。4.3 错误分类与分级冷却classifyFreeFailure把错误归类为五类rate-limit限流429、quota额度402/456、blocked访问拦截401/403/404/410、unavailable服务不可用5xx/408、request一般请求错误其他 4xx。冷却时长按类别分级并带指数退避与 20% 抖动freeRoutingPolicy.ts额度类基础 1 天上限 1 天日额度通常隔天恢复拦截类基础 6 小时上限 1 天限流类基础 5 分钟上限 6 小时瞬时故障基础 1 秒上限 30 分钟。Retry-After 优先若服务端返回了retryAfterMs冷却时长直接采用服务端规定的恢复时间不提前消费服务端等待窗口。request类错误返回 0 冷却但调度层仍会给一个至少 1 秒的短暂冷却避免同一服务在下一段文本中持续消耗尝试机会freeFallback.ts。4.4 恢复探测与并发约束处于冷却中的服务会在冷却结束后以**单探测probing**方式重新参与选择state.probing true保证同一时间只有一个恢复探测在飞成功后清空failures并重建平滑观测。调度同时遵守三类硬约束并发上限微软为 2其余服务为 1最小间隔微软 100 msMyMemory 与 DeepLX 1000 ms其余 300 ms总预算默认单次请求总预算 20 秒FREE_TRANSLATION_TOTAL_TIMEOUT_MS排队与各备用服务共同消费同一截止时间deadline。这些约束定义在 free-translation.ts 的candidatesFor中调度执行在 freeFallback.ts。4.5 冷却持久化与取消保护健康状态服务身份摘要、错误类别、冷却时间、EMA 性能通过freeTranslationHealthStorage持久化到local:freeTranslationHealth:v1键src/platform/storage/freeTranslationHealthStorage.ts保证后台重启后继续遵守恢复时间。写入按变更顺序串行、挂起时只保留最新快照存储故障或挂起不会阻断翻译boundedStorage1000 ms 上限批次翻译用独立的AbortController转发调用方取消迟到响应不会覆盖已开始服务的健康状态free-translation.ts。五、请求装配匿名身份与凭据隔离免费翻译的请求装配在 src/providers/translation/free-translation.ts 完成两个设计值得展开凭据冻结prepareRequest在第一次 await 前冻结请求配置快照并显式把token、secret、customHeaders、proxy、requireApiKey全部置空同时清空有道/腾讯的 AppKey、AppSecret并把 DeepLX 端点重置为公共默认端点——这就是免费池不继承独立服务凭据的代码落地匿名连接身份providerIdentity对服务 ID 与公共端点做 sha256 哈希生成连接身份microsoft:xxx、myMemory:yyy冷却与健康状态按该身份记录。已保存的 Key、代理和私有 DeepLX 地址均不能改变免费链的连接或冷却身份MyMemory 的可选邮箱会纳入哈希邮箱变更即视为新的匿名身份。批量翻译按FREE_TRANSLATION_BATCH_CONCURRENCY 3并发执行任何一个文本失败都会以取消信号中止整批free-translation.ts。六、新增网页适配器有道的 GET 改造与词霸的 AES 解密本轮新增的 6 个候选分为两组适配器中文网页组有道、金山词霸与实验组搜狗、Reverso、Lingva、Apertium。6.1 有道网页翻译youdaoFree实现在 src/providers/translation/free-chinese-web.ts。报告明确记载有道 POST 请求在扩展环境曾返回 403而同一公开端点原生支持 GET最终适配器改用 GET、不携带 Cookie、不伪造 Origin并经真实生产扩展实测确认。请求签名基于 MD5先对q keyfrom求摘要再对client q 时间戳 secret 摘要求最终签名时间戳带有基于查询长度的微调偏移。方向仅支持中英互译自动语言时按简体中文脚本Hans判定繁体中文方向直接以request类错误拒绝free-chinese-web.ts。6.2 金山词霸icibaFree词霸接口返回的是AES-ECB 加密的响应内容适配器使用固定的aahc3TfyfCEmER33响应密钥解密后再取out字段请求签名同样经 MD5 摘要 AES-ECB 加密6key_web_new_fanyi6dVjYLFyzfkFkk前缀拼接查询后取前 16 位再加密。业务错误码err_no会映射为对应的免费失败类别429→限流、403→拦截、402→额度解密失败统一按unavailable处理free-chinese-web.ts。6.3 实验组四兄弟实现在 src/providers/translation/free-extra-web.ts搜狗sogouFree先 GET 首页抓取secretCode匿名参数再对源语言 目标语言 文本 secret做 MD5 生成请求签名POST 到translate.sogou.com/api/transpc/text/result以status 0为业务成功ReversoreversoFreePOSTapi.reverso.net/translate/v1/translation携带x-reverso-origin: translation.web头语言代码映射为 ISO 639-2如en→eng、zh-hans→chi不接受繁体中文方向LingvalingvaFree走 REST 风格GET {instance}/api/v1/{from}/{to}/{text}默认公共实例为lingva.ml结果校验translation字段ApertiumapertiumFree先调用/apy/listPairs动态核对语言对无中文方向再按langpair源|目标调用/apy/translate。所有适配器共享统一的健壮性设施按\r\n/\n拆分保留换行、按 1000 码点分块翻译、保留文本槽glossary 槽协议与边缘空白、响应取消checkAbort并通过serializeTranslationSlots恢复槽位free-extra-web.ts。七、设置页操作与参数说明免费翻译的设置入口位于扩展的翻译服务 → 免费翻译服务页组件src/features/settings/ui/services/FreeTranslationSettings.vue。可操作项与取值范围如下配置项说明取值范围 / 默认值选择模式freeTranslationModebalanced默认/sequential服务启停freeTranslationOrder中是否包含该 ID至少保留 1 个toggleDisabled防止关掉最后一个顺序调整仅顺序模式下可用上移/下移按钮按列表顺序逐个尝试每个服务最多等待freeTranslationTimeoutMs高级设置1–15 秒默认 5 秒配置归一化在 freeTranslation.tsMyMemory 联系邮箱myMemoryEmail可选合法邮箱或留空提供后可提升额度会随请求发送给 MyMemory冷却恢复时间的直观说明在高级设置中给出网络问题通常几分钟后重试限流按服务提示恢复拦截可能需要几小时日额度通常隔天恢复与freeRoutingPolicy的分级冷却完全对应。权重展示区在全部服务冷却时会显示不可用提示每 5 分钟自动刷新也会在模式或启停变化时即时刷新FreeTranslationSettings.vue。八、确定性验证120 项测试、四维度 100% 覆盖报告的验证体系分为两层。第一层是纯确定性验证全量 Vitest307 个文件、6,153 项测试全部通过本轮新增的策略、存储、两组网页适配器以及重构后的免费路由和 HTTP 错误模块120 项相关测试通过statements、branches、functions、lines 四项覆盖率均为 100%类型检查、Chrome/Firefox 生产构建、userscript 构建及 verifier 均通过。测试覆盖清单与源码一一对应可到 tests/freeBalancedRouting.test.ts、tests/freeFallback.test.ts、tests/freeRoutingPolicy.test.ts、tests/freeChineseWebProviders.test.ts、tests/freeTranslationWeightsHandler.test.ts 验证动态性能影响实际服务选择持久化的性能记录reliability 0.25、latency 10 s会压低该候选的选中概率冷却持久化与恢复探测失败后写入failures/retryAt成功探测后清空并重建 EMAreliability 回到 1Retry-After服务端恢复时间优先于本地退避排队预算并发满时排队等待超时抛AttemptTimeoutError并发限制与最小间隔同一服务两次请求间遵守minIntervalMs挂起存储与迟到响应存储 load/save 挂起或抛错都不阻断翻译迟到的加载值不会覆盖已开始服务的状态取消时序AbortError 在各阶段加载、排队、请求中都能正确传播。九、真实生产扩展验证第二层是真实浏览器验证。验证使用独立的临时 Edge profile正常窗口置于第二屏、以macos-background-cdp/launchservices-no-foreground启动、确认browserFrontmost: false不复用用户浏览器、不移动系统鼠标记录在 docs/reports/free-balanced-translation-20260912/report.json。验证要点与结果界面契约默认自动均衡、微软首位、9 项默认启用、13 项可选、无权重输入控件持久化服务启停、顺序和模式在重新加载设置页后保持响应式1440、820、390 像素宽度均无横向溢出明暗主题均通过检查有道网页翻译隔离启用后真实连接检查成功耗时144 ms金山词霸隔离启用后真实连接检查成功耗时197 ms真实翻译往返仅启用词霸时在 example.com 页面对段落执行翻译 → 恢复 → 再次翻译译文节点数量按1 → 0 → 1变化恢复后原文与初始一致。十、证据边界与使用限制报告对哪些验证过、哪些没有做了严格的边界声明这也应是使用者对该功能的基本预期搜狗本轮网络超时Reverso 和 Lingva曾遇到访问验证。三者拥有真实协议适配器和合成响应测试但尚无本轮生产扩展的成功证据Apertium官方语言对列表已核对确认不支持中文方向但没有本轮生产扩展翻译成功证据彩云、Papago、LibreTranslate未取得足够的当前匿名可用证据本轮未作为空适配器加入服务池完整 UI 技能脚本已运行但其持久化用例仍假设通用设置中存在旧目标语言控件而当前该位置已是界面语言脚本超时因此完整套件不计为通过上述免费服务专项属于独立的真实浏览器验证Firefox 与 userscript 本轮只有构建/产物验证没有运行时浏览器验证机器翻译服务受网络、额度及服务端策略影响测试成功不代表持续可用性承诺。最后一点值得强调FluentRead 的实现严格按自身 Vue/WXT 架构独立完成没有修改参考仓库或引入跨仓库依赖。免费翻译的免密钥、动态均衡、分级冷却与匿名隔离设计为零配置翻译提供了完整可复现的工程参考——从 src/core/config/freeTranslation.ts 的纯配置规则到 src/services/translation/freeFallback.ts 的调度内核再到 tests/freeBalancedRouting.test.ts 的 100% 覆盖测试读者可按此链路逐层深入。赞分享前端AI 应用本地部署【免费下载链接】FluentReadAn open-source browser extension for bilingual translation. 一款开源的浏览器双语翻译插件。项目地址https://gitcode.com/gh_mirrors/fl/FluentRead点击查看免费下载相关推荐Apache DolphinScheduler 负载均衡机制全解析从加权随机、平滑轮询到动态加权调度Apache DolphinScheduler 负载均衡机制全解析从加权随机、平滑轮询到动态加权调度 本篇技术指南以 Apache DolphinSchedu任务调度大数据后端前端Diem Key Manager 源码级解析验证者共识密钥的自动轮换与状态协调机制Diem Key Manager 源码级解析验证者共识密钥的自动轮换与状态协调机制 本文以 DiemLibra支付网络中的 Key Manager 组件为区块链金融科技KlipperScreen常见问题解决从安装到使用的10个技巧KlipperScreen常见问题解决从安装到使用的10个技巧 KlipperScreen是Klipper 3D打印固件的图形用户界面帮助用户轻松控制3D打桌面应用智能硬件上一篇Kubernetes Pause 镜像引用更新指南跨仓库错峰协调的完整实践下一篇CANN ascend-boost-comm 安全加固指南ASLR 系统加固、运行用户、文件权限与构建安全全解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考