hao-fan

项目概述

好翻是一款开源、免费的沉浸式双语网页翻译扩展，支持 Chrome、Firefox 和 Edge。与云端聚合服务不同，它直连你自己配置的翻译商——请求不经任何中转，API Key 只保存在本机浏览器。

谁给你翻译，由你自己决定。

主要功能

• 沉浸式双语对照：原文保留，译文渲染在原文下方，随页面滚动自然跟随
• 直连自选服务商：DeepSeek、OpenAI、Gemini、智谱、混元、通义、Kimi、豆包等 12 家 AI，加 Ollama 本地与任意 OpenAI 兼容接口，另有 4 家传统机翻（3 家免 Key）
• 流式输出：划词、悬停、点段落逐字回填，首字即显，异常自动回退不漏译
• 上下文感知：结合页面标题与前段译文构造滑动窗口，长文术语与指代更连贯
• 质量自检：译后校验数字、URL、邮箱与占位符保真度，缺失自动校正重试
• 划词与悬停翻译：选中即出浮层，悬停即出气泡，支持复制与 TTS 朗读
• 省 Token 机制：句子级缓存、术语库命中、标识符保护、多引擎故障转移
• 翻译历史：本地保存 200 条，可搜索、点击回填重译、一键清空
• 设置备份：配置导出 JSON 跨设备迁移，API Key 默认不导出

适用人群

• 常读英文网页的开发者
• 有自建 AI 服务的技术用户
• 在意隐私的翻译重度用户
• 需要对照原文学习语言的人

快速上手

1. 从 Releases 下载对应浏览器的 ZIP 并解压
2. Chrome/Edge 在 chrome://extensions 开启开发者模式后「加载已解压的扩展程序」；Firefox 在 about:debugging 临时载入
3. 打开设置选择服务商并填入 API Key，点「测试连接」确认可用；也可先用内置免 Key 通道直接体验

核心优势

• 无中心无遥测：数据只发往你配置的服务商，不采集使用行为
• 透明可审计：MIT 开源，每项行为都能在源码中找到实现
• 省钱省力：多级缓存与批量合并把 Token 消耗压到最低

系统要求

项目	要求
浏览器	Chrome（MV3）、Firefox（MV2）、Edge
快捷键	Alt+T 翻译页面，Alt+S 显隐译文

注意事项

• Firefox 未签名扩展重启浏览器后失效，属浏览器限制
• MyMemory 等免 Key 公共通道无服务等级保证，正式使用建议配置带 Key 的服务
• 机翻通道会把待译文本发往对应服务商，请按隐私需求选择
• 未配置 Key 时不会发送无效请求，而是弹出引导卡