Tai-ch0802 PPTX 技能
快速參考
| 任務 | 指南 |
|---|---|
| 讀取/分析內容 | python -m markitdown presentation.pptx |
| 從範本編輯或建立 | 閱讀 editing.md |
| 從頭建立 | 閱讀 pptxgenjs.md |
讀取內容
# 文字擷取
python -m markitdown presentation.pptx
# 視覺概覽
python scripts/thumbnail.py presentation.pptx
# 原始 XML
python scripts/office/unpack.py presentation.pptx unpacked/
編輯工作流程
詳情請閱讀 editing.md。
- 使用
thumbnail.py分析範本 - 解包 → 操作投影片 → 編輯內容 → 清理 → 打包
從頭建立
詳情請閱讀 pptxgenjs.md。
當沒有範本或參考簡報可用時使用。
設計靈感
不要建立無聊的投影片。 白色背景上的純項目符號不會給任何人留下印象。考慮為每張投影片使用此清單中的設計靈感。
開始之前
- 挑選一個大膽、以內容為導向的色票：色票應該感覺是為此主題量身設計的。如果將你的色彩換到完全不同的簡報中仍然「可行」，那你的選擇還不夠具體。
- 主導而非平等：一個色彩應該主導（60-70% 視覺比重），搭配 1-2 個輔助色調和一個鮮明的強調色。絕不讓所有色彩擁有相同的比重。
- 深色/淺色對比：標題和結論投影片用深色背景，內容用淺色（「三明治」結構）。或全程使用深色以營造高級感。
- 承諾一個視覺主題：選擇一個獨特的元素並重複使用 — 圓角圖片框架、彩色圓圈中的圖示、粗單側邊框。在每張投影片中貫徹使用。
色票
選擇與你的主題相匹配的色彩 — 不要預設使用泛用藍色。以這些色票作為靈感：
| 主題 | 主色 | 輔助色 | 強調色 |
|---|---|---|---|
| 午夜行政 | 1E2761（海軍藍） |
CADCFC（冰藍） |
FFFFFF（白） |
| 森林與苔蘚 | 2C5F2D（森林） |
97BC62（苔蘚） |
F5F5F5（奶油） |
| 珊瑚能量 | F96167（珊瑚） |
F9E795（金） |
2F3C7E（海軍藍） |
| 暖陶土 | B85042（陶土） |
E7E8D1（沙） |
A7BEAE（鼠尾草） |
| 海洋漸層 | 065A82（深藍） |
1C7293（青） |
21295C（午夜） |
| 碳灰極簡 | 36454F（碳灰） |
F2F2F2（米白） |
212121（黑） |
| 青色信任 | 028090（青） |
00A896（海泡綠） |
02C39A（薄荷） |
| 莓果與奶油 | 6D2E46（莓果） |
A26769（灰玫瑰） |
ECE2D0（奶油） |
| 鼠尾草靜謐 | 84B59F（鼠尾草） |
69A297（尤加利） |
50808E（石板） |
| 櫻桃大膽 | 990011（櫻桃） |
FCF6F5（米白） |
2F3C7E（海軍藍） |
每張投影片
每張投影片都需要視覺元素 — 圖片、圖表、圖示或形狀。純文字投影片令人遺忘。
版面配置選項：
- 雙欄（左側文字，右側圖示）
- 圖示 + 文字列（彩色圓圈中的圖示，粗體標題，下方說明）
- 2x2 或 2x3 網格（一側放圖片，另一側放內容區塊網格）
- 半出血圖片（完整左側或右側）搭配內容疊加
資料展示：
- 大型統計數字標註（60-72pt 大數字，下方附小標籤）
- 比較欄位（前/後、優/缺點、並排選項）
- 時間軸或流程圖（編號步驟、箭頭）
視覺修飾：
- 章節標題旁的彩色小圓圈圖示
- 關鍵數據或標語的斜體強調文字
字體排版
選擇有趣的字體搭配 — 不要預設使用 Arial。選一個有個性的標題字體，搭配乾淨的內文字體。
| 標題字體 | 內文字體 |
|---|---|
| Georgia | Calibri |
| Arial Black | Arial |
| Calibri | Calibri Light |
| Cambria | Calibri |
| Trebuchet MS | Calibri |
| Impact | Arial |
| Palatino | Garamond |
| Consolas | Calibri |
| 元素 | 尺寸 |
|---|---|
| 投影片標題 | 36-44pt 粗體 |
| 章節標題 | 20-24pt 粗體 |
| 內文 | 14-16pt |
| 說明文字 | 10-12pt 柔和色 |
間距
- 最少 0.5" 邊距
- 內容區塊之間 0.3-0.5"
- 留出呼吸空間 — 不要填滿每一寸
避免（常見錯誤）
- 不要重複相同版面 — 在投影片之間變化欄位、卡片和標註
- 不要將內文置中 — 段落和清單靠左對齊；僅標題置中
- 不要忽略尺寸對比 — 標題需要 36pt+ 以從 14-16pt 內文中脫穎而出
- 不要預設使用藍色 — 選擇反映特定主題的色彩
- 不要隨機混合間距 — 選擇 0.3" 或 0.5" 間隙並一致使用
- 不要只為一張投影片做樣式 — 完全投入或全程保持簡潔
- 不要建立純文字投影片 — 添加圖片、圖示、圖表或視覺元素；避免純標題 + 項目符號
- 不要忘記文字方塊填充 — 當對齊線條或形狀與文字邊緣時，將文字方塊的
margin: 0或偏移形狀以考慮填充 - 不要使用低對比度元素 — 圖示和文字都需要與背景有強烈對比；避免淺色背景上的淺色文字或深色背景上的深色文字
- 絕不使用標題下方的強調線 — 這是 AI 生成投影片的特徵；改用留白或背景色
QA（必要）
假設有問題存在。你的工作是找到它們。
你的第一次渲染幾乎永遠不正確。將 QA 視為錯誤搜獵，而非確認步驟。如果第一次檢查時發現零問題，表示你還不夠仔細。
內容 QA
python -m markitdown output.pptx
檢查遺漏的內容、錯字、錯誤順序。
使用範本時，檢查殘留的佔位符文字：
python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"
如果 grep 有回傳結果，在宣佈成功之前修復它們。
視覺 QA
⚠️ 使用子代理 — 即使只有 2-3 張投影片。你一直盯著程式碼，會看到你預期的東西，而不是實際存在的東西。子代理有新鮮的眼光。
將投影片轉換為圖片（參見轉換為圖片），然後使用此提示：
視覺檢查這些投影片。假設有問題 — 找到它們。
檢查項目：
- 重疊元素（文字穿透形狀、線條穿過文字、堆疊元素）
- 文字溢出或在邊緣/方塊邊界被截斷
- 裝飾線為單行文字定位但標題換成了兩行
- 來源引用或頁尾與上方內容碰撞
- 元素太近（< 0.3" 間隙）或卡片/區段幾乎接觸
- 不均勻的間隙（某處有大片空白，另一處則擁擠）
- 與投影片邊緣的邊距不足（< 0.5"）
- 欄位或類似元素未一致對齊
- 低對比度文字（如淺灰文字在奶油色背景上）
- 低對比度圖示（如深色背景上的深色圖示沒有對比圓圈）
- 文字方塊太窄造成過多換行
- 殘留的佔位符內容
對每張投影片列出問題或關注點，即使是輕微的。
讀取並分析這些圖片：
1. /path/to/slide-01.jpg（預期：[簡短描述]）
2. /path/to/slide-02.jpg（預期：[簡短描述]）
回報所有發現的問題，包括輕微的。
驗證循環
- 生成投影片 → 轉換為圖片 → 檢查
- 列出發現的問題（如果沒找到，再更嚴格地檢查）
- 修復問題
- 重新驗證受影響的投影片 — 一個修復常常會產生另一個問題
- 重複直到一次完整檢查未發現新問題
在你完成至少一次修復-驗證循環之前，不要宣佈成功。
轉換為圖片
將簡報轉換為個別投影片圖片以供視覺檢查：
python scripts/office/soffice.py --headless --convert-to pdf output.pptx
pdftoppm -jpeg -r 150 output.pdf slide
這會建立 slide-01.jpg、slide-02.jpg 等。
修復後重新渲染特定投影片：
pdftoppm -jpeg -r 150 -f N -l N output.pdf slide-fixed
相依套件
pip install "markitdown[pptx]"- 文字擷取pip install Pillow- 縮圖網格npm install -g pptxgenjs- 從頭建立- LibreOffice (
soffice) - PDF 轉換（透過scripts/office/soffice.py自動配置沙盒環境） - Poppler (
pdftoppm) - PDF 到圖片