fendouai/ViralForge

项目介绍

ViralForge 把一条爆款短视频拆成 Viral DNA 报告：钩子、逐镜结构、词锚点、节拍网格、字幕风格、情绪曲线和转化逻辑。换上自己的产品和脚本后，项目会以可编辑的 VFML 工程重建这套结构，并生成 10 条带成本估算的变体用于 A/B 测试。目标用户是增长团队、UGC 代理商、电商品牌和独立创作者，想用可复现的流程替代"抽卡式"的 prompt 生成视频。

镜头以词而非秒为锚点，改一句台词，镜头、字幕和配音会一起重排。工作室同时以 Agent 工具链提供：Skill、MCP server 和 CLI，每一步都产出机器可读的产物（dna.json、project.vfml.json、变体 CSV、成本账本）。

快速使用

Web 工作室需要 Node.js 22.15+ 和 npm：

git clone https://github.com/fendouai/ViralForge.git
cd ViralForge
npm install
npm run doctor      # 可选：检查本地依赖
npm run dev         # http://127.0.0.1:5173

打开工作室，任选三个内置案例（GLOW LAB、AER、MORI）之一，走一遍"拆解 → 复刻 → 10 条变体"的流程。演示使用预先渲染的自制素材；镜头切分、BPM 和节奏由本地真实计算，不需要任何模型或平台 API key。

要分析自己的本地视频，先安装 FFmpeg、Python 3.9+、numpy 和 opencv-python-headless，然后运行：

node cli/viralforge.mjs analyze ./reference.mp4 --out dna.json
node cli/viralforge.mjs report dna.json

Agent 可以把 skills/viralforge 复制到 .claude/skills/ 使用 Skill，或按 README 中的 stdio 配置让任意 MCP 客户端连接 mcp/server.mjs。

使用约束

Web 应用和构建强制要求 Node.js 22.15+。FFmpeg/ffprobe、带 OpenCV 的 Python 和 Chromium/Playwright 是可选项，只在重新渲染、媒体检查和 CLI 分析时需要。v0.1.0 是 MVP：演示中的语义洞察是人工整理的，不是模型实时输出；复刻影片是预先渲染的；批量变体目前只产出脚本、封面和成本估算。模型调用和批量渲染需要 key 或 worker。平台链接下载有意未实现，只支持本地上传。不支持换脸，参考素材不会进入输出，所有产出都带 AI 生成标注。开源版本不包含分类配方、托管模型、人物一致性和团队计费，README 将这些归入云端产品。许可证为 Apache-2.0。

HotRepo 点评

ViralForge 于 2026-11-13 进入 TypeScript 新项目榜，当时 104 Star、6 Fork，在约 1.5 小时的窗口内新增 4 Star。观察时间很短，不足以判断趋势。更具体的信号是 v0.1.0 的交付范围：可用的本地工作室、CLI、MCP server 和 Skill，三个带变体矩阵的完整案例，以及一套干净的词锚定工程格式。案例中的指标应视为展示报告格式的 fixture 值，而非客户实测结果；人工整理的语义层也应视为演示，而非模型能力。

项目源码与说明