此橋接器的 HyperFrames 創作參考
此精簡參考專為橋接器設計。完整產品指南請見已安裝的桌面應用程式及官方 HyperFrames 文件。
組成
一個獨立的 index.html 在 body 中直接有一個合成根元素。請使用 data-composition-id、data-width、data-height 及有限的 data-duration。根元素的 CSS width/height 為 100%;畫布尺寸則應放在其 data 屬性中。子合成使用一個範本,並將其樣式/腳本寫在範本內部。
為片段指定 class="clip"、明確的 data-start/data-duration 和 data-track-index。一個軌道是 Studio 中的一條車道,並非時間限制或 z-index。根元素的 duration 必須涵蓋所有預定片段的結束時間。編輯時請保留不相關的時間設定、識別符號及媒體。
在 window.__timelines[compositionId] 中註冊一個暫停的 GSAP 時間軸,使用與根元素相同的 ID。對內部元素進行動畫;由框架控制片段的可見性與媒體搜尋。請勿對片段進行 display、visibility 或 autoAlpha 的動畫。避免 CSS-transform/GSAP 衝突、時鐘、計時器、未設種子的隨機值以及依賴網路的動畫狀態。
使用可本地重現的媒體。每個音訊元素都需要唯一的 ID 和有意義的時間設定。避免在媒體上使用 crossorigin,以及在含有 data-start 的影片周圍放置巢狀的時間祖先。檔案路徑必須與實際專案資產相符。
工作流程
在編輯前,請先閱讀相關檔案及應用程式所需的指南。比對使用者要求的範圍。請勿聲稱執行不可用的 MCP 工具或 shell 命令。橋接器會公開命名為 lint、check、timeline 和 inspect 的命令。
執行有意義的命名檢查,回報其實際的退出狀態與發現結果,並保留不相關的工作。lint 錯誤可能會阻止 runtime/layout/contrast 檢測的執行;零樣本並不代表成功的視覺驗證。通過 lint 並非視覺品質的證明。
僅在使用者要求匯出且 app_rules 允許時才進行渲染。持續輪詢 render_status 直到終端狀態;絕不能聲稱未完成的匯出已成功。桌面應用程式可能自行負責匯出,此時請遵循其 app_rules。
音訊資產
在本機啟用且使用者要求時,list_voices 會回傳使用者可用的語音 ID。create_speech 和 create_sound_effect 會回傳實際的、相對於專案的 MP3 檔案。在合成中使用回傳的路徑,並賦予唯一的音訊 ID 和適當的時間設定。若生成失敗,請回報失敗,不得自行發明資產或自動重試。
語音與音效是使用使用者自己的金鑰進行的產品 API 呼叫。腳本/描述會被傳送至 ElevenLabs,生成過程可能消耗點數。聊天僅限文字。此版本不開放音樂、圖片或影片生成。