什麼是墨渡
語言、背景知識、時代距離，都會把人擋在一本好書外面。墨渡用你自己的模型，把整本書翻成你的語言、在你需要的地方補上背景，讓一本固定的書，變成為你準備的版本。墨渡主打四大特色：
模型訂閱／API 整合
翻譯的錢直接付給模型商。墨渡不經手、不抽成，也不記錄你翻了什麼。
已經付 Claude 或 ChatGPT 月費？直接用本機登入的 Claude Code / Codex 翻譯，不用另外申請 API key。
任何 OpenAI 相容端點的 key 貼一次，存進 macOS 鑰匙圈，不落設定檔、不上傳。
跑本機模型就完全離線、零 API 費用；墨渡自動偵測，不用任何設定。
客製化翻譯
客製化眉批
翻譯不是唯一的事。告訴墨渡你是誰、為什麼讀這本書。它會先讀完整章，只挑值得停留的段落落註：有的放在段落之後延伸，有的放在段落之前鋪墊，其餘段落不落註。全書翻完再統一校閱一次，去掉重複和前後不一。換一本書、換一個讀者，眉批就完全不同：
CLI 與自動化
裝好 CLI，你的 agent 就能直接動手：估算成本、翻整本書、產生眉批，或先跟你討論這本書值得註些什麼，再動工。
內建 MCP server，一行指令接上 Claude Code 或任何支援 MCP 的 agent。書籍任務從此進入你的 workflow：翻整個書庫、為不同讀者出不同眉批版，全程不用守著畫面。
# 接上你的 agent（MCP）
claude mcp add translatus -- translatus mcp
# 之後就可以直接說：
#「幫我估一下翻完這本書要多少錢」
#「用專家模式翻，翻完跟我說」
#「這本書照我的背景，先列眉批計畫給我看」
如何安裝
Homebrew 建置需時約一分鐘；也可以從 GitHub Releases 下載預編譯執行檔（macOS / Linux），或用 Rust 從原始碼安裝。CLI 就是完整的墨渡，沒有閹割版。
常見問題
引擎與 CLI 免費且開源（MIT）。翻譯與眉批需要 LLM，模型費用由你自己的訂閱、API key 或本機 Ollama 支付，墨渡不經手、不加價，開始前會先給你成本估算。
不會。解析、快取、重組全部在你的電腦上完成；書的內容只在翻譯時分批送往你自己設定的模型端點。API key 存在 macOS 鑰匙圈。
目前支援 EPUB 與 TXT，匯出可選單語、雙語對照與眉批版。目標語言不限清單，任何模型會的語言都可以。介面有繁中、简中、English、日本語、한국어。
如果你本來就付 Claude 或 ChatGPT（Codex）的月費，墨渡可以透過你本機已登入的官方 CLI 來翻譯，不需要另外的 API key。注意：Anthropic 的服務條款對第三方使用訂閱額度有限制，此路徑可能隨時失效；最穩定的路徑是 API key 或 Ollama。
引擎與 CLI 是純 Rust，可在各平台編譯，Releases 亦提供 macOS 與 Linux 預編譯檔。Windows 預編譯與更多書檔格式在規劃中，這正是開源社群可以幫上忙的地方。