展示影片
展示影片是以消費者視角,展示實際使用服務的過程。長度 5 分鐘以內。 只要說一句「幫我把這個過程拍成影片,並加上簡單的說明」,就會用預設值從頭做到尾。
預設值:Playwright 錄製(1280×720)· 旁白採字幕(SRT + 嵌入字幕),語音僅在要求時加入 · 輸出為 mp4 + srt。
啟動服務的方式、測試帳號、影片風格請遵循專案中的 CLAUDE.md。
步驟
-
拆分場景 — 將請求拆解為使用者實際操作的流程,共 3 到 6 個場景。每個場景描述「畫面顯示的內容」與「一兩句說明」。
-
實際完整走一遍並錄製 — 啟動服務,使用 Playwright 的
recordVideo(解析度與 viewport 相同)從頭到尾實際操作。 以人類操作速度(slowMo約 300ms),點擊後等待結果顯示在畫面上。影片檔案需關閉 context 後才會完成。 只重新錄製失敗的場景。記錄每個場景的錄製時間點(開始、結果顯示、結束)。 -
撰寫字幕 — 避免使用內部術語或程式碼名稱,改說「這樣做的好處是什麼」。每個場景 1 到 2 句話,在結果顯示後才說。
- 不好的例子:「建立一個將 DMN rule 3 的 hit policy 改為 FIRST 的 PR。」
- 好的例子:「重複的規則被整理好了,同一個訂單不會再重複套用折扣。」
-
編輯至 5 分鐘以內 — 只剪掉或加速載入、等待的部分。操作瞬間與閱讀結果的 2 到 3 秒保留。 若還是超過 5 分鐘,合併場景。不可刪除請求中的關鍵步驟。
-
合成 — 使用 ffmpeg 連接片段,並根據最終編輯版的時間點重新計算 SRT 時間碼,再嵌入字幕。 Windows 需切換到工作資料夾,使用相對路徑(避免路徑中的
:跳脫問題)。字型 Windows 使用Malgun Gothic,Linux 使用已安裝的韓文字型(例如Noto Sans CJK KR)。ffmpeg -i edited.mp4 -vf "subtitles=demo.srt:force_style='FontName=Malgun Gothic,FontSize=22'" -c:a copy demo.mp4 -
確認 — 使用
ffprobe -v error -show_entries format=duration -of csv=p=0 demo.mp4檢查是否小於等於 300 秒。 從幾個字幕時間點擷取畫面(ffmpeg -ss <秒數> -i demo.mp4 -frames:v 1 f_<秒數>.png),親自打開檢查字幕所述內容是否在畫面上可見,以及韓文是否正常顯示。
注意事項
- 不得使用假畫面、模擬回應、注入 DOM 數值或強制點擊來製作場景。若無法完整走完流程,請回報無法完成。
- 實際合併 PR、變更正式環境資料、發送郵件、付款等難以復原的操作,只能在專案指定的測試環境中執行。 若無此類環境,請在該場景執行前詢問使用者。確保密碼、Token 不會顯示在畫面或字幕中。
- 回報內容:mp4 與 srt 路徑、實際長度、每個場景的說明、手動檢查的畫面、未確認的部分。發佈或傳送需另行請求。