PDF 翻譯
主動聊天模型即為翻譯器。其附帶的指令碼僅負責準備、持久化、渲染與驗證本地 PDF 工作；絕不呼叫模型、提供者 API 或任何需要憑證的服務。預設輸出為純翻譯內容。
相容性邊界
開始前，請先確認主機具備本地 PDF 存取、UTF-8 檔案讀寫、Python 程序執行、shell 存取以及首次執行依賴安裝的權限。若缺少任何一項能力，請停止並回報：Unsupported host: pdf-translate requires local files, UTF-8 read/write, Python, shell access, and first-run setup. 請勿嘗試使用替代方案。
工作流程
從請求中取得目標語言與頁碼範圍。若未指定原始語言，則根據第一個包含文字的頁面推測；僅在任一語言仍然不明確時才進行詢問。使用一個可寫入的 <job-dir> 並執行：
<python> pdf-translate/scripts/run.py doctor --json
<python> pdf-translate/scripts/run.py setup --json
<python> pdf-translate/scripts/run.py prepare --source <pdf> --job-dir <job-dir> --source-lang <code> --target-lang <code> [--pages <range>] [--output-mode translated|bilingual] [--glossary <file>] [--style academic]
<python> pdf-translate/scripts/run.py next --job-dir <job-dir> --json
<active chat model reads batch_path and writes {"translations":[{"id":"...","text":"..."}]} only to the returned job-owned response_path>
<python> pdf-translate/scripts/run.py submit --job-dir <job-dir> --input <batch-response-path>
<重複 next/submit 直到狀態變為 READY_TO_RENDER>
<python> pdf-translate/scripts/run.py render --job-dir <job-dir> --json
<python> pdf-translate/scripts/run.py validate --job-dir <job-dir> --json
對於現有的工作，請執行 <python> pdf-translate/scripts/run.py status --job-dir <job-dir> --json 來取代 prepare，然後從其下一個動作繼續。請嚴格遵循此決策樹：doctor/setup -> prepare 或 status -> next -> 活躍模型翻譯 -> submit -> 重複 -> render -> validate -> 回傳 PDF。render 僅暫存輸出；validate 在所有結構性檢查通過後才會發布。僅回傳成功 validate 所報告的無衝突最終 PDF 路徑，並附上語言學警告以及首/中/尾部的預覽配對以供視覺檢查。在翻譯前請閱讀 翻譯政策，在處理工作 JSON 前請閱讀 工作格式。每當工作提前停止時，請回報 <job-dir>，以便後續任務能從檔案（而非對話記錄）中恢復。