nateherkai/hyperframes-student-kit

Edit videos, reels, and YouTube Shorts with Codex or Claude Code. 14 skills, transcript-driven cuts, storytelling, 406 motion-graphics cards, and HyperFrames templates.

HyperFrames Student Kit – AI輔助影片編輯實驗環境

是什麼 – 一個可重複使用的開源工具包，讓您能借助大型語言模型代理（Codex 或 Claude）以自然語言提示編輯自己的影片素材。該倉儲整合了「技能」（代理驅動的指令）、動態圖形資產、場景範本，以及一系列自動化常見後製任務的輔助腳本，例如靜音移除、錯誤偵測、基於字幕的重定時、節拍同步驗證與短影片剪輯生成。

為何重要 – 它展示了一個具體的工作流程：LLM 作為影片編輯助理，將自然語言提示轉換為具體的 FFmpeg/GSAP 操作。此工具包專為希望在不從零建構基礎設施的前提下探索 AI 驅動編輯的學生與創作者設計。

核心元件

元件	提供內容
14 個「技能」	預先撰寫的代理提示，針對 `edit-video`、`cut-silences`、`cut-mistakes`、`short-form-edit` 等任務，每個技能皆附有輔助腳本與參考資料。
406 張草稿動態圖形卡片	基於 GSAP 的圖形（兩種視覺風格），包含 CSS 標籤與可編輯槽位；元資料儲存在 `style-library/registry.json` 中。
場景範本	兩種完整場景佈局——深色格線背景與左側玻璃彈出式——可與卡片組合使用。
轉錄與剪輯流程	可選整合 ElevenLabs Scribe、OpenAI Whisper 或本地 Whisper 以取得逐字轉錄；腳本可剪除靜音、標記錯誤並生成編輯決策清單（EDL）。
短影片工作流程	從長時間錄音生成 9:16 Reel 或 YouTube Shorts 的端對端指令，包含鈎子/結尾規劃、字幕時間驗證、B-roll 插入與音效設計提示。
示範與教學專案	12 個示例學生專案與一個無需任何外部 API 金鑰即可運行的合成起始組合。

適用對象

學生與教育者：學習如何將 LLM 代理與媒體流程結合。
內容創作者：希望獲得可腳本化、AI 引導的剪輯方式來修剪與潤飾影片。
開發者：對建構或擴展 AI 代理驅動的影片工具感興趣（該倉儲是即時可用的參考實作）。

快速上手（來自 README）

前置條件 – Node 22+、Git、FFmpeg（含 ffprobe），以及 Chrome/Chromium 在 PATH 中。

克隆與安裝

git clone https://github.com/nateherkai/hyperframes-student-kit.git
cd hyperframes-student-kit
npm ci               # 安裝相依套件
npm run setup        # 檢查工具，建立 .env 模板
npm test             # 健康檢查

執行示範

npm run demo
cd video-projects/demo
npx hyperframes lint
npx hyperframes preview   # 觀看 8 秒動畫
npx hyperframes render --quality draft --output renders/demo.mp4

編輯您自己的素材 – 在 Codex 或 Claude Code 中開啟資料夾，輸入自然語言指令，例如：
```
$edit-video  /path/to/my-recording.mp4
```
助手將呼叫相應的技能（cut-silences、cut-mistakes 等）並產生草稿剪輯。
製作短影片 Reel – 使用 short-form-edit 技能，輸入類似以下提示：
```
/short-form-edit  /path/to/lecture.mp4  make a 9:16 Reel with hook, captions and beat-sync
```
工作流程將在渲染前驗證字幕時間、場景覆蓋與素材重用情況。

可選 AI 服務

ElevenLabs Scribe – 雲端轉錄（預設助手）。
Kie.ai – 產生補充影片／影像資產。
OpenAI Whisper 或 本地 Whisper – 替代轉錄後端。您只需為所選服務提供 API 金鑰；合成起始專案完全離線運行。

限制與考量

該工具包依賴外部 API 進行高品質轉錄或資產生成；若無則僅使用本地流程，跳過這些步驟。
動態圖形卡片與範本為草稿資產，應在最終製作前自訂（CSS 標籤、文字槽位）。
助手指令（$edit-video、/short-form-edit 等）與 Codex 及 Claude Code IDE 延伸功能綁定；在這些環境外使用需手動呼叫底層腳本。
渲染品質由 --quality 標誌控制；高品質渲染耗時更長，可能需要更多系統資源。

快速參考連結（來自倉儲）

代理指示參考 – AGENTS.md
動態圖形詞彙 – MOTION_PHILOSOPHY.md
風格圖書館指南 – style-library/GUIDE.md
工作流程導覽 – docs/WORKFLOW.md
提示食譜 – docs/PROMPTS.md
短影片編輯指南 – docs/SHORT-FORM.md
工具與 API 金鑰設定 – docs/TOOLS-AND-API-KEYS.md

結論 – HyperFrames Student Kit 是一個實作導向的開源沙盒，用於探索 LLM 代理如何驅動影片編輯流程，內含資產、腳本與範例專案，僅需幾個自然語言指令即可從原始素材轉化為精緻的短影片內容。