muran169633/contextflow-translate

项目介绍

ContextFlow Translate 是一个 Chrome / Edge Manifest V3 扩展，保留网页原文并在每段下方插入译文，方便对照阅读。免账号、免密钥的方式包括 MyMemory 和 Google 翻译网页端点；百度、有道、微软、Google Cloud 以及本机 LibreTranslate 需要各自的凭据或服务。AI 模式支持 OpenAI 兼容的 chat/completions 地址、Gemini 的 generateContent 和 Claude 的 Messages API，每种接口单独保存模型名和密钥。它适合希望自行选择翻译服务、而不是依赖单一内置引擎的读者。

AI 模式按每五段一组发送，并附带标题和相邻段落作为上下文，支持最多 60 条 source => target 术语表、四种翻译风格，以及可选的二次审校，用于检查否定、数字、单位和限定词。扩展优先处理当前视口内容，首次每页或每个内容框架最多处理 300 个区块，剩余预算内可继续处理新加载的内容。

快速使用

1. 下载源码压缩包并解压到固定目录，不要直接选中 ZIP。
2. 打开 chrome://extensions 或 edge://extensions，启用开发者模式，点击加载已解压的扩展程序，选择包含 manifest.json 的目录。
3. 打开一个 https:// 文章页，点击工具栏图标，选择 MyMemory · 免费 或 Google 翻译 · 免密钥（非官方），设置源语言和目标语言，点击翻译网页；首次使用时允许访问所选服务。
4. 如需使用自己的模型，选择你的 AI 模型并打开设置，选择接口类型，填写模型 ID 和密钥，兼容服务还需填写基础 URL。保存并测试 API 会发送一次短请求，可能产生服务商费用。
5. 译文显示在原文段落下方，右下角显示进度；可使用停止、移除译文或重试。

页面按钮和默认快捷键 Ctrl+Shift+Y（macOS 为 Command+Shift+Y）可以启动已配置的翻译；Alt+Shift+Y（macOS 为 Option+Shift+Y）在原文与双语视图之间切换。中文图文步骤见使用教程。

LibreTranslate 需要单独部署：按安装文档在本机启动服务并加载所需语言模型，例如 libretranslate --host 127.0.0.1 --port 5000 --load-only en,zh。扩展不会替你安装或启动该服务。

使用约束

免费或免密钥服务各有上限。按 MyMemory 的用量说明，匿名每天 5,000 字符，填写联系邮箱可提高到 50,000；邮箱保存在本地并随请求 URL 发送。MyMemory 不使用 AI 上下文、术语表、翻译风格和二次审校，且请求有 500 字节限制，长段落会被拆分。Google 网页端点是非官方集成，可能被限流或变更，文本会出现在请求 URL 中。百度、有道、微软和 Google Cloud 按各自账户与当前定价计费；扩展在失败时不会自动切换服务商。

凭据保存在 chrome.storage.local，未单独加密，扩展页面和后台脚本可读取，网页本身不能直接访问。远程 AI 地址必须使用 HTTPS，只有 localhost 和 127.0.0.1 允许普通 HTTP。AI 模式会把选中的段落、标题、上下文和术语表发送给你配置的服务商。可选的本地缓存最多保存 200 条译文，期限 7 天。

适用范围限于普通文章类网页：浏览器内部页面、内置 PDF 阅读器、扫描图片和视频内嵌字幕不受支持，复杂布局下译文覆盖层可能定位不准。停止操作只阻止新任务，已经发出的请求仍可能消耗额度。README 明确说明，翻译质量尚未与其他扩展做过基准对比。

Kaggle Notebook 正文位于内嵌框架，翻译时需额外授权 webNavigation 和 kaggleusercontent.com。复制讨论利用当前登录状态读取 Kaggle 讨论及折叠回复，将格式化文本写入剪贴板，不发送给 AI 服务；其他网站仅支持页面中已有的 JSON-LD 结构化评论。

项目采用 MIT 许可证；测试需要 Node.js 22+，运行 npm test，覆盖 URL 校验、提示词、术语解析、结构化输出和模拟的 service worker 接口流程。

HotRepo 点评

在 2026-11-05 的 JavaScript 新项目榜中，ContextFlow 在 10:45 至 13:45 UTC 约三小时的统计窗口内新增 8 星，达到 111 星、1 个 Fork，暂无全语言日榜名次记录。功能与 README 细节较充实，但单条短窗口快照不足以判断热度趋势。项目自身也提示翻译正确性尚未做基准评测，服务可用性和费用随配置变化，实际效果取决于所选服务商和模型。