Profile
Back to NewsBack
GitHub Trending 5 min
Reader Mode
jimmysu0309/shinkansen: 快速、流暢的網頁及 YouTube 字幕翻譯擴充功能。支援 8 種目標語言與多種 AI 引擎,資料不經過第三方

jimmysu0309/shinkansen: 快速、流暢的網頁及 YouTube 字幕翻譯擴充功能。支援 8 種目標語言與多種 AI 引擎,資料不經過第三方

10 hours ago

English | 繁體中文

Shinkansen 🚄

快速、私密的網頁、YouTube 字幕翻譯擴充功能,支援 8 種目標語言與多種 AI 引擎(Google Gemini、Google Translate、OpenAI 相容自訂模型),原地替換網頁文字保留原始排版,瀏覽資料不經過第三方伺服器。

名稱「新幹線」象徵快速、平穩、流暢的閱讀體驗。

從 Chrome Web Store 安裝 · 從 Firefox Add-ons 安裝 · 從 Mac App Store 安裝 · 從 App Store 安裝(iOS / iPadOS) · 下載最新版本 zip · 安裝教學與產品介紹見 官方網頁 · 更新紀錄

近期重大更新

  • iOS / iPadOS 版正式登陸 App Store,Safari 擴充功能搭配多指觸控翻譯與懸浮按鈕,開箱即用
  • 新增 Word(.docx)文件翻譯,譯文寫回原檔,版面、樣式、表格、註解全保留,可輸出雙語對照版
  • 新增字幕檔翻譯,SRT / WebVTT / ASS 字幕檔逐則翻譯,時間軸與樣式標記原樣保留,可輸出單語或雙語字幕
  • PDF 翻譯放寬上限並修正版面,檔案上限放寬到 50 MB / 300 頁、可指定翻譯頁數範圍,修正雙欄短行、彩色底、旋轉頁、段落溢出等版面問題,簡體 / 日文 / 韓文譯文字型用到才下載
  • 新增 EPUB 電子書翻譯,全書術語表與譯後一致性掃描確保人名譯名前後一致,譯本可下載單語或雙語對照版
  • 新增 TXT / Markdown / HTML 檔案文件翻譯,譯文輸出格式與原檔相同;術語表匯入同步支援 CSV(兩欄「原文,譯名」)
  • 網頁翻譯更省,每批容量翻倍,同一頁的 API 請求數減半、input token 省約三成,速度不變;YouTube 自動字幕的 AI 分句改用精簡傳輸格式,費用約減半
  • 簡繁自動互轉預設開啟,簡體(或繁體)網頁載入即走內建字典本地轉換,不需 API Key、離線可用;不需要可在工具列圖示選單關閉
  • 尊重網頁的「不要翻譯」標記,translate="no" / notranslate 標成不翻譯的人名、代號原樣保留、不送 API,字型圖示也不再被翻成文字
  • YouTube 字幕多項修正,自動字幕時間軸修正、譯文提前 1 秒出現、切換影片不殘留舊字幕,youtube.com/live/ 直播連結也能翻譯字幕
  • 大量翻譯品質與穩定性修正,簡繁自動轉換後第一下翻譯不再被當成還原、被截斷的譯文不再寫進快取、譯文被前端框架打回原文的守護補強、長網頁偵測約快三成

為什麼做這個專案

既有的網頁翻譯工具大多需要將個人瀏覽內容傳送到第三方伺服器處理,隱私權難以掌控。Shinkansen 的設計從一開始就以隱私為核心:所有設定與資料都只存在你自己的電腦上;除了你自備的 Gemini API Key 直接連線 Google 之外,不會將任何資料外傳給其他第三方;原始碼完全公開,任何人都可以檢視它的安全性。

效能實測

我們拿英文維基百科的 Taiwan 條目(超過一千段文字)做壓力測試:記憶體不增反減(中文比英文精簡)、翻譯過程中網頁不會變卡(95% 以上的時間在等 API 回應,電腦幾乎不做額外運算)、翻完後頁面結構維持乾淨不留痕跡。用最便宜的模型翻完整頁,API 費用不到 0.08 美元(約台幣 2.5 元),翻過的內容自動快取,下次再開不用重新花錢。完整測試數據見 PERFORMANCE.md。

功能特色

  • 多語翻譯目標 + 多語介面:可選翻譯成 8 種語言(繁體中文 / 簡體中文 / 英文 / 日文 / 韓文 / 西班牙文 / 法文 / 德文)。工具列圖示選單的「翻譯成」切換,所有翻譯模式(網頁 / PDF / YouTube 字幕)共用此設定;工具列圖示 / 設定頁 / 網頁翻譯進度通知 / PDF 文件翻譯 reader 同樣支援 8 語介面,可獨立設定或跟著瀏覽器語言推導
  • 極速秒翻:按下翻譯 1 秒看到頁面開始變中文,不用等整批 API 回完再一次塞回頁面(限 Gemini)
  • 保留網頁排版:原地替換網頁文字,保留字型、字級、顏色與排版,連結仍可點擊、粗體斜體原樣保留
  • 尊重網頁的「不要翻譯」標記:網站作者以 HTML 標準 translate="no" 或 notranslate 標成不翻譯的人名、代號、程式碼原樣保留、不送 API;用字型顯示的圖示(HTML 裡其實是 star、menu 這類字)也不會被翻成文字而消失
  • 單語覆蓋 / 雙語對照雙模式:工具列圖示一鍵切換顯示模式——「單語覆蓋」原地替換、「雙語對照」原文保留 + 譯文以新段落 append。雙語模式提供 4 種視覺標記(淡底色 / 左邊細條 / 虛線底線 / 無)讓你選擇譯文段落的呈現風格
  • 三翻譯引擎:Gemini(AI 翻譯、品質最佳、需 API Key)+ Google Translate(非官方免費端點、不需 API Key、速度更快)+ 自訂模型,依場景自由切換
  • 簡繁互轉完全免費:翻譯目標是繁體或簡體中文時,相反變體的中文內容走內建 OpenCC 字典本地轉換——不需 API Key、不打任何 API、離線可用,詞組級對照涵蓋台灣慣用詞(軟件→軟體、視頻→影片、內存→記憶體)。「簡繁自動互轉」預設開啟——簡體(或繁體)網頁載入時自動轉換,不用手動觸發;可在工具列圖示選單關閉,取消勾選當下立即還原目前頁面;混合語言頁面也只有中文段落走免費轉換,其餘照走你選的翻譯引擎
  • 自訂 AI 模型:OpenAI 相容端點,可接 OpenRouter / Together / Groq / Ollama 本機等百種模型
  • 三組可自訂快速鍵:Alt+A / Alt+S / Alt+D 各自綁一組翻譯預設(引擎 + 模型 + 標籤),依網頁內容重要性一鍵選擇不同引擎(例如閱讀材料用 Flash、隨手瀏覽用 Google MT)。詳見下方「翻譯快速鍵與預設」段落
  • 懸浮按鈕:頁面左/右緣常駐的懸浮按鈕,點選即翻譯本頁,長按可切換翻譯引擎或叫出選單;全平台預設開啟,按鈕大小與透明度可調
  • 文件翻譯(PDF / EPUB / Word / TXT / Markdown / HTML / 字幕檔):上傳檔案整份翻譯——PDF 保留原版面輸出譯文 PDF;EPUB 支援全書術語表(人名譯名跨章節一致)、章節選翻、預覽編輯與雙語對照譯本;Word(.docx)譯文寫回原檔,版面 / 樣式 / 圖表全保留,可輸出雙語對照;TXT / Markdown / HTML 檔沿用同一套章節管線,譯文輸出格式與原檔相同;SRT / WebVTT / ASS 字幕檔逐則翻譯,時間軸原樣保留,可輸出雙語字幕。詳見下方「文件翻譯」段落
  • YouTube 字幕即時翻譯:自動偵測 YouTube 字幕,即時替換為你設定的目標語言(預設繁體中文),字幕樣式與原生 YouTube 字幕一致。詳見下方「YouTube 字幕翻譯」段落
  • 字幕雙語對照:顯示模式設為「雙語對照」時,字幕同時顯示英文 + 中文兩行(英文在上、中文在下),適合練聽力或對照原文。YouTube 與 Google Drive 影片都適用。詳見下方「字幕雙語對照」段落
  • YouTube AI 分句(自動產生字幕專用):YouTube 自動產生字幕(ASR)原本是一個個破碎的詞,經 AI 重新依語意分句後翻譯,中文字幕從「破碎的詞」變「完整句子」,閱讀體驗大幅提升。詳見下方「AI 智慧分句」段落
  • 固定術語表:自訂翻譯對照表,指定特定詞彙一律翻成你要的譯名。支援全域與網域專屬兩層,網域規則覆蓋全域同名詞條。詳見下方「固定術語表」段落
  • 禁用詞清單:可由你編輯的禁用詞對照表,適用任何翻譯目標語言——多數目標語言預設為空,只有繁體中文(台灣)目標預設帶 26 條(例如視頻 / 軟件 / 數據 / 網絡 / 質量 / 用戶)。會以高顯著性區塊注入到 system prompt 末端,明確要求譯文不可使用左欄詞彙。詳見下方「禁用詞清單」段落
  • 只翻文章開頭:先翻前幾段預覽再決定是否讀完整篇,大幅節省 token。詳見下方「只翻文章開頭」段落
  • 全文術語表一致化(預設不開啟):特別適合人名眾多的長文,自動確保同一個人名或專有名詞前後翻譯一致。詳見下方「術語表一致化」段落
  • 翻譯快取與即時節費報告:雙層快取機制(本地快取 + Gemini implicit cache),翻譯完成後提示訊息即時顯示 cache hit rate 與實際節省費用。詳見下方「翻譯快取與費用計算」段落
  • 用量追蹤:記錄每次翻譯的 token 數與費用,附圖表與 CSV 匯出
  • 編輯譯文:翻譯完成後可直接在頁面上修改譯文,適合要列印 PDF 或讓 Readwise Reader 抓取時,手動修正翻得不理想的地方
  • 送到 Instapaper:把翻譯後的整篇文章透過 Instapaper API 一鍵存進你自己的 Instapaper 帳號,存進去的是「你看到的中文譯文」而非原文。不像 Instapaper 官方儲存方式只存網址、由伺服器重新抓取原文,Shinkansen 直接上傳翻譯後的內容,日後可重讀譯文版
  • 跨 tab 延續翻譯:在 tab A 按快速鍵翻譯後,從 A 點連結開新 tab B(含按住 Cmd(Mac)/ Ctrl(Windows)點連結 / target="_blank" / window.open),B 自動翻譯並繼承同一組 preset;新 tab 再開新 tab 也繼續
  • 自動翻譯指定網站:在設定頁加入常看的網域,開啟該網站時自動翻譯,不用每次手動按快速鍵(翻譯通知會標示 [自動翻譯] 讓你知道是 whitelist 觸發)
  • 還原原文:按同一組快速鍵即切換回原文,隨時對照
  • Google Docs 翻譯:自動偵測 Google Docs,開啟可翻譯的閱讀版並翻譯(詳見下方說明)

安裝方式

Chrome / Edge / Brave 等 Chromium 瀏覽器

前往 Chrome Web Store 安裝頁面 點「加到 Chrome」即可。

Firefox

前往 Firefox Add-ons 安裝頁面 點「Add to Firefox」即可。

⚠ Firefox 使用者注意:預設快捷鍵 Alt+S / Alt+A / Alt+D 會被瀏覽器或其他擴充功能攔截(Firefox 把 Alt+S 用於開啟「歷史」選單、Alt+D 用於切換地址列焦點;Alt+A 常被 Save Page WE 等擴充功能搶走)。Chrome 沒有此衝突,但 Firefox 環境下三組預設快捷鍵可能完全無法觸發翻譯。請到 about:addons → 設定圖示(齒輪)→「管理擴充功能快捷鍵」,把 Shinkansen 的三個快速鍵改成不衝突的組合(例如 Ctrl+Shift+S)。設定頁的「翻譯快速鍵」section 也會在 Firefox 環境自動顯示這個提示

開發版(載入未封裝)

  1. 開啟 Chrome,網址列輸入 chrome://extensions/ 並按 Enter
  2. 右上角打開「開發人員模式」
  3. 點「載入未封裝項目」(Load unpacked)
  4. 選擇本專案的 shinkansen/ 資料夾
  5. 擴充功能清單會出現 Shinkansen,可以固定到工具列

首次設定

  1. 申請 Gemini API Key — 直接開 aistudio.google.com/api-keys 登入後按「Create API key」,詳細步驟見 API Key 申請教學
  2. 點工具列的 Shinkansen 圖示 → 「設定」
  3. 貼上你的 Gemini API Key
  4. 預設模型 gemini-3.1-flash-lite、Service Tier DEFAULT
  5. 其餘參數可依需求調整(溫度、每批段數、字元預算等)

使用方式

  • 手動翻譯:點工具列圖示 → 「翻譯本頁」
  • 翻譯快速鍵(三組):
- Option+S / Alt+S — 預設 Gemini Flash Lite(省成本,推薦日常用) - Option+A(macOS)/ Alt+A — 預設 Gemini 3.8 Flash(品質高) - Option+D / Alt+D — 預設 Google Translate(免費、不需 API Key) - 三組鍵位、引擎、模型、標籤都可在設定頁「翻譯快速鍵」區塊自訂 - 已翻譯狀態下按任一快速鍵 → 還原原文 - 翻譯中按任一快速鍵 → 取消翻譯
  • iOS / iPadOS 觸控手勢:在 iPhone / iPad 的 Safari 網頁上,多指輕點頁面即翻譯(等同主要預設快速鍵,再輕點一次還原原文或取消翻譯),多指長按改用次要預設。預設四指,iPhone 單手操作可在設定頁「觸控手勢翻譯」改成三指;容易誤觸發時也可在同處關閉——懸浮按鈕與外接鍵盤快速鍵不受影響
  • YouTube 字幕翻譯:開啟有字幕的影片(人工或自動產生皆可),確認 CC 已開啟,點工具列圖示 → 打開「YouTube 字幕翻譯」開關
  • 自動翻譯指定網站:在設定頁的「自動翻譯網站」名單加入網域,進入該網站自動翻譯(翻譯通知會顯示 [自動翻譯] 前綴)
  • 固定術語表:在設定頁的「術語表」Tab 新增對照詞條,翻譯時會強制使用你指定的譯名
  • 術語表一致化:在工具列圖示或設定頁開啟「術語表一致化」,長文翻譯會先建立專有名詞對照表
  • 編輯譯文:翻譯完成後,在工具列圖示點「編輯譯文」可直接修改頁面上的譯文。編輯時頁面下方會出現浮動工具列,可逐段「復原」剛才的修改、按「完成」結束編輯

翻譯快速鍵與預設

Shinkansen 提供三組可自訂的翻譯預設,各綁一個快速鍵:

| 快速鍵 | 預設引擎 | 預設模型 | 適合場景 | |--------|----------|----------|----------| | Alt+S / Option+S | Gemini | Flash Lite($0.25 / $1.50) | 日常閱讀,最省 | | Alt+A / Option+A | Gemini | 3.8 Flash($0.75 / $3.75) | 重要文章,品質優先 | | Alt+D / Option+D | Google Translate | — | 不需 API Key、速度快、完全免費 |

可以在設定頁「翻譯快速鍵」區塊自訂:每組 preset 的引擎(Gemini / Google Translate)、模型(Flash Lite / Flash / Pro / 自訂)、顯示標籤都可以改。鍵位本身也可直接在同一區塊自訂——點該組右上方的鍵位欄位,再按下想要的組合鍵即可(Chrome 用 ⌥ Option 或 ⌃ Control;Safari 含 Mac/iPad/iPhone 請用 ⌃ Control——iOS Safari 不會把 ⌥/⌘ 傳給網頁,設定頁會自動依瀏覽器顯示可用的鍵,按 ESC 取消),iPad 外接鍵盤也能改。也可在 Chrome chrome://extensions/shortcuts、Firefox about:addons 調整內建預設鍵

統一的取消/還原行為:

  • 翻譯中按任一快速鍵 → 立即取消翻譯
  • 已翻譯狀態下按任一快速鍵 → 還原原文(不分用哪個 preset 翻的)
跨 tab 延續翻譯:在 tab A 按快速鍵翻譯後,從 A 點連結開新 tab B(按住 Cmd(Mac)/ Ctrl(Windows)點連結、target="_blank" 或 window.open),B 會自動翻譯且繼承同一組 preset——讓使用者可以一路按連結讀下去不用每個 tab 都按快速鍵。新 tab 再開新 tab 也繼續;手動打網址 / 從 bookmark 開 / 從外部 app 開的 tab 不繼承(openerTabId 為空)。按任一組快速鍵還原只影響當前 tab,不影響樹中其他 tab。

Google Translate 翻譯引擎

Shinkansen 支援 Google Translate 作為第二翻譯引擎:

適合場景:大量瀏覽英文論壇、新聞、商品頁等「讀懂意思就好」的內容,用 Google MT 省 API 費用;需要精準翻譯(文學、學術文章、專有名詞處理)時切 Gemini。

Google Docs 翻譯

Google Docs 的編輯畫面使用 Canvas 渲染文字,一般的網頁翻譯擴充功能無法存取其內容。Shinkansen 會自動偵測 Google Docs 頁面,並採用以下流程:

  1. 在 Google Docs 編輯頁面按下 Option + S(或點工具列圖示的「翻譯本頁」)
  2. Shinkansen 會自動在新分頁開啟同一份文件的「行動版閱讀模式」(mobilebasic)
  3. 新分頁載入完成後自動開始翻譯,不需再按一次
注意事項:你必須有該文件的檢視權限。「行動版閱讀模式」是純閱讀,不會影響原始文件。

文件翻譯(PDF / EPUB / Word / TXT / Markdown / HTML / 字幕檔)

點工具列 Shinkansen 圖示 → 「翻譯文件」,開啟獨立分頁後把 PDF、EPUB、Word(.docx)、TXT、Markdown、HTML 或字幕檔(SRT / WebVTT / ASS)拖進頁面即可整份翻譯。檔案完全在你的瀏覽器本機解析,除了送給翻譯引擎的文字之外不上傳任何內容。唯一的例外是目標語言為簡體中文 / 日文 / 韓文的 PDF 翻譯:第一次會從專案網站下載對應字型(約 10–20 MB,只下載一次,之後離線可用),請求不含任何文件內容。

PDF 翻譯:

  • 保留原版面:解析 PDF 版面重建段落(欄位、表格、清單、圖說),譯文按原位置渲染
  • 線上閱讀器:翻譯完成後原文與譯文左右對照,捲動同步
  • 下載譯文 PDF:譯文直接寫在原頁面版面上(內嵌繁中字型),下載 <原檔名>-shinkansen.pdf 離線閱讀或轉存
  • 指定翻譯頁數:解析後可填起訖頁碼只翻其中一段,長篇報告 / 手冊不必整份送翻;閱讀器與下載的 PDF 仍是完整文件,範圍外的頁維持原文
  • 上限:300 頁 / 50 MB;純掃描影像(需 OCR)與加密 PDF 不支援
EPUB 電子書翻譯(beta):
  • 全書術語表:翻譯前掃描全書抽出人名 / 地名 / 術語對照表(含暱稱、簡稱、姓氏單獨出現等變體),過目編輯後全程凍結,確保譯名跨章節一致;譯名寫純中文就只輸出中文(模型自行補上的「(原文)」會被清掉),要附原文對照就把譯名寫成「譯名(原文)」並勾「對照一次」;可匯出 / 匯入 JSON,也可匯入外部整理的 CSV(兩欄「原文,譯名」,容許表頭列與引號跳脫),系列作續集可重用前作譯名
  • 章節選翻:解析後列出章節清單(含每章字數與預估費用),先翻一兩章驗品質再續翻,已翻章節走快取不重付
  • 譯後一致性掃描:每輪翻譯完成自動偵測「同一原文多譯名」漂移,可一鍵統一譯名並回填術語表
  • 預覽與編輯:逐章與全書預覽、段落點擊即改、搜尋取代、原文對照顯示
  • 工作階段自動存檔:翻譯進度、術語表、累計費用整包存在瀏覽器本機,關頁重開自動還原,也可匯出成檔案在另一台電腦匯入接續
  • 譯本下載:譯文寫回原書結構(CSS / 圖片 / 字型與未翻章節原樣保留),可選單語譯文或雙語對照版;上限 100 MB,DRM 書不支援
Word(.docx)檔案翻譯:
  • 譯文寫回原檔:版面、樣式、字型、圖片、表格全部由 Word 自身維持——粗斜體、底線、色字、螢光標記、超連結、清單編號、書籤都原樣保留,下載 <原檔名>-shinkansen.docx 直接用 Word 開啟編輯
  • 章節選翻:依標題樣式(標題 1 / 標題 2)切章出章節勾選清單;頁首頁尾、註腳、文件註解各自成章可獨立勾選,註解內容也會翻譯
  • 目錄與頁碼欄位不會壞:PAGE / 目錄等 Word 欄位原樣保留,翻完在 Word 更新欄位即以譯後標題重算
  • 單語或雙語對照:雙語版原文段落保留、譯文段落接在每段後面(-shinkansen-dual.docx),切換重新下載不重翻
  • 與 EPUB 同一套管線:全書術語表、譯後一致性掃描、預覽編輯、工作階段自動存檔、費用預估全部沿用
  • 限制:上限 100 MB;加密檔與含未接受追蹤修訂的檔案會擋下提示;舊版 .doc 不支援
TXT / Markdown / HTML 檔案翻譯: