🎯 PPT Translator

保持排版翻譯 PPT，支援任意語言對。

核心原理

Agent Loop（渲染驗證）：

1. 提取 PPT 文字 + 樣式
2. LLM 翻譯（保證準確）
3. 寫回 PPT（python-pptx）
4. LibreOffice 渲染成真實 PNG
5. Vision 模型檢測文字溢位
6. 有溢位 → 縮字號 15% → 回步驟 3
7. 通過 → 輸出最終 PPTX

依賴

• python-pptx（pip）
• libreoffice（yum/apt）

使用方法

python3 scripts/translate.py \
  --input /path/to/file.pptx \
  --output /path/to/output.pptx \
  --translations '{"原文": "translation", ...}' \
  --max-iter 5

Agent 呼叫流程

1. 使用者傳送 PPTX 檔案
2. Agent 提取所有文字 → 翻譯（自己翻譯或呼叫 LLM）
3. 呼叫 scripts/translate.py 執行渲染驗證迴圈
4. 迴圈完成後將輸出 PPTX 發回使用者

輸出

• 最終 PPTX 檔案（可編輯）
• 渲染驗證 PNG（可選，用於確認）
• 迭代日誌（幾輪收斂、最終字號縮放比）

注意事項

來源於7w4.net。

• LibreOffice 首次啟動較慢（~5s），之後正常
• 字號縮放是全域性的（所有 shape 等比縮），未來可最佳化為 per-shape
• 不支援 .ppt（老格式），僅支援 .pptx

這個 PPT 翻譯工具質量不錯，核心設計實用，文件清晰易懂，能有效處理翻譯後的排版問題。不過功能範圍較窄，只支援較新的 pptx 格式，不支援老版本；某些複雜排版情況下可能出現文字溢位。使用前需要了解它的能力和限制。整體來說是個靠譜的翻譯工具，但可能不適合所有 PPT 檔案。