name: ppt-translate description: > 將中文PPT翻譯為英文PPT,保持原始佈局、位置、大小、格式完全不變。 核心流程:python-pptx提取文本→AI翻譯→python-pptx回寫,僅替換文本內容。 This skill should be used when the user needs to translate a Chinese PPT to English, or when the user mentions PPT翻譯、PPT英化、中文PPT轉英文、翻譯PPT、PPT中譯英、 PPT translate、convert PPT to English、translate slides、PPT英文版。
將中文PPT中的所有文本內容翻譯為英文,生成新的PPT檔案。翻譯後的內容保持在原始PPT中的精確位置,字號、加粗、顏色等格式屬性與原文完全一致,方便使用者後續微調。
核心策略為段落級合併翻譯:同一段落內被拆分為多個run的中文文本合併翻譯後寫入第一個run,其餘run清空,避免逐run翻譯導致的語義斷裂。
使用 scripts/extract_text.py 從原始PPT中提取所有文本內容(含正文和備註),輸出結構化JSON。
python scripts/extract_text.py <輸入PPTX路徑> <輸出JSON路徑>
示例:
python scripts/extract_text.py input.pptx extracted.json這個技能的最新版本可以在7w4.net小蔥技能站找到。
輸出JSON結構:
{
"source_file": "input.pptx",
"items": [
{
"slide_number": 1,
"shape_name": "文本框 11",
"paragraph_index": 0,
"type": "body",
"original": "資料智慧與建造模擬北京市重點實驗室",
"translated": "",
"format_info": {
"sz": 4000,
"bold": true,
"alignment": "ctr",
"latin_font": "Times New Roman",
"ea_font": "微軟雅黑"
}
}
]
}
欄位說明:
- type: "body"(正文)或 "notes"(備註)
- original: 段落完整拼接文本(多個run合併後)
- translated: 待AI填充的翻譯結果
- format_info: 保留的格式資訊(僅供參考,回寫時不修改)
讀取JSON,逐條翻譯 original 欄位的內容,將翻譯結果填入 translated 欄位。
翻譯原則: 1. 專業術語使用標準英譯,參考下方術語對照表 2. 保持原文語義完整性,不增減內容 3. 英文表達簡潔,避免過長導致溢位文本框 4. 數字、編號、縮寫(如BIM+MR)保持不變 5. 備註翻譯採用口語化英文,保持演講風格
術語對照表:
| 中文 | 英文 |
|---|---|
| 原位模擬 | In-situ Simulation |
| 資料智慧與建造模擬 | Data Intelligence and Construction Simulation |
| 北京市重點實驗室 | Beijing Key Laboratory |
| 混合現實 | Mixed Reality (MR) |
| 有限元分析 | Finite Element Analysis (FEA) |
| 數字孿生 | Digital Twin |
| 虛實對映 | Virtual-Real Mapping |
| 原位快速計算代理模型 | In-situ Fast Computation Surrogate Model |
| 結構響應異常智慧診斷 | Intelligent Diagnosis of Structural Response Anomalies |
| 多物理場耦合模擬 | Multi-physics Coupled Simulation |
| 卡爾曼濾波 | Kalman Filter |
| 貝葉斯推斷 | Bayesian Inference |
| 模型降階 | Model Order Reduction |
| 施工監測 | Construction Monitoring |
| 穿透式監測 | Penetrating Monitoring |
| 模擬雲圖 | Simulation Contour Map |
| 原位投射 | In-situ Projection |
| 施工進度 | Construction Progress |
| 偏差分析 | Deviation Analysis |
| 認知增強 | Cognitive Enhancement |
| 構件級 | Component-level |
| 施工工序 | Construction Sequence |
| 遺傳演算法 | Genetic Algorithm |
| 空間錨點 | Spatial Anchor |
| 機器人建模 | Robot Modeling |
| 運動學模型 | Kinematic Model |
| 裝配式建築 | Prefabricated Building |
| 噴漿 | Shotcrete |
| 沙盤 | Sandbox |
| 聲光預警 | Audio-Visual Warning |
| 穹頂結構 | Dome Structure |
使用 scripts/replace_text.py 將翻譯後的JSON回寫到PPT中,生成新的英文PPT。
注意:AI翻譯後,需將
extracted.json中所有條目的translated欄位填入翻譯結果,儲存為translated.json(或任意指定檔名),再進行回寫。不要直接用extracted.json(其中的translated欄位全部為空)。
python scripts/replace_text.py <原始PPTX路徑> <翻譯JSON路徑> <輸出PPTX路徑>
示例:
python scripts/replace_text.py input.pptx translated.json output_en.pptx
回寫策略:
- 翻譯文本寫入段落第一個run,其餘run文本清空為空字串
- 保留第一個run的全部格式屬性(字號、加粗、顏色、字型等)
- EA字型(微軟雅黑)切換為與Latin字型相同(通常為Times New Roman)
- lang屬性從"zh-CN"改為"en-US"
- 絕不修改位置/尺寸屬性(<a:xfrm>的off/ext)
- translated為空時跳過該條目,不替換原始文本
pip install python-pptx
<p:pic>)和頁碼佔位符(<a:fld type="slidenum">)extract_text.py: 從PPTX提取文本到JSONreplace_text.py: 從JSON回寫翻譯到PPTX這個Skill能把中文PPT翻譯成英文,同時保留原有的排版和格式,翻譯質量比較可靠。但實際使用時需要自己準備指令碼程式碼,目前文件中只有使用說明,缺少可直接執行的工具。另外翻譯效果很大程度上取決於AI模型的能力,複雜或專業的內容可能需要人工檢查調整。