## 📂 專案

選過的專案（對時、腳本都會一起還原）不用重新選路徑。

## ⚙️ 設定（AI CLI，選填 — 不設定也能用，旁白會改用數據規則生成，只是不會描述畫面內容）

這格要填的是「怎麼呼叫你電腦上已經裝好的 AI 指令列工具」的完整指令，程式會照你填的內容 直接執行。`{prompt}` 這串文字，執行時會被換成程式要問的問題； `{image}` 會被換成一張截圖的實際路徑。
例如你填 `claude -p "{prompt} 圖片路徑: {image}" --allowedTools Read`， 程式實際執行時就會變成 `claude -p "描述這張圖... 圖片路徑: C:\...\f_001.jpg" --allowedTools Read`。

AI 指令鏈（由上而下依序嘗試）
第一個連不上、額度用完、或任何錯誤，會自動往下一個試，全部失敗才報錯（錯誤訊息會列出每個工具各自的原因）。 成功的那個會被記住，之後直接從它開始，不會每次都重試掛掉的那個。
可用變數：`{prompt}` 問題文字、`{image}` 圖片路徑 （單獨當一個參數時會展開成多個檔案，供 `-i a.jpg b.jpg` 這種多圖參數使用； 純文字呼叫時會連同前面的旗標一起移除）、`{out}` 暫存檔路徑 （有填的話就從該檔讀答案，而不是讀螢幕輸出——適合會印出工作階段訊息的工具）。
API key／登入額度都是你自己的 CLI 在管，本程式不會儲存任何金鑰，只儲存這些指令文字本身。

## 📝 AI 提示詞範本（可編輯，存在 data.db）

要編輯哪個
範本名稱
選定的範本會套用在目前載入的專案上（每個專案可用不同範本）。

## 1選擇素材（單機模式：只記路徑，不複製檔案）

多段會依順序自動接在同一條 FIT 時間軸上，一次輸出成一支影片。需相同解析度與幀率。
FIT
貼絕對路徑即可，檔案留在原地，程式只讀取不複製。
📎 參考附件（選填）
排行榜截圖、相關網頁、人物介紹文字檔…AI 寫旁白時會參考

## 2對時（影片 ↔ FIT）

對時片段
影片位置(秒)
或手動：
相機原始檔（沒經過剪輯軟體轉檔的）內含錄影開始時間，按第一顆按鈕一鍵完成。 畫面上有燒錄時鐘浮水印的影片可用 AI 判讀；兩者都不行才需要手動輸入。

## 3分析截圖（產生每張截圖的畫面說明）

透過 FIT 自動分析場景 截圖間隔(秒) 每批連拍張數 使用 AI 辨識畫面內容
自動模式：從 FIT 的功率／心率／迴轉／速度變化找出高光時段，只在那些時段連拍分析 （每時段連拍「每批連拍張數」張、每秒一張）。平淡路段不截圖、不花 AI 額度。
「每批連拍張數」>1 時，連續的截圖會整批一次交給 AI 看「這幾秒發生了什麼變化」—— 描述有動態（誰從哪側超越、距離拉近拉開），呼叫次數也除以批量。設 1 ＝ 傳統單張模式。 已辨識過的批次會自動沿用不重跑。

## 4旁白 / 字幕

旁白聲音
旁白最大空白(秒) 每句旁白左邊的 ▶ 可以立刻試聽這個聲音唸出來的效果。
根據截圖說明＋騎乘數據＋附件＋補充背景，重寫整份旁白（會覆蓋下方內容）
📟 儀表盤（從 FIT 數據疊加到畫面） 位置與大小為預設編排：左側高度/坡度/迴轉數、左下心率、右下速度、右側功率—— 啟用後下面點選任一句旁白，也會一併顯示該秒的實際數據，方便比對時間戳有沒有對錯
配置
標題文字
要調整每個數值的位置／大小／顏色，按「開啟編輯器」—— 在新分頁裡拖曳即時預覽，存成配置後回到這裡選用即可。
對應畫面

秒 | 旁白（TTS 唸） | 字幕（留空=同旁白） |
--- | --- | --- | ---

## 5生成影片

解析度
編碼
旁白聲音
節奏背景音（心率+功率驅動） 音量 0.9 片尾停留(秒) 旁白提前(秒)
「旁白提前」＝整份旁白與字幕一起往前挪。因為講話需要時間， 在該秒才開口的話，關鍵字唸出來時畫面往往已經過去了；提前一點可以讓描述正好落在那個畫面上。 字幕與語音永遠一起移動，不會對不上。