動畫資訊圖表
使用時機
- 從 JSON / CSV / 基準測試結果建立 GIF 或動態圖表。
- 以動畫呈現卡片移動、排名、比較長條圖、狀態轉換。
- 製作數值準確性與演出時間/實際測量時間區分很重要的文章 / SNS 素材。
如果只需要靜態 PNG,請使用 visualize-as-infographic;若要分析現有影片,請使用 video-watch;若要製作可編輯的結構圖,請使用 draw.io 系列 workflow。
輸入
- Source artifact:JSON / CSV / 文字。若有測量值,則以此為唯一事實來源(SSOT)。
- 觀眾語言與目標媒介:例如日文部落格、X、簡報等。
- 時間模式:
illustrative:動作為演出,不代表處理速度。measured:影格時間來自實際時間戳記。mixed:數值為實測,卡片或長條的動作為演出。
- 輸出尺寸。預設為部落格/X 適用的
1200x675,必要時也建立靜態備用圖。
工作流程
- 凍結證據
- 固定 source artifact、取得日期時間、對象筆數、測量邊界。
- 決定延遲是
1 request、serial total、fresh-process end to end等,明確所測量的值。 - 若加工外部媒體,需在 manifest 中記錄原始 URL、取得日期、source 相對路徑、SHA-256,並在生成前比對 hash。
- 設計敘事
- 每個 GIF 只聚焦一個主張。冗長說明請放回本文。
- 固定閱讀順序:輸入 → 判斷 → 下一步處理、before → after、比較 → 結論等。
- 若主題是狹窄的 decision gate,則使用強調色、粗外框、中央配置或 callout 等方式讓它成為視覺層級的主角。將輸入和輸出放在兩側,並在框內寫下 gate 決定的值。
- 不要將官方術語與作者自創的分層/分類以相同外觀直接斷定。對於自創模型,應在 asset 內標示範圍(例如「本文中的整理」),並避免使用讓人誤以為是產品包含或成熟度的箭頭或巢狀結構。
- 在渲染前進行本地化
- 說明 UI、狀態、標題文字要配合讀者語言。日文文章中不要殘留泛用英文 UI。
- 產品名稱、API field、model ID 等專有名詞請保留官方寫法。
- 避免直譯腔。例如:用「接近定義基準中的哪個階段」代替「階段で採点」。
- 在 asset 內明確標示時間
illustrative:顯示「卡片移動為演出(非實際測量速度)」。measured:顯示測量邊界與單位,並根據實際測量值製作影格持續時間。mixed:同時寫明「顯示值為實測 / 長條、卡片的動作為演出」。
- 可重現地生成
- 保留 generator script、GIF、靜態備用圖,必要時保留 source snapshot。
- 數值不應手動輸入,而是從 source artifact 讀取。
- 第三方影片應裁剪到主張所需的最小影格(例如 before / operation / after),並移除無關的瀏覽器 chrome。在 asset 內區分顯示出處,以及可能造成誤讀的資訊(如 dummy 資料、未發送、作者額外註記等)。
- 機械驗證
python scripts/validate_animation.py output.gif `
--expected-width 1200 --expected-height 675 `
--timing-mode illustrative `
--contact-sheet output-contact.jpg `
--report output-validation.json
- 目視檢查
- 以原始尺寸與目標嵌入寬度(手機約 360px)確認開始、中間、結束影格。
- 修正文字重疊、裁切、順序、空白、無法閱讀的註記、殘留英文 UI 後重新生成。
時間規則
- GIF 總播放時間不一定等於 API 延遲。請勿自動視為相同。
- 若為多個 request 的總和,應顯示是並行還是序列。
- 若比較對象的測量邊界不同,則視為「觀察到的端到端時間」,而非「模型速度」。
- 估算成本、正確率、token 數也需與 source artifact 比對,並在 asset 中加入避免誤讀的註記。
完成條件
- GIF 是動畫格式,且滿足預期尺寸與最少影格數。
- 時間模式與測量邊界在 asset 內可見。
- source artifact 的數值與顯示數值一致。
- 若來自外部媒體,則 source URL / 取得日期 / SHA-256 與 manifest 一致。
- 說明 UI 已統一使用讀者語言。
- 主題的 decision gate 最先可見,且能讀懂它接收什麼、回傳什麼。
- 在 asset 本身即可區分官方定義與作者自創的整理。
- 已確認開始、中間、結束影格與循環播放。
- 在目標嵌入寬度下文字可讀。
- 已回報 generator、GIF、靜態備用圖、驗證報告的所在位置。