產品影片(及其相關資產),端對端流程
您正在製作一個可發佈的產品資產——一部精美影片、一組精確尺寸的靜態截圖,或兩者兼具——來源是一個即時網頁,使用 vos CLI。
一切都是數據:您編寫流程腳本,CLI 負責錄製與規劃,您調整 JSON 參數,然後重新渲染。絕對不要為了修正節奏或縮放而重新錄製——只需編輯 doc.json 並再次渲染即可。
品質標準:請遵循 references/taste.md —— 依照其品質循環,並以多模態方式判斷靜態截圖。
設定
npm i -D @vosjs/cli
一個命令,一個套件:@vosjs/cli 是開源 (MIT) 的 vos 二進位檔,包含引擎動詞、此處使用的錄製管線(螢幕錄製的 record / plan / frames / render)以及 vos.so 平台動詞。(在 0.9 版本之前,錄製管線是作為 @vosso/vos-plugin 單獨發布的;若專案中仍列出它,則可將其移除。)
需求:
- 一個 Chromium 瀏覽器:系統 Chrome 會被自動找到;否則執行
npx playwright install chromium或將VOS_BROWSER_PATH指向一個瀏覽器。 退出碼 3 表示未找到瀏覽器。 - 渲染時需有網路連線:渲染頁面會從 esm.sh 載入 three/mediabunny。錄製時也需要能連線到目標 URL。 完全離線的沙盒環境無法進行渲染——請直接告知,而非輸出空無一物的結果。
慣例:日誌輸出到 stderr,結果輸出到 stdout;使用 --json 會輸出以換行分隔的 JSON 資料流 (NDJSON),並以 `{