Communitygithub.com

互動式分鏡腳本

將完成的繪製分鏡腳本(PDF 或圖片)轉換為一個 HTML 頁面上的互動視覺故事:引導式手勢、合成或錄製的音效、選定的視覺風格與多語言文字。

互動式分鏡腳本 是什麼?

這個技能是為已熟悉分鏡腳本(包括分鏡板、鏡頭、場標與註記)的創作者設計,它能將傳統的靜態分鏡腳本轉化為一款互動式視覺故事網頁。使用者可以透過點擊、長按與拖曳繪製畫面本身來推動故事進展,同時結合音效、對白/字幕以及符合影片節奏的轉場效果。此技能並非用來產生動態分鏡(animatic),而是保留原始手繪線條,並提供三種視覺預設(電影/美式漫畫/像素風格)來決定最終呈現的氛圍。它支援使用者錄製的音檔或 WebAudio 合成音效,並且內建多語言文字切換功能。工作流程分為以下步驟:先詢問必要的客製化選項(場景、外觀、文字、音效、語言與部署方式),然後自動讀取 PDF 分鏡並建立連拍表,再依據鏡頭邏輯(如長鏡頭、遠近景匹配)重構背景與手勢互動,最後產生單一 HTML 頁面,透過 canvas 繪圖與場景狀態機驅動互動。輸出內容可直接分享為網頁,或嵌入使用者的現有網站。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/beiabei10/interactive-storyboard/tree/HEAD/interactive-storyboard

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

互動式分鏡腳本 是做什麼的?

將完成的繪製分鏡腳本轉換為一個互動式視覺故事:一個網頁,觀看者透過點擊、長按與拖曳繪製畫面本身來推動故事,搭配音效、對白/字幕以及符合影片節奏的轉場效果。這個技能是為已熟悉分鏡腳本(分鏡板、鏡頭、場標與註記)的人設計;它不是一個動態分鏡產生器。

此技能作者丁怡霖的範例作品:The Joy of the White Room 與 Fahrenheit 451(場景 1、8、9)——請參閱 examples/;線上體驗:The Joy of the White Room、Fahrenheit 451, scenes 1 → 8 → 9。

0. 建置前先詢問(一輪後開始執行)

只詢問會改變建置結果的項目;其餘部分採用合理的預設值,並明確告知使用了哪些預設。

  1. 哪些場景/分鏡板(如果分鏡腳本很長:先試做一個場景,其他場景再用相同方式處理)。
  2. 外觀:選擇下方預設之一,或選擇「保留原始繪圖樣貌」。
  3. 文字:僅對白 / 旁白 / 兩者皆有 / 無。使用分鏡腳本原有的文字;切勿自行編造對白或旁白。
  4. 音效:使用使用者錄製的音檔(需提供檔案並告知每個音檔屬於哪個分鏡板)或合成音效。
  5. 語言:務必詢問該作品需要哪些語言;沒有預設語言集。只建置指定的語言。所有螢幕上的字串(標題、場標、提示、對話框、製作名單)皆存放於各自語言的表格中,並可在播放時即時切換;若包含多種語言,起始語言可遵循宿主頁面(?lang=、postMessage 或 <html lang>)。你提供的翻譯為草稿,使用者應進行確認。
  6. 存放位置:僅為可分享的獨立頁面,或同時嵌入使用者自己的網站(若需嵌入,則請提供網站套件,並編輯他們的副本)。
  7. 製作名單:完全依照使用者提供的措辭(例如「製作者:……」);不得新增他們未列出的角色。

1. 閱讀分鏡腳本

  • Storyboarder / PDF 匯出:使用 pdfimages -png 將每個分鏡板以完整大小(包含註記區域)匯出為 PNG;找出繪圖邊框(掃描行列以找到框線),並以相同方式將所有分鏡板裁切至繪圖區域(若場景比例為 16:9,則保留 16:9 視窗)。使用 pdftoppm -r 150 渲染頁面,並讀取註記、場標(EXT./INT. … – 日/夜)、持續時間與對白;pdftotext -layout 可取得場標。
  • 製作一個連拍表以及每個分鏡板的網格化檢視(每隔寬度/高度的 0.1 畫一條線):之後的所有座標(角色站立位置、點擊位置、螢幕位置)都將以影像分數(image fractions)為單位在這些檢視圖上量測,絕不猜測。
  • 撰寫一個節拍列表:分鏡板 → 發生的事件 → 能讓觀看者執行該動作的單一手勢 → 音效 → 文字。

2. 先處理鏡頭,再處理特效

  • 找出長鏡頭。 連續幾個分鏡板如果拍攝設置相同且主體在移動(例如人物從 A 走到 B 再到 C),則屬於同一個連續鏡頭:建立一個乾淨的背景(利用其他分鏡板將主體移除),將主體剪下並移動,攝影機隨之漂移。不要在這種情況下使用整張分鏡板的交叉溶解。
  • 對相同主體的近景 → 遠景(或反向)屬於同一個移動:將遠景分鏡板放大,使其主體與近景分鏡板中的大小和位置相同(根據量測的頭部/腳部位置計算縮放與中心點),在達成匹配構圖後完成交叉溶解,然後再拉遠。檢查匹配構圖的螢幕截圖;若出現鬼影表示數值有誤。
  • 需要被視為同一個移動的分鏡板應共享同一個色板(使用相同的預設顏色處理)。
  • 當使用者表示某個分鏡板顯示的是電視機的背面、從背後看到的門等,切勿繪製分鏡板上未顯示的任何內容:可以用光線與音效暗示畫外空間。

3. 外觀預設

所有預設均保留使用者的線條繪製;絕不重新繪製。

  • 電影 / 孔版印刷(Riso)風格(White Room 的樣式):按場景分級調色(明亮飽和的顏色對比陰暗氛圍),柔和的紙張紋理,細微的顆粒感;偶爾——非持續——的片門抖動、閃爍與輕微刮痕;一個註冊陰影。特效稀少且柔和:持續的閃爍或抖動會使人疲勞。
  • 美式漫畫風格:雙邊平滑處理;利用暗色閾值加上黑頂帽變換產生墨水層,使極細鉛筆線條也能被墨線化;在繪製區域內使用平坦的專色,中間調使用 45° 班點網點,並在整張圖板上疊加淺色網屏,邊緣密度更高;顏色板與墨水板偏移 1–2 像素;輸出大小約為 1.5 倍。每個地點/時間使用一種專色(溫暖的白天、藍色的夜晚、綠色的 CCTV、紅色的警報……)。字體:場標使用黃色說明框,對白使用漫畫狀聲詞放在畫面中,對白使用對話氣球。
  • 像素風格:將圖像縮小為一個小網格,使用有限色板與有序抖動,然後以最近鄰插值法放大;文字使用像素字型。

頁面邊框會根據預設風格變化(放映室、新聞紙頁面、遊戲畫面)。網頁字型載入時會有一個 2–3 秒的備用競賽機制,確保故事不會因字型而等待。

4. 建置:一個 HTML 頁面、一個 Canvas

  • 一個 16:9 的舞台、一個 canvas、下方的字幕/提示區域、語言切換(若有多種語言)以及音效開關。
  • 場景狀態機:每個場景是一個物件,包含 enter / render(t) / tap / drag / down / up / hover / key;go(scene) 切換場景;st() 回傳場景內的時間。一個攝影機輔助函式(setCam(img, zoom, cx, cy)、toScreen、toImg)讓所有互動區域與特效以影像分數為單位放置,並跟隨攝影機。
  • 每個場景都有離開方式:一個鍵盤按鍵以及一個緩慢的自動備用機制(10–20 秒),確保沒有人會卡住;較長的場景還需加上「跳過」連結。
  • 將所有音效呼叫包裹在錯誤處理中,確保缺少音頻上下文或解碼失敗時不會中斷故事。
  • 使用 <img> 載入圖片(在 file:// 協議下也可運作);音訊則透過 fetch + decodeAudioData 載入,當 fetch 被封鎖時備用為 <audio> 元素。

5. 互動設計

  • 手勢就是故事的動作。 奔跑 = 快速點擊;屏住呼吸 = 不要觸碰;探身觀看 = 按住;攀爬 = 重複向上拖曳;遞交某物 = 攜帶它;翻頁 = 在書本上橫向拖曳;關閉電源 = 按住按鈕上的手。盡量偏愛這些手勢,而非通用的「點擊繼續」;單純的點擊保留給對白與純節奏的節拍。
  • 使用使用者自己的繪圖,絕不使用發明的道具。 沿著物體輪廓剪下(在網格化縮放圖上用多邊形描邊,邊緣柔化),加上細白邊框(類似剪紙),拖曳時提起並加上小陰影與傾斜,在原本位置留下空白紙張,若放置錯誤則彈回。檢查剪下範圍是否與分鏡板一致:切勿誤剪入樓梯、傢俱或其他角色的手。
  • 添加在分鏡板上的特效(螢幕亮起、無線電波、觀景窗)必須符合繪圖的幾何形狀——將螢幕光暈裁剪至螢幕的透視四邊形,而非矩形——並且應向使用者指明這些是額外添加的。
  • 提示要說明位置與方式:「按住魚並來回塗抹」,而不是「與之互動」。字體大於內文,放在圖片下方。
  • 畫面上的引導標示,預設為靜態(參考 What Remains of Edith Finch 的設計):在觸控點上放置一個小標誌,已經顯示動作——輕觸為脈衝,長按為填充環,拖曳方向為 V 形箭頭,畫圈為旋轉弧線(漫畫風格:使用墨水「看這裡」的勾勾)。步驟開始時,一隻手演示手勢兩次,然後縮回;只有在約 3 秒無操作後才會再次出現。手指按下時隱藏所有引導。切勿用長虛線路徑遮蓋圖畫。

6. 轉場

  • 配合情緒:預設為柔和(溶解時新面板從略大尺寸穩定下來、墨水淡出/淡入、電視開啟或火焰點燃時的輕微光暈)。僅在單一震撼場景中使用一個硬切(負片格、速度線、抖動)。全部使用硬切會顯得太僵硬。
  • 連續平推至下一個空間是一個長移動:兩者之間的任何東西(例如牆壁)會採用目標面板的顏色與紋理,並融入其中;移動過程中不應出現裝訂線。
  • 切勿顯示旋轉或縮放圖像的黑邊:將攝影機限制在畫面內。

7. 音效

  • 錄製的音效:修剪至與動作同步(門打開的聲音與繪製的門把同步),統一音量,環境音循環加入淡入淡出。
  • 合成音效(使用 WebAudio,無需檔案):腳步、紙張、門、機械獵犬、警報、心跳、電視低語…… 每次播放都隨機化(時間、音高、包絡),並使包絡形狀不均勻,避免聽起來像機器重複;在安靜場景中避免點擊聲與乾燥的嗶嗶聲。
  • 使用音橋來傳達意義(洗衣機的聲音逐漸變成夢中的大海;音效在標題區域持續)。在添加分鏡腳本未暗示的音效前先詢問。

8. 文字

  • 對白:使用對話氣球(漫畫風格)或字幕(電影風格),尾巴指向說話者的頭部,保持在面板內部,透過測量自動換行,絕不以閉合標點符號開頭。分別填滿每個氣球的內容與尾巴,確保筆畫不會穿過文字。
  • 場標以說明框形式放在角落;避免遮擋重要的繪圖區域(如果某個分鏡板上的場標會遮住主體,則跳過該說明框)。
  • 你添加的引用內容(例如角色朗誦的內容)必須屬於公共領域,並告知使用者。

9. 效能

  • 將 canvas 寬度上限設為約 1600 像素(DPR = max(1, min(devicePixelRatio, 2, 1600 / cssWidth)))。
  • 預先渲染靜態疊加層(紙張紋理、暗角)一次,並在每個影格上疊加;切勿每影格重建漸層或圖案。
  • 對於溶解效果,將前一影格保留為半尺寸,而非每影格複製一份完整尺寸。
  • 在宿主頁面上延遲載入故事(使用海報 +「進入故事」按鈕);每個場景頁面只載入自己的圖片。

10. 像觀眾一樣測試

  • 使用無頭瀏覽器(例如 Playwright)搭配真實滑鼠手勢(點擊、長按、拖曳,從 toScreen 量測座標),遍歷整個故事,每種語言都要測試,遇到任何頁面錯誤即視為失敗。暴露一個僅用於測試的 __go(scene, state) 函式以跳至特定節拍。
  • 擷取每個關鍵影格以及每個轉場/匹配過程中的影格的螢幕截圖;仔細檢視。
  • 編輯腳本後進行語法檢查(node --check)。不要在單行陳述的中間使用 // 註解(這會悄悄註解掉該行剩餘部分,導致頁面空白)。
  • 在重大變更前後量測影格率。明確說明音效與感受是透過量測與螢幕截圖驗證的,而非透過實際播放。

11. 交付

  • 提供可分享的託管頁面供審查;對於使用者的網站,提供包含故事的他們網站套件壓縮檔(故事放在自己的資料夾中,例如 story/<project>/)、一個延遲載入的嵌入區塊,並且不更改其他任何內容。如果使用者已在他們的網站內改編了故事,務必編輯那個改編版本(對其進行三方合併),切勿用原始版本覆蓋它。
  • 多個場景:每個場景一個頁面,共用同一個資源資料夾,場景之間串聯(一個場景結束 → 下一個場景,保留語言設定;最後一個場景返回第一個)。每個場景的封面需要一次點擊來解鎖音訊(導航後)。
  • 絕不代替使用者部署到任何地方;只需交付壓縮檔。
  • 單獨開啟一個檔案會是黑色畫面:頁面需要旁邊的 a/ 資源資料夾。交付檔案時請告知使用者此點。

相關技能