Communitygithub.com

产品宣传片

指导 AI 智能体如何规划、构建或剪辑“产品宣传片”,最终产出一段完整的视频剪辑。流程涵盖产品宣传片,以代码形式渲染,以及 Studio:一个弹窗中的简报,引导模式:`?`。当有新的任务需要此技能时使用。

产品宣传片 是什么?

此技能定义了一个高度工程化的“产品宣传片”制作工作流程,其核心理念是将胶片渲染为代码。一个 HTML 页面和一个 Canvas 构成的引擎,通过 `seek(t)` 函数从零开始绘制任意时刻的画面帧。Headless Chrome 捕获每个目标帧的多个子帧,ffmpeg 负责混合和编码,最终输出视频。这种方式使得每一帧都可审查、每次修改成本低廉,且循环完全精准。该技能附带一个完整的工具集,包括用于渲染、旁白、混音、节拍检测、交付验证的脚本,以及一个功能丰富的模板引擎。模板引擎支持 24 种转场效果、多种视觉风格预设、动态排版(13 种样式),并通过 WebGL 合成器实现真实的 3D 渲染。此外,还有一个名为“Studio”的可视化窗口工具,允许用户通过交互式向导选择配方、格式、外观、声音等,并将所有选择写入一个 `brief.json` 文件,从而简化创作流程。该技能专为在本地 macOS 环境下运行设计,依赖 Playwright 驱动已安装的 Chrome 浏览器,并支持多种音频模型(如 macOS 的 `say` 命令、MLX 本地模型)进行旁白生成。

兼容平台✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/gfazioli/manovella/tree/HEAD/plugins/manovella/skills/site-promo-film

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

产品宣传片,以代码形式渲染

一个页面,一个画布,seek(t) 从零开始绘制时间 t 处的帧。Headless Chrome 为每个帧捕获 N 个子帧,ffmpeg 混合并编码它们。影片是一个函数;视频是其采样——这使得每一帧都可审查、每次修改成本低廉,且循环完全精准。

这些文件随此技能一起提供。将它们复制到影片的工作文件夹中;不要重写引擎。

文件说明
template/promo.html引擎加上一个 8 秒的演示:封闭形式的弹簧、弹簧总和轨迹、一个摄像机、文本辅助工具(表格数字、翻转)、标题、一个真实的光标、一个单对象变形链,以及用于真正 3D 的 WebGL 合成器。直接打开即可渲染。
template/reel.html一个时间轴上的长片:六个场景,六个格式(动态字、一个浏览器、一个带有拉焦的便当网格、一个终端、一个设备的 3D 封面流、一个结束卡),五个转场,每个场景一个外观,章节。约 56 秒,非循环。§2 的目录,运行中。
template/film.js页面共享的引擎:舞台(每个子帧进行亚像素抖动,确保慢速移动时无步进或闪烁)、用于光栅的 FILM.draw、弹簧和摄像机、时间轴(场景、章节、检查点和二十四组转场:2D 画布上的十六组,一个 WebGL2 上下文上的八组片段着色器)以及效果(景深、镂空字、打字效果)。顶部有文档。
template/parts.js矢量部件:一个 macOS 窗口、一个浏览器、一个终端、一个 iPhone、一个 iPad、一个 MacBook、一个 iMac、键帽、一个开关、一个戒指、一个按钮、指针。每个都返回其内容所在的矩形。
template/parts.html所有部件放在一张 16:10 的页面上,和其他页面一样:PAGE=parts.html node render.mjs stills parts 0 制作出 docs/parts.jpg 所转换的 PNG(使用 sips -s format jpeg -s formatOptions 92)。
template/fx.js外观,由页面加载:背景(纯色、渐变、场或图片;柔和品牌光;点、网格或视差线条;透视地板;聚光灯)、收尾(暗角、颗粒)以及依赖它的效果(磨砂玻璃、点击涟漪、拉焦标题)。二十三个预设和 photo,每个字段都可覆盖,文件顶部有文档。与 release-film 共享。
template/type.js标题和动态字(§3):TYPE.draw(ctx, t, spec) 有十三种样式 —— 升起、聚焦、稳定、追踪、擦除、层叠、粗细、分裂、翻盖、打字、交换、里程表、解码 —— 带有强调标记、节奏,以及 TYPE.load 用于加载一个字体的多个字重。像其他部分一样,是 t 的纯函数。
template/fonts/二十个开源许可字体家族(拉丁 + 拉丁扩展 woff2,每个带有其 OFL.txt)和 fonts.json,它们的字面。影片仅将使用的字体复制到 src/fonts/;scripts/fonts.mjs add 可以获取另一个。
scripts/render.mjsstills <dir> t…、sheet <dir>(时间轴的检查点)、looks <dir> <t>、loopcheck、video <out> [workers]。从页面读取尺寸、帧率、持续时间和章节;抖动每个子帧;以可恢复的块进行渲染;FROM/TO、PREVIEW=1、RESUME=1、KEEP=1、AUDIO=、SHUTTER=;扩展名决定格式(.mp4、.mov ProRes、.webm、.gif;HEVC=1;ALPHA=1 用于透明 .mov 或 .webm);在渲染前检查轨道,在渲染后检查文件;如果一个页面的 WebGL 上下文丢失,则捕获失败;如果另一个渲染正在运行,则拒绝重复渲染同一个剪辑。顶部有文档。
scripts/narrate.mjs一个影片的故事(story.json:每个步骤一句话,可以是教程或宣传片的讲述)变成语音、时钟和字幕:voice/*.aiff、narration.wav(影片的 AUDIO)、narration.js(每个步骤的时间,供页面使用)和 captions.srt / .vtt。使用 Mac 的 say 命令,或 --from 指向您自己录制的文件夹。"human": "natural" 像人一样改变停顿;模型发出的声音([chuckle])会从字幕中移除。顶部有文档。
scripts/voice.mjs由在 Mac 上运行的语音模型讲述的同一个故事(story.json 中的 "mlx":课程用 Chatterbox,宣传片用 Orpheus,快速草稿或意大利语影片用 Kokoro),比 say 更接近真人:它说出每个步骤(voice-mlx.py,通过 mlx-audio),调整语速和音量,然后调用 narrate.mjs。一次录制是一个种子;"tone"(calm、warm、bright)控制模型的朗读自由程度,"human" 允许每行语速在 3% 内变化,并允许一行发出声音([chuckle]、[sigh]:每个模型自己的拼写,或省略)。--audition 比较多个录制,--recordings 在录制处停止,--setup 在每台 Mac 上制作 Python 并获取模型(voice-constraints.txt 固定其安装的版本)并说明该 Mac 是否会重复这里录制的版本。顶部有文档。
scripts/mix.mjs将一条语音和一条音乐轨道混合成一个音轨,用于 AUDIO=:两者都经过测量(EBU R128),音乐在语音说话时 --under LU 低于语音,在行间 --lift dB 提升,在每行开始前降低;打印结果及其测量值。顶部有文档。
scripts/contact.mjs一个带字幕的静态帧或外观文件夹的联系表(字幕来自其中的 labels.json);--size WxH 使其正好为该尺寸(--font、--gap、--pad;静态帧从不裁剪;.jpg 写入为 JPEG);--dark 用于暗色表。--compare A=<dir> B=<dir> [C=<dir>] <out.png>:两到三个文件夹并排,每列有标签,每个它们共享的静态帧占一行,用于在一张图片上进行 A/B 选择。
scripts/beats.mjs从音轨的样本中提取其节拍:速度、是否保持不变、每个节拍、小节、段落,以及用于页面的 bpm 和 AUDIO_AT;--out beats.js 用于跟随一个漂移轨道的页面(FILM.beats)。render.mjs 导入它以将页面的节拍与轨道的节拍进行比对。--selftest。
scripts/clickcheck.mjs检查每个点击是否可见:对于页面的每个 CLICKS,点击点在屏幕上的移动速度以及光标在按下前和按下期间移动的距离。如果存在用户看不到的点击则退出 1(release-film §3b),如果页面没有光标则退出 2。
scripts/layoutcheck.mjs检查每个标题是否在帧内、分开且可读:在每个检查点,检查每个 TYPE.draw 绘制的标题,相对于安全区域、其他标题和其周围的背景(限制在其头部中)。如果标题失败则退出 1,如果页面未通过 TYPE.draw 绘制任何标题则退出 2。
scripts/deliver.mjs最后一步(§8):完成的视频及其封面离开工作文件夹,进入它们自己的文件夹;影片交付后,在确认其源文件安全存在于工具包中后,trash 会删除工作文件夹。--selftest。
scripts/fonts.mjs工具包的字体:add "<Family>" [axes] 从 Google Fonts 获取并包含其许可证,check、list。

除此之外,还有 studio/(Studio,见下文)、guide.md(引导模式,见下文)和 README.md(图片目录,以及影片制作各个阶段的示例请求)。

设置:一个工作文件夹 ~/Downloads/<name>-work/(~/Downloads 是工作根目录,除非下面设置文件中的 workRoot 另有指定),页面和这些文件在其 src/ 中,并在此处运行 npm i playwright-core。它通过 channel: 'chrome' 驱动已安装的 Chrome,因此无需下载其他内容。<name> 是 <product>-<what>(如 acme-promo、acme-2.4-whats-new),并且它也命名了交付文件夹和每个交付文件(§8)。

Studio:弹窗中的简报

可视化入口。一个独立的向导窗口:配方、格式、外观、来自 Mac 的图片、在真实引擎上运动的类型和动画(以产品的颜色和宽高比显示)、声音(播放音乐库中的曲目,在选择前试听语音模型的语音),并且每个选择都会写入一个 brief.json。无需安装任何东西,也不进行渲染。/manovella:studio 也可打开它。

  • 何时使用:当调用 studio,或者在对话中尚未说明要制作哪个影片时调用。如果用户已经用语言说明了他们的需求,则直接进入 §0。
  • 运行:在工作区后台运行 node <此技能目录>/studio/studio.mjs(其仓库的同级目录是所提供的产品),并在一行中说明窗口已打开。它会自行退出,并打印一行,退出时唤醒您:BRIEF <path>、CANCELLED、CLOSED 或 TIMEOUT(说明并停止)。窗口是 Studio 在此 Mac 上构建的自己的应用程序(~/Applications/Manovella.app,其名称、版本和图标显示在 Dock 中),否则是 Chrome 应用窗口;MANOVELLA_WINDOW=chrome 保持使用 Chrome。如果两者都没有,则打开默认浏览器;--no-open 改为打印 URL,用于屏幕在其他地方的会话。
  • 音乐库 是可选的:一个包含用户影片音乐的文件夹,用户可将其放置在任何位置(同步驱动器、项目文件夹)。它由 MANOVELLA_MUSIC 为一次运行指定,否则由 musicLibrary 在 ~/Library/Application Support/manovella/settings.json(在 macOS 之外是 ~/.config/manovella/settings.json;前导的 ~ 会被展开)中指定;同一文件中的 musicLibraryIgnore 列出了要跳过的文件夹名称,deliverToLibrary(true 或 false,默认为 false)表示完成的影片是否也放入其中。不会自动检测。较旧的文件带有 brandLibrary 和 brandLibraryIgnore,会被读取为 musicLibrary 和 musicLibraryIgnore(且 deliverToLibrary 开启,就像以前一样),并在 Studio 设置中首次更改时使用新键重写。同一文件还接受 projectFolders(Studio 查找产品的位置)、pictureFolders(其背景图片;未设置:~/Pictures)和 workRoot(<name>-work 的存放位置,以及除非影片交付到库或项目有指示,否则 <name>/ 的存放位置;未设置:~/Downloads);Studio 的设置窗口(Manovella.app 中徽标旁的齿轮或 ⌘)会写入所有这些设置,deliver.mjs 也会读取 workRoot。代码中没有其他地方读取库键:对于没有 Studio 制作的影片,本段是对我的指示。
    • Studio 提供库顶层及其每个文件夹中(直接或在该文件夹的 audio/ 文件夹中)的每个音频文件(mp3、m4a、aac、wav、aiff、flac、ogg);跳过点文件夹和 musicLibraryIgnore 中的名称。按品牌的文件夹是可选的,用于分组其曲目;以产品命名的文件夹会首先列出(“此产品的”)。可选的注释文件位于曲目旁边(…notes.txt 或 .md:每个曲目一段,以曲目的文件名开头:说明它是什么、其情绪、适合何处),Studio 会显示它。
    • 完成的影片:当 deliverToLibrary 开启且存在库时,位于 <library>/<Brand>/video/<name>/(§8);否则位于项目自身指示存放完成媒体的位置,否则位于工作根目录中的 <name>/(默认 ~/Downloads/<name>/)。
    • 新制作的曲目(见下文)会保存在库中,当库按品牌组织时保存在产品的文件夹中,并带有其段落在该文件夹的注释文件中(如果库存在);否则仅放在影片的 src/audio/ 中。文件提供程序(Google Drive、iCloud Drive、Dropbox)中的文件夹可能将其文件保持为“无数据”状态直到打开,因此在测量文件之前要先打开或复制。库保留的文件会被复制,永远不会从库中移出。
  • brief <path>,作为参数或来自 BRIEF 行:读取简报;它回答了 §0。
    • formats: [] 是我选择的三个。对于宣传片或有章节的影片,一个、两个或三个命名的是故事板的格式,按顺序,我选择其余的,每个都不同;发布片和教程的一个格式是它们自己的(whatsnew、tutorial),永远不会填充。look: null 是外观表(§4)。

    • frame:产品展示在什么中,无论格式如何;null 是每种格式自己的(浏览器用于演练,终端用于命令行,Mac 窗口用于教程),我的选择。

      • window:应用程序在其 macOS 窗口中(PARTS.window)。
      • macbook:从正面看的 MacBook,应用程序的窗口或网站的浏览器在其屏幕上(PARTS.laptop、PARTS.notch 最后绘制)。
      • imac:从正面看的 iMac,在其底座上,应用程序的窗口或网站的浏览器在其桌面上(PARTS.desktop:其矩形是主体,547 : 375,底座在下方绘制;color 是苹果七种颜色之一,或品牌最接近它们的强调色)。无刘海:摄像头在白色边框内。
      • iphone、ipad:设备(PARTS.phone 并且最后绘制 PARTS.island;PARTS.tablet,根据其矩形横竖放置,摄像头在其长边上),产品自身的布局在其上(§1),并且每次点击都是触摸:一个柔和的圆盘按下,带有外观的涟漪,从不使用 PARTS.ARROW;教程会说要轻点。
      • browser:产品作为 PARTS.browser 中的页面,其真实地址显示在字段中。
      • terminal:PARTS.terminal,使用 FILM.typed 打字。
      • bare(Studio 中的 Just the UI):产品 UI 自身,一个带有圆角和阴影的浮动面板,没有窗口装饰,也没有环绕的设备。产品仍在屏幕上:没有产品的影片是 Kinetic type 格式,而非此格式。

      对于每个故事板中展示产品的每个场景,此框架保持不变:iPhone 应用程序的教程从第一步到最后一步都在 iPhone 上讲述。本身就是一个表面的格式会顺应它:使用 iphone 的 Browser walkthrough 是该宽度手机中的网站;使用 macbook 或 imac 的 Terminal 是 Mac 桌面上的终端窗口。3D 中的设备 是展示多个设备的唯一格式:所选设备引领封面流(第一个面对摄像头的卡片,以及它返回的卡片),其他设备跟随它。当框架和格式冲突时…

…[已截断以便翻译]

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能