SuperAPI AI 工具集

launch-video

设计与创作

查看项目

更新于 10-16 01:17

技能介绍

用途:为 Hunk 生成产品演示视频,每一帧终端画面都来自真实 Hunk TUI,不使用录屏或模拟图。仅限维护者使用,需要 Hunk 源码检出(流水线位于 scripts/launch-video/,不随 npm 发布),且仅支持 Unix,捕获脚本会执行 /bin/bash。

主要能力与三阶段流程:capture.ts(bun)通过 PTY 驱动 Hunk,将带样式的关键帧截为 PNG;compose.mjs(node + Playwright)在 Chromium 的 1920x1080 HTML 舞台上渲染每个 PNG,叠加窗口边框、卡片、字幕与转场后截图;ffmpeg 以 30fps 将合成图编码为 mp4/webm。通用机制位于 @hunk/term-video 工作区包(packages/term-video/),scripts/launch-video/ 只保留 Hunk 的场景、字幕与卡片。

使用方式:先 bun install;再 bun run scripts/launch-video/capture.ts(须在仓库根目录运行,输出默认到 <repo>/.video-work/);然后在 .video-work 内安装 playwright 与 playwright-core 并 bunx playwright install chromium;接着 node scripts/launch-video/compose.mjs .video-work;最后用 ffmpeg 的 concat 命令编码 mp4(libx264)与 webm(libvpx-vp9)。可用 SCENES=review 只捕获指定场景,但完整合成仍需所有场景至少捕获过一次。

适用场景:单功能短片、基于 changelog 的完整版本汇总、以及教程/对比/公告等自定义视频。

限制:capture 约需 3–6 分钟、compose 约 2–4 分钟,需长超时;compose.mjs 需 node ≥ 18;Playwright 必须与其驱动的 Chromium 版本匹配;mp4 需要带 libx264 的 ffmpeg;视频无音轨;.video-work/ 已被 gitignore,不应提交视频或帧。字幕字体、浏览器路径等细节资料中另有说明。