Communitygithub.com

Drama2557/4RealDigital-Video-Studio

场景间过渡的渲染正确性准则,适用于HyperFrames启动视频——确保主时间线上过渡合成正确的前提条件。当构建主时间线/index.html、剪切或交叉淡变接缝处出现白色闪烁(尤其在暗色影片中)、需要排查过渡透明度凹陷透出原因或验证渲染端重叠场景包装器的混合机制时使用。涵盖不透明舞台地面(#root背景)白色闪烁防护以及注入器如何重叠包装器、保持最终帧、乒乓式切换轨道、并将符合lint规范的模板代码印刻到主时间线上。不包含逐过渡目录——参见过渡注册表以了解单个过渡条目。

4RealDigital-Video-Studio 是什么?

该技能定义了PLV场景间过渡的渲染正确性准则,确保任何类型的过渡(交叉淡变、推拉滑动、缩放穿越等)都能在主时间线上正确合成。它解决了因#root背景透明导致的白色闪烁问题——当两个场景包装器的总透明度小于1时,默认白色背景会透出,尤其在暗色影片中非常刺眼。方法是通过CSS为#root设置不透明背景(如#000),并由注入器在断点处应用过渡:延长输出场景持续期以保持最终帧、提前输入场景起始时间创建重叠窗口、通过0/1乒乓分配轨道确保两个重叠包装器不共享同一轨道、并将GSAP模板印刻到主时间线。这些机制在原型渲染中已验证,且所有代码遵循lint规则,兼容Cursor、Claude Code等AI开发工具,适用于HyperFrames启动视频的master timeline构建。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Drama2557/4RealDigital-Video-Studio/tree/HEAD/.agents/skills/seam-craft

在你喜欢的 AI 中提问

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

文档

场景衔接工艺——场景间过渡的渲染前提条件

这是PLV场景间衔接的渲染正确性准则:使任何过渡都能正确合成的前提条件和主时间线机制,与具体选择哪个过渡无关。逐过渡目录(交叉淡变、推拉滑动、缩放穿越、曲线切割……)位于过渡注册表中——本页是支撑所有过渡的底层准则。

本准则管辖的过渡已准备好Tier-B:对两个场景的剪辑包装器(#el-<sid>)进行纯变换/透明度/滤镜操作,无需注入额外DOM,无需场景间协作。叠加系(交错块、百叶窗、漏光、网格溶解、翻页燃烧)和着色器过渡推迟到后续阶段。

舞台地面前提条件(白色闪烁防护)

多个模板存在一个窗口期,其中两个包装器的总透明度 < 1(曲线切割的中间窗口剪切、缩放穿越的0.15下限、普通交叉淡变的幂曲线凹陷)。包装器后面的内容在这段窗口期内会透出。如果组装后的index.html的#root没有不透明背景,渲染器会在凹陷处将默认白色页面合成进来 → 每个接缝处出现白色闪烁,在暗色影片上尤为刺眼(此问题在修复前于两次Spotify运行中观察到)。组装器必须绘制舞台: #root { background: var(--canvas-deep, var(--canvas, #000)) } —— assemble-index.mjs现在已发出此样式;这些模板的其他消费者也需要承担同样的保证。

注入器如何应用过渡

在场景_i_(from)与场景_i+1_(to)之间的break边界处,注入器:

  1. 将#el-<from>包装器的data-duration延长duration_s(保持其最终帧——已验证:core/src/runtime/init.ts:1393-1410外部槽分支)。
  2. 将#el-<to>包装器的data-start提前duration_s(创建重叠窗口)。
  3. 将所有剪辑的data-track-index重新分配为0/1乒乓式,使两个重叠的包装器永远不会共享同一轨道(同一轨道重叠是非法的——core/src/lint/rules/composition.ts)。较高轨道的内容合成在顶部。
  4. 在T = overlap-start处将gsap_template印刻到window.__timelines["main"]。

通过原型渲染验证(2026-05-31):主时间线包装器补间被寻址并渲染(不会与子合成自身的暂停时间线发生双重寻址——运行时独立驱动它们),扩展的包装器保持场景_i_的最终帧,较高轨道的传入包装器在传出包装器上方合成并与之混合。

模板占位符

注入器在每行gsap_template中替换以下标记:

标记含义
__OLD__"#el-<from>" —— 传出剪辑包装器选择器(带引号)
__NEW__"#el-<to>" —— 传入剪辑包装器选择器(带引号)
__T__重叠开始时间(秒,主时钟)
__DUR__此边界的duration_s
__DX__方向类型的水平移动距离:-1920(左)/ 1920(右)
__DY__垂直移动距离:-1080(上)/ 1080(下)
__ORIGIN_OUT__ / __ORIGIN_IN__用于squeeze的transformOrigin对

filter / scaleX / transformOrigin在主时间线上是lint干净的(已验证:core/src/lint/rules/gsap.ts没有按属性白名单,并将检查范围限定在data-composition-id区间;x/y/scale/rotation/opacity白名单仅是一个_场景工作器_的提示规则——它不约束index.html)。

Individual skills in this repo

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

Drama2557/4RealDigital-Video-Studio

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

Drama2557/4RealDigital-Video-Studio

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

Drama2557/4RealDigital-Video-Studio

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

Drama2557/4RealDigital-Video-Studio

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

Drama2557/4RealDigital-Video-Studio

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

Drama2557/4RealDigital-Video-Studio

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Drama2557/4RealDigital-Video-Studio

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

Drama2557/4RealDigital-Video-Studio

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

Drama2557/4RealDigital-Video-Studio

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Drama2557/4RealDigital-Video-Studio

Install, discover, and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

Drama2557/4RealDigital-Video-Studio

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

Drama2557/4RealDigital-Video-Studio

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

Drama2557/4RealDigital-Video-Studio

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

House-style oversized macOS cursor technique for HyperFrames launch videos. Load whenever a scene involves cursors or a pointer-led action, when kicking off a UI scene, when igniting a morph/transition/typing run with a click, or when a scene reads as static, dead, or stale and needs a cheap high-yield source of motion to carry the viewer's eye and segment them out of the stale state. Covers cursor size/look (incl. brand-motif cursors), the off-screen entry law, tip-targeting and the click tap, click-ignites-the-next-beat, and exit / cross-scene handoff.

Drama2557/4RealDigital-Video-Studio

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

Drama2557/4RealDigital-Video-Studio

Agent skill / project related to launch or product demo video: Drama2557/4RealDigital-Video-Studio

相关技能