從一本書，到一本你的書。
墨渡是免費開源的 CLI，把整本 EPUB 翻成你的語言，並照你的偏好寫下註解。免費、開源、跑在你的 Mac 本地，不用擔心隱私。
開始安裝
brew install doka-software/tap/translatus什麼是墨渡
書印出來是固定的；讀它的人不是。
語言、背景知識、時代距離，都會把人擋在一本好書外面。墨渡用你自己的模型，把整本書翻成你的語言、在你需要的地方補上背景，讓一本固定的書，變成為你準備的版本。
讀者背景行銷業上班族，英文讀得懂但美國文學讀得少，想知道這本書為什麼被叫作「美國夢」的代表作。
And as the moon rose higher the inessential houses began to melt away until gradually I became aware of the old island here that flowered once for Dutch sailors' eyes.
月亮越升越高，那些可有可無的屋舍漸漸隱去，我慢慢意識到腳下這座古老的島嶼：當年曾在荷蘭水手眼前綻放的、新世界那片鮮綠的胸膛。
註解「美國夢」這個詞比這本書還晚出生。小說 1925 年出版，要到 1931 年歷史學家 James Truslow Adams 才在《美國史詩》裡替它命名，而那一年美國正深陷大蕭條，街上排的是失業與領救濟麵包的長隊。這個詞誕生在夢看起來最不可能實現的時候。
讀者背景做電商營運，正在把出貨流程拆給幾個小組，第一次讀經濟學經典。
The greatest improvement in the productive powers of labour seems to have been the effects of the division of labour.
勞動生產力上最大的改善，似乎都來自分工的效果。
註解史密斯接著舉的是別針工廠：一個人獨力做，一天做不到二十根；十個人拆成十八道工序，平均一人一天四千八百根。他要說的不只是分工比較快，而是分工會改變每個人手上技能的形狀。
讀者背景剛開始帶團隊的工程師，想建立自己的習慣系統，聽說這本自傳是很多方法的原點。
I made a little book, in which I allotted a page for each of the virtues.
我做了一本小冊子，每一項德行分配一頁。
註解這套十三德行的做法是後世習慣追蹤表的雛形：一次只專注一項，其餘維持觀察，做完一輪再重來。富蘭克林自己承認從沒做到完美，他認為價值在於紀錄讓他看見了自己。
皆為真實引擎輸出，實際使用時由你自由決定。
功能
原文翻譯
整本 EPUB 一次翻完，人名與術語從第一章到最後一章維持同一個。
逐段翻，快，適合小說與一般閱讀。
In his blue gardens men and girls came and went like moths among the whisperings and the champagne and the stars.
在他湛藍的庭園裡，男男女女如飛蛾般來去，穿梭於竊竊私語、香檳與星光之間。
相對複雜的翻譯形式。先建立詞彙表再翻譯，翻完再自我校對一輪。受 Andrew Ng 的 translation-agent 啟發。
詞彙表→翻譯→自我校訂→一致性
In his blue gardens men and girls came and went like moths among the whisperings and the champagne and the stars.
在他那片湛藍的庭園裡，男男女女來去如飛蛾，穿行於低語、香檳與星光之間。
情境註解
告訴墨渡你想從這本書裡知道什麼。它會先讀完整章，只在跟你的動機有關的地方停下來寫。動機不同，停的地方就不同。
我想知道的這篇小說底下那個真實的世界：1920 年代殖民地城市的貧富地景是怎麼形成的，這些格局後來又怎麼延續下去。
That really was extravagant, for the little cottages were in a lane to themselves at the very bottom of a steep rise that led up to the house. A broad road ran between. True, they were far too near. They were the greatest possible eyesore, and they had no right to be in that neighbourhood at all. They were little mean dwellings painted a chocolate brown. In the garden patches there was nothing but cabbage stalks, sick hens and tomato cans. The very smoke coming out of their chimneys was poverty-stricken.
這說法未免太誇張了——那些小屋座落在一條自成一格的小巷裡，緊靠著通往宅子的陡坡最低處，中間隔著一條寬闊的馬路。誠然，它們離這裡近得過分了；它們是最礙眼不過的存在，根本沒有資格出現在這一帶。那些低矮簡陋的屋子刷著巧克力棕色的漆，屋前的小圃裡除了高麗菜梗、病懨懨的母雞和番茄罐頭，什麼也沒有。就連從煙囪飄出來的煙，也透著一股窮酸氣。
註解窮巷坐落陡坡最底，隔一條大路才接上宅邸，這樣的地形分布並非偶然——殖民地城市開發初期，地勢較高、排水較好的地段留給有力遷入者興建大宅，低窪地帶則聚集勞工簡屋。這種山丘富、谷地窮的空間邏輯，日後在威靈頓等紐西蘭城市的擴張中持續複製。
我想知道的作者本人的處境怎麼滲進這篇小說：她寫的時候人在什麼狀態，她跟這個場景的真實距離有多遠，典故又是從哪裡來的。
It’s all the fault, she decided, as the tall fellow drew something on the back of an envelope, something that was to be looped up or left to hang, of these absurd class distinctions. Well, for her part, she didn’t feel them. Not a bit, not an atom. . . . Just to prove how happy she was, just to show the tall fellow how at home she felt, and how she despised stupid conventions, Laura took a big bite of her bread-and-butter. She felt just like a work-girl.
都是那些荒謬的階級之見惹的禍，她斷定，眼看著那個高個子在一個信封背面畫著什麼——那是帳篷布要捲起來還是垂下去的示意圖。對她來說，她根本感覺不到這些分別。一點也不，一絲也不……為了證明自己有多快活，為了讓那個高個子看見她是多麼自在、多麼不屑那些愚蠢的規矩，蘿拉大口咬了一口奶油麵包。她覺得自己簡直就像個女工。
註解曼斯菲爾德出身紐西蘭殖民地上流Beauchamp家族，赴倫敦受教育後躋身布倫斯伯里邊緣圈子——既想批判階級體制，又終究置身其中。Laura這句自我開脫，也帶著這種距離感。
我想知道的書裡那些東西到底長什麼樣子。英文句子看得懂，但那個年代的物件、職業和生活方式沒概念，讀完一段腦中沒有畫面。
Four men in their shirt-sleeves stood grouped together on the garden path. They carried staves covered with rolls of canvas, and they had big tool-bags slung on their backs. They looked impressive. Laura wished now that she had not got the bread-and-butter, but there was nowhere to put it, and she couldn’t possibly throw it away.
四名男工只穿著襯衫、捲起袖子，聚攏站在花園小徑上。他們扛著幾根纏著卷卷帆布的長桿，背上斜背著大大的工具袋，看起來頗有氣勢。蘿拉這才後悔手上還拿著那片奶油麵包，偏偏又沒地方放，總不能就這麼扔掉。
註解襯衫捲袖、扛工具袋出場的這幾位，是受雇來搭棚子的臨時工人，跟後面穿戴整齊的雪莉登家人形成明顯對比——那個年代，勞動者的裝束幾乎就是身分的標籤。
Agent 整合
內建 MCP server。在 Claude 或 ChatGPT 的 app 裡裝好之後，直接說話就可以，不用打開終端機。
Claude
幫我把 gatsby.epub 翻成繁體中文
Thought process ›
翻好了，輸出在 gatsby.繁體中文.epub。全書 12 章，人名與術語我對過一輪。要不要順便加上註解？
+Write a message…
安裝
- 安裝墨渡：打開「終端機」（Terminal，在「應用程式 → 工具程式」裡），貼上這一行按 Enter：
裝好之後輸入
brew install doka-software/tap/translatustranslatus，介面就開起來了。
沒有 Homebrew 也可以，到 GitHub Releases 下載對應平台的檔案。
- 串接模型：進到介面選「設定」，第一欄「來源」用左右鍵切換。
- 方式一 · 用你已經在付的訂閱：付過 Claude 或 ChatGPT 月費的話選「訂閱」，直接用本機登入的 Claude Code 或 Codex，不用另外申請 key。
- 方式二 · API 金鑰：任何 OpenAI 相容端點的 key 貼一次，存進 macOS 鑰匙圈，不落設定檔、不上傳。
- 方式三 · 本機 Ollama：完全離線、零 API 費用。墨渡自動偵測，不用任何設定。
翻譯的錢直接付給模型商。墨渡不經手、不抽成，也不記錄你翻了什麼。
- 設定翻譯：回主選單選「翻譯」，挑一本書。要翻成什麼語言、要不要加註解、用哪個模型，全都在這一頁選完。按「繼續」會先算給你看要花多少，確認了才開始跑。
常見問題
- 要先去申請 API key 嗎？
- 不用，而且不用打指令。輸入
translatus進到介面，選「設定」，第一欄「來源」就是訂閱、API 金鑰、本機 Ollama 三選一。已經付 Claude 或 ChatGPT 月費就選訂閱，不申請任何 key；選 Ollama 則零 API 費用、全離線。API key 只是第三條路。 - 我的書會被送去哪？
- 只送去一個地方：你自己設定的模型端點。沒有遙測、沒有分析、沒有回報。
- 翻到一半斷了，或 token 達上限怎麼辦？
- 每個譯好的段落當下就寫進本機快取，不用你做任何事。斷線、按
^C、隔一週再回來都一樣：選書清單會直接標出「已完成 8/12 章」，確認頁只算剩下的章節，進度盤把還原的章節標成「快取」，已翻的段落不會重扣。兩件要先知道的事：換模型或換深度會讓存檔作廢、整本重跑（介面上會先講）；token 額度用完時，已經翻好的一樣留著，但墨渡不會自己停下來等你額度恢復，它會繼續嘗試、翻不動的段落先保留原文，所以額度用完請自己按^C，之後再續跑。 - 墨渡真的完全免費嗎？
- 引擎與 CLI 免費且開源（MIT）。翻譯與註解需要 LLM，模型費用由你自己的訂閱、API key 或本機 Ollama 支付，墨渡不經手、不加價，開始前會先給你成本估算。
支持這個專案
Translatus，墨渡的開源引擎。
墨渡不靠訂閱賺錢。它誕生於一個簡單的念頭：想讀的書不該被語言擋住。書不是單向、制式的表達；它可以為每個讀者客製呈現，同時不修改作者原本的表達。引擎與命令列以 MIT 授權開源、永遠免費。
你可以檢視每一行處理你的書的程式碼，可以自己編譯，可以改造它、轉發它，甚至拿去做自己的產品。書是你的，工具也該是。
歡迎一起維護。回報問題、修一個 bug、補一種語言、加一種格式，任何尺寸的參與都算數。如果你支持這種客製化的閱讀體驗，也歡迎贊助。
贊助之外，一顆 GitHub 星星、一次問題回報、一段使用心得，也都是支持。
- 原始碼與 issue：github.com/doka-software/translatus
- 維護者：@doka-doka（doka.software）
書印出來是固定的；讀它的人不是，今天就試試看。
brew install doka-software/tap/translatus