FluentRead 新手上手指南：从安装到首次双语翻译与恢复原文的完整流程

前端AI 应用本地部署【免费下载链接】FluentReadAn open-source browser extension for bilingual translation. 一款开源的浏览器双语翻译插件。项目地址https://gitcode.com/gh_mirrors/fl/FluentRead点击查看免费下载本篇指南以 FluentRead 的官方入门文档docs/en/guide/getting-started.md为主体完整覆盖插件的安装方式、语言与翻译服务的选择、第一次完成网页双语翻译、恢复原文以及只翻译一句话的高频场景。结合仓库中语言检测src/core/language、翻译服务目录docs/en/config/translation-engines.md与常见问题docs/en/guide/faq.md的源码与文档细节读完你可以独立完成从零到一的安装配置并理解简繁中文跳过、自动检测等行为背后的判定逻辑。安装按浏览器选择安装方式FluentRead 是开源的浏览器双语翻译扩展安装方式根据浏览器分为两类运行环境安装方式Chrome从 Chrome Web Store 官方商店搜索并添加扩展跟随浏览器提示完成安装Edge从 Edge Add-ons 官方商店添加扩展跟随浏览器提示完成安装Firefox从 Firefox Add-ons 官方商店添加扩展跟随浏览器提示完成安装装有脚本管理器的浏览器使用 Tampermonkey、Violentmonkey 或 Via 等脚本管理器安装 FluentRead 用户脚本详见 docs/en/guide/userscript.md安装后有两个收尾动作固定到工具栏把 FluentRead 固定到浏览器工具栏方便随时点开菜单进行翻译或设置刷新旧页面安装之前已经打开的网页需要刷新一次扩展才能接管页面。需要注意浏览器设置页、扩展商店页面等受浏览器保护的特殊页面不允许进行网页翻译首次体验请打开普通文章页面。用户脚本版本与扩展版本的能力边界不同。脚本管理器与网页权限会限制可用功能图片识别、划区截图、Chrome 内置翻译、后台功能与视频字幕可能不可用且不同脚本管理器之间行为可能有差异见 docs/en/guide/userscript.md。日常深度使用推荐浏览器扩展版本。第一次翻译四步走完流程第 1 步打开一篇文章新闻、博客、论坛帖子或在线文档都是合适的起点。先避开翻译受限的浏览器内部页面。第 2 步选择你的语言点击工具栏中的 FluentRead 图标打开扩展菜单保持源语言为自动检测Auto-detect然后选择目标语言。扩展的默认目标语言为简体中文可按你的阅读习惯改为其他语言。从语言目录的实现看简体中文与繁体中文是两个独立语言选项src/core/language/catalog.ts 将zh-Hans简体中文与zh-Hant繁體中文分别列出共提供 52 种语言选项。语言选择是否真的跳过一段中文文本背后有一套保守的判定逻辑体现在 src/core/language/chinese.ts 与 src/core/language/detect.ts 中明确匹配目标中文书写体系的文本会被跳过判定需要简体或繁体字形的明确中文证据simplifiedChineseEvidencePattern / traditionalChineseEvidencePattern仅凭共享汉字不会推断简体或繁体同时用 Unicode 简繁字形冲突表逐对审核字形scriptPairs 字形表。含常见粤语口语标记如「嘅」「咗」「喺」的文本不会被当作普通话跳过cantoneseMarkerPattern。少量缩写不会触发整段翻译AI、CoT、OpenAI 这类首字母缩写与内部大写产品名iPhone 等可以嵌在长中文句中而不判定为外语technicalTokenPattern。而混排文本、完整的外语段落、以及书写体系识别不确定的文本仍会继续翻译。短文本与不确定结果采取宁可多翻策略shouldSkipTranslationForTarget对短拉丁文本少于 50 个字母、无中文证据的 Han 文本与任何未知统计结果都返回不跳过MIN_RELIABLE_STATISTICAL_LETTERS 50保证不确定的文本不会静默漏译。一句话总结自动检测 目标语言 这些保守的跳过规则让中文目标下不重复翻译中文、外语照常翻译达到可用且不漏译的平衡。第 3 步选择翻译服务保持默认的免费翻译服务Free translation service即可开始它无需任何 API Key。若该服务在你的网络下繁忙或不可用稍后重试或在设置中切换到其他服务详见 docs/en/config/translation-engines.md。可用服务类型包括场景推荐起点立即开始免费翻译服务免 API Key已有某个服务商账号对应的 Microsoft、Google、DeepL 等服务用云厂商额度换取稳定免费配额云厂商服务Google Cloud、Azure、阿里云、腾讯云、百度、火山引擎各有每月免费字符额度需要句子讲解、语气分析配置好模型与凭据的 AI 服务完全本地翻译本地模型翻译、Ollama本地、Chrome 本地翻译免费服务默认启用 Microsoft、腾讯 TranSmart、火山引擎、Google、有道网页、ICIB A、Yandex、DeepLX、MyMemory 等免 Key 端点并按自动均衡模式动态分配请求断开的端点会按服务商策略暂停数分钟到数小时不等。更换服务后记得先恢复原文再重新翻译新设置才会完整生效。第 4 步翻译整个页面并恢复原文点击菜单中的**页面翻译Translate this page**按钮默认快捷键 AltT译文会显示在原文段落旁边形成双语对照——原文与译文相邻方便随时对比名称、细节或上下文详见 docs/en/guide/features.md。默认情况下FluentRead 采用随读随译模式跟随你的滚动位置逐段翻译不必等待整篇文章一次性完成。若希望一次处理全页可在设置中改为整页处理。要回到原始页面点击菜单中的恢复原文Restore original即可。想换一种语言或换一个服务时同样先恢复原文再重新翻译。只翻译一句话划词翻译与悬停翻译不需要整页翻译时有两个轻量入口划词翻译先在扩展菜单中启用「划词翻译Selection translation」选中一句话后点击选区附近出现的 FluentRead 图标即可。结果卡片支持复制译文、朗读原文可拖动与缩放。悬停翻译把鼠标悬停在一个段落上按下默认的Control 键即可翻译该段落无需选中文字也无需翻译整页。按键行为可在快捷键设置中调整见 docs/en/guide/custom-hotkey.md。若需要句子成分拆解与解释如语气、长句解析、用法讲解可单独配置阅读卡reading card它有自己的 AI 服务设置见 docs/en/guide/deepseek-harness.md。注意常规划词翻译只给译文AI 讲解必须显式启用阅读卡并配置可用的 AI 服务与模型。遇到问题按顺序排查如果点了翻译却什么都没发生按以下顺序排查详见 docs/en/guide/faq.md确认扩展已启用并刷新当前页面后重试确认目标语言正确并确认页面不是浏览器设置页、扩展商店页等受限页面换成普通文章再试检查服务连通性在服务设置中点击「检查连接」免费服务繁忙时稍后重试或换一个服务商只翻了一部分默认是随读随译继续滚动即可也可在设置中改为整页范围一次处理划词能用但整页不行可能是页面识别问题或请求过多触达繁忙服务先翻译一个段落试连通性出现重复翻译或布局错乱先恢复原文再排查是否有其他翻译扩展或浏览器自带翻译同时生效只保留一个翻译器。收尾把配置记牢把流程跑顺入门流程可以浓缩为一条主链路安装 → 固定到工具栏 → 刷新旧页面 → 打开文章 → 选目标语言 → 用免费服务 → 点页面翻译AltT→ 随读随译 → 恢复原文。单句场景则走划词或 Control 悬停。在此基础上你还可以进一步深入docs/en/config/translation-engines.md 讲解了如何接入 DeepL、AI 服务、Ollama 本地模型与多 Key 轮换docs/en/guide/features.md 覆盖了页面翻译的进阶设置浮动球、按钮替换式翻译、段落处理参数、双语句子高亮docs/en/guide/faq.md 汇集了更多故障场景的排查答案。赞分享前端AI 应用本地部署【免费下载链接】FluentReadAn open-source browser extension for bilingual translation. 一款开源的浏览器双语翻译插件。项目地址https://gitcode.com/gh_mirrors/fl/FluentRead点击查看免费下载相关推荐FluentRead 快速上手从安装到第一次双语翻译的完整实操指南FluentRead 快速上手从安装到第一次双语翻译的完整实操指南 本文以 FluentRead 开源双语翻译浏览器插件为对象完整讲解从浏览器安装、语言与翻前端AI 应用本地部署FluentRead 使用指南从安装到网页、图片、文档与视频字幕的完整双语翻译实战FluentRead 使用指南从安装到网页、图片、文档与视频字幕的完整双语翻译实战 FluentRead流畅阅读是一款开源的浏览器双语翻译插件以「原文与前端AI 应用本地部署8分钟装通Continue代码补全与AI编码代理上手指南8分钟装通Continue代码补全与AI编码代理上手指南 写单测还在翻API文档让AI编码代理代劳 还在为写单元测试手动切窗口查 API 吗Continu人工智能AI Agent代码智能体开发工具工具调用RAG上一篇JPEXS Free Flash Decompiler技术解密逆向工程如何拯救Flash数字遗产下一篇解密流媒体下载黑科技N_m3u8DL-RE如何轻松获取加密视频内容创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考