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 代理如何驱动视频编辑流水线，包含资产、脚本和示例项目，仅需几个自然语言命令即可从原始素材生成精炼的短视频内容。