checklist-overlay
螢幕錄影在左側,核對清單在右側。每個項目在螢幕上步驟發生的瞬間打勾。最後一個勾選後,影片停留在已全部勾選的清單上。
輸入
| 輸入 | 備註 |
|---|---|
| 錄影 | 一個本機影片檔案,最好為 16:9。無聲可接受。 |
| 步驟 | 3 到 7 個項目:{ "label": "...", "at": <錄影中的秒數> }。標籤為簡短的命令式短語(約 2 到 4 個詞)。 |
| 標題 | 一行。說明結果(例如「在 5 個步驟中將技能加入你的 agent」)。 |
| 副標題 | 選用一行。 |
| 調色盤 | 選用的十六進位代碼覆寫:bg, surface, panel, ink, muted, accent, border, accentInk。預設為深色搭配橘色強調色。請確保 accentInk 夠暗以便在 accent 上閱讀。 |
如果有人未提供時間戳,請掃描錄影(使用 ffmpeg 每 1 到 2 秒提取影格並檢查),選取每個步驟明顯已完成或正在進行中的第一個影格。請勿猜測。
工作流程
- 載入
/hyperframes、/hyperframes-core、/hyperframes-cli以取得專案合約。 - 撰寫
spec.json:{ "title": "...", "subtitle": "...", "palette": { "accent": "#ff6b2b" }, "steps": [ { "label": "開啟應用程式", "at": 1.5 }, { "label": "搜尋", "at": 7.9 } ] } - 將構圖生成至專案目錄:
node <skill>/scripts/create.mjs spec.json <recording.mp4> <project-dir> [--hold 2.2]它會複製錄影、提取最後一個影格(以便在錄影結束後畫面保持靜止),並寫入與錄影同尺寸的index.html。總長度 = 錄影長度 + 停留時間(預設 2.2 秒)。 npx --yes hyperframes check必須通過,且無任何錯誤或警告。- 進行驗證(如下),然後渲染:
npx --yes hyperframes render --workers 2 --quality delivery --output final.mp4。
時間規則
- 勾選動作必須與步驟同步,絕不能提前。填色和勾選繪製從
t = at開始;繪製約在 0.3 秒後完成。在at之前,項目中不得有任何看起來已勾選的部分。 - 時間戳為錄影時間,且錄影從構圖時間 0 開始,因此
at原樣使用。如果你剪輯了錄影,請將每個at偏移相同的量。 - 「下一個」項目的輪廓可在前一個打勾後不久出現。它只能是輪廓,不能是填色或勾選。
- 勾選動作至少間隔 1.5 秒,以便每個都能被看清楚。如果兩個步驟太接近,請合併它們。
- 最後一個勾選應至少在錄影結束前 1.5 秒,或提高
--hold值,使完成清單至少可見 2 秒以上。 - 計數器(
n / N)、進度條和影格環脈衝都與相同的at值同步,因此它們會保持一致。
佈局(16:9 錄影)
1920x1080 畫布,邊距 56 像素。標題和副標題在上方;錄影畫框為主要元素,寬約 1250 像素(約佔寬度的 65%),核對清單面板為 520 像素寬的直欄,在其右側,高度與畫框相同,項目均分高度。這樣可確保錄影中的 UI 文字清晰可讀。請勿將畫框縮小到低於約 1100 像素寬;對於較高的錄影,生成器會根據長寬比縮放畫框。非 16:9 的錄影:請檢查畫框在標題下方仍能容納,或先裁切錄影。
標籤以 32 像素大小換行至兩行;字數控制在約 26 個字元以內。
驗證
請在渲染後的 final.mp4 上執行,而非僅檢查截圖:
- 對於每個步驟,在
at前 0.08 秒和at後 0.45 秒各提取一個影格:ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png。 - 檢查它們。之前:項目未勾選,計數器為 i-1。之後:項目已填色並有勾選標記,計數器為 i,進度條已前進。
- 在最後的停留期間(約結束前 0.2 秒)提取一個影格:所有項目已勾選,計數器顯示
N / N,進度條已滿。 - 檢查錄影中的文字在畫框中是否清晰可讀,且無標籤被裁剪。若有問題,請修正
spec.json或調色盤並重新生成。 - 使用
ffprobe檢查檔案:1920x1080、h264,持續時間 = 錄影長度 + 停留時間。
交付
回報 final.mp4 的路徑、其持續時間以及所使用的步驟時間戳。保留專案目錄(index.html、assets/、spec.json),以便日後可透過不同標籤或調色盤重新生成影片。如果使用者想在 Studio 中編輯,請先執行 npx hyperframes preview。