Hypit 使用教程

📖 项目简介

Hypit 是 hypit-ai 开源的视频工作流引擎，截至 2026 年 9 月 17 日 GitHub 仓库页显示约 7.9K Star、900 多个 Fork，协议为 Hypit 开源协议。它不是又一个「一句话出片」的生成器，而是给编程 Agent 一套制作视频的语言和系统：丢进一条参考视频，Agent 把它复刻成完整 workflow——画面、字幕、B-roll、特效全部锚在「词」上，而不是秒上。

核心是一套叫 SVML 的视频标记语言。左边是源码，右边实时出画；改一个词，字幕、卡点、贴图自己往后挪。渲染走无头 Chromium 并发（官方示例写明 64 路），词级对齐用 WhisperX。生成模型不是必需的：字幕、动效和代码渲染的画面，不调生成模型也能编译成成片。

安装走一行 npx skills add，装的是 Skill。仓库里同时有 .claude/skills 和 .codex/skills，Claude Code、Codex 这些编程 Agent 装完直接用 /hypit 调。视频项目可以放在任意目录，不必和仓库绑在一起。

📎 相关链接与下载地址（点击展开）

GitHub 仓库：
https://github.com/hypit-ai/hypit
在 GitHub 搜索 hypit-ai/hypit 也能找到。
官网 / 中文文档：
https://hypit.ai · 开发指南
更多教程：关注公众号 / 抖音 / 视频号「IT小圈」

✨ 核心亮点

🧾

整条工作流，不是脚本

丢进参考视频，拿到画面、字幕、B-roll、特效一整份可重跑的 workflow

🔁

一份 workflow，一百个变体

换主角、换产品、换语言、换画幅，结构不动，只生成要变的部分

🔤

锚在词上，不锚在秒上

改一句台词，时间轴自己重排；WhisperX 做词级对齐

🧩

组件可插拔

换主播不动字幕；用组件库、fork 一份，或自己写

🧩 它能做什么、输出什么

项目	说明
输入	参考视频文件，或一段文字描述（不提供参考片也能从零写 workflow）
适用类型	UGC 排行榜、播客切片、街头采访、信息流广告、带货口播、代码渲染画面
输出	可编辑的 SVML workflow + 渲染成片；同一套结构可跑出多个变体
语言 / 兼容	台词可整段翻译；官方示例含西班牙语变体。Agent 入口覆盖 Claude Code、Codex
规格 / 容量	官方示例用 64 路无头 Chromium 并发渲染；词级对齐走 WhisperX

🖥️ 环境要求

环境	建议配置
操作系统	Windows / macOS / Linux 均可（仓库徽章按 Node 跨平台）
运行环境	Node 22.15 及以上、pnpm 10.33、TypeScript 5.9（仓库 README 徽章）
硬件	本地渲染吃 CPU；走生成模型时显卡不是硬性门槛，模型在你选的服务上跑
低配 / 无卡方案	不调生成模型，只编译字幕、动效和代码渲染画面；或把模型接到已有 API / 本地模型
关键依赖	Coding Agent（Codex / Claude Code）、Hypit 可执行程序（首次用 Skill 时 Agent 会协助准备）、可选 WhisperX

🚀 如何使用

💡

最短路径：本机已有 Node 22 和 Codex / Claude Code → 一行命令装 Skill → 在任意空目录开会话，敲 /hypit。

确认运行环境

仓库要求 Node 22.15 及以上。先在终端确认版本，不够就先升级 Node，再装 pnpm。

                        bash
                        node -v
corepack enable
corepack prepare pnpm@10.33.0 --activate
pnpm -v
                    

安装 Hypit Skill

在 GitHub 搜索 hypit-ai/hypit 核对仓库后，用官方这一行装全局 Skill。第一次用时，Agent 会检查 Hypit 可执行程序并协助准备。

                        bash
                        npx skills add hypit-ai/hypit -g
                    

最小例子：复刻一条参考视频

在任意空目录或现有项目里打开 Codex / Claude Code，把参考视频路径丢给 /hypit。下面这句来自官方 README 的用法示例，排行榜内容可按你的主题改。

                        text
                        /hypit 复刻这个视频：/path/to/video.mp4，把排行榜内容换成 Hypit 与其他 AI 视频产品的对比。
                    

Skill 会帮你做的事：

步骤	作用
检查环境	确认 Hypit 可执行程序和依赖是否就绪
索要凭据	这条视频如果要调生成模型，Agent 会向你要对应服务的连接信息
生成素材	按 workflow 生成或复用 A-roll / B-roll / 字幕
编译成片	把 SVML 渲染成可预览、可重跑的成片

进阶：不给参考片，或一次出多个变体

可以从描述起稿；同一套 workflow 只改要变的部分（主角、产品、语言），结构不动。官方 UGC / 播客 / 街头采访示例各带三个 clone。

                        text
                        /hypit 做一个 ranking 视频，把 Hypit 排到 S 级。

/hypit 同一套工作流，把主角换成表情包，再出一条。
                    

结合 Codex 使用

仓库自带 .codex/skills。在 Codex 桌面里打开任意项目目录，直接敲 /hypit 即可，不必再配一套 CLI。模型服务把服务名和文档告诉 Agent，它会帮你接；也可以走本地模型。

✅

装上之后，Codex 的活从「写代码」变成「写视频源码」：改词、换组件、重跑，都在同一份 workflow 里。

🎯 典型应用场景

📋

UGC 排行榜

足球 Tier List 那一套：换解说、翻排名、把球员换成科技创始人

🎙️

播客切片

分屏对峙 + 说话人字幕；换主播、换产品、换成 App 广告

🎤

街头采访

人脸跟随字幕 + 三阶段揭示；换语言、换道具、换角色

📣

信息流广告

克隆一条正在跑的广告结构，换 Hook 和产品，主体不动

🛒

带货口播

同一格式每天换 SKU：换产品、换口播、换 CTA

💻

代码渲染成片

字幕、动效、前端画面本地编译，不调用生成模型

📈 和普通剪辑软件比什么

对比点	说明
编辑单位	剪辑软件锚在秒/帧；Hypit 的 SVML 锚在词，改台词时间轴重排
产出物	剪辑软件交出一条成片；Hypit 交出可重跑的 workflow + 成片
变体	传统做法每条重剪；同一套结构换组件就能出多条
渲染	官方示例 64 路无头 Chromium 并发；词级对齐走 WhisperX
生成模型	可选。纯代码渲染的字幕和动效可以不调生成模型

🧠

它强在「把视频写成源码」：Agent 改的是文字和组件，不是时间轴上的关键帧。

❓ 常见问题

Q: 和普通 AI 视频工具、剪辑软件有什么区别？

普通生成工具交出一条片子；剪辑软件交出时间线。Hypit 交出一份可编辑、可重跑的 workflow。复刻是最快入口，不是唯一入口——也可以从模板或纯描述起稿。

Q: 必须给参考视频吗？支持哪些形态？

不是必须。可以 /hypit 直接描述你要的片子。官方公开示例覆盖 UGC 排行榜、播客、街头采访；README 还写了信息流广告、带货、多语言、代码渲染。

Q: 装完 Skill 提示找不到可执行程序怎么办？

官方说明：首次使用时 Agent 会检查 Hypit 可执行程序并协助准备。把报错原文丢回 Codex / Claude Code，让它按仓库文档补环境，不要自己空猜路径。

Q: 没有显卡、也不想调生成模型，还能用吗？

能。README 写明生成模型不是必需的：字幕、动效和代码渲染画面可以本地编译成成片。要生成真人/实拍风 A-roll 时，再把模型服务接上。

Q: 模型服务怎么选？

把服务名称和 API 文档告诉 Agent，它会配连接。官方提到可以走推荐的托管服务、你自己的 API，或本地模型。具体接哪一家按你现有账号来。

Q: 怎么和 Codex 结合？

一行 npx skills add hypit-ai/hypit -g 装全局 Skill，仓库自带 .codex/skills。在 Codex 里打开项目目录，敲 /hypit 即可。

Q: 和 Claude Code 是什么关系？只能用 Codex 吗？

不是。README 写明面向 Claude Code、Codex 等 Coding Agent，仓库同时有 .claude/skills 和 .codex/skills。用你手头那个 Agent 即可。

Q: 可以商用吗？产出的视频归谁？

协议是 Hypit 开源协议。官方写明：你创作的视频和其他产出归你所有；第三方模型与服务可能另有条款，用之前自己看对应服务的约定。