外掛安裝: 在執行設定或更新命令之前,若此技能位於 HyperFrames 外掛內,請遵循外掛安裝規則。獨立安裝請保留下方的更新說明。
HyperFrames Studio 慣例
Studio 會為每個頂層元素繪製一條時間軸軌道。遵循下列規則的專案會以簡短、可讀的時間軸開啟;不遵循的專案則會以一堆無法編輯的未標籤軌道開啟。以下是關於建置內容的慣例。關於如何修改剪輯,請遵循 /hyperframes-core 的 references/creator-editing-recipes.md,切勿自行發明不同的編輯方式。
0. 先討論再建置
在開啟檔案之前,先閱讀訊息。判斷對方要求什麼:
| 對方 | 你 |
|---|---|
| 指名了某項變更,無論語氣多客氣(例如「把標題放大」、「可以剪掉第三幕嗎?」) | 直接執行。 |
| 對已建置的影片提供感受性意見(例如「開頭感覺很卡」、「長度似乎不夠」) | 找出原因,改變可測量的部分,說明該意見的含義以及你做了什麼調整,並按照 /hyperframes-creative 的 references/storyboard-recipe.md 第 4 節記錄。 |
| 提出問題但未指名任何變更(例如「為什麼標題會跳動?」) | 回答問題。不修改任何東西。 |
| 說不要修改任何東西、先暫停、「只是在想」、「我們討論一下」 | 不修改任何檔案,即使是你注意到的錯誤也不要改。用語言提出建議。 |
| 針對這部影片提出一個想法但無具體變更(例如「我希望結局更有氣勢」) | 提出變更方案並將其加入計畫(請見下文)。不要修改任何合成檔案。 |
| 要求一部新影片 | 規劃(第 5 節)。 |
| 批准一個計畫(例如「建置吧」、「開始做」) | 按照批准的內容進行建置。 |
一條同時提出問題和變更的訊息,會同時得到回答和變更。只有在無法判斷對方是否要求任何東西時,才屬於對話:一個錯誤的回答只浪費一條訊息;一個錯誤的建置則會浪費長時間執行和一輪意見回饋。
對話回覆:
- 首先用簡短的幾句話,以平實的語言回答。
- 只問那些答案會改變影片的問題,每個問題附上建議答案及其取捨(例如「30 秒適合資訊流;60 秒則為示範留下空間」)。
- 當需要構思一個想法時:對於新影片,請參考
/hyperframes的references/pitch-round.md提供方向;對於關於這部影片的想法,請針對所指名的部分提供兩到三個選項。推薦其中一個。 - 最後說明下一步以及啟動該步驟的關鍵字(例如「說『建置』我就開始」)。
將計畫保留在專案中,而不僅僅是對話記錄中:下一條訊息可能開啟一個無法看到當前對話記錄的新工作階段。按照 /hyperframes-creative 的 references/storyboard-recipe.md 第 4 節記錄一輪意見的方式,將計畫新增到 STORYBOARD.md;絕不要覆蓋已鎖定的影格。如果對方要求你完全不要修改任何東西,則什麼都不要寫:在回覆中提出計畫,並詢問是否要將其儲存下來。
1. 每個場景都是一個子合成
根合成只包含計時主機、媒體和音訊。任何具有巢狀結構的場景(包含子元素的 div、包含副標題的標題、圖表)都應使用自己的檔案,並透過 data-composition-src 載入,接線方式請參考 /hyperframes-core 的 references/sub-compositions.md。
留在根合成內的巢狀標記不會成為獨立的軌道。它會隱藏在一個不透明的軌道內,無法逐部分修剪或移動。
編寫時應假設有一個結構檢查工具會拒絕任何違反規定的情況。
2. 一條字幕軌道
- 所有字幕都位於同一條軌道上:一個單一的子合成主機(一個
data-track-index),標記為data-track-kind="captions",按順序承載所有字幕組。 - 切勿為每個字幕組使用一條軌道,也不要將字幕與其他類型混合在同一條軌道上。
- 字詞時間規則不變:請參考
/embedded-captions和caption_*的 lint 規則。
3. 每種元素類型一條軌道
按類型分組,以便每一行都是一個完整的元素,使用者可以將其作為一組進行選取、靜音或拖曳。
| 類型 | data-track-kind |
|---|---|
| 基礎影片 / A-roll | video(來自標籤) |
| 場景、疊加層、圖形 | graphics |
| 字幕 | captions |
| 音訊(旁白、音樂、音效) | audio(來自標籤) |
將 data-track-kind 放在子合成主機上。影片和音訊類型來自標籤,因此 <video> 和 <audio> 不需要屬性。為每個類型指定各自的 data-track-index;該數字僅供顯示,不會改變渲染的圖層順序。使用 CSS 進行圖層管理。
4. 安全區域
任何參考線或安全框疊加層都位於預覽窗格中,絕不在合成內部,因此請勿在 HTML 中添加輔助元素。
兩種畫面比例(寬螢幕和直立)都使用相同的兩個安全框,即 Premiere 的預設值。預覽切換開關會繪製它們,並在每條邊的中點加上刻度。來源:packages/studio/src/utils/previewSafeMargins.ts 中的 ACTION_SAFE_PERCENT 和 TITLE_SAFE_PERCENT。
| 方框 | 佔畫面比例 | 每邊內縮比例 |
|---|---|---|
| 動作安全框 | 90% | 5% |
| 標題安全框 | 80% | 10% |
- 安全邊距:所有可見內容都應位於動作安全框(90%)內,字幕和關鍵內容則應位於標題安全框(80%)內。
- 雙欄和 50/50 佈局應確保每一半的內容都位於標題安全框內。
5. 新影片:規劃、分鏡、建置
hyperframes-launches 的影片是按照以下順序製作的。每個步驟都有負責人;請遵循此順序,不要在此重述。
| 步驟 | 負責人 |
|---|---|
| 1. 簡報 | /hyperframes 的 references/intent-interview.md。在現有專案中,只有針對同一部影片的後續工作才保留:新版本或剪輯版,同樣的工作流程和畫面比例。詢問其必答問題,跳過 hyperframes init,絕不覆蓋 BRIEF.md 或 STORYBOARD.md,為每個檔案新增一個新的日期章節,並在回覆中說明。具有不同工作流程或畫面比例的影片應啟動一個新專案,並在回覆中說明。 |
| 2. 方向 | /hyperframes 的 references/pitch-round.md |
| 3. 分鏡 | /hyperframes-creative 的 references/storyboard-recipe.md |
| 4. 建置 | 簡報所指派的工作流程(/hyperframes 第 2 節)及其自身的參考文件 |
| 5. 意見 | /hyperframes 的 references/review-loop.md |
以下是發布影片的附加規則,適用於產品發布。當工作流程選擇的故事弧線有不同規定時,以故事弧線為準。
- 發布產品的實拍畫面。 在簡報中要求對方提供螢幕錄影,除非工作流程本身會自動擷取(例如透過 URL 擷取網站),並用一個帶有標籤的佔位符保留其位置,直到取得錄影為止。切勿模擬已發布產品的 UI。作為背景顯示的第三方工具(例如聊天應用程式、編輯器)應根據擷取內容忠實重建。
- 同一個世界。 同一視窗或畫布在各個節拍之間應保持連續。檢查每一個剪輯點:任何持續存在的元素都不得跳動。
- 游標與滾動內容。 游標或視窗本身滾動出去的內容,應通過視窗或影格邊緣離開,而不是在畫面中間淡出。元素和文字切換應遵循工作流程中包含的
cut-catalog.md。 - 以指令或網址作為結尾, 並將標誌落在仍在移動的影片上。
- 在每個版本中聲明執行時間。 是否超出目標長度由對方決定,而非由你決定。
檢查你的工作
執行 hyperframes check(它會執行 lint)並修正所有發現的問題。然後在 Studio 中開啟專案,確認時間軸顯示了一條基礎軌道、每條場景主機一條軌道、一條字幕軌道以及音訊軌道。