RetexPDF 是做什麼的？
一般請求流程為：輸入 PDF → 完整翻譯 → 通用 arXiv 風格 LaTeX → 編譯成 PDF。請完成這項工作，包括版面分類與翻譯。不需要使用者尋找作者提供的 TeX 原始碼、使用 LaTeX、設定翻譯 API 或執行指令碼。AI 代理負責翻譯；指令碼負責持久化、組合與編譯。提供的 PDF 即為權威版本。
自動準備環境
Windows：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "<skill>/scripts/bootstrap.ps1" -WithPdf
macOS：
bash "<skill>/scripts/bootstrap.sh" ensure --with-pdf
使用回傳 JSON 中的絕對 python 可執行檔。需回傳 status: ready。Bootstrap 會優先重複使用現有的私有環境與相容的已安裝 Python；僅在找不到相容版本時才下載 Python。若明確提供 -PythonPath / --python 則優先使用。受管理的 PDF 環境支援 64 位元的 Python 3.10–3.14。它會在私有環境中安裝固定的 PyMuPDF，並偵測或安裝 Tectonic。請勿修改系統 Python、PATH、shell 設定檔或登錄檔。請勿安裝完整的 TeX 發行版。使用 %LOCALAPPDATA%/RetexPDF 或 ~/Library/Caches/RetexPDF 下的現有快取。
首次使用需要網路存取以下載缺少的依賴項、套件和字型。一般首次使用時，請勿傳遞 -Offline / --offline。Doctor 為唯讀模式；offline 模式明確禁止下載。macOS 的進入點已存在，但仍需原生 Mac 驗證。若環境失敗，請保留具體日誌並盡可能修復；不要引導使用者手動安裝 LaTeX。
選擇輸入路線
- 提供 PDF： 使用 PDF 工作流程、
scripts/pdf_translate.py和assets/arxiv-paper.tex。不要轉向尋找作者 TeX 原始碼或凍結重建的片段。作者原始碼不是必要條件。AI 代理必須分類渲染後的 PDF，並填寫完整的翻譯清單。 - 提供現有 TeX 專案： 使用原始碼清單 和
scripts/translation_ledger.py。原始的 TeX 數學公式可以直接保留。除非使用者要求使用通用模板，否則保留提供的 document class。 - 提供論文連結/ID： 取得指定的 PDF。可選配對原始碼；切勿在未告知的情況下替換為不同版本。
使用使用者要求的目標語言與地區設定。從對話中推斷已確定的目標；僅在真正未指定時才詢問。中文並非固定目標。為要求的書寫系統選擇合適的字型與語言支援。
不可協商的內容規則
- 翻譯整篇論文，包括所有段落、標題、圖表說明、一般腳註、致謝、演算法、證明與附錄。即使使用者要求「查看效果」，仍表示整篇論文，除非明確要求僅提供樣本。絕不摘要、縮短推導過程，或將某個章節替換為省略內容的說明。
- 完整保留作者區塊：姓名、順序、所屬機構文字、上標、貢獻/通訊作者註記與電子郵件。保留參考文獻條目與編號。保留資料、識別碼與公式標籤。保留圖表藝術作品與數值；翻譯圖表說明。若使用者要求翻譯藝術作品/表格內部的文字，請新增一個獨立的文字圖層對應工作流程，而非在未告知的情況下視為已翻譯。
- 將每個行內公式保留在其句子中。保留每個展示公式、多行推導與符號。對於 PDF 輸入，將公式/圖表/表格區域複製為向量 PDF 剪輯，包括分數、根號、重音符號與方程式編號。絕不使用影像生成重新繪製數學公式。不要根據不可靠的提取字元順序重建公式。
- 保留原始順序。在翻譯前合併跨頁斷裂的句子。在能夠容納於一頁時，將圖表說明與其對象和演算法保持在一起。使用通用模板重新編排文字；原始座標與原始頁數不是必要條件，除非明確要求。
- 請勿在論文內部添加譯者序言、閱讀說明、省略註記、摘要或任何新內容。技術報告應置於 PDF 外部。
- 在組合之前，持久保留原始版本、完整清單與每個翻譯。每個原始單元都必須有翻譯或明確合法保留的資產。切勿使用未更改散文的回退方式來隱藏未完成的翻譯。上下文長度限制意味著應儲存並恢復待處理的單元，而非省略它們。
- 字形清單僅證明對提取字形的機械性覆蓋。請將渲染後的原始頁面與清單進行比較，以發現圖形、掃描文字、多欄閱讀順序與受損的提取。將每個翻譯單元與其完整原始版本進行比較。
reviewed標記記錄的是實際工作，並非用來跳過建置的捷徑。
PDF 執行
遵循命令與 JSON 格式的詳細參考：
extract：保留確切的原始 PDF、所有頁面、字形、字型與位置。- 檢查頁面渲染；在
layout.json中分類作者區塊、圖、表、圖表說明與展示數學公式。修正行內數學公式的分段與連接。僅在將頁面的可見內容與其清單進行比較後，才將其標記為已審閱。包含所有沒有原生文字的圖形內容。 prepare --target-language ...：分配翻譯 ID，並凍結版面、散文與向量片段。每個原生字形必須被確切地記錄一次。pending：讀取帶有上下文的完整單元。分批翻譯，並在實際比較原始版本後，使用put --file ... --reviewed儲存。數學公式佔位符必須保持完整且有序。使用一致的詞彙表。build --output <new-project>：組合全新的main.tex與fragments.pdf，然後自動編譯。缺少翻譯、原始版本/版面變更、缺少公式符號或未審閱的單元/頁面會中止建置。切勿僅使用編譯器繞過這些檢查來完成未完成的翻譯。- 渲染並檢查實際編譯後的 PDF。修復裁剪、重疊、錯誤字形、分離的圖表說明與損壞的行內公式。驗證每個原始頁面與章節（包括最後的附錄）都有對應的輸出內容。僅在完成所有工作後才交付。
版面變更需要再次執行 prepare。翻譯 ID 可能會改變：透過凍結的原始版本雜湊值與頁面來協調舊行，然後檢查對應關係。切勿盲目複製舊 ID 金鑰行，或重新計算雜湊值以核准已變更的內容。
對於掃描檔案或文字提取受損的情況，請在持久化清單中新增 OCR/視覺轉錄，然後再進行翻譯。此指令碼的原生提取器並非 OCR 引擎，不得將純影像頁面視為空白。若某個區塊尚無法讀取，請繼續嘗試恢復它；切勿在未告知的情況下省略它，或聲稱輸出完整。
字型、編譯與交付
內建模板為通用單欄學術文章，適用於 arXiv 風格的輸出，並非獨特的官方 arXiv 模板。中文使用 ctex 搭配 Fandol 字型（預設）。其他書寫系統可提供 --language-setup 參數，內含正確的字型/語言套件；請使用代表性的標題、段落與公式來確認覆蓋範圍、字型形狀與方向。不要僅將目標語言參數視為字型已設定完成的證明。
Tectonic 會自動下載缺少的套件/字型。修復產生的工作副本或產生器中的編譯器錯誤，方法是修改內容，而非刪除內容。failed 不是可交付的結果；review_required 表示 PDF 已存在，但其警告需要解決。compiled 僅確認編譯成功，而非語義或視覺上的完整性。對於僅需編譯原始碼的請求，請直接使用 retex.ps1 -Action Compile 或 retex.sh compile。Shell-escape 保持停用狀態。
將作業/中繼檔案保留在 RetexPDF 工作快取或使用者指定的工作目錄中。交付完整的翻譯後 PDF 與可編輯的組合專案；保留原始快照、版面、翻譯清單與覆蓋率報告以供追溯。請勿將論文的資料或翻譯打包到已安裝的技能中。在論文外部揭露具體的剩餘限制，包括適當時保留在圖表內部的原始語言標籤。切勿保證機械性檢查能完美應對所有可能的 PDF 語義翻譯。