HyperFrames Agent 工作流完全指南從 HTML 到視頻的路由、意圖與技能編排【免費(fèi)下載鏈接】hyperframesWrite HTML. Render video. Built for agents.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/hy/hyperframesHyperFrames 是一個(gè)用 HTML 寫視頻的開(kāi)源框架——一段視頻組合composition就是一個(gè) HTML 文件DOM 通過(guò)data-*屬性聲明時(shí)間軸動(dòng)畫運(yùn)行時(shí)可任意 seek媒體播放由框架接管。本文基于倉(cāng)庫(kù)中 skills/hyperframes/SKILL.mdHyperFrames 的強(qiáng)制入口點(diǎn)展開(kāi)完整講解 Agent 面對(duì)做視頻、改視頻、渲染視頻類請(qǐng)求時(shí)應(yīng)遵循的決策狀態(tài)機(jī)如何從項(xiàng)目狀態(tài)出發(fā)、如何路由新鮮創(chuàng)作、如何安裝并加載領(lǐng)域技能以及支撐這套編排的BRIEF.md、意圖訪談與 CLI 版本管理。讀完本文你將掌握 HyperFrames 項(xiàng)目中從一句話需求到可渲染 composition 已確認(rèn) BRIEF的完整 Agent 工作流以及每條路由、每個(gè)命令背后的源碼級(jí)依據(jù)。1. 起點(diǎn)永遠(yuǎn)從項(xiàng)目狀態(tài)開(kāi)始SKILL.md的第一條鐵律是任何視頻相關(guān)請(qǐng)求創(chuàng)建、編輯、動(dòng)畫、渲染、檢查、診斷、校驗(yàn)、預(yù)覽、發(fā)布、批量渲染都必須先讀取本技能然后從項(xiàng)目狀態(tài)出發(fā)決策而不是從通用創(chuàng)作流程出發(fā)。決策依據(jù)是第一張狀態(tài)表自上而下匹配第一行命中的規(guī)則命中的更低行一律不再評(píng)估狀態(tài)動(dòng)作明確將現(xiàn)有 Remotion 源碼移植到 HyperFrames讀取references/routes/remotion-to-hyperframes.md直接路由到該工作流跳過(guò)意圖層對(duì)現(xiàn)有 HyperFrames 項(xiàng)目執(zhí)行特定操作檢查/診斷/校驗(yàn)/預(yù)覽/渲染/發(fā)布/批量渲染只執(zhí)行該操作跳過(guò)意圖與路由加載/hyperframes-cli及所需領(lǐng)域技能對(duì)現(xiàn)有項(xiàng)目做特定編輯直接編輯不運(yùn)行意圖層項(xiàng)目存在BRIEF.md讀取其workflow與flow字段執(zhí)行對(duì)應(yīng)工作流flow: companion一律在/general-video中執(zhí)行不再詢問(wèn)任何 brief 問(wèn)題無(wú) brief但存在hyperframes.json或STORYBOARD.md從項(xiàng)目文件與已記錄偏好恢復(fù)從現(xiàn)有產(chǎn)物推斷歸屬工作流無(wú)法唯一確定時(shí)才允許問(wèn)一個(gè)純路由問(wèn)題不做意圖訪談全新創(chuàng)作運(yùn)行意圖層references/intent-interview.md然后按 §2 的路由表路由一次配套規(guī)則若全新請(qǐng)求沒(méi)有說(shuō)明主題或輸入先問(wèn)視頻主題再路由提問(wèn)前必須先查偏好與配方見(jiàn) skills/hyperframes/references/intent-interview.md 第 1 步。figma.com輸入或已命名配方只改變攝入方式而非路由——由訪談中的 Adapt orthogonal inputs 一節(jié)處理。這套狀態(tài)機(jī)的設(shè)計(jì)意圖很清晰意圖訪談intent layer只對(duì)全新創(chuàng)作運(yùn)行一次。編輯、項(xiàng)目操作、已有 brief、可恢復(fù)項(xiàng)目、顯式 Remotion 移植都直接繞開(kāi)它避免重復(fù)提問(wèn)和重復(fù)路由。2. 保持項(xiàng)目 CLI 版本新鮮升級(jí)探測(cè)是只讀的腳手架項(xiàng)目會(huì)在package.json的 scripts 中固定pinhyperframesversion保證渲染可復(fù)現(xiàn)pin 永遠(yuǎn)不會(huì)自行前進(jìn)且被 pin 的舊 CLI 運(yùn)行時(shí)不打印任何升級(jí)警告。因此恢復(fù)一個(gè)帶 pin 的項(xiàng)目時(shí)應(yīng)在第一個(gè)影響渲染的命令之前做一次探測(cè)npx hyperframeslatest upgrade --project . --check這條探測(cè)是只讀的只報(bào)告 pin 與最新版的差異。注意保留顯式的.——舊版 CLI 上裸寫--project后緊跟另一個(gè) flag 時(shí)會(huì)把那個(gè) flag 當(dāng)作目錄值吞掉。以下任一信號(hào)出現(xiàn)時(shí)執(zhí)行升級(jí)探測(cè)報(bào)告項(xiàng)目落后任何 CLI 輸出已提示stderr 通知This project pins hyperframes… (latest …)被 pin 的腳本在--json結(jié)果中出現(xiàn)_meta.updateAvailable: true。執(zhí)行升級(jí)并驗(yàn)證npx hyperframeslatest upgrade --project . npx hyperframes checkcheck通過(guò)只說(shuō)明composition 在新版本上依然通過(guò)校驗(yàn)不代表渲染輸出與舊 pin 逐幀一致——因此一次成功的升級(jí)絕不能靜默必須在本次運(yùn)行的摘要中同時(shí)寫出新舊版本號(hào)。尚無(wú) composition 的項(xiàng)目無(wú)需驗(yàn)證若check失敗則回滾package.json變更繼續(xù)使用被 pin 的版本并報(bào)告項(xiàng)目停留在哪個(gè)版本及原因。對(duì)信號(hào)采取行動(dòng)而不是把信號(hào)轉(zhuǎn)述給用戶永遠(yuǎn)不要留下一個(gè)已升級(jí)卻未驗(yàn)證的 pin。3. 路由新鮮創(chuàng)作先匹配交付物再讀路由契約SKILL.md的第二張表是新鮮創(chuàng)作的路由表同樣取第一個(gè)匹配行。關(guān)鍵原則匹配的是請(qǐng)求的交付物而不是順帶提到的某個(gè)詞或文件類型。優(yōu)先級(jí)請(qǐng)求工作流1顯式移植現(xiàn)有 Remotion 源碼/remotion-to-hyperframes2編寫演示文稿、pitch deck 或可導(dǎo)航交互式 deck/slideshow3為現(xiàn)有 talking-head 素材添加純字幕/副標(biāo)題而不改動(dòng)畫面/embedded-captions4為現(xiàn)有 talking-head/訪談/播客素材添加設(shè)計(jì)好的圖形疊層而不改動(dòng)畫面/talking-head-recut5由音樂(lè)曲目構(gòu)建節(jié)拍同步視頻無(wú)旁白、無(wú)網(wǎng)站抓取/music-to-video6創(chuàng)作顯式簡(jiǎn)短、無(wú)旁白、以動(dòng)效為先的單元通常 10s/motion-graphics7從 PR 引用解釋 GitHub 拉取請(qǐng)求或代碼變更/pr-to-video8從 URL 或站點(diǎn)專屬 brief 營(yíng)銷/展示網(wǎng)站、產(chǎn)品頁(yè)、App 或公司/product-launch-video9用虛構(gòu)視覺(jué)解釋主題/文章/筆記無(wú)產(chǎn)品、無(wú)站點(diǎn)抓取/faceless-explainer10其他任何自定義視頻或組合/general-video定稿路由前必須讀取references/routes/workflow.md——每個(gè)路由對(duì)應(yīng)一個(gè)小文件內(nèi)含該路由的輸入/輸出/觸發(fā)契約在懶安裝的工作流技能尚不可用時(shí)即可用以及該路由的訪談入口。若候選路由不滿足其契約繼續(xù)向下匹配而不是強(qiáng)行套用只讀取命中的那個(gè)路由文件。3.1 常見(jiàn)歧義裁決SKILL.md給出了一組精確的裁決規(guī)則是路由實(shí)踐中最容易出錯(cuò)的地方短動(dòng)畫標(biāo)題、logo sting、數(shù)據(jù)/圖表命中、地圖命中、獨(dú)立 lower-third無(wú)旁白且動(dòng)效即信息時(shí)歸/motion-graphics靜態(tài)標(biāo)題卡、有旁白的序列、較長(zhǎng)蒙太奇或自定義循環(huán)歸/general-video。顯式短視頻動(dòng)效可以使用 URL、推文、文章或截圖作為素材而用這個(gè)網(wǎng)站做個(gè)視頻的泛化請(qǐng)求是/product-launch-video。現(xiàn)有素材加字幕走/embedded-captions素材加設(shè)計(jì)化信息卡走/talking-head-recut。重定時(shí)、重排、重新調(diào)色、重取景或重混素材屬于自定義編輯落到/general-video。音樂(lè)文件只有在節(jié)拍網(wǎng)格驅(qū)動(dòng)成片時(shí)才選/music-to-video作為背景音樂(lè)使用時(shí)不覆蓋按主題匹配的路由。我想要個(gè)故事板改變的是評(píng)審流程而不是工作流無(wú)其他路由信號(hào)時(shí)用/general-video。已確認(rèn)的草圖板本身可以是交付物評(píng)審循環(huán)定義該停止點(diǎn)。專項(xiàng)敘事工作流支持約 3 分鐘以內(nèi)的成片30–90s 最強(qiáng)明顯更長(zhǎng)的片子路由到/general-video。時(shí)長(zhǎng)永遠(yuǎn)不覆蓋顯式移植、deck、字幕、疊層或音樂(lè)驅(qū)動(dòng)交付物。3.2 路由契約速覽來(lái)自各 route 文件slideshow 路由交付物是可導(dǎo)航的 deck 而非 MP4——離散幻燈片、片段揭示、分支、熱點(diǎn)、演示者模式與演講者備注配套SlideshowController使用的 JSON island。訪談只有一個(gè)問(wèn)題路由確認(rèn)本身前端能力推薦跳過(guò)兩個(gè) run-shape 問(wèn)題都不適用。embedded-captions 路由輸入是真實(shí)媒體文件非 URL 或創(chuàng)作 brief輸出是原素材不動(dòng) 字幕層與選定字幕身份必須問(wèn)題是哪個(gè) clip延遲告知字幕身份選擇先探測(cè)素材再?gòu)哪夸浿卸踢x 2–3 個(gè)并推薦run-shape 不適用。talking-head-recut 路由輸入素材原樣播放輸出疊加轉(zhuǎn)錄同步的圖形卡動(dòng)態(tài)標(biāo)題、lower-thirds、數(shù)據(jù)標(biāo)注、引文、側(cè)欄或畫中畫渲染策略問(wèn)題寬高比、布局、樣式組、卡片數(shù)延遲到其 Step 7由已探測(cè)素材與轉(zhuǎn)錄給出推薦。general-video 路由兜底路由覆蓋靜態(tài)標(biāo)題卡、長(zhǎng)品牌/sizzle 片、多場(chǎng)景蒙太奇、靜態(tài)循環(huán)/海報(bào)、類 NLE 素材重混與自由組合同時(shí)執(zhí)行所有flow: companionbrief兩個(gè) run-shape 問(wèn)題都適用且它是 companion 宿主。4. 路由一次然后離開(kāi)意圖層產(chǎn)出 BRIEF.md對(duì)于新鮮創(chuàng)作意圖層skills/hyperframes/references/intent-interview.md運(yùn)行完整對(duì)話——記憶、分流、pitch 輪、must-haves、run-shape、交接——并以寫入BRIEF.md收尾。BRIEF.md是工作流唯一讀取的路由產(chǎn)物此后任何這條路由要求了什么的問(wèn)題都從BRIEF.md回答不會(huì)再重開(kāi)本技能或訪談。4.1 意圖層的八個(gè)步驟提問(wèn)前先讀記憶用node MEDIA_DIR/scripts/prefs.mjs get --hyperframes MEMORY_ROOT --json讀取記住的默認(rèn)值腳手架前用不存在的探針路徑如/tmp/hyperframes-intent-memory-run-id再用recipe.mjs list檢查配方命名的配方若與可能路由匹配先提出采納采納會(huì)鎖定配方所含字段只問(wèn)缺失字段與兩個(gè) run-shape 問(wèn)題且不取消評(píng)審與渲染審批門檻。分流輸入判斷請(qǐng)求是已成型信息、素材、場(chǎng)合都可讀還是未成型有主題沒(méi)觀點(diǎn)。未成型請(qǐng)求在路由后進(jìn)入 pitch 輪并在此處先問(wèn)一個(gè)問(wèn)題用戶已經(jīng)想象到什么。選路由用 §3 的路由表與歧義規(guī)則然后讀routes/workflow.md。pitch 輪僅未成型請(qǐng)求沿五條真正不同的路徑各取樣一個(gè)概念其中至少兩個(gè)必須落在分布尾部概率 0.10全部展示后再推薦一個(gè)每個(gè) pitch 三行概念一句話、視覺(jué)世界、開(kāi)場(chǎng)鉤子。選中的概念是 brief 的創(chuàng)作核心落入BRIEF.md的## Intent其命名的能力隨## Customizations確認(rèn)。路由 must-haves每字段一問(wèn)推薦選項(xiàng)在前并附帶收據(jù)receipt請(qǐng)求已回答的字段可跳過(guò)——推斷不算回答但選中的 pitch 算。兩個(gè) run-shape 問(wèn)題(a)故事板——在活板上逐 pass 評(píng)審或跳過(guò)板子從已確認(rèn) brief 一次出片(b)自動(dòng)化還是伴跑——automation是匹配工作流端到端執(zhí)行 briefcompanion是回到/general-video一起構(gòu)建。兩者正交絕不合并成一個(gè)菜單flow×storyboard四種組合全部合法。錦上添花推薦而非盤問(wèn)——發(fā)一輪 offer推薦優(yōu)先目錄按需展示素材當(dāng)場(chǎng)回答其具體用途設(shè)計(jì)規(guī)格保持三態(tài)提問(wèn)。交接一次整合檢查陳述與推斷分開(kāi)展示推斷組是糾錯(cuò)區(qū)修正后必須重新展示確認(rèn)絕不執(zhí)行已編輯但未確認(rèn)的 brief。4.2 BRIEF.md 的 frontmatter 契約BRIEF.md約 1KB是訪談的交付物。核心鍵如下鍵含義示例workflow執(zhí)行工作流companion 運(yùn)行記錄為general-videofaceless-explainerflowautomation——匹配工作流的流水線 ·companion——在/general-video中共創(chuàng)automationstoryboardyes——在活板上評(píng)審 ·no——從已確認(rèn) brief 一次出片yesmessage視頻必須傳達(dá)的那一件事Ship it in an afternoondestination/aspect/language/audience/length/angle…該路由確認(rèn)的注冊(cè)表字段—工作流在hyperframes init之后且僅在其之后的第一動(dòng)作就是據(jù)此寫出BRIEF.md——init拒絕非空目錄順序不可顛倒。5. 安裝并進(jìn)入工作流在讀取選中的工作流之前先安裝或刷新它與核心領(lǐng)域技能npx hyperframes skills update workflow-name使用不帶/的裸名稱。命令失敗時(shí)浮出錯(cuò)誤絕不憑記憶重建工作流。其余一切——core 與 lazy 的劃分、init刷新什么、診斷、CI 退出方式、無(wú) CLI 回退——都記錄在 skills/hyperframes/references/skill-lifecycle.md 中。關(guān)鍵生命周期事實(shí)來(lái)自 skill-lifecycleHyperFrames急切安裝核心集/hyperframes、hyperframes-*領(lǐng)域技能、/media-use懶安裝工作流技能路由選中時(shí)才通過(guò)skills update workflow-name安裝。npx hyperframes init檢查 GitHub 并刷新核心集與已裝技能不安裝從未用過(guò)的工作流離線或限流時(shí)優(yōu)雅降級(jí)不阻斷腳手架。--skip-skills暫被忽略CI 可用HYPERFRAMES_SKIP_SKILLS1退出。診斷命令族skills check陳舊或核心集不完整時(shí)非零退出、skills check --json、裸skills update刷新核心集與已裝項(xiàng)、剪除未發(fā)布技能、不擴(kuò)張工作流集、skills update name...額外安裝命名技能、裸skills安裝完整發(fā)布集。無(wú) CLI 回退npx skills add heygen-com/hyperframes --skill workflow-name裝單個(gè)--all裝全套。6. 按需加載領(lǐng)域技能能力地圖與創(chuàng)作者編輯路由SKILL.md的第三張表是領(lǐng)域技能能力地圖——按需加載絕不一次全裝需求技能組合結(jié)構(gòu)、時(shí)間屬性、軌道、變量、確定性/hyperframes-core動(dòng)效規(guī)則、場(chǎng)景藍(lán)圖、轉(zhuǎn)場(chǎng)、運(yùn)行時(shí)適配器/hyperframes-animationSeek 安全的 GSAP、CSS、Anime.js、WAAPI、FLIP、路徑、遮罩、SVG、3D 關(guān)鍵幀或hyperframes keyframes診斷/hyperframes-keyframes設(shè)計(jì)規(guī)格、概念、調(diào)色板、字體排印、旁白、節(jié)拍規(guī)劃/hyperframes-creative圖片、圖標(biāo)、logo、音頻、字幕、調(diào)色、LUT、可復(fù)用媒體/media-use配音 carving、音頻效果鏈、自動(dòng)化包絡(luò)、跨軌單鏈/單推子submix bus/hyperframes-audioinit、lint、check、snapshots、compare、批量渲染、Studio、render、publish 或診斷/hyperframes-cli注冊(cè)表塊與組件/hyperframes-registryFigma 資產(chǎn)、tokens、組件或故事板幀重建為動(dòng)效/figma6.1 創(chuàng)作者編輯短語(yǔ)是跨領(lǐng)域請(qǐng)求當(dāng)用戶說(shuō)出剪輯式口語(yǔ)指令時(shí)需要加載匹配行中命名的每一個(gè)領(lǐng)域技能典型組合見(jiàn)下表例如把這段素材剪了需要/general-video/hyperframes-corecore 擁有data-start、data-duration、data-media-start與軌道布局創(chuàng)作者請(qǐng)求必需領(lǐng)域剪切素材、硬切、修剪、拼接、重排或使用源區(qū)間/general-video/hyperframes-core放大、punch-in/out、多狀態(tài)平滑縮放/重取景、Ken Burns、運(yùn)鏡/general-video/hyperframes-core/hyperframes-keyframes動(dòng)畫內(nèi)層視覺(jué)/裁剪包裝而非定時(shí) clipmatch cut 或 whip pan 運(yùn)鏡轉(zhuǎn)場(chǎng)/general-video/hyperframes-animation/hyperframes-keyframes/hyperframes-registry先搜索/安裝轉(zhuǎn)場(chǎng)原語(yǔ)再手工編寫淡入淡出、交叉淡化、軌道增益/音量、自動(dòng)化、duck/carve、音頻效果或跨軌單效果/general-video/hyperframes-core/hyperframes-audio畫面聲音混合編輯剪切疊加運(yùn)鏡或混音/general-video/hyperframes-core/hyperframes-keyframes有視覺(jué)動(dòng)效時(shí) /hyperframes-audio有音頻處理時(shí)生成素材或預(yù)處理不支持的變速/源內(nèi)凍結(jié)/media-use僅生成/預(yù)處理不做軌道混音兩條關(guān)鍵限制data-playback-rate常量對(duì)畫面與保音高聲音是渲染安全的但不使源變速可做關(guān)鍵幀——變速需預(yù)處理跨領(lǐng)域編輯契約的可復(fù)制版本見(jiàn)/hyperframes-core的references/creator-editing-recipes.md。另外關(guān)于攝影類媒體觀感的寬泛反饋太暗了、太平了、風(fēng)格化一下、遮住臉也路由到/media-use即便用戶從沒(méi)說(shuō)過(guò)調(diào)色或效果。6.2 領(lǐng)域技能不接管端到端交付物領(lǐng)域技能只是能力提供方永不擁有端到端交付物——只加載當(dāng)前工作流實(shí)際需要的那些。構(gòu)建期若涉及重要攝影素材最終質(zhì)量 pass 中應(yīng)包含一次基于事實(shí)的媒體潤(rùn)色掃描保持素材原樣也是合法結(jié)果。關(guān)于素材處理必須先讀 skills/media-use 的 media-treatments 參考 的對(duì)應(yīng)說(shuō)明——它約束的是素材如何被處理絕不約束媒體是否可用不得用通用 LUT、CSS 濾鏡/疊層或透明度 tween 替代既有的規(guī)范處理原語(yǔ)。7. 完整入口鏈路從請(qǐng)求到可渲染項(xiàng)目綜合SKILL.md及其參考文件一條完整的新鮮創(chuàng)作鏈路是讀取本技能強(qiáng)制入口按狀態(tài)表定位全新創(chuàng)作 → 進(jìn)入意圖層其余狀態(tài)按表直達(dá)意圖層八步記憶與配方 → 分流 → 路由 →未成型時(shí)pitch 輪 → must-haves → 兩個(gè) run-shape 問(wèn)題 → 推薦/素材/設(shè)計(jì)規(guī)格 → 交接安裝工作流npx hyperframes skills update workflow-name進(jìn)入工作流其 Setup 在hyperframes init之后寫入BRIEF.md按需加載領(lǐng)域技能§6 能力地圖執(zhí)行構(gòu)建、npx hyperframes check校驗(yàn)、preview評(píng)審、獲批后render。這條鏈路確保三個(gè)不變式意圖只問(wèn)一次、路由只做一次、BRIEF.md是唯一的路由契約載體。對(duì) Agent 而言SKILL.md就是做視頻這件事的決策內(nèi)核——所有后續(xù)工作流、領(lǐng)域技能與 CLI 命令都圍繞這張狀態(tài)表和兩張路由表展開(kāi)?！久赓M(fèi)下載鏈接】hyperframesWrite HTML. Render video. Built for agents.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/hy/hyperframes創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考