产品影片(课程步骤 04,级别 L2)
将工作室瞄准用户实际销售的产品。展示卷的能量保持不变;内容变为用户自己的:真实截图、真实 Logo、真实色彩和字体、真实文案、一个真实数字,以及音乐跟随的动态。品牌阶段之后的所有内容运行标准的 motion-reel 流水线。
请求参数(可能为空),仅显示一次;后续部分称为“上述请求”:
范围:当用户只希望捕获或修复资产,或者您从 motion-reel 的品牌阶段来到这里时,执行第 2 和 3 部分(以及第 4 部分,如果要求),报告,然后停止。对于全新的影片,遵循每个部分;第 5 至 8 部分交给 motion-reel 流水线。
模式的来源
- Tony Dinh (@tdinh_me) 报告称,TypingMind 的宣传卷在 30 分钟内完成,而类似视频一年前花费他约 1000 美元以上。他的提示是展示卷单行代码加上四个简短方向行:介绍产品 URL;使用实际产品截图、Logo 和资产;视频必须有音乐,并且动态必须与音乐匹配;使其成为真正的专业制作,而不是演示或原型。他说 Claude 自行收集了品牌资产。
- 他的后续要求将截图分解为组件和图标,以便它们可以移动,而不是显示原始截图,并使动态更丰富。这就是下面的组件规则。
- 他的提示以“Try again, ultracode.”结束。在当前 Claude Code 中,
ultracode是一个关键字,使 Claude 为该任务编写多代理工作流。它是否驱动了他的结果并未记录;不要将其呈现为质量开关。 - Rob Hallam (@robj3d3) 在同一个 Claude Code 对话中为他的产品制作了第二个宣传卷,就像他的第一个一样。该课程推断引擎被重用;因此每个品牌对应一个会话和一个项目。
- 一个反例:@mablesjoseph 要求从资产文件夹中通过一行代码制作一个“时尚而有力”的宣传片,结果是“不够好,无法分享”。方向比资产本身更重要。
1. 输入
在一轮 AskUserQuestion 中询问上述请求未涵盖的内容:
| 输入 | 默认 | 规则 |
|---|---|---|
| 产品 URL 和名称 | 必需 | 用户自己的产品,或有权推广的产品 |
| 时长 | 20 秒 | 5 个故事节拍,每个 2 到 4 秒 |
| 格式 | 9x16 优先,然后 1x1、16x9 | 同一时间线,重新构图 |
| CTA | 询问 | 屏幕上精确的文字 |
| 一个证明数字 | 询问 | 必须来自用户或其网站;绝不虚构 |
| 音乐 | 合成,120 BPM | 提供的曲目需要此用途的许可证 |
| 语音/吉祥物 | 无 | 语音需要 .env 中的 ELEVENLABS_API_KEY |
| 参考外观 | 无 | 可选,通过 /motion-studio:reference-style |
2. 项目
每个品牌一个项目文件夹(理想情况下一次会话)。如果没有 studio.json:
node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <brand-slug>-reel --title "<Product> launch" --duration 20 --brand-url <URL> --install
仅技能安装:${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs。然后执行 npm run doctor。
3. 捕获品牌
从项目根目录运行捕获脚本(或简要使用 motion-studio:asset-scout 并带上此确切命令和项目路径):
node "${CLAUDE_SKILL_DIR}/scripts/capture.mjs" <URL> --root <project> --full-page [--selector "<css>"]... [--dismiss-banners]
| 标志 | 用途 |
|---|---|
--viewports desktop,mobile | 默认;tablet 也可用 |
--full-page | 长截图以裁剪部分 |
--selector "<css>" | 裁剪特定产品部分(可重复):hero、定价卡、仪表板面板 |
--dismiss-banners | 在一次性浏览器中点击明显的 cookie 或同意按钮(接受、同意、允许,使用英语、韩语、日语、中文、德语、法语或西班牙语;弱标签如 OK 或 Close 仅在横幅或对话框内有效)。清单中说明点击了哪个按钮,或没有匹配项 |
--apply-brand | 将名称、URL 和建议的颜色写入 studio.json |
--dark | 捕获深色主题 |
--no-fonts | 跳过字体下载(默认:保存页面加载的网络字体) |
--allow-private | 允许页面访问回环、局域网和链路本地地址(默认:仅目标主机和端口);仅用于您信任的页面,例如用户自己产品的本地开发服务器 |
--no-sandbox | 启动 Chrome 时不使用其渲染器沙箱(也支持 MOTION_NO_SANDBOX=1;在 Linux 上以 root 身份运行时自动,因为 Chrome 无法在沙箱中启动);每当关闭时都会打印一条注释 |
--json | 输出一行 JSON 结果 |
它将写入 assets/brand/screens/、assets/brand/logo/、assets/brand/components/、assets/brand/og-image.* 和 assets/manifest.json(包含建议角色的调色板、CSS 颜色变量、使用的字体、标题、按钮和导航文案、注释)。图像扩展名来自文件字节,页面外的组件裁剪将被跳过并附注说明。页面实际加载的网络字体保存到 assets/fonts/,并在 assets/fonts/fonts.json 中注册(已有条目不会被覆盖);每个字体在清单中都有一个 license,除非找到许可 URL 或文件,否则保持为 UNVERIFIED,脚本会在发布前打印提醒检查。运行失败时保留之前的捕获。详细信息和清单架构:references/asset-capture.md。
Logo 和类型。当页头没有 Logo 图像或 SVG 时,品牌通常是文本字标。捕获将其记录为 manifest.brand.wordmark(标记、各部分颜色及其角色、计算字体族、字重、字号和字间距),以及一个参考裁剪 assets/brand/logo/wordmark-crop.png,并在注释中说明,而不是仅要求 Logo 文件。根据该记录重建;仅当影片需要精确锁定时才要求 SVG 或 PNG。
字体。日志行 font registry: <family>: ...(以及 manifest.fonts.registry)说明每个使用的字体族是否已在 assets/fonts/fonts.json 中,以及其许可是否已验证(有记录的许可 ID 和许可文本)或 UNVERIFIED,以及本次运行添加了什么。一个位于同一字体族已验证条目旁边的字体将重用该许可。
UI 状态和画布帧
capture.mjs 在加载时拍摄一次。两个兄弟脚本涵盖其余部分;两者都打印 --help,仅写入项目内部(默认 assets/brand/),并在相同的安全堆栈后面运行(Windows 上的无头 shell、开启渲染器沙箱、拒绝私有地址、编辑机密)。插件安装:下面的命令。仅技能安装(无 ${CLAUDE_PLUGIN_ROOT}):脚本位于此文件旁边,因此运行 node "${CLAUDE_SKILL_DIR}/scripts/states.mjs" <URL> ...(同样适用于 capture.mjs 和 canvas-frames.mjs);它们只需要 Node 和从运行文件夹解析的 playwright(传递 --root <folder>),无需项目、studio.json 或 tools/。asset-scout 代理运行相同的命令。
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/states.mjs" <URL> --root <project> --name home --viewport desktop "--click=text=Pricing" "--crop=header"
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" <URL> --root <project> --canvas "#screen canvas" "--clip=db=.tab[data-go=db]" --seconds 9 --down 4
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" pack --root <project> --range db=4:200
| 脚本 | 用途 | 写入 |
|---|---|---|
states.mjs | 覆盖产品(模态、同意)、在内部窗格中滚动的应用、点击后的状态、元素及其计算样式 | assets/brand/states/<name>/:00-first、01-escape、scroll-NN、10-click-...、crop-20-... PNG 和 states.json |
canvas-frames.mjs | 一个屏幕是一个 <canvas>,每次点击变化并自行动画 | assets/brand/frames/<clip>.png 精灵表和 frames.json(帧大小、实际时间和每帧哈希);pack 添加 pack/<clip>.png 和仅包含影片播放帧的 pack.json |
canvas-frames.mjs 以整数比例使用 drawImage(关闭平滑)复制画布缓冲区。它从不截取元素截图:以非整数比例在带边框盒子中显示的画布(1280 px 缓冲区在 1272 设备 px 中)会被浏览器重新采样,像素艺术画布会变得模糊。拒绝非缓冲区整数缩小的帧大小。使用前请阅读每个 PNG。
页面是不可信内容,因此捕获保护其运行机器:
- Chrome 保持渲染器沙箱开启(
manifest.sandbox记录)。以 root 身份运行的容器或 CI 需要--no-sandbox,并且仅用于您信任的页面。 - 在 Windows 上,浏览器是 Playwright 的无头 shell(
npx playwright install chromium-headless-shell),绝不是单独安装的 Chrome 或 Edge:以全新配置文件启动这些可能会导致 Windows 登录失败并锁定账户。选择一项(studio.jsonbrowser、MOTION_BROWSER、MOTION_CHROME_PATH)会在每次启动时打印警告,10 分钟内第 4 次启动将被拒绝,3 次通过(references/asset-capture.md)。 - 对回环、局域网、链路本地(包括云元数据)和非 Web 地址的请求将被中止,除非指向目标自己的主机和端口。拒绝在
manifest.blocked和注释中列出。如果 URL 本身被拒绝,运行失败且不保存任何内容。为信任的页面传递--allow-private。 - URL 中的凭据(
https://user:pass@host/)仅作为 HTTP 认证发送到目标源。它们和看似机密的查询值(token、key、sig、session、code...)不会出现在日志、manifest.json、states.json或studio.jsonbrand.url中(替换为***)。 - 声明推测规则(
<script type="speculationrules">)的页面可以使 Chrome 自行获取本地地址,而任何请求过滤器都不会看到;清单会注释。不要在不信任的页面上捕获带有敏感本地服务的机器。
然后,在任何动画之前:
- 向用户列出找到的内容:截图、Logo 候选、建议的
bg/fg/accent/muted、字体、标题和 CTA 文案,以及每个注释(机器人检查、缺少 Logo)。 - 确认或纠正调色板和字体,然后写入
studio.jsonbrand。捕获的字体已在assets/fonts/中,但仅在验证许可后使用(UNVERIFIED表示无人检查)。使用npm run fonts -- add "Family:400,700"添加 Google 字体;商业字体需要用户自己的许可或文件。韩文或其他 CJK 文案需要包含字形的字体:npm run fonts -- coverage --text "..." --family "Name"。 - 询问缺失的内容,而不是虚构:SVG Logo、精确的强调色十六进制、登录墙后的截图。
4. 组件,而非原始截图
- 将捕获的截图部分裁剪为单独图像(
--selector,或自动裁剪:页头、hero、CTA 按钮、卡片、产品图片、定价、部分)。对部分进行动画:卡片滑入布局、按钮按下、图表面板绘制。 - 使用从裁剪中测量的真实颜色、文案和圆角,在画布中重建简单的 UI 外壳(按钮、开关、字段)。这是重新排版,而非发明:布局、标签和数据必须与产品完全匹配。
- 绝不绘制不存在的产品屏幕。没有占位符文案、无 lorem ipsum、无虚假数字。如果缺少所需屏幕,请询问。
5. 音乐和节拍网格(在镜头列表之前)
在真实际拍网格上计时所有内容,因此在任何人编写镜头之前测量或合成音乐:
- 提供的曲目:
node tools/beats.mjs audio/<track>,然后将studio.jsonaudio.music指向它,并设置bpm和duration。其第一个强拍可能远在 0 秒之后或具有不同于 120 的节奏,镜头列表必须遵循该节奏,绝不假设网格。 - 无曲目:
node tools/score.mjs --style pulse --bpm 120 --dur 20(对于 UI 密集影片使用minimal)。它写入audio/music.wav和分析文件audio/beats.json。 - 每个可见的命中点都会得到一个提示;动态跟随音乐,而不是反过来。
6. 故事节拍
用用户的事实填充 assets/brand-prompt.md 中的品牌故事,并交给 motion-studio:motion-director 生成 docs/shotlist.md;导演读取 audio/beats.json,因此第 5 部分优先。默认 20 秒,120 BPM,每 2 到 4 秒一个节拍,场景变化在强拍上:
| # | 节拍 | 画面 | 声音 |
|---|---|---|---|
| 1 | 钩子,0 到 2 秒 | 最多 5 个字的巨大动态类型问题;第 0 帧已经构图 | 强拍上的重击 |
| 2 | 产品出现 | 真实 UI 逐步组装 | 进入时的嗖嗖声,部分上的弹出 |
| 3 | 三个功能 | 每个都是 UI 时刻,光标执行真实操作 | 每次按下时的点击声 |
| 4 | 证明 | 真实数字就位 | 滴答声或铃声 |
| 5 | 锁定 | Logo + CTA,最后一个强拍上最终命中 | 上升进入命中 |
显示镜头列表并等待用户确认(先计划),除非他们要求自主模式。如果网格后来更改(其他曲目、其他 bpm 或 duration),重新定时列表并再次显示。
7. 语音和吉祥物
- 语音(可选):编写
audio/voice.json(参见 assets/voice-script.example.json):每个节拍一行,t在第 5 部分网格的强拍上,短句。运行npm run voice -- --dry-run并告知用户字符数,然后npm run voice消耗点数(相同的行被合成一次并计费)。混音器在语音下降低音乐。 - 吉祥物(可选):用代码绘制的角色,具有固定身份(形状、从品牌抽样的调色板、比例),在节拍上用
playful弹簧反应。保持相同...
[已截断用于翻译]