Communitygithub.com

Motion Homepage

Builds a personal site whose cartoon host follows the cursor and performs between sections as the page scrolls, then deploys the static page.

What is Motion Homepage?

Interview the owner, lock one character and one background, generate gaze and transition clips, assemble a static homepage, and ship a public link. The same character carries the page; scroll progress plays the performance.

Works with~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/yaohuicong/motion-homepage/tree/HEAD

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

会动的个人主页

成品是一个静态网站(HTML/CSS/JS,无需构建),由三层组成:

  1. 人物舞台:全屏画布,画的是 AI 生成的角色视频帧。首屏按鼠标方向播放"追视闭环"的对应帧;滚到下一版块时,播放两版块之间的"衔接片段",滚动进度就是播放进度。手机竖屏时角色放在上半屏。
  2. 内容版块:首屏 / 个人履历 / 作品目录 / 精选作品 / 结尾,文字压在舞台上方,避开角色所在的一侧。
  3. 手绘装饰与特效:涂鸦(进场时一笔画出、之后像手绘动画一样抖动)、缓慢变形的颜料色块、跟着角色头部的对话气泡、手绘圈和笔刷下划线、鼠标划过角色时的旋转波纹扭曲(React Bits「Ripple Distortion」,WebGL,只扭曲舞台;不支持时退回荧光笔拖尾)、逐字弹出、浮动的小卡通贴纸。

模板默认是"深色手绘涂鸦 + 3D 主角"风格(近黑底 + 荧光黄绿/紫/蓝/橙、马克笔手写标题、3D 卡通角色配 2D 涂鸦贴纸),整站英文。换风格靠改 theme(颜色、字体)和各版块的 decor(装饰),不用改引擎。

网站好不好看,七成取决于素材是否连续一致(同一个角色、同一张背景、上一段的末帧就是下一段的首帧),三成取决于版式。所以这个 skill 把大部分篇幅花在素材规划和检查上;代码已经写好在 template/,通常只改 site.config.js 和少量 CSS。

目录

template/                 可直接运行的模板(自带占位素材 assets/demo/)
  site.config.js          全部文字、素材路径、手感参数
  js/  css/               引擎与样式,一般不用改
  tools/calibrate.html    追视关键帧标定工具
scripts/frames.py         视频/图片 → 网页用帧序列(需要 ffmpeg)
scripts/check-site.mjs    检查配置与素材是否齐全
scripts/fetch-reactbits.mjs  下载 React Bits「Ripple Distortion」到站点(鼠标划过人物的旋转波纹扭曲;许可原因不随模板分发)
scripts/cutout.py         纯色背景的贴纸/小角色 → 透明底 webp(--split 拆贴纸合集)
scripts/serve.py          本地预览服务器(不缓存,改完刷新就是新版)
scripts/shoot.mjs         验收截图:无头 Chrome + 真实鼠标事件,逐版块截图(桌面/手机)
scripts/make-demo-assets.py  重新生成占位素材(一般用不到)
references/
  01_规划.md              访谈清单、版块与角色动线怎么定
  02_素材提示词.md        角色、背景、追视、衔接、作品图的提示词模板与验收(含"只能传首帧"工具的实测做法)
  03_建站与迭代.md        配置字段说明、常见问题与改法、怎么给反馈
  04_部署.md              Netlify / Vercel / GitHub Pages / Cloudflare,以及后续加作品
  05_开源主页设计参考.md  开源/公开拆解的个人主页值得学的做法(用户说"不够高级"时先读)

工作流程

每一步做完给用户看实际结果(截图、帧拼图或本地预览),确认后再往下走。用户不懂技术时,不要让他们读配置,只给他们看画面。

1. 访谈与规划 → 读 references/01_规划.md

先弄清:主页是谁的、要放哪些内容(履历、作品、联系方式)、角色从哪来(本人照片、已有 IP,还是新设计)、喜欢什么风格(请用户给 1–2 张参考图或网站)、手上有哪些生图/生视频工具。然后写一份 plan.md 放在站点目录:版块顺序、每个版块的文字、角色在每个版块的姿态和位置、每段衔接里角色做什么动作。这张"角色动线"是后面所有素材的依据——姿态和位置要跟版式配合(文字在左,角色就在右)。

2. 素材 → 读 references/02_素材提示词.md

顺序很重要,后一步要用前一步的产物做参考:

  1. 角色定稿图:正面、全身或半身,表情鲜明。已有 IP 时保持识别特征(脸、发型、标志性配饰),服装可按主题改。
  2. 背景底板:一张不含角色的背景,全站共用,也是所有视频的背景,这样换片段时背景不会闪。
  3. 姿态关键图:每个版块一张(角色 + 同一张背景 + 同一机位),对应规划里的姿态和位置。
  4. 追视闭环:从正面出发看遍 8 个方向再回到正面。视频工具能传首帧+尾帧时,分段生成再用 frames.py gaze-join 拼;只能传首帧时(很多图生视频工具都是这样),用"星形"做法:8 条都从首屏关键帧出发、各转向一个方向并做一个表情的短视频,frames.py gaze-star 合成(一条长视频连做 8 个方向,模型会越做越跑偏)。
  5. 衔接片段:相邻两张姿态关键图作为首帧和尾帧,生成中间的表演。只能传首帧时按顺序链式生成(上一段末帧 = 下一段首帧);某段首帧里看不到角色的脸时,用"倒放法"(先出结尾姿势定稿图,生成反向动作再倒放),否则结尾的脸会被模型改掉。
  6. 作品封面:用户已有作品图就直接用;横版 16:10 最合适。

用户如果只能生图、不能生视频,模板也能跑:追视用 9 张图(正面 + 8 个方向,会以溶解切换),衔接用两张姿态图配合 blend: true,具体命令和配置见 02 的"路线 C"。效果会弱一些,但要如实告诉用户差别在哪里。

一张素材都还没有时(零素材首版):先把网站搭起来让用户看到版式和交互——复制模板、按用户信息填好 site.config.js 的文字、颜色、作品,保留模板的占位角色。这时要注意:

  • 对话气泡、文案里不要说"我是一只狐狸"之类和占位角色对不上的话,先用中性的句子;
  • 交付时第一句就说明"画面里的人物是占位的,换成你的角色需要先生成哪几张图/视频",并附上 plan.md 里的素材清单;
  • check-site.mjs 会提醒哪些地方还在用占位素材,交给用户前把这份提醒原样告诉用户。

如果当前环境里有生图/生视频工具(比如图片和视频生成 MCP),可以直接用它出图出视频;工具只能传首帧时,按 02 的"链式生成"一段接一段做。没有视频工具时,由用户在即梦、可灵、Vidu、海螺等平台生成——这时给出完整提示词、首尾帧该上传哪张图、时长和比例,并说明收到视频后怎么检查。

每批素材到手都要先检查再接入:抽帧拼成一张图看(ffmpeg -i x.mp4 -vf "fps=2,scale=320:-1,tile=6x3" sheet.jpg),按 02 里的验收清单逐项核对。有问题时,把问题说具体(第几秒、哪里变了、变成什么样),再改提示词重生成。

3. 建站 → 读 references/03_建站与迭代.md

cp -r <skill>/template <站点目录>          # 先复制模板,原模板不改
cd <站点目录>
node <skill>/scripts/fetch-reactbits.mjs .                            # 鼠标划过人物的扭曲,下载失败时自动退回 liquid
python3 <skill>/scripts/frames.py extract 衔接1.mp4 assets/clips/t1     # 每段衔接
python3 <skill>/scripts/frames.py gaze-join assets/clips/gaze 段1.mp4 段2.mp4 …   # 追视(首尾帧分段)
python3 <skill>/scripts/frames.py gaze-star assets/clips/gaze L=左.mp4 UL=左上.mp4 …   # 追视(只能传首帧:星形)
node <skill>/scripts/check-site.mjs .
python3 <skill>/scripts/serve.py 8000                                  # 打开 http://localhost:8000(不缓存)

把 frames.py 打印的配置片段填进 site.config.js,再填文字、颜色(theme.bg 用脚本报出的背景四角色,页面和视频才能无缝相接)、字体。追视视频不是分段拼的,用 http://localhost:8000/tools/calibrate.html 标定关键帧和头部位置。

参考图决定 theme 和 decor:先按 03 的"风格从参考图来"写下底色、强调色、标题字体、装饰语言、角色画法,再改配置。模板默认整站英文(界面固定文字在 ui 里改);中英文混排时,英文大标题字体后面一定要跟一个中文字体(如 "Permanent Marker", "ZCOOL QingKe HuangYou")。参考图是别人的作品时,只借风格方向,不照搬角色、名字、文案和版面。

4. 迭代

在浏览器里从头滚到尾,按 03 的检查清单逐项看:首屏追视八个方向是否都顺、离开首屏时是否回正再衔接、每段衔接首尾有没有跳、文字和涂鸦有没有压到角色脸上、作品目录开合、作品轮播、结尾角色有没有被面板挡住、手机竖屏。

一次只改一类问题,改完再看。这样每次改动的效果清楚,也不会把已经满意的部分改坏。03 里有常见问题与对应改法。

5. 部署 → 读 references/04_部署.md

默认推荐 Netlify Drop(把文件夹拖进网页就能得到公开链接)。部署前再跑一次 check-site.mjs,确认没有占位素材、没有缺文件。

交付时说清楚

  • 站点目录在哪、怎么本地预览、怎么改文字和换作品(改 site.config.js 的哪一段)。
  • 哪些检查实际做过(在什么浏览器、什么尺寸看过;shoot.mjs 截图只证明画面摆得对,动起来顺不顺要用户在真实浏览器里看),哪些没做(比如没在真机手机上试)。
  • 素材体积和首屏加载时间;如果偏大,给出压缩办法。

Related Skills