PPT Template Editor

將 template.pptx 轉成可編輯 YAML，逐頁回填 output，再套用回 PowerPoint。

適用時機

• 需要把簡報內容流程化成 extract -> resolve -> apply。
• 需要同時處理文字、圖表、表格 placeholders。
• 需要逐頁（by page）控制回填品質與可追蹤性。

輸入

• template.pptx
• template.yaml（由 extract 產生）
• 可選參考資料：txt/csv/json/html/xml（由 assets.sources 指定）

輸出

• template.yaml
• resolved.yaml
• out.pptx

工作流程（重新命名）

1. Step 1 - Build Template YAML

從 PPTX 抽出每頁 placeholders/charts/tables 骨架。

1. Step 2 - Resolve Template YAML By Page

逐頁讀取 page dict + references，只回填每個項目的 output。

1. Step 3 - Apply Output To PPTX

將 resolved.yaml 套用到原始 template.pptx 產生最終簡報。

指令

python ppt-template-editor/scripts/extract_templates.py template.pptx --out template.yaml
python ppt-template-editor/scripts/resolve_outputs.py template.yaml \
  --subagent-cmd "python ppt-template-editor/scripts/codex_subagent_resolver.py" \
  --out resolved.yaml
python ppt-template-editor/scripts/apply_from_yaml.py template.pptx resolved.yaml --out out.pptx

By-Page Resolve 參考載入規則

• 先讀：references/resolve-by-page.md
• 再讀：references/output-schema.md
• 若只需快速整批 resolve，可直接使用 scripts/resolve_outputs.py。
• 若需人工或外部 LLM 逐頁控制，使用：
• scripts/read_page_context.py
• scripts/write_page_resolve.py

Resolve 子代理協議

主流程傳給子代理（stdin JSON）：

• page_no
• page
• references

子代理回傳（stdout JSON）：

• 直接 page dict，或
• {"page": <page_dict>}

Placeholder 規範

• 文字 placeholder 格式：${{ ... }}
• 圖表 placeholder 來源：圖表 shape 的 Alt Text Description（備援：shape name）
• 表格 placeholder 來源：表格 shape 的 Alt Text Description（備援：shape name）

MVP 限制

• 文字替換以 run 為單位；跨 run 以 rewrite_runs 方式降級處理。
• 表格僅支援固定格數覆寫（不增減列欄）。
• 圖表套用採 python-pptx replace_data，輸入需為合法 categories/series。

失敗處理

• Shape 名稱缺失或重複會降低定位可靠性。
• 表格 output.values 非二維陣列時，該表格跳過並記 warning。
• 頁碼超出範圍時，該頁跳過並記 warning。