產品捲軸(課程步驟 04,等級 L2)
將工作室瞄準用戶實際銷售的產品。展示影片的能量保持不變;內容則變成他們的:真實截圖、真實標誌、真實顏色與字型、真實文案、一個真實數字,以及音樂與動作同步。品牌階段之後的所有內容都執行標準的動態捲軸流程。
請求引數(可為空),僅顯示一次;後續部分將提到「上述請求」:
範圍:當用戶僅希望擷取或修復資產時,或者您從 motion-reel 的品牌階段來到這裡,請執行第 2 和第 3 部分(以及第 4 部分如有要求),進行報告,然後停止。對於全新的影片,請遵循每個部分;第 5 至第 8 部分將交由 motion-reel 流程處理。
此模式的來源
- Tony Dinh (@tdinh_me) 報告說,一個 TypingMind 的展示影片在不到 30 分鐘內完成,而一年前類似的影片花費他超過 1,000 美元。他的提示是展示影片的一行指令加上四行簡短的方向:介紹產品 URL;使用實際的產品截圖、標誌和資產;影片必須有音樂且動作必須與之匹配;使其成為真正的專業製作,而非演示或原型。他說 Claude 自行收集了品牌資產。
- 他的後續要求將螢幕截圖分解為元件和圖示,以便它們可以移動,而不是顯示原始截圖,並使動作更加豐富。這就是下面的元件規則。
- 他的提示以「再試一次,ultracode。」結束。在當前的 Claude Code 中,
ultracode是一個關鍵字,會讓 Claude 為任務編寫多代理工作流程。它是否驅動了他的結果並未記錄;請勿將其作為品質開關展示。 - Rob Hallam (@robj3d3) 在同一個 Claude Code 聊天中為他的產品製作了第二個展示影片,與第一個相同。課程推測引擎被重複使用;因此每個品牌只使用一個會話和一個專案。
- 一個反例:@mablesjoseph 要求從一個資產資料夾中用一行指令製作一個「時尚有力的」宣傳片,結果是「不夠好,無法分享」。方向比資產本身更重要。
1. 輸入
在一個 AskUserQuestion 輪次中詢問上述請求未涵蓋的內容:
| 輸入 | 預設值 | 規則 |
|---|---|---|
| 產品 URL 與名稱 | 必要 | 用戶自己的產品,或他們有權推廣的產品 |
| 時長 | 20 秒 | 5 個故事節拍,每個 2 到 4 秒 |
| 格式 | 先 9x16,然後 1x1,16x9 | 相同時間軸,重新構圖 |
| CTA | 詢問 | 螢幕上的確切文字 |
| 一個證明數字 | 詢問 | 必須來自用戶或其網站;絕不虛構 |
| 音樂 | 合成,120 BPM | 提供的曲目需要此用途的授權 |
| 語音 / 吉祥物 | 無 | 語音需要在 .env 中設定 ELEVENLABS_API_KEY |
| 參考外觀 | 無 | 可選,透過 /motion-studio:reference-style |
2. 專案
每個品牌一個專案資料夾(理想情況下是一個會話)。如果沒有 studio.json:
node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <brand-slug>-reel --title "<Product> launch" --duration 20 --brand-url <URL> --install
僅技能安裝:${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs。然後執行 npm run doctor。
3. 擷取品牌
從專案根目錄執行擷取腳本(或簡要地 motion-studio:asset-scout,帶有此確切命令和專案路徑):
node "${CLAUDE_SKILL_DIR}/scripts/capture.mjs" <URL> --root <project> --full-page [--selector "<css>"]... [--dismiss-banners]
| 標誌 | 用途 |
|---|---|
--viewports desktop,mobile | 預設;tablet 也可用 |
--full-page | 高解析度截圖,用於裁剪部分 |
--selector "<css>" | 裁剪特定產品部分(可重複):英雄區、定價卡、儀表板面板 |
--dismiss-banners | 在丟棄式瀏覽器中點擊明顯的 Cookie 或同意按鈕(接受、同意、允許,支援英文、韓文、日文、中文、德文、法文或西班牙文;僅在橫幅或對話框內的 OK 或關閉等弱標籤才計算在內)。Manifest 中會記錄點擊了哪個按鈕,或沒有匹配項 |
--apply-brand | 將名稱、URL 和建議的顏色寫入 studio.json |
--dark | 擷取深色主題 |
--no-fonts | 跳過字型下載(預設:儲存頁面載入的網頁字型) |
--allow-private | 允許頁面存取迴路、LAN 和鏈路本地地址(預設:僅目標自己的主機和連接埠);僅用於您信任的頁面,例如用戶自己產品的本地開發伺服器 |
--no-sandbox | 啟動 Chrome 時不啟用渲染器沙箱(也可使用 MOTION_NO_SANDBOX=1;在 Linux 上以 root 身份執行時自動啟用,因為 Chrome 無法在沙箱下啟動);每當關閉時會列印提示訊息 |
--json | 輸出單一 JSON 結果行 |
它會寫入 assets/brand/screens/、assets/brand/logo/、assets/brand/components/、assets/brand/og-image.* 和 assets/manifest.json(包含建議角色的調色板、CSS 顏色變數、使用的字型、標題、按鈕和導覽文案、備註)。圖片副檔名來自檔案的位元組,頁面外的元件裁剪會被跳過並附帶提示訊息。頁面實際載入的網頁字型會儲存到 assets/fonts/ 並在 assets/fonts/fonts.json 中註冊(現有條目絕不會被覆蓋);每個字型在 manifest 中都有 license,除非找到授權 URL 或檔案,否則保持為 UNVERIFIED,並且腳本會列印一則提醒,請在發布前檢查。失敗的執行會保留先前的擷取內容。詳細資訊和 manifest 架構:references/asset-capture.md。
標誌與字標。當標頭沒有標誌圖片或 SVG 時,品牌通常是文字字標。然後擷取腳本會將其記錄在 manifest.brand.wordmark 中(標記、每個部分的顏色及其角色、計算的字型系列、粗細、大小和字元間距),以及一個參考裁剪 assets/brand/logo/wordmark-crop.png,並在備註中說明,而不僅僅是要求提供標誌檔案。從該記錄重建;僅在影片需要精確的組合時才要求提供 SVG 或 PNG。
字型。日誌行 font registry: <family>: ...(以及 manifest.fonts.registry)會說明每個使用的字型系列是否已在 assets/fonts/fonts.json 中,以及其授權是否已驗證(授權 ID 和授權文字已記錄)或 UNVERIFIED,以及此執行新增了什麼。如果某個字型存在於同一系列的已驗證條目旁邊,則會重用該授權。
UI 狀態與畫布影格
capture.mjs 在載入時拍攝一次。兩個同級腳本涵蓋其餘部分;兩者都印出 --help,僅寫入專案內部(預設為 assets/brand/),並在相同的安全堆疊下執行(Windows 上為無頭 Shell,啟用渲染器沙箱,拒絕私有地址,編輯機密)。外掛安裝:下面的命令。僅技能安裝(無 ${CLAUDE_PLUGIN_ROOT}):腳本位於此檔案旁邊,因此執行 node "${CLAUDE_SKILL_DIR}/scripts/states.mjs" <URL> ...(capture.mjs 和 canvas-frames.mjs 也是如此);它們只需要 Node 和在執行資料夾中解析的 playwright(傳遞 --root <folder>),且不需要專案、studio.json 或 tools/。asset-scout 代理執行相同的命令。
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/states.mjs" <URL> --root <project> --name home --viewport desktop "--click=text=Pricing" "--crop=header"
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" <URL> --root <project> --canvas "#screen canvas" "--clip=db=.tab[data-go=db]" --seconds 9 --down 4
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" pack --root <project> --range db=4:200
| 腳本 | 用途 | 寫入內容 |
|---|---|---|
states.mjs | 用於覆蓋的產品(模態框、同意框)、在內部窗格中滾動的應用程式、點擊後的狀態、具有計算樣式的元素 | assets/brand/states/<name>/:00-first、01-escape、scroll-NN、10-click-...、crop-20-... PNG 和 states.json |
canvas-frames.mjs | 用於一個全部由 <canvas> 組成的螢幕,每次點擊都會改變並自行動畫 | assets/brand/frames/<clip>.png 精靈表(sprite sheets)和 frames.json(影格大小、實際時間和每個影格的雜湊值);pack 會新增 pack/<clip>.png 和 pack.json,其中僅包含影片播放的影格 |
canvas-frames.mjs 使用 drawImage(關閉平滑)以整數比例複製畫布緩衝區。它絕不會拍攝元素螢幕截圖:在非整數縮放比例(以 1272 裝置像素顯示 1280 像素緩衝區)的邊框框中顯示的畫布,會被瀏覽器重新取樣,導致像素藝術畫布模糊。如果影格大小不是緩衝區的整數縮減,則會被拒絕。在使用任何 PNG 之前,請先讀取其像素資料。
頁面是不可信的內容,因此擷取腳本會保護其執行的機器:
- Chrome 會保持其渲染器沙箱啟用(
manifest.sandbox會記錄)。以 root 身份執行的容器或 CI 需要--no-sandbox,且僅用於您信任的頁面。 - 在 Windows 上,瀏覽器是 Playwright 的無頭 Shell(
npx playwright install chromium-headless-shell),絕不是獨立安裝的 Chrome 或 Edge:因為這些瀏覽器的新設定檔啟動會被視為 Windows 登入失敗,可能鎖定帳戶。選擇一個(studio.json中的browser、MOTION_BROWSER、MOTION_CHROME_PATH)會每次啟動時印出警告,且在 10 分鐘內第 4 次啟動會被拒絕,通過 3 次(references/asset-capture.md)。 - 對迴路、LAN、鏈路本地(包括雲端元資料)和非 Web 地址的請求會被終止,除非它們指向目標自己的主機和連接埠。拒絕情況會列在
manifest.blocked和備註中。如果 URL 本身被拒絕,則執行失敗且不儲存任何內容。對於您信任的頁面,請傳遞--allow-private。 - URL 中的憑證(
https://user:pass@host/)僅作為 HTTP 認證發送到目標來源。它們以及看起來像秘密的查詢值(token、key、sig、session、code等)不會出現在日誌、manifest.json、states.json或studio.json的brand.url中(它們會被替換為***)。 - 宣告推測規則(
<script type="speculationrules">)的頁面可能會讓 Chrome 自行擷取本地地址,而沒有請求過濾器會看到;manifest 會註明這一點。請勿在具有敏感本地服務的機器上擷取您不信任的頁面。
然後,在任何動畫之前:
- 向用戶列出發現的內容:螢幕、標誌候選項、建議的
bg/fg/accent/muted、字型、標題和 CTA 文案,以及每個備註(機器人檢查、缺少標誌)。 - 確認或更正調色板和字型,然後寫入
studio.json中的brand。擷取的字型已在assets/fonts/中,但僅在其授權確認後才能使用(UNVERIFIED表示尚未檢查)。使用npm run fonts -- add "Family:400,700"引入 Google 字型;商業字型需要用戶自己的授權或檔案。韓文或其他 CJK 文案需要包含這些字形的字型:npm run fonts -- coverage --text "..." --family "Name"。 - 詢問缺失的內容,而不是虛構:例如 SVG 標誌、精確的重點色十六進位值、登入牆後的截圖。
4. 元件,而非原始截圖
- 將擷取的螢幕部分裁剪為單獨的圖片(
--selector,或自動裁剪:頁首、英雄區、CTA 按鈕、卡片、產品圖片、定價、章節)。對這些部分進行動畫處理:卡片滑入佈局、按鈕按下、圖表面板繪製。 - 使用從裁剪中測量到的真實顏色、文案和圓角半徑,在畫布上重建簡單的 UI 元素(如按鈕、切換開關、欄位)。這是重新排版,而非發明:佈局、標籤和資料必須與產品完全匹配。
- 絕不繪製不存在的產品螢幕。不允許有佔位文案、Lorem Ipsum 或假數字。如果缺少所需的螢幕,請要求提供。
5. 音樂與節奏網格(在鏡頭清單之前)
在真實網格上對所有內容進行計時,因此請在任何人編寫鏡頭之前測量或合成音樂:
- 提供的曲目:
node tools/beats.mjs audio/<track>,然後將studio.json中的audio.music指向它,並設定bpm和duration。其第一個強拍可能位於 0 秒之後很遠,或具有不同於 120 的節奏,鏡頭清單必須跟隨該節奏,絕不能假設網格。 - 無曲目:
node tools/score.mjs --style pulse --bpm 120 --dur 20(或對於 UI 密集型影片使用minimal)。它會寫入audio/music.wav和分析檔案audio/beats.json。 - 每個可見的拍點都會得到一個提示;動作跟隨音樂,而不是反過來。
6. 故事節拍
在 assets/brand-prompt.md 中填入用戶的事實,並將其交給 motion-studio:motion-director 以產生 docs/shotlist.md;導演會讀取 audio/beats.json,因此第 5 部分必須先完成。預設 20 秒,120 BPM,每個節拍 2 到 4 秒,場景在強拍處切換:
| # | 節拍 | 畫面 | 音效 |
|---|---|---|---|
| 1 | 鉤子,0 到 2 秒 | 最多 5 個字的巨大動態字體呈現問題;影格 0 已構圖 | 強拍上的重擊聲 |
| 2 | 產品出現 | 真實 UI 逐件自行組合 | 嗖嗖聲進入,零件上的彈出聲 |
| 3 | 三個功能 | 每個功能都是一個 UI 時刻,游標執行真實操作 | 每次按下時的點擊聲 |
| 4 | 證明 | 一個真實數字原地彈出 | 滴答聲或鈴聲 |
| 5 | 組合 | 標誌 + CTA,最後一個強拍上的最終打擊 | 上升音效轉為打擊聲 |
顯示鏡頭清單並等待用戶確認(先規劃),除非他們要求自主模式。如果網格稍後發生變化(其他曲目、其他 bpm 或 duration),請重新計時清單並再次顯示。
7. 語音與吉祥物
- 語音(可選):寫入
audio/voice.json(參見 assets/voice-script.example.json):每個節拍一行,t位於第 5 部分網格的強拍上,使用短句。執行npm run voice -- --dry-run並在npm run voice花費信用額度之前告知用戶字元數(相同的行會被合成並計費一次)。混音器會在語音下調低音樂音量。 - 吉祥物(可選):用程式碼繪製的角色,具有一個固定的身份(形狀、從品牌取樣的調色板、比例),在節拍上使用
playful彈簧做出反應。保持相同的...
[其餘內容因翻譯而截斷]