Shinkansen:快速、私密的网页与 YouTube 字幕翻译扩展
Shinkansen:快速、私密的网页与 YouTube 字幕翻译扩展
Shinkansen(新干线)是一款以隐私为核心的浏览器翻译扩展,集成 Google Gemini、Google Translate 以及自定义 AI 模型,支持翻译为 8 种目标语言。它提供极速翻译、双语对照与原地替换功能,所有数据仅保存在本地,不经过第三方服务器,并完全开源。
核心特性一览
- 多语翻译与界面:支持翻译为繁体中文、简体中文、英文、日文、韩文、西班牙文、法文、德文;扩展界面同样支持这 8 种语言,可独立设置或跟随浏览器语言。
- 极速秒翻:按下翻译后 1 秒内页面开始变为中文(仅限 Gemini)。
- 原地排版保留:直接替换网页文字,保留字体、字号、颜色与排版,链接仍可点击。
- 双语对照模式:选择“单语覆盖”或“双语对照”,后者以新段落 append 译文,并提供 4 种视觉标记(淡底色、左边细条、虚线底线、无)。
- 三翻译引擎:Gemini(需 API Key,质量最佳)、Google Translate(非官方免费端点,无需 Key)、自定义模型(OpenAI 兼容端点,可接 OpenRouter、Claude、Ollama 等)。
- YouTube 字幕即时翻译:自动替换字幕为中文,样式与原生一致;支持双语对照和 AI 分句功能。
- 固定术语表与禁用词清单:自定义翻译对照表,禁止特定词汇(如“视频”“软件”等)出现在译文中。
- 只翻文章开头:先翻译前几段预览,大幅节省 token。
- 翻译缓存与费用报告:双重缓存机制(本地 + Gemini implicit cache),实时显示缓存命中率与节省费用。
- 跨标签延续翻译:从已翻译页面打开新标签时自动继承翻译设置。
- 自动翻译指定网站:白名单网站自动触发翻译。
- 编辑译文:翻译完成后可直接在页面修改,适合导出或抓取。
隐私与性能
Shinkansen 从设计之初就以隐私为核心:所有配置和数据仅存储在你的电脑上;除你自备的 Gemini API Key 直连 Google 外,不会将任何数据外传;源代码完全公开,任何人都可审查安全性。
压力测试(英文维基百科 Taiwan 条目,超一千段文字)显示:
- 内存不增反减(中文比英文更精简);
- 翻译过程中页面不卡顿(95% 时间等待 API 响应);
- 翻译完成后页面结构干净无痕;
- 使用最便宜模型翻译全页,API 费不到 0.08 美元(约 2.5 元新台币);
- 翻译内容自动缓存,下次打开无需重复付费。
完整测试数据见 PERFORMANCE.md。
安装指南
Chrome / Edge / Brave 等 Chromium 浏览器
前往 Chrome Web Store 安装页面 点击“加到 Chrome”。
Firefox
前往 Firefox Add-ons 安装页面 点击“Add to Firefox”。
⚠ 注意:Firefox 默认快捷键 Alt+S / Alt+A / Alt+D 可能被浏览器拦截。请到 about:addons → 设置 → 管理扩展快捷键,改为不冲突的组合(如 Ctrl+Shift+S)。
开发版(加载未打包项目)
1. 打开 Chrome,地址栏输入 chrome://extensions/ 并回车
2. 开启右上角“开发者模式”
3. 点击“加载已解压的扩展程序”,选择本项目的 shinkansen/ 文件夹
4. 扩展列表出现 Shinkansen,可固定到工具栏
使用与配置
快速上手
- 申请 Gemini API Key(参考 API Key 申请教程)
- 点击工具栏 Shinkansen 图标 → “设置”
- 粘贴你的 Gemini API Key,默认模型
gemini-3-flash-preview,Service TierDEFAULT - 其余参数可按需调整(温度、每批段数、字符预算等)
手动翻译
- 点击工具栏图标 → “翻译本页”
- 或使用快捷键:三组可自定义快捷键(默认
Alt+A/Alt+S/Alt+D),可分别绑定不同引擎、模型和预设,按内容重要性一键切换。
YouTube 字幕翻译与 AI 分句
- 自动侦测 YouTube 字幕并替换为中文。
- 双语对照模式同时显示英文+中文(英文在上)。
- AI 分句功能针对 YouTube 自动生成字幕(ASR)进行语义重新分段,输出完整句子,阅读体验大幅提升。
高级功能
- 固定术语表:自定义翻译对照表,支持全局与域名专属两层,域名规则覆盖全局同名词条。
- 禁用词清单:编辑禁用词表(预置 25 条,如“视频”),以高显著性区块注入 system prompt 末端,明确要求模型不使用这些词。
- 只翻文章开头:设置先翻前几段预览,再决定是否整篇翻译。
- 全文术语表一致化(默认关闭):适合人名众多的长文,确保同一专有名词前后翻译一致。
- 翻译缓存与费用计算:本地缓存 + Gemini implicit cache,翻译后显示缓存命中率与节省费用。
- API 配额管理:后台自动管理 Gemini API 用量,避免大页面翻译被拦截,接近每日配额时提前警告。
- 用量追踪:记录每次翻译的 token 数与费用,附图表与 CSV 导出。
- 跨标签延续翻译:从已翻译页面点击链接打开新标签,自动使用同一预设翻译。
- 自动翻译指定网站:在设置中加入白名单域名,打开网站时自动翻译。
- 还原原文:按同一快捷键即可切回原文。
- Google Docs 翻译:自动检测并开启可翻译的阅读版。
性能实测数据
使用最便宜模型翻译完整的英文维基百科 Taiwan 条目(1000+ 段落):
- API 费用 < 0.08 美元
- 页面翻译过程中不卡顿,内存不增反减
- 翻译完成后页面结构干净
- 缓存机制避免重复计费
关键要点
- 隐私优先:所有数据本地处理,仅直连 Google Gemini,不经过任何第三方。
- 极速体验:Gemini 模式下 1 秒内页面开始变化;缓存加速二次访问。
- 低成本:翻译全页仅需 0.08 美元,缓存后零成本。
- 高度可定制:多引擎切换、自定义模型、术语表、禁用词、快捷键绑定。
- 全面兼容:支持网页、PDF、YouTube 字幕,保留原始排版,双语对照可选。
- 开源透明:代码公开,可审计安全性。