# auto-edit-workspace

> 開源的 AI 自動剪輯工作區（繁體中文）。把講解影片、旁白、螢幕錄影、圖片放進專案資料夾，用白話文跟 AI Agent（Claude Code、ChatGPT Codex、MiniMax Code、Cursor）說「剪乾淨」「做出完成影片」，就會剪掉講錯重講的 NG、照講稿對齊字幕、配上字卡與情境動畫、音效，輸出 MP4 或剪映素材。程式碼 MIT 授權，免費。

運作方式：AI Agent 負責判斷（哪一句是 NG、每段用什麼情境與動畫、卡片寫什麼），工作區裡的 Node.js 程式負責計算（whisper 詞級逐字稿、auto-editor 初剪、字幕斷句對時、動畫每一拍對準講到的詞、版面檢查、人聲響度 −14 LUFS），再用 HyperFrames（HTML 轉影片）render 完成影片。流程有六個停點，AI 會停下來給使用者確認。

## 重點

- 指令都是白話文：「剪乾淨」「做出完成影片」「配螢幕錄影」「s05 往左移」「s12 重新設計」「可以了，輸出完成影片」「輸出剪映素材」
- 18 種情境模板、34 支情境動畫範例、示意動畫（線條插圖照講解演出具體動作）、40 種字卡動態、9 個音效
- 橫式長片（1920×1080）與直式短影片（1080×1920，Shorts、Reels、抖音）；直式需直拍素材，目前不支援橫拍轉直式
- 風格包：主色、背景圖、亮色／暗色主題；講者調光、瘦臉、美顏（預設關閉，臉部偵測在本機做）
- 網頁版剪輯台（說「打開剪輯台」）：裁剪、音量、轉場、字幕，卡片上的字在完成影片預覽即時改；螢幕錄影可以分區快轉、減速、定格；AI 做的變速和轉場都畫在時間軸上
- 初剪預覽：剪乾淨後給一個網址，字幕疊在畫面上（只有聲音的黑屏也看得到），不用另外輸出，錯字直接改
- 素材分析：認主軌、找出沒有講者的句子、掃每支螢幕錄影的切頁、開視窗、等待、捲動，再用關鍵字把素材對到字幕
- 螢幕錄影：快轉、減速、定格、紅框、箭頭、放大、打碼；講者小視窗放在錄影範圍內
- 只有開頭結尾露臉也可以：沒有講者的段自動用全螢幕，內容和縮到 87% 的錄影對齊，下方留字幕，右上角留給小節角標
- 「構圖」同頁拖框、調光、選主色、上傳背景，用目前播放頭的畫面預覽動畫；滑鼠移入循環播放，移開顯示完成畫面
- AI 背景設計：複製生圖指令交給 AI，產生 A／B／C 三組，每組含全畫面、側邊欄、章節背景，共 9 張；三類各自選圖、可混搭
- 構圖、主色與背景都會自動存；已有完成影片時，按「更新預覽」才會做進去。設定與草稿存在專案內，原素材與共用模板保留
- 修改單：在剪輯台點一段、勾「以圖像展示為主」「更有質感」這類標籤，複製一行指令交給 AI 重做；改完標 ✓、一鍵看結果
- 影片的轉檔、轉字幕、render 都在使用者自己的電腦上做；支援 macOS 與 Windows
- 需要：Node.js 22 以上、ffmpeg、whisper.cpp、auto-editor、HyperFrames（版本固定在 package.json；AI 會照手冊幫忙安裝）

## 文件

- [README](https://github.com/dean9703111/auto-edit-workspace/blob/main/README.md)：開始使用、能做什麼、剪輯與修改單、構圖與動畫預覽、本集背景設計、風格包、常見問題
- [AGENTS.md](https://github.com/dean9703111/auto-edit-workspace/blob/main/AGENTS.md)：AI Agent 的守則、停點、規則
- [PROMPTS.md](https://github.com/dean9703111/auto-edit-workspace/blob/main/PROMPTS.md)：可以直接貼的提示詞
- [CONTENTS.md](https://github.com/dean9703111/auto-edit-workspace/blob/main/CONTENTS.md)：模板、工具、文件總覽
- [EDITOR.md](https://github.com/dean9703111/auto-edit-workspace/blob/main/shared/template/EDITOR.md)：剪輯、構圖、AI 背景設計與修改單怎麼用
- [情境庫](https://deanlin.net/auto-edit-workspace/shared/template/)：18 種情境模板與情境動畫的即時預覽
- [字卡動態](https://deanlin.net/auto-edit-workspace/shared/template/fx/)：40 種文字動態預覽

## 其他

- 原始碼：https://github.com/dean9703111/auto-edit-workspace
- 作者：林鼎淵（Dean Lin），YouTube 頻道「工程師下班有約」
- 授權：程式碼 MIT；情境模板與字卡動態 CC BY 4.0；詳見 NOTICE.md