academic-deck-animator

name

academic-deck-animator

description

學術簡報動畫引擎:以 slides_content.json 統一規格驅動的雙引擎動態簡報產生器。引擎A html-canvas 產出自包含 HTML 簡報+Canvas 粒子特效(particle-burst、drift-field、network-lines,僅限封面/章節頁);引擎B native-pptx 產出原生 PowerPoint 檔+真正的物件進場動畫(appear/fade/wipe/fly-in,依 entry_order 與 delay_ms 排時序),另有 split 拆頁模式把逐步動畫拆成連續頁面、轉 PDF 排版不重疊。內建學術動畫克制原則(動畫服務論證,不做裝飾)。何時用:口試簡報、研討會報告、演講簡報要加動畫或動態效果、要粒子特效開場、要逐步揭示研究架構/模型/論證、要把動畫簡報轉成 PDF 講義時。觸發詞:PPT動畫、簡報動畫、動態簡報、動效、粒子特效、particle、canvas 簡報、進場動畫、飛入、淡入、逐步顯示、逐條出現、動畫拆頁、slides_content.json、簡報轉場。與 academic-pptx 劃界:那個管簡報「內容與結構」的學術決策(說什麼、怎麼編排),本 skill 管「動效實作」(怎麼動起來);先用那個定內容,再用本 skill 上動畫。與 academic-slides 劃界:那個做 Beamer 風靜態 HTML 主題與數學排版,本 skill 做動畫層與粒子特效;純靜態學術 HTML 簡報找那個。與 pptx 劃界:那個是通用 .pptx 檔案讀寫機制,本 skill 是學術動畫規格+雙引擎產生器。

Academic Deck Animator(學術簡報動畫引擎)

把學術簡報從「靜態頁面」升級成「有節奏的論證」。一份 slides_content.json 驅動兩種輸出:

引擎	產出	適用場景
html-canvas	自包含 .html(零依賴、瀏覽器直接開)	演講現場用自己電腦、要粒子特效與流暢網頁動效、線上分享連結
native-pptx	原生 .pptx(真 PowerPoint 動畫,可再編輯)	主辦方要求交 .pptx、口試現場用別人電腦、需要委員會後修改

兩引擎讀同一份 JSON,可同時輸出兩種格式。

核心哲學:動畫是論證的節拍器,不是裝飾

學術簡報的觀眾(口試委員、審稿人、同行)對「AI 生成感」與「業配感」高度敏感。 未經設計的連環動畫是最明顯的破綻。因此本 skill 的預設值全部保守:

• 動畫唯一的正當理由:控制資訊揭示的節奏,讓聽眾的注意力跟上論證。
• 粒子特效只允許出現在封面、章節分隔頁、結尾頁——內容頁一律禁用。
• 結果表格、迴歸係數、統計圖,永不加裝飾性動畫;只允許「逐欄/逐列揭示」這種服務講解的動畫。
• 每一個動畫都應對應講者的一個「說話節拍」。講稿裡沒有停頓點的地方,就不該有動畫。

完整原則與每種版型的建議,讀 references/animation-principles.md。

工作流程

第 1 步:確認內容已定稿

本 skill 不做內容決策。若使用者的簡報內容還沒定(還在想說什麼、順序怎麼排), 先走 academic-pptx 的內容規劃,拿到定稿大綱後再回來。內容已定就直接進第 2 步。

第 2 步:撰寫 slides_content.json

依 references/slides-content-schema.md 的完整規格撰寫。最小骨架:

{
  "metadata": { "presentation_title": "...", "author": "...", "version": "1.0.0" },
  "global_settings": {
    "aspect_ratio": "16:9",
    "theme_color": { "primary": "#0F172A", "secondary": "#38BDF8", "accent": "#F59E0B" },
    "font_family_east_asian": "Microsoft JhengHei"
  },
  "slides": [
    {
      "slide_id": 1,
      "layout": "cover",
      "engine_config"        
            
    
  

重要欄位速查:

• engine_config.engine:html-canvas 或 native-pptx。整份簡報通常選一種;混用時各引擎只輸出屬於自己的頁面。
• engine_config.fx:canvas 特效名(particle-burst / drift-field / network-lines / none)。只在 cover、section_divider、closing 版型生效,其他版型會被引擎忽略並警告。
• elements[].animation:{ "entry_order": 1, "effect": "fade-in", "duration_ms": 500, "delay_ms": 0, "trigger": "on-click" }。
• content.bullets[].animation_step:條列逐步揭示的步驟編號;同編號同步出現。
• engine_config.post_process: "split-animation-layers":native-pptx 引擎的拆頁指令,轉 PDF 前用。

第 3 步:執行引擎

引擎 A(HTML-Canvas),零第三方依賴,任何有 Python 的環境都能跑:

python scripts/build_html_deck.py slides_content.json -o deck.html

引擎 B(Native-PPTX),需要 python-pptx(pip install python-pptx):

# 產出含原生動畫的 pptx
python scripts/build_native_pptx.py slides_content.json -o deck.pptx

# 拆頁模式:逐步動畫拆成連續頁面(轉 PDF 用,PPspliT 概念)
python scripts/build_native_pptx.py slides_content.json -o deck_print.pptx --split

第 4 步:驗證與交付

• HTML:用瀏覽器打開,←/→ 或空白鍵換頁、換頁內點擊觸發逐步揭示;P 鍵切換簡報者模式(含備忘稿)。
• PPTX:先用 python-pptx 重新開啟確認檔案合法,再提醒使用者用 PowerPoint 實際播放一次確認動畫。 動畫時序不對時,調 JSON 的 entry_order / delay_ms 重跑即可,不要手動改 pptx。
• 拆頁版:確認頁數 =「原頁數 + 各頁動畫步數總和」(每頁 K 步拆成 K+1 頁,含未點擊的初始狀態),匯出 PDF 後排版不重疊。

兩引擎的能力邊界(如實告知使用者)

能力	html-canvas	native-pptx
粒子特效	✅ 三種,可調強度	❌(原生 PPT 做不到,勿承諾)
物件進場動畫	✅ CSS 級(fade/fly/wipe/zoom)	✅ 原生(appear/fade/wipe/fly-in)
進場時序(順序+延遲)	✅	✅(entry_order → 點擊組;delay_ms → 組內延遲)
交出去可再編輯	❌(HTML 原始碼)	✅(正常 PowerPoint 物件)
動畫拆頁轉 PDF	不需要(直接列印模式)	✅ --split
圖表	建議貼靜態圖(PNG/SVG)	原生 shape 組合或貼圖

native-pptx 的動畫是以 OOXML <p:timing> 時間樹直接注入(python-pptx 沒有動畫 API)。 支援的效果清單與對應 presetID 寫死在 scripts/build_native_pptx.py 的 EFFECT_MAP, 新增效果前先讀該檔案開頭的註解,不要憑記憶編 presetID。

環境備註

• 兩支腳本都相容 Claude Code(桌面版)與 claude.ai 網頁版的程式執行環境;引擎 A 只用標準函式庫。
• Windows 中文字型預設「微軟正黑體」,可在 global_settings.font_family_east_asian 覆寫(如 DFKai-SB 標楷體)。
• 產出檔案一律 UTF-8;JSON 內中文不需轉義。