shorts-from-peaks
工具順序
search_videos(query, n, shorts)- 搜尋 YouTube，依觀看次數與病毒式傳播潛力排名結果，並將其與熱圖峰值一併儲存。list_sources可顯示已儲存的內容。偏好官方或授權來源。get_peaks(video_id)- 已儲存來源的熱圖峰值。若無熱圖，請明確告知；建議改用其他來源或手動設定區間，切勿憑空捏造峰值。create_clip_project(video_id, peak_rank=1, hook_text)- 從峰值建立編輯器草稿，或傳入start/end秒數進行手動區間（直接執行）。render_project(video_id, hook_text, custom_script)- 在背景渲染草稿（直接執行）；透過get_job(job_id)輪詢狀態。其checks_failed會列出未通過的轉換檢查項目。- 修正未通過的檢查，然後要求使用者確認後使用
queue_add(project_id)加入佇列。ui_open("editor", video_id)可向使用者展示草稿。
- 若無熱圖，或使用者上傳/提供長影片連結：
autoclip_source(url, length, max_clips, prompt, create_drafts)可從逐字稿找出最佳片段，並回傳排名剪輯（透過get_job輪詢）；若create_drafts=true，則直接進入編輯器。
讀取峰值
- 數值標準化為 0-1。峰值為大於等於 0.8 的區域最大值；相距小於 10 秒的峰值合併為一個。
- 忽略影片前 5% 的異常峰值（開場人工痕跡）。保留數值最高的前 3 個峰值。
- 每個峰值需回報
start-end、peak_value、rank，以及影片標題與 URL。
剪輯區間
- 總長度 15-30 秒（硬性上限 30 秒：轉換檢查會拒絕更長的片段）。
- 從峰值前 3-5 秒開始，讓觀眾掌握背景；在峰值後 2-4 秒結束。剪輯應落在句子或動作邊界。
- 不得超出影片總長度。來自第三方剪輯的片段不得超過其總時長的 50%：需補充 B-roll、圖片或資料卡。
- 一個 Short 僅呈現一個時刻。只有當兩個峰值屬於同一故事節拍時，才可使用兩個峰值。
鉤子（前 3 秒）
- 一個問題、風險或令人驚訝的主張，搭配首幀畫面朗讀，加上大型螢幕標題（最多 6 個字）。
- 僅使用標題、描述或逐字稿中確實存在的事實；未經證實的傳言需標註「傳言」。
- 旁白：句子最多 8 個字，速度約每秒 2.5 字，順序為鉤子 -> 背景 -> 峰值處的高潮 -> 簡短的呼籲行動。來源影片的音量保持低聲或關閉；由旁白主導。
轉換檢查（五項皆須通過；請參閱 docs/LEGAL.md）
narration：必須包含原創旁白。visual_layers：至少疊加 2 個圖層（文字、圖片/貼圖、B-roll、資料卡）。text_overlay：必須有鉤子或螢幕文字。duration：長度不得超過 30 秒。source_credit：所有平台說明文中皆需標註來源。 若有任一項未通過，需修正專案並重新渲染；重新渲染會使先前的核准無效。
字幕與文字
- 逐字字幕，每組 2-4 個字，使用粗體無襯線字體，白字黑邊，當前字詞高亮顯示。
- 字幕需避開底部約 12% 與側邊約 6% 的區域（平台 UI）。僅當頻道風格使用表情符號時才可加入。
標題、說明文、標籤
- 標題/第一行即為鉤子，少於 80 個字元。後接一句背景說明。
- 3-5 個標籤：1 個小眾、1-2 個主題、1 個廣泛。不得使用禁用或誤導性標籤。
- 務必包含
來源：<頻道名稱> - <URL>。 - 範本請參考
references/clip-brief.md。
AI 揭露
合成旁白（TTS）或 AI 生成視覺內容，需在核准前設定每篇貼文的 AI 揭露標記，並在平台上傳時加上 AI 標籤。請在確認卡中提醒使用者。
禁止事項
- 發布原始剪輯、超過 30 秒的剪輯，或無旁白的剪輯。
- 使用使用者標記為封鎖的來源，或私人/會員限定/需登入的來源。
- 未經使用者確認即加入佇列、排程或刪除。