產品示範影片流程
所有操作透過 tin-studio（執行 tin-studio help）進行。在執行環境提供的工作目錄（稱為 WORK；API 執行使用 /home/tin-work/studio，傳統 OAuth 執行使用 /home/user/.tin-lite/studio）中進行 Studio 操作；只有最終的 MP4 檔案會放入專案 checkout 目錄中。這不是即時螢幕錄影：你捕捉已穩定的關鍵影格，渲染器會合成捲動、點擊、縮放與字幕動畫，因此結果會非常流暢。
1. 規劃故事
- 閱讀
wiki/INDEX.md（## Product、功能地圖、定位）。閱讀angle與notes。 - 執行
tin-studio inspect <product_url> WORK/inspect。閱讀 JSON：headings及其scrollY、帶有現成selector的actions（優先使用inHeader: true的導航用 selector）、text、docHeight。用圖片檢視器打開WORK/inspect/inspect.png與WORK/inspect/inspect-full.png，注意每個畫面顯示的內容。如果故事需要，可再檢查一兩個頁面（文件、定價頁）。 - 決定格式：
script-format.md描述：一個最多七個字的鉤子（hook），點出痛點（若有angle則使用該內容），接著五到七個步驟。每個步驟是一個可見的瞬間，搭配一句最多十四個字的旁白與一條最多五個字的字幕。每個字幕與鉤子中標記恰好一個*單詞*。最後一個步驟落在頁面實際提供的行動呼籲（試用、定價、安裝）上，並加上一條[warm]台詞。總台詞最多 75 個字。 - 主張來自頁面文字或專案記憶；數字必須在提到該數字的步驟中顯示於螢幕上。
- 每一句台詞都以創作者對觀眾說話的方式撰寫：現在式、第二人稱、直接講述事物本身。切勿描述頁面（「頁面顯示」、「此區塊列出」、「網站範例」）；說明其對觀眾的意義（「你的 Agent 會獲得自己的編號」）。數字與數量用文字表示，品牌名稱保留於完整句子內。
2. 撰寫與捕捉
- 依照
script-format.md的格式撰寫WORK/script.json。 - 執行
tin-studio capture WORK/script.json WORK/out。用圖片檢視器打開每個WORK/out/frames/kNNN.png並檢查：頁面已載入（無空白、無錯誤、無插頁廣告）；沒有 Cookie 橫幅或彈出視窗遮蓋內容（若出現此類元素，則新增一個點擊該關閉按鈕的步驟，或選擇無此問題的頁面）；每個捲動位置與字幕預期相符；每個點擊命中目標元素（點擊關鍵影格顯示新頁面）。錯誤的關鍵影格需修正腳本：從 inspect 取得更好的selector、scrollTo、更大的settleMs，或改用不同頁面。重新捕捉直到每個關鍵影格正確為止。
3. 語音
- 執行
tin-studio voice WORK/out --voice <voice> --language "<language>"。在鉤子台詞上加上[excited]，在最後一句加上[warm]；其餘為純句子。每次執行會印出每個步驟的片段長度；若片段超過五秒，則縮短該句。 - 單次執行有上限（24 行、3000 個字元）。重新執行時會保留未修改的行，因此只需在
WORK/script.json中編輯一行，無需重新捕捉，再執行voice即可。 - 若提供者拒絕某句台詞，會回報為
REFUSED並附上原因，其他台詞則保留。content_policy_violation表示提供者的不透明文字檢查誤判：首先不要帶任何--style參數再次執行voice（已知預設樣式可通過），然後用更簡單的措辭改寫該句並再次執行voice。切勿重送未修改的被拒絕台詞，且對同一句最多嘗試兩次改寫；放棄該句，讓字幕承擔該步驟。
4. 預覽、渲染、檢查
- 角色：當設定
character時，檔案路徑為/home/user/project/characters/<character>.svg；先對該檔案執行tin-studio check。若缺少或被拒絕，則不帶角色進行渲染，並在訊息中說明。 - 在完整渲染前預覽三個影格（鉤子、中間捲動處、最後步驟）：
tin-studio frame WORK/out WORK/p1.png --at 1.5 --bg <backdrop> [--character <svg>]， 並在總長度約一半處及結尾再次預覽。檢查：字幕清晰可讀且居中、角色臉部可見且未遮蓋字幕、手機卡片顯示正確畫面、背景不衝突。 - 渲染：
tin-studio render WORK/out WORK/<slug>.mp4 --bg <backdrop> [--character <svg>]。 它會印出影片長度。接著tin-studio check WORK/<slug>.mp4必須輸出OK，且tin-studio probe應顯示 1080x1920 並包含音訊串流。 - 若超過 40 秒：刪減一個步驟或縮短台詞，重新執行
voice，再次渲染。
5. 交付
將檢查過的 MP4 複製到指定的輸出路徑，不要複製其他檔案。最終訊息為故事板：鉤子，然後每個步驟的字幕、旁白台詞與螢幕內容；標示總長度、使用的語音、背景與角色；以及任何因頁面不支援而軟化處理的主張。
規則
絕不註冊、登入、填寫表單、或按下購買、發送、刪除、邀請、聯絡按鈕。不得使用任何帳戶。不得捕捉登入後頁面。不得編輯頁面 DOM 來偽造狀態。不得在專案 checkout 目錄中建立除指定輸出檔案以外的任何檔案。