英文技術(shù)書(shū)并不是讀不懂但讀完整本通常還是比母語(yǔ)慢。這件事很容易被低估。平時(shí)查一段文檔、看一個(gè) Stack Overflow 回答英語(yǔ)不會(huì)構(gòu)成明顯障礙可當(dāng)閱讀變成幾百頁(yè)的長(zhǎng)期任務(wù)持續(xù)的語(yǔ)言切換會(huì)占掉不少注意力。我們做Translate Technical Books最初只是想解決這個(gè)樸素的問(wèn)題能不能把自己有權(quán)處理的英文技術(shù)書(shū)穩(wěn)定地轉(zhuǎn)成真正適合閱讀的中文版本項(xiàng)目地址https://github.com/cfodes/translate-technical-books直接讓模型翻譯 PDF為什么不夠第一次嘗試的人很自然會(huì)想到提取 PDF 文本翻譯再合并。普通文章也許可以這樣做技術(shù)書(shū)卻很容易出問(wèn)題。代碼、命令行輸出、公式、表格和圖片都依賴結(jié)構(gòu)PDF 提取到的字符順序不一定就是人的閱讀順序代碼圍欄、圖注關(guān)系和標(biāo)題層級(jí)也可能已經(jīng)丟失。更麻煩的是模型會(huì)努力把損壞的輸入翻譯成“看起來(lái)正?！钡闹形?。如果缺了一個(gè)參數(shù)、斷了一行公式成品未必會(huì)主動(dòng)提醒你。因此這個(gè)項(xiàng)目把工作分成了兩步。第一步不是翻譯而是得到可信源稿translate-technical-book-parser-first負(fù)責(zé)解析 PDF。它會(huì)比較 Marker、Docling 與 PyMuPDF4LLM 的結(jié)果并在出現(xiàn)分歧時(shí)回到原 PDF 頁(yè)面尋找證據(jù)。只有結(jié)構(gòu)、哈希和頁(yè)覆蓋檢查通過(guò)才會(huì)得到后續(xù)使用的 canonical Markdown。如果輸入本身就是結(jié)構(gòu)良好的 Markdown 或 EPUB這一步可以簡(jiǎn)單很多主要由本地確定性腳本完成。第二步才是翻譯translate-technical-book把已經(jīng)通過(guò)檢查的 Markdown 按結(jié)構(gòu)切分。代碼、公式、API、路徑、鏈接和圖片引用會(huì)被保護(hù)每個(gè)分塊翻譯后單獨(dú)檢查再合并成整本書(shū)。這樣設(shè)計(jì)不是為了把流程搞復(fù)雜而是為了讓它可以中斷續(xù)跑也可以只重試失敗的部分。一本幾百頁(yè)的書(shū)不應(yīng)該因?yàn)樽詈笠粋€(gè)章節(jié)出錯(cuò)就從頭再來(lái)一次。最終保留中文 Markdown 作為可編輯主版本需要時(shí)再構(gòu)建 EPUB、HTML 或 PDF。我們已經(jīng)跑過(guò)哪些規(guī)模開(kāi)發(fā)期間我們用三個(gè)匿名的完整技術(shù)書(shū)樣本驗(yàn)證了整套流程共 679 個(gè)翻譯分塊最終自動(dòng) QA 為 679/679。為了方便比較README 使用 2026-08-10 的gpt-5.6-terra價(jià)格重新折算三個(gè)樣本的 Standard 干凈載荷等價(jià)成本分別約為 5.60、5.76 和 10.87 美元Batch/Flex 約為一半。這些不是歷史實(shí)際賬單。真實(shí) agent 運(yùn)行還會(huì)包含工具回顯、失敗重試和重復(fù)上下文。一個(gè)保存了完整日志的樣本Token 是干凈載荷的 3.27 倍。倉(cāng)庫(kù)里保留了完整的計(jì)算口徑方便復(fù)算也避免用一個(gè)過(guò)于漂亮的數(shù)字誤導(dǎo)使用者。如何安裝gitclone gitgithub.com:cfodes/translate-technical-books.gitcdtranslate-technical-booksCODEX_SKILLS_DIR${CODEX_HOME:-$HOME/.codex}/skillsmkdir-p$CODEX_SKILLS_DIRcp-Rtranslate-technical-book$CODEX_SKILLS_DIR/cp-Rtranslate-technical-book-parser-first$CODEX_SKILLS_DIR/最小 Python 依賴python3-mvenv .venv .venv/bin/pipinstall-rrequirements.txtPDF 多解析器依賴單獨(dú)放在requirements-parser.txt中。第一次使用時(shí)建議不要直接處理整本書(shū)先選 20 頁(yè)左右的代表性內(nèi)容并給出明確預(yù)算使用 $translate-technical-book-parser-first 把 book.pdf 轉(zhuǎn)成可翻譯的 canonical Markdown。 先處理 20 頁(yè)代表性樣本預(yù)算不超過(guò) 20 次高智能調(diào)用通過(guò) QA 后再規(guī)劃全書(shū)。目前的邊界它還不是“放進(jìn)去一本任意 PDF就能自動(dòng)得到完美中文書(shū)”的工具。復(fù)雜 PDF 的解析依賴比較重項(xiàng)目還缺少公開(kāi)的 parser-first 回歸夾具和完整的一鍵 orchestrator。自動(dòng)檢查也只能證明結(jié)構(gòu)和受保護(hù)內(nèi)容沒(méi)有發(fā)現(xiàn)遺漏不能代替人工語(yǔ)義抽檢。我們希望先把一件事做好不要在證據(jù)不足時(shí)裝作成功。哪里失敗流程就停在哪里哪里需要重試也盡量只重試那一塊。項(xiàng)目采用 MIT License不包含實(shí)驗(yàn)書(shū)籍、譯文或原書(shū)圖片。歡迎試用也歡迎把它擴(kuò)展到新的學(xué)科、語(yǔ)言和解析器。