句點發表影片
一段 24 秒循環影片,產品的完整工作流程在字標的句點內上演。所有內容都放在 template/ 中:渲染器(index.html,所有內容在 config.js 中)、渲染、掃描與音訊腳本、字型、真實 macOS 游標以及峰值量測的 SFX。你的工作主要是選擇內容與照片,然後執行管線。在變更任何動畫前,請先閱讀 references/craft.md 一次。它包含了方向、節拍圖以及已經解決的陷阱。
工作流程
1 · 設定
~/.claude/skills/period-launch-video/scripts/new_project.sh <project>/brag-output/<slug>
將輸出放在使用者的專案內。如果存在 brag-output/ 這類被 git 忽略的資料夾,請使用它。該腳本也會從這台 Mac 複製真實的 macOS 游標(make_pointers.py,不重新分發)並安裝 Playwright。若要符合原始外觀,請將 Thmanyah Sans woff2 檔案(thmanyah-sans-{400,500,700}.woff2)放入 assets/fonts/。若無,則使用 IBM Plex Sans Arabic。
2 · 從專案收集輸入(只詢問缺少的部分)
- 身份取自已發布版本。 使用 App Store 截圖、iOS 素材目錄(圖示、顏色)以及應用程式本身的範例資料與文案。忽略過時的網頁素材。如果你無法判斷哪個版本是現行的,請詢問。這是第一次執行後的主要修正。
- 圖示: 將正方形應用程式圖示複製到
assets/img/icon.png。模板會自行套用 iOS 圓角遮罩。 - 歌曲: 如果專案已有現成曲目則使用,否則請詢問。執行
python3 find_hit.py assets/music/song.mp3並設定config.song.hit(≈ 回報的擊點 − 0.04)與bpm。enterAt(預設 3.10)是擊點落下的時間,位於第一個藥丸處。保持enterAt + 20 beats約在 13.5 秒,使「結果」落在第 20 拍。 - 文案: 填入
config.js:名稱(一個單字,它會變成黑色字標加上句點)、標語、兩行開場文字、ask 藥丸、工作、find/write/night 標籤、3 個結果、通知、5 個函式庫列、圖表數值以及 CTA。讓每個數字在節拍間保持一致。使用西方數字。保持嚴格的 JSON 格式,因為audio.py會解析它。 - 誠實檢查: 如果故事暗示了產品實際上做不到的事情(例如隔夜批次工作),請在渲染前提出並提供中立的措辭。
3 · 照片(四張圖板)
請遵循 references/image-prompts.md。根據可用資源選擇路徑:
- 有額度的 Higgsfield MCP。 先處理白天,然後夜晚與黎明作為白天工作的編輯,再加上外部。先預估費用。
- 本地 Codex(
which codex)。scripts/codex_image.sh使用使用者的 ChatGPT 訂閱中的 Codex 內建 image_gen。 - 無額度也無 Codex。 將四個填好的提示提供給使用者(編輯部分使用 Gemini)並等待圖片檔案。
然後:
python3 check_align.py # night/dawn 必須相對於 day 偏移 (0,0)
python3 grade_plates.py # → assets/img/*.jpg + 模糊副本;預覽 out/plates.jpg
4 · 節拍圖 + 六張靜態圖 → 渲染前取得批准
node stills.mjs 1.30 7.35 10.10 14.60 17.30 23.25 # open, find, write, results, phone, out
python3 sheet.py out/review-sheet.jpg out/stills/t{1.30,7.35,10.10,14.60,17.30,23.25}.png
先自己仔細檢查每張靜態圖:文字是否合適、有沒有被裁切、玻璃元件在圖板上是否可讀。然後向使用者展示該試算表(使用 SendUserFile)以及根據 index.html 中的 T 建立的節拍圖表格。只有在他們批准後才開始渲染。
5 · 渲染、驗證、交付
./build.sh out/<slug>-launch.mp4 # 4 個渲染工作者 → scan.py + scan_local.py → 時間軸 + 音訊 → H.264/AAC
scan.py必須回報接縫差異約為 0(乾淨的循環),且無突波或階梯。scan_local.py的擊點若為計數器或打字聲則可接受。其他情況都是真正的爆音:找出是哪個交接造成的並修正。然後用node render.mjs a b只重新渲染那些影格,並使用build.sh中的 ffmpeg 指令重新編碼。- 在每個計數器結束時抽取一個影格,確認它顯示了精確的最終數字。
- 報告規格(1440²、60fps、1440 影格、24.0 秒、LUFS、峰值)、任何未解決的誠實標記以及檔案路徑。
超越預設值的調整
- 重新計時: 編輯
index.html中的T(保持 0.8 秒滑動),然後重新執行node timeline.mjs && python3 audio.py。 - 函式庫列數固定為 5 列,由佈局決定。圖表軸有 3 個標籤(起點、中點、終點)。
- LTR 產品(英文字標):模板為 RTL 佈局。句點位於左端,列與藥丸靠右對齊,掃描與圖表從右到左進行。對於 LTR,鏡像這些錨點(
align、R/L邊界、scanX、cpt),並將圖示放在左側。為此預留時間並檢查每張靜態圖。