📖 使用說明

這個網站在做什麼？（超白話）

幫你把「短視頻要怎麼排」先設成一份模板，並可把 Coze 產生的素材 URL 一次灌進來，自動排出分鏡。

• 人在外面用手機也能開（Cloudflare 部署後幾乎不用等醒來）
• 真正寫入「剪映草稿」仍要在你 Windows 電腦做（下一步）
• 模板請下載 JSON，存到 Google 雲端硬碟 coze橋接器

建議操作流程

1. 在 Coze 跑完工作流，得到字幕、圖、旁白、BGM 等（都用 URL）
2. 把 Coze 結果組成 JSON（變量名見下表），在「設定」頁貼上或上傳
3. 按匯入 → 自動產生分鏡數與素材
4. 微調位置／字級／鈎子 → 下載模板 JSON
5. JSON 放到 Google「coze橋接器」資料夾保存

Coze 對接原則（很重要）

• 不要綁死格式：同一個變量可以是字串、數字、陣列、或逗號分隔，解析器會盡量吃。
• 以變量名為準：請在 Coze 輸出時用下表的名字（或別名）。
• 素材用 URL：之後本機會依 URL 下載。
• 分鏡數量可自動：給時間軸或列表長度即可，不必手填幾個分鏡。

最小可用例子

{
  "project_name": "測試片",
  "bgm_url": "https://example.com/bgm.mp3",
  "cover_url": "https://example.com/cover.png",
  "background_url": "https://example.com/bg.png",
  "shot_images": "https://a.png,https://b.png,https://c.png",
  "shot_subtitles": "鈎子文案,痛點,方法",
  "shot_voices": "https://v1.mp3,https://v2.mp3,https://v3.mp3",
  "voice_timeline": "2.8,3.2,3.0"
}

編號式例子（Coze 不好輸出陣列時）

{
  "shot_1_image_url": "https://a.png",
  "shot_1_subtitle": "鈎子",
  "shot_1_voice_url": "https://v1.mp3",
  "shot_1_duration": 3,
  "shot_2_image_url": "https://b.png",
  "shot_2_subtitle": "痛點",
  "shot_2_duration": 2.5
}

全部官方變量名（請在 Coze 對應）

「別名」表示可以替代主變量名。編號模式見表下方。

編號模式（N 從 1 開始）

設定頁各區說明

① 匯入 Coze

貼上 JSON 或上傳檔。成功後看「匯入日誌」確認讀到哪些欄位。

② 全域

專案名、解析度、BGM／底圖／封面 URL 與音量等。

③ 分鏡

可手動增刪排序；每鏡有圖/視頻 URL、字幕、旁白 URL、位置。

④ 預覽

9:16 示意位置，不必等於剪映 100%。

⑤ 下載

下載後請放到 Google 雲端硬碟 coze橋接器。關掉網頁可能清空瀏覽器暫存。

常見問題

Q：為什麼不用 Streamlit？
Cloudflare 靜態站較穩、較快、較少冷啟動。

Q：會露出 GitHub 嗎？
此站是靜態前端，不附 GitHub 原始倉庫連結；請用 private 源碼或只放 Drive。

Q：會直接進剪映嗎？
還不會。本站負責模板；本機橋接下一步再接 URL 下載與寫草稿。