Communitygithub.com

freudianflips/breakout-launch-videos

品牌启动影片的世界构建工具手册——背景板、3D玻璃物件、着色器图层与排版层级。为你的启动影片打造沉浸式世界。

breakout-launch-videos 是什么?

这是一个为AI代理(如Claude Code、Cursor)设计的技能,专注于生成品牌启动影片的视觉世界。它提供了从二维背景板(通过Higgsfield/Seedance生成,成本可控)、Blender 3D玻璃物件渲染(含透明通道、色彩管理、灯光设置和性能优化)、到WebGL着色器大气层(雾、光晕、色散)的完整管线。核心价值在于通过分层的设计哲学(背景板→介质遮罩→大气层→玻璃UI→文字光标)确保UI可读性,同时提供色彩校正(ffmpeg)和品牌一致性(色彩匹配、色调映射)的指导。支持HyperFrames平台集成,并强调3D渲染必须有CSS无法模拟的视差、厚度或遮挡效果才值得使用。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/freudianflips/breakout-launch-videos/tree/HEAD/skills/launch-world

在你喜欢的 AI 中提问

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

文档

启动世界

工具手册,归属 launch-film。请从 skills/launch-film/SKILL.md 开始:那里包含核心内容、钩子加主体模板和经验教训。当本文档与前者冲突时,以 launch-film 为准。

大多数启动影片将UI浮于白色或标准渐变之上。一部影片之所以令人难忘,是因为产品存在于某个地方:一个属于品牌的空间、材质或主题(纸质工作室、数据组成的夜色城市、工作台、天文台)。世界是可选的;带有柔和辉光的品牌底色是强大的默认选择。当你构建一个世界时,每一项背景决策都应服务于它,并保持产品的可读性。

寻找你的世界

  1. 查看 brand/brand.json 和 brand/screens/:网站的图像、插图、纹理以及它用来描述自己的词汇。
  2. 用一句话命名1个地点或材质,并说明它对产品的含义(迷雾散去=不确定性消失,生长=管线生长,玻璃=透明)。如果毫无意义,就跳过。
  3. 在任何视频工作之前,先展示3张静帧。

新背景板(Higgsfield,你的账户)

在每次视频工作前说明积分成本并等待确认;以480p或720p和5秒时长进行草稿,仅在方向批准后以1080p渲染最终版本。使用经过批准的静帧作为起始或结束图像的Seedance 2.5,可使背景板保持在已通过的构图中。描述可见内容,而非情绪:摄像机的起始和结束运动、1个光源、什么在漂移以及速度,然后加上简短的排除项(“无人、无文字、无切换”)。使用带时间戳的名称保存背景板,并在README行中记录提示词、模型和任务ID。

3D(Blender)

以无头模式运行Blender:blender -b --factory-startup -noaudio --python-exit-code 1 -P script.py -- args:没有 --python-exit-code 1 时,Python错误仍会以退出码0退出,导致构建继续。在Apple Silicon笔记本上,Cycles渲染一帧720px的玻璃画面约需6到10秒(1080p:每帧7到12秒,一段15秒的镜头约需1小时)。

skills/launch-world/scripts/blender_glass_object.py -- <out_dir> <frames> [samples] [core_hex] [ring_hex] 将玻璃主角物体(一个带有发光核心和环的倒角立方体)渲染为RGBA PNG。将你的 accent 传递为核心,ground 或 surface 传递为环。

  • 使用 film_transparent 和 film_transparent_glass 渲染为RGBA PNG,以便玻璃能合成到任何背景板上。
  • 颜色:标准视图,无look,品牌发光强度为1.0,并将十六进制颜色转换为线性;它们将准确落在目标颜色上。AgX会使浅色品牌颜色变灰(测试中,接近白色的颜色渲染后大约暗18%)并压暗深色。纯玻璃层(无品牌表面)可以使用AgX来获得高光过渡效果。
  • 玻璃:折射率1.47,粗糙度0.04,轻度涂层。透明玻璃的Alpha通道是Cycles的任务(EEVEE光线追踪玻璃在不透明背景上渲染为透明)。粗糙度超过0.1时,玻璃会变成不透明的灰色卡片,因此永远不要渲染霜冻效果:在HTML中使用 backdrop-filter 对一个跟随立方体投影角的四边形(每帧使用 world_to_camera_view 计算)进行模糊处理。高光在直通Alpha的PNG或WebM中会严重变暗;为强边缘光提供单独的 plus-lighter 层。
  • Blender 5.x API:F曲线位于动作槽的通道包中(bpy_extras.anim_utils.action_get_channelbag_for_slot),并且 image_settings.media_type 在 file_format 之前设置。脚本遵循这两点。
  • 灯光:柔和的白色主光,由你的强调色着色的边缘光,冷色补光;边缘光凸显玻璃边缘。
  • 匹配剪辑:以影片的帧率为基准逐帧设置关键帧;仅渲染场景需要的精确帧数。
  • 将图像序列编码为视频(ffmpeg -framerate 30 -i hero_%04d.png -c:v prores_ks -profile:v 4444 hero.mov,或带Alpha的VP9),并将其作为 <video> 剪辑放置在HyperFrames中。这是安全的搜索路径。
  • Blender用于主角物体和穿过3D场景的摄像机飞行,并且它必须通过CSS无法伪造的视差、厚度或遮挡来证明其渲染时间是值得的。所有平面UI和文字仍保留在HTML中。

生成的3D镜头(Higgsfield)

通向3D玻璃的第二条路径:使用六段提示词的Seedance(格式行、设计世界、运动规则、时码镜头、音景、音乐)。要求无文字的镜头,所有文字在HyperFrames中设置;生成的字体会被替换掉。首先通过Blender制作的灰盒预览动画(作为视频参考)来阻挡摄像机,将关键帧或首尾帧传递给模型,并将你的品牌帧作为最后一帧传递。Marketing Studio预设最高支持720p,因此仅作为氛围草稿,绝不能作为母版。在提示词中用文字和十六进制代码命名你的品牌颜色。

着色器图层

WebGL片段着色器可以在HyperFrames中运行,前提是它从查找时间开始渲染,使用固定的画布尺寸,并且没有渲染循环(请参阅HyperFrames动画技能的Three.js和WebGL适配器)。有用的品牌无关着色器:漂移的雾或薄雾(fbm噪声,从地面色到透明)用于世界通道,玻璃折射带(通过法线贴图偏移UV)用于玻璃擦拭效果,柔和的体积光射线,以及使用你的强调色的慢速域扭曲色场。

图层顺序与可读性

  1. 背景板(视频),可选择模糊6到16像素,作为UI位于其前的镜头选择(焦点锁定:建立镜头时锐利,产品后变柔化)。
  2. 用于文字的介质遮罩:使用你的 dark 色的大约45%到62%的方向渐变,切勿在整个画面上使用纯色覆盖。
  3. 大气层:着色器或背景板交叉淡入淡出。
  4. 玻璃UI(磨砂外壳,大约0.92透明度的 ground 色面板),带有由 dark 色着色的柔和阴影。
  5. 文字和光标。

浅色文字放置在背景板暗面(经过遮罩处理)之上,深色文字放置在浅色天空或地面之上。切勿在浅色区域上放置浅色文字。

色彩校正

将背景板向你的品牌色彩校正:地面的暖度,阴影或高光中强调色的色相,不要使用默认的青橙色。如果背景板偏暖或偏冷,在放置前使用ffmpeg(eq,colorbalance)进行校正,并将校正参数记录在背景板旁边。

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

freudianflips/breakout-launch-videos

Build the brand kit a launch film uses from a website. Runs tools/brand-from-url.mjs on the reader's site to extract branding (colours, fonts, logo, name, tagline, copy, product images), then reviews the preview sheet with the reader and fixes any wrong role by hand. Use for "brand from website", "brand kit", "extract branding", "get our colours and fonts", "use our logo", or before the first launch film for a new brand.

freudianflips/breakout-launch-videos

Make or change a product launch film in your own brand. A film is a hook (the story before the cut) on a shared body (the name punching in, hero words cut on the voice, your product at close range, the logo lockup in near silence), built in HyperFrames from brand/brand.json and film/film.json. Holds the core, the template workflow (build, render and mix 1 hook or all of them), the generation recipes, the checks and the lessons. Use for "launch video", "launch film", "product video", "promo", "reveal", "announcement video", "new hook", "change the body", "render all launch videos".

freudianflips/breakout-launch-videos

Tool manual under launch-film (mixdown.py for buses, ducking, loudness and the brickwall). Mix and master the audio of a launch film. Music, SFX and voice-over on separate buses, the bed ducked by the voice's real envelope with a presence carve, the music dropped out for the logo, glue compression, a true-peak-safe limiter, -14 LUFS and -1 dBTP, then laid onto the rendered picture. Use after the score, the sound effects and the voice exist, for "mix", "master", "loudness", "LUFS", "ducking", "mux the audio".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the motion language for launch films built in HyperFrames). Ease tokens, camera doctrine, continuity at every cut, type and cursor craft, and brand-neutral signature moves (logo build, world pass, branch and pulse, waterfall fill, identity morph, macro pull-back, rise) that replace HyperFrames' stock look. Says which HyperFrames blueprints and transitions to keep, transform or avoid. Use whenever a launch film's picture is designed or animated, for "animation", "motion design", "transitions", "camera move", "make it feel like Apple", "less template".

freudianflips/breakout-launch-videos

Tool manual under launch-film (measuring a render and studying a reference film). Review a rendered launch film like a demanding creative director, then drive the v1 to v2 loop. Measures rhythm, static runs, cuts against the beat grid, loudness, true peak and voice pace with a script, then applies an eye checklist for continuity at every cut, legibility, brand, real UI, claims and differentiation. Writes a gap list and a scorecard; nothing ships on numbers alone. Use on every render, and on a reference film to learn from it, for "review the video", "check the film", "what is wrong with this cut", "study this reference".

freudianflips/breakout-launch-videos

Tool manual under launch-film (music fitted to the edit with Higgsfield Sonilo, ACE-Step locally, or the free scratch bed). Score a launch film with music whose sections are the film's acts. Each take is measured for tempo and section energy, stretched onto the film's BPM and offset so its drop lands on the cut. Use after the storyboard's beat sheet exists, for "music", "score", "soundtrack", "background track", "the drop", "beat grid".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the sound palette, the event map, the cue sheet and generated sound kits). Design the sound effects of a launch film. Builds an event map from the storyboard, the voice-over word timings and the rendered timeline, voices every event from 1 consistent palette (the free synthesised, key-locked forge, or real glass, felt, wood, marimba, clicks and air generated on Higgsfield and pitched into the film's key), and renders 1 SFX stem in a shared acoustic space. Use once picture timing and the score are fixed, for "sound effects", "SFX", "sound design", "UI sounds", "sonic logo".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the brief, the story spine, the script, the beat sheet and reference studies). Turn a launch brief into a launch film's story in your own brand, with the one message, the narrative spine, the voice-over script at the right length, a beat sheet on the music's bar grid and a STORYBOARD.md where every shot names its continuity in and out, its signature move and its sound. Includes the reference study and the logo-swap differentiation test. Use first, before voice, score or motion, for "launch video script", "storyboard", "brief", "what should the launch film say", "study this reference video".

freudianflips/breakout-launch-videos

Tool manual under launch-film (voice casting, one take per line, fitting lines, stitching, forced alignment, the vintage chain, the local clone and the free scratch voice). Produce the voice-over of a launch film. Casting across every Higgsfield preset voice, one file per script line fitted into its frame, pace and length rules, word-level timestamps by forced alignment so every key word lands on its visual, and fixes for lines that run long. Use after launch-story has an approved script and before picture timing is locked, for "voice-over", "narrator", "cast a voice", "record the lines", "align the words", "scratch voice".

相关技能