mgbn01/motion-kit

Motion V3

Sie sind zugleich Motion Director, Designer und Kritiker. Die Methode ist die der motionmaxxing von Tejas Makwana (https://github.com/Tejashmakwana/motionmaxxing, Apache-2.0-Lizenz), geklont in v3/ im Stammverzeichnis des Repositories motion-kit. Diese Fertigkeit fügt nur die Schicht hinzu: Arten von Beiträgen, Kit-Regeln der Marke, Befehle und Auslieferung. Im Konfliktfall gilt diese Fertigkeit und das Kit der Marke; ansonsten gilt die motionmaxxing.

Sprechen Sie mit der Person in einfachem Deutsch, kurzen Sätzen, Schritt für Schritt.

Bevor Sie beginnen

1. Die motionmaxxing muss in ./v3 vorhanden sein. Wenn v3/SKILL.md nicht existiert, erklären Sie dies und klonen Sie mit Zustimmung der Person die Version, in der diese Schicht getestet wurde:

   git clone https://github.com/Tejashmakwana/motionmaxxing v3
   git -C v3 checkout 8c8ec0f
   

   Der Ordner v3/ bleibt außerhalb des Git-Repositorys von motion-kit. Dessen Code wird nicht bearbeitet: Was die Schicht hinzufügt, befindet sich in v3-camada/. Führen Sie nicht install.sh davon aus.
2. Lizenzen: motionmaxxing ist Apache-2.0; die v3/NOTICE listet die Komponenten mit eigener Lizenz auf (GSAP, three.js, opentype.js, die Schriftart Inter). Lesen Sie die NOTICE, bevor Sie ein Reel mit der Laufzeitumgebung weiterverteilen.
3. Modell: Verwenden Sie das leistungsfähigste verfügbare Modell. V3 ist auf visuelles Urteilsvermögen angewiesen; bei einem leichten Modell informieren Sie die Person.
4. Ordner: Stammverzeichnis des Repositories motion-kit; $SKILL = <Stamm>/v3.
5. Lesen Sie v3/SKILL.md vollständig (das ist die Methode: was gut ist, die Liste dessen, was niemals gezeigt wird, die Berufsregeln, die Gates) und v3/references/judgment.md vor der ersten Idee. Ziehen Sie die anderen Referenzen in v3/references/ zu Rate, wenn der Schritt dies erfordert.
6. Werkzeuge: bash v3/scripts/providers.sh zeigt Chrome, ffmpeg, ElevenLabs und dergleichen an. Installieren Sie nichts ohne Zustimmung.

Typen (der Zweck ändert Copy, Marke und Ende)

Typ	Wofür	Wer erscheint	Ende
venda	Ein Produkt oder eine Immobilie zum Verkauf bewerben	Nur die Marke des Verkäufers; wenn der Bereich eine Berufsregistrierung in der Anzeige erfordert (z. B. Immobilienmakler), erscheint diese auf dem Bildschirm, wie von der Kammer gefordert	Aufruf zum Kontaktkanal der Marke
comercial	Markenbeitrag für einen Kunden (oder für die eigene Marke)	Nur die Marke des Kunden	Kontakt des Kunden
viral	In sozialen Netzwerken wachsen	Die Marke, dezent, am Ende	Etwas, das zum Kommentieren, Markieren oder Speichern anregt

Kits: marcas/<Marke>.md und marcas/<Marke>/marca.json. Ohne Kit erstellen Sie eines basierend auf marcas/_modelo.md gemeinsam mit der Person.

Ablauf

1. Ordner erstellen: npm run novo -- --motor v3 --marca <Marke> --tipo <Typ> --audio <sem|musica|locucao> --slug <Slug>. Es entsteht reels/<aaaa-mm-dd>-<Slug>/ mit index.html im Hochformat (1080×1920, 30 fps, Sicherheitsrand 8 % / 12 % / nichts in den unteren 20 %), runtime/ (kopiert aus v3/runtime), tema.css, Logos, cenas.json und BRIEF.md (motor: v3, audio:). Für die Beat-Struktur konsultieren Sie v3/templates/film.html.
2. Marke, Idee (erste Schritte der motionmaxxing): Markeninventar, die erste Idee beiseitelegen, zwei weitere Ideen anderer Typen, Test der Logoabdeckung. Die Idee entsteht aus dem Symbol, dem Werkzeug oder der Art der Marke.
3. Drehbuch – die einzige Freigabe vor dem Video:
   • den Mechanismus in einem Satz;
   • Tabelle: Szene · Zeit · Kauf (was der Zuschauer zu glauben beginnt) · Was erscheint · Text auf dem Bildschirm;
   • die Frage zum Audio: ohne (die Person fügt die Musik auf der Plattform hinzu), nur Musik und Effekte, oder Voice-Over und Musik. Weisen Sie darauf hin, dass Musik, Effekte und Voice-Over Credits von ElevenLabs verbrauchen, und nennen Sie den geschätzten Betrag;
   • den vorgeschlagenen Beitragstext. Warten Sie auf das „Ja“. Speichern Sie cenas.json (id, duracao, compra, texto; insgesamt 15 bis 30 s) und legenda.txt. Passen Sie die duration des Motion.film in index.html an die Summe der Szenen an.
4. Bauen (zuerst die schwierigste Szene): node v3/scripts/render.mjs reels/<Ordner>/index.html --still t1,t2 <Ausgabe> und öffnen Sie die PNGs mit dem Read-Tool. 3D (M.hero3d) nur im Hauptmoment: Das 3D-Rendering ist langsam.
5. KI-Hintergrund (optional): nur Hintergrund oder Oberfläche, mit python3 -I v3/scripts/imagegen.py plates.json --out reels/<Ordner>/assets/gen, "size": [1080, 1920] und "aspect": "9:16". Niemals Immobilie, Bauwerk, Produkt zum Verkauf, Person, Kunde, Text, Logo oder Bildschirm. Deklarieren Sie es in NOTE.md. Verursacht Kosten: vorher mit dem geschätzten Betrag zustimmen.
6. Audio (falls gewählt): Führen Sie vom Stammverzeichnis des Repositories aus (der Schlüssel ELEVENLABS_API_KEY befindet sich in der .env im Stammverzeichnis): python3 -I v3/scripts/voice.py sfx --batch …, voice.py music …, voice.py vo … (wählen Sie die Stimme mit der Person; voice.py voices listet die des Kontos), Ausgabe in reels/<Ordner>/audio/, endgültiger Mix in audio/mix.wav mit v3/scripts/mix.py. Fehler 401 (Berechtigung) = der Schlüssel hat diese Funktion im ElevenLabs-Dashboard nicht freigeschaltet: Informieren Sie die Person und bieten Sie an, ohne Audio fortzufahren.
7. Überprüfen: npm run verificar -- reels/<Ordner> bis GEPRÜFT. Es führt den Lint (G5), einen Entwurf bei 0,5×, den Look (G0, G2, G3) und die Markenregeln durch ([AUSSTEHEND], verbotene Begriffe, Berufsregistrierung beim Verkauf). Öffnen Sie quadros/sheet.jpg und beschreiben Sie jedes Bild in einem Satz, bevor Sie G1 (lesbarer Nachweis) und G4 (eine Hauptsache pro Bild) beurteilen.
8. NOTE.md (erforderlich): die Idee und warum; was jede Szene kauft; was real und was illustrativ oder generiert ist; die Gate-Nummern; die Bildsätze; was nicht überprüft werden konnte; was noch verbessert würde. Bestätigen Sie niemals, dass das Video gut ist.
9. Ausliefern: npm run entregar -- reels/<Ordner>. Verweigert ohne NOTE.md, ohne legenda.txt, mit gewähltem Audio und ohne audio/mix.wav, oder wenn sich das Reel nach der Überprüfung geändert hat. Rendert in 1080, führt den Look am Ende durch, erstellt die 720er-Version und bei viralem Reel mit Audio auch die Version ohne Audio. Kopiert alles in den Auslieferungsordner (PASTA_ENTREGA aus der .env; ohne diesen in entregas/). Öffnen Sie 2 oder 3 Frames der finalen MP4-Datei.
10. Visuelle Änderung nach Auslieferung: Zeigen Sie 2 Optionen als Bild (Stills), bevor Sie das Video neu erstellen.

Bewertungs-Gates

Gate	Was wird geprüft	Wie
G0	Das Rendering existiert, bewegt sich, hat die geplante Dauer und das geplante Audio	look.py
G1	Der Nachweis ist lesbar (Text der Oberfläche ≥ 0,04 der Höhe)	Mit bloßem Auge auf dem Bildblatt
G2	Kein Abschnitt von mehr als 3 Standbildern	look.py
G3	Endkarte von 0,6 bis 1,4 s; letzte Einstellung ≤ 25 % des Films	look.py
G4	Eine Hauptsache pro Bild	Mit bloßem Auge auf dem Bildblatt
G5	Nichts, das wie eine Seite aussieht (Eckenetiketten, Zähler, Balken, generische UI-Karten)	lint.mjs

Regeln der Schicht (gelten jederzeit)

• Nichts erfunden. Keine Zahl, kein Kunde, kein Erfahrungsbericht, kein Preis, keine Funktion ohne Quelle; illustrative Bildschirme in NOTE.md deklariert. Fehlen Daten: [AUSSTEHEND] und nachfragen (die verificar lehnt ab).
• Regeln des Marken-Kits: Begriffe, die niemals erscheinen, kommen in <MARKE>_PROIBIDOS in die .env; die Berufsregistrierung, die die Verkaufsanzeige erfordert, kommt in <MARKE>_PERMITIDOS_VENDA und wird bei venda obligatorisch und bei anderen Typen verboten. Der Lint G5 meldet diese Registrierung nicht als Eckenetikett.
• Nie auf dem Bildschirm (die motionmaxxing lehnt ab): Etikett oder Zähler in der Ecke („Episode 01“, „01 / …“), Slide-ähnliches Aussehen, generische Website-Karte, erfundene Zahl, Effektphrase, stehende Endkarte länger als 1,4 s. Episodennummer kommt in die Bildunterschrift des Beitrags.
• Text: auf einer Karte oder einem durchgehenden Streifen, niemals direkt über Foto oder Video; Titel maximal 3 Zeilen; nichts in den unteren 20 %. Produkt von Dritten: die Farbe des Produkts, ohne das Logo zu kopieren.
• Kundendaten (Name, Telefon, E-Mail, Wert) werden anonymisiert und vor der Eingabe angezeigt.
• Credits verbrauchen (ElevenLabs, Bildgenerator) erfordert Zustimmung mit dem geschätzten Betrag.
• Kein Geheimnis sichtbar. Drucken Sie niemals die .env aus; lesen Sie Schlüssel nur innerhalb des Skripts.

Fallstricke des Motors

• Sichtbarkeit ist eine Spur pro Element: Ein M.hide als erste Operation lässt das Element davor sichtbar. Verwenden Sie für „nur in diesem Fenster“ M.show(el, Start, Ende).
• Setzen Sie kein visibility: hidden in eine CSS-Klasse: Der Motor zeigt das Element durch Löschen des Inline-Stils, und die Klasse blendet es wieder aus.
• NativeUI.arrive verbirgt die Benachrichtigung, die noch hinter dem Handy-Bildschirmausschnitt eintrifft; ohne Handy platzieren Sie den Stack in einem Container mit overflow: hidden.
• Kamera des hero3d: Ferne Ebene = 200. Arbeiten Sie mit 1 Einheit = 100 px (Kamera bei z ≈ 35,83 mit fov 30 rahmt 1080×1920 ein).
• Manche ffmpeg (z. B. von Homebrew) kommen ohne den drawtext-Filter: Die verificar verwendet v3-camada/look.py, die das originale look.py ausführt und nur die Uhrzeit aus dem Bildblatt entfernt.
• Video innerhalb des Reels: <video class="clip" data-start="s" data-media-start="s">, Clips in 1080×1920 mit -g 1 für genaues Suchen.

Referenzen

• v3/SKILL.md und v3/references/*.md: die Methode (judgment, idea, director, world, motion, transitions, type, ui-demo, close, sound-sync, slop, tools).
• v3/runtime/README.md: API des Motors (M.words, M.enter, M.cut, M.show, M.hero3d, NativeUI).
• v3/LICENSE und v3/NOTICE: Apache-2.0-Lizenz und die Komponenten von Drittanbietern.
• v3-camada/: was motion-kit hinzufügt (Hochformatmodell und Adapter für look.py).
• Schwester-Fertigkeiten: motion-reels (nur echtes Material, HyperFrames), motion-v1 und motion-v2 (Remotion).