Plugin-Installation: Führen Sie vor dem Einrichten (Setup) oder vor Aktualisierungsbefehlen (Freshness) die Plugin-Ausführungsregeln aus, wenn dieses Skill innerhalb eines HyperFrames-Plugins verwendet wird. Bei eigenständigen Installationen gelten die unten stehenden Aktualisierungshinweise.
HyperFrames Keyframes
Keyframes sind ein Pose-Vertrag: sichtbare Zustände, kontinuierliche Subjektidentität, suchsichere Laufzeit, überprüfte Pixel.
Verwenden Sie hyperframes-animation für allgemeine Szenenrezepte. Verwenden Sie hyperframes-cli für die vollständige Befehlsdokumentation. Verwenden Sie references/keyframe-patterns.md nur, wenn Sie Implementierungsmechanismen auswählen, nicht den visuellen Stil.
Bearbeitungsgrenze für Ersteller
Keyframes steuern visuelle Bewegung, nicht die Clip-Montage. Harte Schnitte im Quellenbereich, Trimmen, Splice und Umsortieren gehören zu /hyperframes-core: Autoren ein Medienelement pro beibehaltenem Bereich, platzieren Sie es mit data-start und data-duration und wählen Sie seinen Quellen-Offset mit data-media-start. Benachbarte Bereiche erzeugen einen harten Schnitt. Ein Crossfade verwendet überlappende Clips auf verschiedenen Spuren plus visuelle Opazitäts-Keyframes; Audioausblendungen verwenden /hyperframes-audio.
| Erstelleranfrage | Wahrheitsgetreuer Mechanismus |
|---|---|
| Punch-in / Punch-out | Keyframe scale mit x/y oder prozentualer Verschiebung auf einem nicht-zeitgesteuerten visuellen/Crop-Wrapper innerhalb des Clips. Verwenden Sie einen Set/Short-Tween für einen harten Punch und einen Tween für eine sanfte Bewegung. |
| Sanfter Multi-State-Zoom oder Reframe | Halten Sie einen Subjekt-Wrapper am Leben und autoren Sie mehrere Zoom/Reframe-Zustände als Pose-Leiter mit segmentspezifischem Easing. |
| Schwenk, Reframe oder Ken-Burns-Kamerafahrt | Animieren Sie die Wrapper-Translation plus Skalierung. Die Geometrie wird erstellt; dies ist keine Gesichtsverfolgung oder automatische semantische Neurahmung. |
| Verkettete Kamerafahrten | Verketten Sie beschriftete Transformationsschritte auf einer registrierten, suchsicheren Timeline. |
| Match-Cut oder Whip-Pan | /hyperframes-animation steuert die visuelle Übergabe; /hyperframes-registry liefert Primitive; Keyframes bewahren die erstellte Geometrie, Richtung und Geschwindigkeit. Es gibt keine automatische Match-Frame-Erkennung. |
| Zuschneiden und Masken-Reframe | Interpolieren Sie clip-path oder eine Maske auf einem inneren visuellen Wrapper, um zuzuschneiden/neu einzurahmen, ohne die Quellenzeit zu ändern. Polygon-Keyframes können einen Polygon-/Masken-Übergang bilden. |
| Gerichteter Wipe-Cut oder Iris-/Enthüllungsschnitt | Animieren Sie eine Masken/Clip-Grenze über überlappende visuelle Clips; /hyperframes-animation steuert die Übergabechoreografie. |
| Split-Screen-Übergabe | Behalten Sie beide visuellen Clips, die vom Core platziert wurden, und keyframen Sie dann ihre inneren Crop/Mask-Wrapper und die Teilungsgeometrie. |
| Konstante Quellenzeitraffung | /hyperframes-core steuert die normalisierte data-playback-rate (0.1..10) für render-sicheres Bild und tonhöhenerhaltenen Ton. Sie ist für das gesamte Medienelement konstant. |
| Quellgeschwindigkeitsrampen | Eine rate-Spur in data-automation auf dem <video>/<audio> (t in Clip-Sekunden, v 0.1..10, Log-Interpolation); sie überschreibt die konstante Rate. |
| Einfrieren / Halten | Eine visuelle Pose, ein endgültiges Quellbild oder eine abgeschlossene Unterkomposition kann gehalten werden. Ein beliebiges Einfrieren mitten in der Quelle wird nicht unterstützt; bereiten Sie ein Standbild/abgeleitetes Segment vor, platzieren Sie es als eigenen Clip und fahren Sie dann mit einem anderen Quellbereich fort. |
Wenn Sie Bild und Ton zusammen bearbeiten, laden Sie /hyperframes-core, dieses Skill für visuelle Bewegung und /hyperframes-audio für Ein- und Ausblendungen, Crossfades, Lautstärkeautomatisierung, Ducking/Carve oder Effekte auf den platzierten Spuren.
Eine visuelle Übergangs- oder Zuschneidebehandlung ist kein zeitlicher Quellentrimm oder -splice. /hyperframes-core steuert die Timeline, das Clip-Timing und die Quellbereiche; Keyframes animieren nur die sichtbare Übergabe oder den Zuschnitt auf Wrappern innerhalb dieser Clips. Für kopierbare kombinierte Bild/Ton-Rezepte verwenden Sie /hyperframes-core → references/creator-editing-recipes.md.
Vorgehen
- Identifizieren Sie das animierte Subjekt, die sichtbaren Zustände, den Endzustand und die Laufzeit.
- Wählen Sie den kleinsten Mechanismus, der die Anfrage beweist. Lesen Sie
references/keyframe-patterns.mdnur, wenn der Mechanismus unklar ist. - Autoren Sie suchsichere Keyframes in der deklarierten Laufzeit. Registrieren Sie die Laufzeitinstanz erst nach Abschluss des Builds; das Bauen innerhalb von
document.fonts.readyist in Ordnung. - Überprüfen Sie mit
hyperframes check(es führt Lint aus),hyperframes keyframes, einem fokussierten--shotund Snapshots zu Beweiszeitpunkten. - Wenn der Beweis fehlschlägt, korrigieren Sie die Quell-Keyframes und führen Sie die kleinste fehlschlagende Diagnose erneut aus, bevor Sie rendern.
Vertrag
- Benennen Sie das sich bewegende Subjekt.
- Nennen Sie die Posen, die benötigt werden, um die beabsichtigte Bewegung zu beweisen, einschließlich des Endzustands.
- Keyframen Sie sichtbare Kanäle, keinen versteckten Hilfszustand.
- Bewahren Sie die Objektidentität, wenn Kontinuität wichtig ist.
- Überblenden Sie nur, wenn die beabsichtigte Bewegung ein Ersatz oder eine Auflösung ist.
- Halten Sie lesbare oder semantische Zustände lange genug, um sie zu sehen.
- Das letzte Bild ist Teil der Animation, keine Bereinigung.
- Setzen Sie nicht auf den Ruhezustand zurück, es sei denn, es wird verlangt.
- Beenden Sie nicht mit Schwarz, es sei denn, es wird verlangt.
- Wenn Sie eine Startszene bearbeiten, bewahren Sie Layout, Kopie, Assets, Farben und Endzustand, es sei denn, Sie werden gebeten, sie neu zu gestalten.
Laufzeitregeln
GSAP:
- Bauen Sie beim Laden der Seite oder innerhalb von
document.fonts.readyund registrieren Sie sich erst nach Abschluss des Builds - Verwenden Sie
gsap.timeline({ paused: true }) - Registrieren Sie als
window.__timelines[compositionId] - Der Registrierungsschlüssel muss mit
data-composition-idübereinstimmen - Rufen Sie
tl.play()nicht für renderkritische Bewegungen auf - Halten Sie Wiederholungen endlich
CSS-Keyframes:
- Endliche Dauer und Iterationsanzahl
- Deterministische Verzögerung
animation-fill-mode: both- Verwenden Sie
data-start, wenn das Timing zu einem Clip gehört
Anime.js:
- Synchron erstellen
autoplay: false- Endliche Dauer und Schleifen
- Pushen Sie jede Instanz zu
window.__hfAnime
WAAPI:
- Endliche
duration fill: "both"- Deterministische Konstruktion
- Die Textoberfläche listet WAAPI nicht auf; verifizieren Sie mit
--shot(es sucht WAAPI) und Snapshots
Niemals für renderkritische Bewegungen verwenden:
Date.now()performance.now()- ungesäter
Math.random() - Hover/Scroll-Trigger
- Timer
- eine Timeline, die registriert wurde, bevor ihr asynchroner Build abgeschlossen ist
- nicht registriertes
requestAnimationFrame - Endlosschleifen
GSAP-Skelett
const root = document.querySelector("[data-composition-id]");
const compositionId = root.dataset.compositionId;
const tl = gsap.timeline({ paused: true });
tl.addLabel("state-a", 0);
tl.to(".subject", {
keyframes: [
{ x: 0, opacity: 1, duration: 0.2 },
{ x: 120, opacity: 1, duration: 0.4, ease: "power2.out" },
{ x: 100, opacity: 1, duration: 0.2, ease: "power2.inOut" },
],
ease: "none",
});
window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;
Verwenden Sie Labels für semantische Zustände. Verwenden Sie Positionsparameter anstelle von verketteten Verzögerungen. Verwenden Sie immediateRender: false für spätere from()/fromTo()-Tweens, die dieselbe Eigenschaft betreffen.
Keyframe-Formen
- Array-Keyframes: Pose-Leiter mit Dauer/Easing pro Schritt.
- Prozent-Keyframes: exaktes Timing innerhalb eines Tweens.
- Eigenschafts-Arrays: kompakte Mehrfachstopp-Änderungen.
ease: "none"auf dem Elternelement, wenn jeder Stopp sein eigenes Easing hat.easeEach, wenn jedes Segment das gleiche Gefühl teilen soll.
Kopieren Sie keine numerischen Abstände oder Timings aus Beispielen. Leiten Sie sie aus der tatsächlichen Kompositionsgeometrie und -dauer ab.
Für ein Subjekt, das sich zwischen zwei Kästchen bewegt, bevorzugen Sie einen kontinuierlichen Transformations-Tween oder FLIP. Teilen Sie x/y/scale nur dann in mehrere erleichterte Keyframes auf, wenn der Betrachter einzelne Schläge spüren soll; jedes Segment ändert die Geschwindigkeit und kann als Ruckler wahrgenommen werden.
Kanäle
Bevorzugen Sie Compositor/visuelle Kanäle: x/y/z, xPercent/yPercent, scale, rotationX/Y/Z, skew, transformOrigin, svgOrigin, opacity, autoAlpha, clip-path, Masken, CSS-Variablen, SVG-Pfad/Dash-Werte, Kamera-Transformationen, Shader-Uniforms.
Vermeiden Sie Layout-/Lebenszyklus-Kanäle: top/left/right/bottom, width/height, margin/padding, display, visibility, späte DOM-Erstellung, Helfer-Overlays für Subjektbewegungen.
Für Sichtbarkeitsänderungen verwenden Sie autoAlpha auf der registrierten suchbaren GSAP-Timeline oder ein tl.set() mit null Dauer an einer expliziten Grenze. Zielen Sie nur auf ein Nicht-Clip-Element oder einen Wrapper innerhalb des Clips; zielen Sie niemals auf .clip selbst. Tweenen Sie niemals rohes visibility mit Dauer und tweenen Sie niemals display.
Mechanismusauswahl
Wählen Sie den kleinsten Mechanismus, der die Anfrage beweist:
| Bedarf | Mechanismus |
|---|---|
| Gleiches Subjekt ändert Box oder Hierarchie | gemeinsames Element / FLIP |
| Subjekt legt eine sichtbare Route zurück | Pfadverlauf |
| Strich wächst oder zeichnet nach | Strichzeichnung |
| Form wird zu einer anderen Form | Forminterpolation |
| Enthüllungsgrenze ist sichtbar | Clip, Maske oder Shader-Uniform |
| Viele Elemente bewegen sich mit Reihenfolge | Stagger / indizierte Verzögerung |
| Text selbst bewegt sich | Zeilen-, Wort-, Zeichen- oder Bandunterteilung |
| Oberfläche biegt, streckt oder schneidet | Eltern/Kind-Gegentransformation |
| UI hat Zustände | explizite Zustandsmaschine |
| Szene hat Tiefe | DOM 3D, Three.js oder WebGL-Kamera/Objekt-Keyframes |
Mechanismen können kombiniert werden, aber jeder muss die Idee verdeutlichen. Dekoration ist kein Beweis.
Timing
- Antizipation nur, wenn sie Ursache oder Richtung verdeutlicht.
- Beschleunigung verlässt den Ruhezustand.
- Spitzenbeweis zeigt den Mechanismus unmissverständlich.
- Nachziehen verkauft Energie und Richtung.
- Überschwingen nur, wenn sich das Subjekt elastisch oder taktil anfühlen soll.
- Pfadverlauf mit konstanter Geschwindigkeit benötigt normalerweise
ease: "none". - Diskrete UI-Zustände benötigen normalerweise ein scharfes Aus-Easing.
- Wiederholte Elemente benötigen geordnete Offsets, keine identischen Timings.
- Endgültige Verriegelungen benötigen längere Haltepunkte als Übergangsposen.
- Glätte bedeutet kontinuierliche Geschwindigkeit auf demselben Subjekt.
- Überlappen Sie keine Tweens, die dieselbe Transformationseigenschaft schreiben, es sei denn, die Überlappung ist beabsichtigt und verifiziert.
- Vermeiden Sie es, große
clip-path/Masken-Änderungen zu animieren, während dieselbe Heldenoberfläche auch skaliert oder sich bewegt; verwenden Sie verschachtelte Enthüllungen, nachdem sich die Hauptbewegung beruhigt hat.
Text
Bewahren Sie Zeilenboxen, Wortabstände, Lesbarkeit und endgültige Passform. Wenn sich Text intern bewegt, bewegen Sie die Glyphen oder maskierten Bänder, nicht nur Dekorationen um den Text herum. Machen Sie einen Snapshot von lesbaren Bildern.
SVG
Für Strichwachstum bevorzugen Sie DrawSVGPlugin, dann stroke-dasharray/stroke-dashoffset. Für Forminterpolation bevorzugen Sie MorphSVGPlugin; konvertieren Sie Primitive bei Bedarf in Pfade und teilen Sie komplexe Silhouetten in einfachere Teile auf.
3D
Skalierung allein ist falsche Tiefe. Verwenden Sie Perspektive auf einem stabilen Elternelement, transform-style: preserve-3d, z-Reise, Rotation, Kamera-/Weltbewegung, Okklusion und Ebenenreihenfolge, wenn sich Objekte kreuzen.
Verwenden Sie einen oder zwei diagnostische Winkel, die die Tiefenbeziehung aufdecken. Wenn der angewinkelte Beweis keine Tiefenkreuzung zeigt, verbessern Sie z/Kamera/Okklusion.
Canvas / WebGL
Keyframen Sie Kameraposition, Kamera-Ziel, Objekttransformation, Materialopazität, Shader-Uniforms und Postprozess-Intensität durch deterministischen Zustand. Rendern Sie aus der HyperFrames-Zeit. Verwenden Sie --ghost, da Markerboxen keine interne Canvas-Bewegung sehen können.
CLI-Beweis
npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<file>" --ghost --angle <angle>
npx hyperframes snapshot . --at <times>
Wählen Sie <selector> für das echte animierte Subjekt. Wählen Sie <times> für das erste Bild, Beweispunkte, Final-Minus-Halt und exaktes Finale. Wählen Sie <angle> nur, wenn Tiefe bewiesen werden muss.
| Werkzeug | Beweist |
|---|---|
keyframes | Targets, explizite Stopps, Pfade, Spuren, komponierte Eltern/Kind-Bewegung, CSS-Stopps, Anime-Registrierung |
--shot | Geister, Routenform, Zeitabstand, DOM-3D-Projektion, fokussierter Selektorbeweis |
--layout strip | In-Place-Bewegung, Überlappungen, Kontakt, subtile Skalierung/Opazität, Textwellen |
--ghost | Canvas, WebGL, Shader-Bewegung, gerendertes 3D |
snapshot --at | Masken |
…[gekürzt für Übersetzung]