Ian Xiaohei SVG Motion

把 Ian 小黑正文配图的原则，改造成可控的 HTML + SVG + GSAP timeline 动效。目标不是复刻生图像素，而是把文章里的一个认知动作重建成分层漫画舞台，方便录视频、按字幕 cue 对齐、后续改文案和元素。

Core Rule

Do not auto-vectorize a PNG and animate the resulting path soup. Use raster images only as composition references. Rebuild the scene as semantic SVG groups:

idea -> shot plan -> SVG layer plan -> HTML/SVG template -> GSAP timeline -> static + motion review

Workflow

1. Extract one cognitive anchor from the article, script, screenshot, or storyboard scene.
2. Choose one physical metaphor: sorting, carrying, bridging, leaking, catching, folding, weighing, opening, rerouting, or falling.
3. Make Xiaohei perform the core action. If removing Xiaohei does not change the meaning, redesign.
4. Design a 16:9 white canvas with one main scene, 35%+ whitespace, and 3-5 short handwritten annotations at most.
5. Build semantic SVG groups for every moving object.
6. Animate with GSAP timeline. Use x, y, rotation, scale, opacity, and SVG stroke drawing. Avoid layout animations.
7. Save both a playable HTML page and a static review screenshot.
8. If this is for a 口播成片 project, map timeline segments to subtitle/cue timing before final render.

Read When Needed

• Read references/style-rules.md before designing a new scene or judging whether the result still feels like Ian Xiaohei.
• Read references/svg-layering.md before writing or editing the SVG structure.
• Read references/motion-rules.md before writing GSAP animation.

Output Contract

Default output folder:

output/<slug>-xiaohei-svg-motion/

Required files:

index.html
README.md
preview.png
vendor/gsap.min.js

Optional files:

source.png        # reference image, if provided by the user
cue-map.md        # when aligning to spoken script or subtitles

Reusable Assets

AI model and interface icons live in:

assets/icons/