会动的个人主页
成品是一个静态网站(HTML/CSS/JS,无需构建),由三层组成:
- 人物舞台:全屏画布,画的是 AI 生成的角色视频帧。首屏按鼠标方向播放"追视闭环"的对应帧;滚到下一版块时,播放两版块之间的"衔接片段",滚动进度就是播放进度。手机竖屏时角色放在上半屏。
- 内容版块:首屏 / 个人履历 / 作品目录 / 精选作品 / 结尾,文字压在舞台上方,避开角色所在的一侧。
- 手绘装饰与特效:涂鸦(进场时一笔画出、之后像手绘动画一样抖动)、缓慢变形的颜料色块、跟着角色头部的对话气泡、手绘圈和笔刷下划线、鼠标划过角色时的旋转波纹扭曲(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
顺序很重要,后一步要用前一步的产物做参考:
- 角色定稿图:正面、全身或半身,表情鲜明。已有 IP 时保持识别特征(脸、发型、标志性配饰),服装可按主题改。
- 背景底板:一张不含角色的背景,全站共用,也是所有视频的背景,这样换片段时背景不会闪。
- 姿态关键图:每个版块一张(角色 + 同一张背景 + 同一机位),对应规划里的姿态和位置。
- 追视闭环:从正面出发看遍 8 个方向再回到正面。视频工具能传首帧+尾帧时,分段生成再用
frames.py gaze-join拼;只能传首帧时(很多图生视频工具都是这样),用"星形"做法:8 条都从首屏关键帧出发、各转向一个方向并做一个表情的短视频,frames.py gaze-star合成(一条长视频连做 8 个方向,模型会越做越跑偏)。 - 衔接片段:相邻两张姿态关键图作为首帧和尾帧,生成中间的表演。只能传首帧时按顺序链式生成(上一段末帧 = 下一段首帧);某段首帧里看不到角色的脸时,用"倒放法"(先出结尾姿势定稿图,生成反向动作再倒放),否则结尾的脸会被模型改掉。
- 作品封面:用户已有作品图就直接用;横版 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截图只证明画面摆得对,动起来顺不顺要用户在真实浏览器里看),哪些没做(比如没在真机手机上试)。 - 素材体积和首屏加载时间;如果偏大,给出压缩办法。