--- name: pptx description: "簡報創建、編輯和分析。當 Claude 需要處理簡報（.pptx 檔案）時使用：(1) 創建新簡報、(2) 修改或編輯內容、(3) 處理版面、(4) 添加註解或講者備註，或任何其他簡報任務" license: 專有。LICENSE.txt 包含完整條款 --- # PPTX 創建、編輯和分析 ## 概述使用者可能會要求你創建、編輯或分析 .pptx 檔案的內容。.pptx 檔案本質上是一個包含 XML 檔案和其他資源的 ZIP 壓縮檔，你可以讀取或編輯。對於不同的任務，你有不同的工具和工作流程可用。 ## 讀取和分析內容 ### 文字擷取如果你只需要讀取簡報的文字內容，應該將文件轉換為 markdown： ```bash # 將文件轉換為 markdown python -m markitdown path-to-file.pptx ``` ### 原始 XML 存取你需要原始 XML 存取來處理：註解、講者備註、投影片版面、動畫、設計元素和複雜格式。對於這些功能，你需要解壓簡報並讀取其原始 XML 內容。 #### 解壓檔案 `python ooxml\/scripts\/unpack.py ` **注意**：unpack.py 腳本位於專案根目錄的相對路徑 `skills\/pptx\/ooxml\/scripts\/unpack.py`。如果腳本不在此路徑，使用 `find . -name "unpack.py"` 來定位它。 #### 關鍵檔案結構 * `ppt\/presentation.xml` - 主要簡報中繼資料和投影片引用 * `ppt\/slides\/slide{N}.xml` - 個別投影片內容（slide1.xml、slide2.xml 等） * `ppt\/notesSlides\/notesSlide{N}.xml` - 每張投影片的講者備註 * `ppt\/comments\/modernComment_*.xml` - 特定投影片的註解 * `ppt\/slideLayouts\/` - 投影片的版面模板 * `ppt\/slideMasters\/` - 母版投影片模板 * `ppt\/theme\/` - 主題和樣式資訊 * `ppt\/media\/` - 圖片和其他媒體檔案 #### 排版和色彩擷取 **當給予要模仿的範例設計時**：始終先使用以下方法分析簡報的排版和色彩： 1. **讀取主題檔案**：檢查 `ppt\/theme\/theme1.xml` 以獲取色彩（``）和字體（``） 2. **取樣投影片內容**：檢查 `ppt\/slides\/slide1.xml` 以獲取實際字體使用（``）和色彩 3. **搜尋模式**：使用 grep 在所有 XML 檔案中尋找色彩（``、``）和字體引用 ## **不使用模板**創建新 PowerPoint 簡報從頭創建新 PowerPoint 簡報時，使用 **html2pptx** 工作流程將 HTML 投影片轉換為具有精確定位的 PowerPoint。 ### 設計原則 **關鍵**：在創建任何簡報之前，分析內容並選擇適當的設計元素： 1. **考慮主題內容**：這個簡報是關於什麼的？它暗示什麼樣的調性、行業或情緒？ 2. **檢查品牌**：如果使用者提到公司\/組織，考慮他們的品牌色彩和識別 3. **將調色盤與內容匹配**：選擇反映主題的色彩 4. **陳述你的方法**：在撰寫程式碼前解釋你的設計選擇 **要求**： - 在撰寫程式碼前陳述你的內容導向設計方法 - 僅使用網頁安全字體：Arial、Helvetica、Times New Roman、Georgia、Courier New、Verdana、Tahoma、Trebuchet MS、Impact - 透過大小、粗細和色彩創建清晰的視覺層次 - 確保可讀性：強對比、適當大小的文字、乾淨的對齊 - 保持一致：在投影片間重複模式、間距和視覺語言 #### 色彩調色盤選擇 **創意選擇色彩**： - **跳脫預設思維**：什麼色彩真正匹配這個特定主題？避免自動化的選擇。 - **考慮多個角度**：主題、行業、情緒、能量等級、目標受眾、品牌識別（如有提及） - **勇於冒險**：嘗試意想不到的組合——醫療保健簡報不必是綠色，金融不必是海軍藍 - **建構你的調色盤**：選擇 3-5 個協調的色彩（主色 + 輔助色調 + 強調色） - **確保對比**：文字在背景上必須清晰可讀 **範例色彩調色盤**（使用這些激發創意——選擇一個、調整它，或創建你自己的）： 1. **經典藍**：深海軍藍（#1C2833）、石板灰（#2E4053）、銀色（#AAB7B8）、米白（#F4F6F6） 2. **青綠與珊瑚**：青綠（#5EA8A7）、深青綠（#277884）、珊瑚（#FE4447）、白色（#FFFFFF） 3. **大膽紅**：紅色（#C0392B）、亮紅（#E74C3C）、橙色（#F39C12）、黃色（#F1C40F）、綠色（#2ECC71） 4. **溫暖腮紅**：淡紫（#A49393）、腮紅（#EED6D3）、玫瑰（#E8B4B8）、奶油色（#FAF7F2） 5. **勃艮第奢華**：勃艮第（#5D1D2E）、深紅（#951233）、鏽色（#C15937）、金色（#997929） 6. **深紫與翡翠**：紫色（#B165FB）、深藍（#181B24）、翡翠（#40695B）、白色（#FFFFFF） 7. **奶油與森林綠**：奶油色（#FFE1C7）、森林綠（#40695B）、白色（#FCFCFC） 8. **粉紅與紫色**：粉紅（#F8275B）、珊瑚（#FF574A）、玫瑰（#FF737D）、紫色（#3D2F68） 9. **萊姆與梅子**：萊姆（#C5DE82）、梅子（#7C3A5F）、珊瑚（#FD8C6E）、藍灰（#98ACB5） 10. **黑與金**：金色（#BF9A4A）、黑色（#000000）、奶油色（#F4F6F6） 11. **鼠尾草與赤陶**：鼠尾草（#87A96B）、赤陶（#E07A5F）、奶油色（#F4F1DE）、炭灰（#2C2C2C） 12. **炭灰與紅**：炭灰（#292929）、紅色（#E33737）、淺灰（#CCCBCB） 13. **活力橙**：橙色（#F96D00）、淺灰（#F2F2F2）、炭灰（#222831） 14. **森林綠**：黑色（#191A19）、綠色（#4E9F3D）、深綠（#1E5128）、白色（#FFFFFF） 15. **復古彩虹**：紫色（#722880）、粉紅（#D72D51）、橙色（#EB5C18）、琥珀（#F08800）、金色（#DEB600） 16. **復古大地**：芥末（#E3B448）、鼠尾草（#CBD18F）、森林綠（#3A6B35）、奶油色（#F4F1DE） 17. **海岸玫瑰**：老玫瑰（#AD7670）、海狸（#B49886）、蛋殼（#F3ECDC）、灰綠（#BFD5BE） 18. **橙與青綠**：淺橙（#FC993E）、灰青綠（#667C6F）、白色（#FCFCFC） #### 視覺細節選項 **幾何圖案**： - 對角線分隔而非水平 - 不對稱欄寬（30\/70、40\/60、25\/75） - 90° 或 270° 旋轉的文字標題 - 圖片的圓形\/六邊形框架 - 角落的三角形強調形狀 - 重疊形狀增加深度 **邊框與框架處理**： - 只在一側的粗單色邊框（10-20pt） - 對比色的雙線邊框 - 角括號而非完整框架 - L 形邊框（上+左或下+右） - 標題下的底線強調（3-5pt 粗） **排版處理**： - 極端尺寸對比（72pt 標題 vs 11pt 正文） - 寬字距的全大寫標題 - 超大展示字型的編號章節 - 資料\/統計\/技術內容使用等寬字體（Courier New） - 密集資訊使用窄字體（Arial Narrow） - 強調用的空心文字 **圖表與資料樣式**： - 單色圖表搭配單一強調色用於關鍵資料 - 水平長條圖而非垂直 - 點狀圖而非長條圖 - 極簡網格線或完全沒有 - 資料標籤直接在元素上（不用圖例） - 關鍵指標使用超大數字 **版面創新**： - 帶文字覆蓋的全出血圖片 - 用於導覽\/上下文的側欄（20-30% 寬度） - 模組化網格系統（3×3、4×4 區塊） - Z 模式或 F 模式內容流 - 色塊上的浮動文字框 - 雜誌風格多欄版面 **背景處理**： - 佔投影片 40-60% 的純色區塊 - 漸層填充（僅垂直或對角） - 分割背景（兩種色彩，對角或垂直） - 邊緣到邊緣的色帶 - 作為設計元素的負空間 ### 版面提示 **創建帶圖表或表格的投影片時：** - **雙欄版面（建議）**：使用橫跨全寬的標題，然後在下方分兩欄——文字\/項目符號在一欄，精選內容在另一欄。這提供更好的平衡，使圖表\/表格更易讀。使用不等欄寬的 flexbox（例如 40%\/60% 分割）為每種內容類型優化空間。 - **全投影片版面**：讓精選內容（圖表\/表格）佔據整張投影片以獲得最大影響力和可讀性 - **絕不垂直堆疊**：不要在單欄中將圖表\/表格放在文字下方——這會導致可讀性差和版面問題 ### 工作流程 1. **必須 - 讀取整個檔案**：從頭到尾完整讀取 [`html2pptx.md`](html2pptx.md)。**讀取此檔案時絕不設定任何範圍限制。** 讀取完整檔案內容以獲取詳細語法、關鍵格式規則和最佳實踐，然後再進行簡報創建。 2. 為每張投影片創建具有適當尺寸的 HTML 檔案（例如 16:9 為 720pt × 405pt） - 對所有文字內容使用 `

`、`

`-`

`、`
`、`
` - 對將添加圖表\/表格的區域使用 `class="placeholder"`（以灰色背景渲染以便可見） - 關鍵：首先使用 Sharp 將漸層和圖示柵格化為 PNG 圖片，然後在 HTML 中引用 - 版面：對於帶圖表\/表格\/圖片的投影片，使用全投影片版面或雙欄版面以獲得更好的可讀性 3. 創建並執行 JavaScript 檔案，使用 [`html2pptx.js`](scripts\/html2pptx.js) 程式庫將 HTML 投影片轉換為 PowerPoint 並儲存簡報 - 使用 `html2pptx()` 函數處理每個 HTML 檔案 - 使用 PptxGenJS API 將圖表和表格添加到佔位區域 - 使用 `pptx.writeFile()` 儲存簡報 4. 視覺驗證：生成縮圖並檢查版面問題 - 創建縮圖網格：`python scripts\/thumbnail.py output.pptx workspace\/thumbnails --cols 4` - 讀取並仔細檢查縮圖以發現： - 文字截斷：文字被標題列、形狀或投影片邊緣截斷 - 文字重疊：文字與其他文字或形狀重疊 - 定位問題：內容太靠近投影片邊界或其他元素 - 對比問題：文字與背景對比不足 - 如發現問題，調整 HTML 邊距\/間距\/色彩並重新生成簡報 - 重複直到所有投影片視覺正確 ## 編輯現有 PowerPoint 簡報編輯現有 PowerPoint 簡報中的投影片時，你需要使用原始 Office Open XML（OOXML）格式。這涉及解壓 .pptx 檔案、編輯 XML 內容，然後重新打包。 ### 工作流程 1. 必須 - 讀取整個檔案：從頭到尾完整讀取 [`ooxml.md`](ooxml.md)（約 500 行）。讀取此檔案時絕不設定任何範圍限制。讀取完整檔案內容以獲取 OOXML 結構和編輯工作流程的詳細指導，然後再進行任何簡報編輯。 2. 解壓簡報：`python ooxml\/scripts\/unpack.py ` 3. 編輯 XML 檔案（主要是 `ppt\/slides\/slide{N}.xml` 和相關檔案） 4. 關鍵：每次編輯後立即驗證並在繼續前修復任何驗證錯誤：`python ooxml\/scripts\/validate.py --original ` 5. 打包最終簡報：`python ooxml\/scripts\/pack.py ` ## 使用模板創建新 PowerPoint 簡報當你需要創建遵循現有模板設計的簡報時，你需要複製和重新排列模板投影片，然後替換佔位內容。 ### 工作流程 1. 擷取模板文字並創建視覺縮圖網格： * 擷取文字：`python -m markitdown template.pptx > template-content.md` * 讀取 `template-content.md`：讀取整個檔案以理解模板簡報的內容。讀取此檔案時絕不設定任何範圍限制。 * 創建縮圖網格：`python scripts\/thumbnail.py template.pptx` * 參見[創建縮圖網格](#創建縮圖網格)章節了解更多細節 2. 分析模板並將清單儲存到檔案： * 視覺分析：審查縮圖網格以理解投影片版面、設計模式和視覺結構 * 創建並儲存模板清單檔案到 `template-inventory.md`，包含： ```markdown # 模板清單分析投影片總數：[數量] 重要：投影片從 0 開始索引（第一張投影片 = 0，最後一張投影片 = 數量-1） ## [類別名稱] - 投影片 0：[版面代碼（如有）] - 描述\/用途 - 投影片 1：[版面代碼] - 描述\/用途 - 投影片 2：[版面代碼] - 描述\/用途 [... 每張投影片都必須單獨列出其索引 ...] ``` * 使用縮圖網格：參考視覺縮圖以識別： - 版面模式（標題投影片、內容版面、章節分隔頁） - 圖片佔位位置和數量 - 投影片組間的設計一致性 - 視覺層次和結構 * 此清單檔案是下一步選擇適當模板所必需的 3. 根據模板清單創建簡報大綱： * 審查步驟 2 中的可用模板。 * 為第一張投影片選擇介紹或標題模板。這應該是前幾個模板之一。 * 為其他投影片選擇安全的、基於文字的版面。 * 關鍵：將版面結構與實際內容匹配： - 單欄版面：用於統一敘事或單一主題 - 雙欄版面：僅當你確實有 2 個不同的項目\/概念時使用 - 三欄版面：僅當你確實有 3 個不同的項目\/概念時使用 - 圖片 + 文字版面：僅當你有實際圖片要插入時使用 - 引言版面：僅用於人物的實際引言（帶出處），絕不用於強調 - 絕不使用佔位多於你內容的版面 - 如果你有 2 個項目，不要強制放入 3 欄版面 - 如果你有 4+ 個項目，考慮分成多張投影片或使用列表格式 * 在選擇版面前計算你的實際內容數量 * 驗證所選版面中的每個佔位都將填入有意義的內容 * 選擇一個選項代表每個內容區段的最佳版面。 * 儲存 `outline.md`，包含內容和利用可用設計的模板對應 * 模板對應範例： ``` # 要使用的模板投影片（從 0 開始索引） # 警告：驗證索引在範圍內！有 73 張投影片的模板索引為 0-72 # 對應：大綱中的投影片編號 -> 模板投影片索引 template_mapping = [ 0, # 使用投影片 0（標題\/封面） 34, # 使用投影片 34（B1：標題和正文） 34, # 再次使用投影片 34（複製第二個 B1） 50, # 使用投影片 50（E1：引言） 54, # 使用投影片 54（F2：結尾 + 文字） ] ``` 4. 使用 `rearrange.py` 複製、重新排序和刪除投影片： * 使用 `scripts\/rearrange.py` 腳本創建按所需順序排列投影片的新簡報： ```bash python scripts\/rearrange.py template.pptx working.pptx 0,34,34,50,52 ``` * 腳本自動處理複製重複的投影片、刪除未使用的投影片和重新排序 * 投影片索引從 0 開始（第一張投影片是 0，第二張是 1 等） * 相同的投影片索引可以出現多次以複製該投影片 5. 使用 `inventory.py` 腳本擷取所有文字： * 執行清單擷取： ```bash python scripts\/inventory.py working.pptx text-inventory.json ``` * 讀取 text-inventory.json：讀取整個 text-inventory.json 檔案以理解所有形狀及其屬性。讀取此檔案時絕不設定任何範圍限制。 * 清單 JSON 結構： ```json { "slide-0": { "shape-0": { "placeholder_type": "TITLE", \/\/ 或 null 表示非佔位符 "left": 1.5, \/\/ 位置（英寸） "top": 2.0, "width": 7.5, "height": 1.2, "paragraphs": [ { "text": "段落文字", \/\/ 可選屬性（僅當非預設時包含）： "bullet": true, \/\/ 偵測到明確的項目符號 "level": 0, \/\/ 僅當 bullet 為 true 時包含 "alignment": "CENTER", \/\/ CENTER、RIGHT（非 LEFT） "space_before": 10.0, \/\/ 段落前間距（點） "space_after": 6.0, \/\/ 段落後間距（點） "line_spacing": 22.4, \/\/ 行距（點） "font_name": "Arial", \/\/ 來自第一個 run "font_size": 14.0, \/\/ 點 "bold": true, "italic": false, "underline": false, "color": "FF0000" \/\/ RGB 色彩 } ] } } } ``` * 關鍵功能： - 投影片：命名為「slide-0」、「slide-1」等 - 形狀：按視覺位置排序（上到下、左到右）為「shape-0」、「shape-1」等 - 佔位類型：TITLE、CENTER_TITLE、SUBTITLE、BODY、OBJECT 或 null - 預設字型大小：`default_font_size` 以點為單位，從版面佔位擷取（可用時） - 投影片編號已過濾：SLIDE_NUMBER 佔位類型的形狀自動從清單中排除 - 項目符號：當 `bullet: true` 時，`level` 始終包含（即使為 0） - 間距：`space_before`、`space_after` 和 `line_spacing` 以點為單位（僅當設定時包含） - 色彩：`color` 用於 RGB（例如「FF0000」），`theme_color` 用於主題色彩（例如「DARK_1」） - 屬性：輸出中僅包含非預設值 6. 生成替換文字並將資料儲存到 JSON 檔案根據前一步的文字清單： - 關鍵：首先驗證清單中存在哪些形狀——只引用實際存在的形狀 - 驗證：replace.py 腳本將驗證替換 JSON 中的所有形狀都存在於清單中 - 如果你引用不存在的形狀，你會收到顯示可用形狀的錯誤 - 如果你引用不存在的投影片，你會收到指示投影片不存在的錯誤 - 腳本退出前會一次顯示所有驗證錯誤 - 重要：replace.py 腳本內部使用 inventory.py 識別所有文字形狀 - 自動清除：除非你為它們提供「paragraphs」，否則清單中的所有文字形狀都將被清除 - 為需要內容的形狀添加「paragraphs」欄位（不是「replacement_paragraphs」） - 替換 JSON 中沒有「paragraphs」的形狀將自動清除其文字 - 帶項目符號的段落將自動左對齊。當 `"bullet": true` 時不要設定 `alignment` 屬性 - 為佔位文字生成適當的替換內容 - 使用形狀大小確定適當的內容長度 - 關鍵：包含原始清單中的段落屬性——不要只提供文字 - 重要：當 bullet: true 時，不要在文字中包含項目符號符號（、-、*）——它們會自動添加 - 基本格式規則： - 標題\/標題通常應有 `"bold": true` - 列表項應有 `"bullet": true, "level": 0`（當 bullet 為 true 時 level 必需） - 保留任何對齊屬性（例如，`"alignment": "CENTER"` 用於置中文字） - 當與預設不同時包含字型屬性（例如，`"font_size": 14.0`、`"font_name": "Lora"`） - 色彩：使用 `"color": "FF0000"` 用於 RGB 或 `"theme_color": "DARK_1"` 用於主題色彩 - 替換腳本期望格式正確的段落，不只是文字字串 - 重疊形狀：偏好 default_font_size 較大或 placeholder_type 更適當的形狀 - 將帶替換的更新清單儲存到 `replacement-text.json` - 警告：不同的模板版面有不同的形狀數量——在創建替換前始終檢查實際清單顯示正確格式的範例 paragraphs 欄位： ```json "paragraphs": [ { "text": "新簡報標題文字", "alignment": "CENTER", "bold": true }, { "text": "章節標題", "bold": true }, { "text": "不帶項目符號符號的第一個項目符號", "bullet": true, "level": 0 }, { "text": "紅色文字", "color": "FF0000" }, { "text": "主題色彩文字", "theme_color": "DARK_1" }, { "text": "無特殊格式的普通段落文字" } ] ``` 替換 JSON 中未列出的形狀將自動清除： ```json { "slide-0": { "shape-0": { "paragraphs": [...] \/\/ 此形狀獲得新文字 } \/\/ 清單中的 shape-1 和 shape-2 將自動清除 } } ``` 簡報的常見格式模式： - 標題投影片：粗體文字，有時置中 - 投影片內的章節標題：粗體文字 - 項目符號列表：每個項目需要 `"bullet": true, "level": 0` - 正文：通常不需要特殊屬性 - 引言：可能有特殊對齊或字型屬性 7. 使用 `replace.py` 腳本應用替換 ```bash python scripts\/replace.py working.pptx replacement-text.json output.pptx ``` 腳本將： - 首先使用 inventory.py 的函數擷取所有文字形狀的清單 - 驗證替換 JSON 中的所有形狀都存在於清單中 - 清除清單中識別的所有形狀的文字 - 只對替換 JSON 中定義了「paragraphs」的形狀應用新文字 - 透過應用 JSON 中的段落屬性保留格式 - 自動處理項目符號、對齊、字型屬性和色彩 - 儲存更新的簡報驗證錯誤範例： ``` ERROR: Invalid shapes in replacement JSON: - Shape 'shape-99' not found on 'slide-0'. Available shapes: shape-0, shape-1, shape-4 - Slide 'slide-999' not found in inventory ``` ``` ERROR: Replacement text made overflow worse in these shapes: - slide-0\/shape-2: overflow worsened by 1.25" (was 0.00", now 1.25") ``` ## 創建縮圖網格為快速分析和參考創建 PowerPoint 投影片的視覺縮圖網格： ```bash python scripts\/thumbnail.py template.pptx [output_prefix] ``` 功能： - 創建：`thumbnails.jpg`（或大型投影片組的 `thumbnails-1.jpg`、`thumbnails-2.jpg` 等） - 預設：5 欄，每網格最多 30 張投影片（5×6） - 自定義前綴：`python scripts\/thumbnail.py template.pptx my-grid` - 注意：如果你想在特定目錄輸出，輸出前綴應包含路徑（例如 `workspace\/my-grid`） - 調整欄數：`--cols 4`（範圍：3-6，影響每網格投影片數） - 網格限制：3 欄 = 12 張投影片\/網格，4 欄 = 20，5 欄 = 30，6 欄 = 42 - 投影片從零開始索引（投影片 0、投影片 1 等）使用案例： - 模板分析：快速理解投影片版面和設計模式 - 內容審查：整個簡報的視覺概覽 - 導覽參考：透過視覺外觀找到特定投影片 - 品質檢查：驗證所有投影片格式正確範例： ```bash # 基本用法 python scripts\/thumbnail.py presentation.pptx # 組合選項：自定義名稱、欄數 python scripts\/thumbnail.py template.pptx analysis --cols 4 ``` ## 將投影片轉換為圖片要視覺化分析 PowerPoint 投影片，使用兩步驟過程將它們轉換為圖片： 1. 將 PPTX 轉換為 PDF： ```bash soffice --headless --convert-to pdf template.pptx ``` 2. 將 PDF 頁面轉換為 JPEG 圖片： ```bash pdftoppm -jpeg -r 150 template.pdf slide ``` 這會創建 `slide-1.jpg`、`slide-2.jpg` 等檔案。選項： - `-r 150`：設定解析度為 150 DPI（調整以平衡品質\/大小） - `-jpeg`：輸出 JPEG 格式（如偏好可使用 `-png` 輸出 PNG） - `-f N`：要轉換的第一頁（例如 `-f 2` 從第 2 頁開始） - `-l N`：要轉換的最後一頁（例如 `-l 5` 在第 5 頁停止） - `slide`：輸出檔案的前綴特定範圍範例： ```bash pdftoppm -jpeg -r 150 -f 2 -l 5 template.pdf slide # 只轉換第 2-5 頁 ``` ## 程式碼風格指南重要：生成 PPTX 操作程式碼時： - 撰寫簡潔的程式碼 - 避免冗長的變數名稱和多餘的操作 - 避免不必要的 print 陳述式 ## 依賴項必需的依賴項（應已安裝）： - markitdown：`pip install "markitdown[pptx]"`（用於從簡報擷取文字） - pptxgenjs：`npm install -g pptxgenjs`（用於透過 html2pptx 創建簡報） - playwright：`npm install -g playwright`（用於 html2pptx 中的 HTML 渲染） - react-icons：`npm install -g react-icons react react-dom`（用於圖示） - sharp：`npm install -g sharp`（用於 SVG 柵格化和圖片處理） - LibreOffice：`sudo apt-get install libreoffice`（用於 PDF 轉換） - Poppler：`sudo apt-get install poppler-utils`（用於 pdftoppm 將 PDF 轉換為圖片） - defusedxml：`pip install defusedxml`（用於安全的 XML 解析）