gitHub 上 222 Star 的小项目,凭什么让我一下子坐直了?
把产品故事、README、网站,一键变成中文竖屏 9:16 动态视频
大家好呀,我是开源先驱~
上周在 GitHub 上闲逛,看到一个项目叫 HyperFrames Motion Director,star 才 200 多,但 README 里的功能描述让我一下子坐直了——「把你的产品故事、文章、README、网站、甚至发布会文案,一键变成 HyperFrames 动态视频。」而且默认就是中文竖屏 9:16 格式——做过短视频的都懂,这简直就是为小红书、抖音、视频号量身定做的。
一句话定位:AI 视频制作界的「导演助理」——你给素材,它给你分镜、设计系统、动效编排、质量审核,一条龙。
01
PART
它是怎么工作的?两阶段,不瞎搞
TWO-PHASE WORKFLOW
我装完试了一下,整个流程非常克制——不像某些 AI 工具上来就哐哐生成一堆没法用的垃圾。它分两个阶段:
阶段一 · 设计方案
先出 BRIEF 简报,等你点头
→
阶段二 · 生成交付
生成素材、搭建合成、审核成项目
阶段一:设计方案,等你点头
拿到你的素材(文章 / README / 产品页)后,它不会立刻生成视频,而是先产出一份 BRIEF_DESIGN_PROPOSAL.md——方向、格式、视觉方案、动效计划,全部列清楚给你看。你确认了,它才往下走。
阶段二:生成素材、搭建合成、审核交付
确认方案后,它开始生成视觉资产、搭建 HyperFrames 合成、跑快照验证、写审核报告。最后交到你手上的不是一堆散文件,而是一个结构完整的视频项目。
「这个『先确认再执行』的设计太懂事了。用过 AI 生成视频的都知道,最怕的就是它自嗨乱搞,你看了想删但已经花了 10 分钟等渲染。」
02
PART
产出物有多专业?
CINEMATIC DELIVERABLES
这是我个人最惊艳的地方——它不只生成视频,还生成了一整套电影级制作文档:
1
📋 BRIEF_DESIGN_PROPOSAL.md — 创意简报,包含方向、格式、视觉方案、动效计划
2
🎨 DESIGN.md — 视觉系统设计,色彩、字体、资产规则、布局约定
3
🎬 STORYBOARD.md — 分镜脚本,每一拍的画面文案、时长、转场
4
✅ REVIEW_REPORT.md — 审核报告,快照检查、问题记录、剩余风险
更厉害的是,它还生成了三份工程设计合约(JSON)
5
SCENE_SCHEMA.json — 结构化场景定义,每个场景的插槽、布局约定、时长、快照
6
VECTOR_TEMPLATES.json — 已批准的 SVG 场景系统,图标、装饰规则,拒绝测试用例
7
MOTION_PRIMITIVES.json — 已批准的 GSAP / SVG / CSS 动效词汇表,插件策略,选择规则
这哪是 AI 生成视频,这分明是一个视频工业化生产脚手架。
03
PART
它强制执行的 12 条铁律
12 IRON RULES
这个项目最让我服气的是它的约束系统。不是「你想咋搞就咋搞」,而是有一套严格的质量标准:
✓
必须先出简报并确认,再执行——防止 AI 瞎搞
✓
默认中文竖屏(9:16,1080×1920),其他格式需显式覆盖
✓
所有 AI 生成的图片必须有明确角色、安静文字区域、裁切安全区
✓
背景和组件数量由故事和产品机制决定,不是固定配额——拒绝千篇一律
✓
独立竖屏背景板 + 素材驱动组件表,需要时单独生成 hero 图
✓
文字在背景上的布局约定必须先于动画确定
✓
场景 Schema、矢量模板、动效基元合约先于实现
✓
GSAP 编排合约:标签、位置参数、插件注册、变换别名、性能规则
✓
动效用于引导注意力,而非重复静态幻灯片模式
✓
最终交付前必须验证、快照、审核
✓
写作紧凑:不说废话、不写通用推销语
✓
命名透明抠图、明/暗联系人表审核、资产清单记录所有验收和修订
用过 AI 视频工具的都懂,大部分工具给你的是一段「还行吧」的视频。但这个 Skill 给你的,是一个可以迭代、可以审核、可以复现的视频项目。
04
PART
怎么装?一行命令
INSTALL & RUN
怎么装?一行命令:
...bash
npx skills add geekjourneyx/hyperframes-motion-director
装完直接用自然语言跟你的 Agent 说:
PROMPT 把这个 README 转成一段 12 秒的中文竖屏 HyperFrames 宣传片。先出简报设计方案,等我确认。
如果你要本地开发脚手架
...bash
# 创建项目骨架
node skills/hyperframes-motion-director/scripts/create_project.mjs ./my-motion-film
# 带时长和动效映射
node skills/hyperframes-motion-director/scripts/create_project.mjs ./my-motion-film --with-timing --with-motion
项目自带验证脚本:
...bash
node skills/hyperframes-motion-director/scripts/check_assets.mjs ./my-motion-film --strict
node skills/hyperframes-motion-director/scripts/validate_image_assets.mjs ./my-motion-film
node skills/hyperframes-motion-director/scripts/validate_design_engineering.mjs ./my-motion-film
///
LAST
写在最后:为什么我觉得它值得关注
WHY IT MATTERS
说实话,222 Star 在 GitHub 上不算什么。但我装完试用之后,觉得这个项目被严重低估了。大多数 AI 视频工具在卷「生成质量」——谁的画面更像实拍、谁的运镜更自然。但 HyperFrames Motion Director 卷的是生产流程——它把一个混乱的「AI 帮你做个视频」变成了可管理、可审核、可迭代的工业化流程。
⚠️ 注意:这个 Skill 需要配合 HyperFrames CLI 使用才能渲染最终视频。它本身是一个制作管线而非独立渲染器。目前需要 Node.js 18+ 环境,AGPL-3.0 协议。
如果你是一个需要频繁把产品文档、文章、README 转成宣传视频的开发者或运营——这个项目值得你花 10 分钟装一下。一句话出分镜 + 设计系统 + 动效编排,这个效率提升,用过就再也回不去了。
👉 项目地址:https://github.com/geekjourneyx/hyperframes-motion-director