Glyph 登陸頁面
一個主題 → 一個頁面。主題循環播放(一個 Kling 片段,其最後一幀銜接第一幀);著色器將其繪製為動態背景上的字形。頁面上包含:
- 主視覺區: 游標 X 軸分割 照片 ← | → 字形;游標 Y 軸設定網格大小;一個環圈和十字準星跟隨游標。標題(一個被分成兩半的單詞)由著色器繪製,呈現為模糊背景的負片效果。密集的線條藝術,部分追蹤主體。
- 區段: 宣言(一個帶有轉折的真實事實)、跑馬燈、四個規格、再次以主體為背景的最終行動呼籲。滾動會將網格溶解成大像素再恢復原狀。
- 系列: 多個頁面共享一個引擎和頁面切換器;每個頁面擁有自己的調色板、背景效果、字形渲染器、字體、線條藝術和文案。
assets/examples/pages/ 包含五個完整頁面,展示了其範圍(夜空中的太空人、紙上的罌粟花、藍圖般的 1984 Mac、帶有網點和等壓線的雲朵、霓虹點字中的水母)。在編寫頁面前先閱讀其中一兩頁;切勿完全複製任何一頁 —— 每個頁面都是為其主題全新設計的。
你需要什麼
| 需求 | 原因 | 方式 |
|---|---|---|
| 一個主題 | 使用者的圖片,或一個用於生成圖片的描述 | 詢問,或採用他們提供的內容 |
FAL_KEY | 靜態圖片、編輯和影片 | 在每個命令中設定為環境變數 (FAL_KEY=… node …);絕不回顯它或將其寫入追蹤檔案。僅在使用者要求儲存時:一個被 .gitignore 忽略的 .env.local 檔案 |
| Node 18+, ffmpeg, Python 3 | 生成器、打包、遮罩 | node -v、ffmpeg -version、python3 -V;macOS 使用 brew install node ffmpeg python |
費用:靜態圖片很便宜(約 $0.15);每個 15 秒的 Kling 片段費用明顯較高,且通常需要重試一次 —— 在第一次生成影片前,請查閱 fal 的定價並告知使用者。
步驟 0 — 確認意圖(一條簡短訊息,然後決定)
- 主題。 擁有圖片 → 檢查它(浮水印:不要移除它們 —— 要求使用者提供授權副本,或改為生成原創圖片;真實人物的照片 → 確認是本人或已取得同意;商標產品在編輯上可接受,但不能有標誌)。無圖片 → 你將生成一張圖片;提出一個符合使用者目標的主題。
- 外觀。 如果使用者描述了外觀,請遵循。否則,自行選擇
references/looks.md中的所有七項決定,並用一兩句話說明你的選擇。如果專案已有頁面,請確保新頁面與每個現有頁面至少在七項中有五項不同。 - 動態。 哪些部分應該移動以及移動幅度(「大量動態」vs「平靜漂浮」);預設為 15 秒。
- 文案與構圖。 語氣、使用者想要的任何事實或名稱;否則,圍繞主題虛構一個展覽/出版物/活動(
references/copy.md)。
步驟 1 — 建立專案架構
python3 <skill>/scripts/new_project.py <project-dir> <id> --name "Name" --title "First/second" [--image path]
cd <project-dir>/tools && npm install
第一次呼叫會建立專案(site/ 目錄,包含 engine.js、base.css、pages.json、index.html;tools/ 目錄包含管線;.gitignore)。後續每次呼叫會新增一個頁面(site/<id>.html)並在 pages.json 中註冊它,以便每個頁面的切換器都能顯示它。
步驟 2 — 提示詞 → 靜態圖片 → 審查
編寫 tools/subjects/<id>.json(references/pipeline.md 中有檢查清單;assets/examples/subjects/ 有五個有效的範例)。預設使用純黑背景,主體位於中心偏右,左側留白。
FAL_KEY=… node generate.mjs <id> still # 根據「圖片」提示詞生成
FAL_KEY=… node generate.mjs <id> edit # 或:將使用者的圖片放到純色背景上(保留原圖)
顯示 tools/<id>.png。迭代直到使用者滿意 —— 下游所有流程都繼承於此。
步驟 3 — 影片片段 → 檢查 → 審查
FAL_KEY=… node generate.mjs <id> video # 需要幾分鐘;在背景執行
node generate.mjs <id> check # 動態數值 + tools/<id>-sheet.png
閱讀數值:如果中間部分低於約 3,表示幾乎沒有移動 —— 在再次花費之前加強提示詞用語並重新生成。顯示連續圖片。如果使用者想要不同的動態,請先讓他們看過修改後的提示詞,然後再花費。
步驟 4 — 建立打包循環
cd <project-dir> && tools/build_media.sh tools/<id>.png <id> video tools/<id>-motion.mp4
python3 tools/track_blobs.py <id> 3 # 可選:用於追蹤疊加的發光/高對比部分的路徑
檢查 site/media/<id>-loop.mp4 的一幀:右半邊必須是乾淨的白色剪影。然後測量你將要標註的位置(references/pipeline.md → 測量)。
步驟 5 — 設計頁面
編輯 site/<id>.html(每個 EDIT 標記),使用 references/looks.md 進行決策,使用 references/shader-recipes.md 處理 GLSL,以及使用 references/copy.md 處理用詞:
:root變數和 Google Fonts 連結。- 著色器:
field()(背景效果 + 光暈)、scene()(字形渲染器、底板、墨色)、photo()、main()(邊緣效應、標題反轉、完成)。設定stage({ focus, cell, zoom, atlas })。 - 標題文字、大小和位置;延伸句子;標誌/系列名稱。
- 線條工作:在腳本中建立的密集 SVG/DOM,帶有動畫;透過
onFrame中的toScreen()追蹤元素。 - 區段:宣言、跑馬燈、規格、行動呼籲、頁尾 —— 包含屬於此外觀的區段樣式。
- 手機:檢查
@media (max-width:760px)區塊(標題大小、行動呼籲大小、隱藏擁擠的標籤)。
步驟 6 — 預覽與驗證
cd <project-dir> && python3 -m http.server 5180 -d site # 開啟 http://localhost:5180/<file>
在瀏覽器中驗證,而不是閱讀程式碼:控制台無錯誤;畫布顯示;移動游標會分割和調整大小;標題在照片和字形兩側都可閱讀;疊加層位於主體上;滾動瀏覽每個區段;測試寬螢幕桌面、近乎方形的視窗以及 375 px 的手機,無水平滾動條。每次編輯後強制重新加載(靜態伺服器會快取)。references/troubleshooting.md 涵蓋了先前曾出現的問題。
步驟 7 — 交付
告訴使用者你建立的內容(主題、動態、七項外觀決策、文案)、任何你無法使其正常運作的部分,以及他們可能想要調整的旋鈕 —— 邊緣效應常數、底板不透明度、網格範圍、光點強度、標題大小 —— 並說明每個參數位於何處。將原始 Kling 片段保留在 Git 之外(.gitignore 已處理)。
新增另一個頁面
再次執行 new_project.py <project-dir> <new-id> --name …,然後對該頁面執行步驟 2 到 6,選擇一個與現有頁面不同的外觀。