Communitygithub.com

會動的個人主頁

做一個個人站:卡通主角會跟著游標轉頭,捲動時在區塊之間接著表演,最後部署成公開頁面。

會動的個人主頁 是什麼?

先訪談再定一個角色和一張全站背景,生成追視與區塊銜接片段,拼成靜態主頁並發布。同一個角色貫穿全頁,捲動進度就是表演進度。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/yaohuicong/motion-homepage/tree/HEAD

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

會動的個人主頁 是做什麼的?

成品是一個靜態網站(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 截圖只證明畫面擺得對,動起來順不順要使用者在真實瀏覽器裡看),哪些沒做(比如沒在真機手機上試)。
  • 素材體積和首頁載入時間;如果偏大,給出壓縮辦法。

相關技能