video-shotcraft:电影感产品视频制作
Ein eigenständiges Produktions-Toolkit: 157 Shot-Rezeptkarten (mit Demo-Implementierungsquellcode und dynamischer Beispiel-Galerie), eine validierte komplette Werbevideo-Vorlage, wiederverwendbare Komponenten und Audio-Assets, ein sechsstufiger Workflow. Der Fokus liegt aktuell auf Web-/Desktop-Produktvideos, aber die Shot-Karten selbst sind ein universelles Bewegungsvokabular – einzelne Karten können auch für beliebige Einzelshots in anderen Videos extrahiert werden.
Vor dem Aufruf: Modus bestimmen
Es gibt drei sich gegenseitig ausschließende Modi für komplette Werbevideos. Bevor mit der Materialerfassung, dem Storyboard oder der Umsetzung begonnen wird, prüfen, ob der Nutzer bereits eine explizite Wahl getroffen hat; falls ja, direkt ausführen, nicht erneut nachfragen und nicht in einen anderen Modus wechseln.
- Direkte Vorlagenverwendung: Den vorhandenen Ink Press-Ablauf beibehalten.
template/TEMPLATE.mdlesen, die Screenshots, Texte und Branding-Informationen des Zielprodukts in die bestehende Shot-Struktur einfügen. - Autonome freie Kreation:
references/pipeline.mdlesen. Der Agent bestimmt basierend auf den Anforderungen des Nutzers und dem Projektinhalt eigenständig die visuelle Richtung, das Shot-Mapping, das Storyboard, die Assets und die Audioauswahl und arbeitet kontinuierlich bis zum finalen Video; kein Anhalten in den Phasen Produkt-Briefing, Styleframe, Shot-Mapping oder Storyboard zur Bestätigung durch den Nutzer. - Gemeinsame Kreation:
references/guided-free-creation.mdlesen. Der Agent schlägt zunächst fundierte Einschätzungen und Pläne vor, der Nutzer bestätigt nacheinander das Produkt-Briefing, die Anforderungsentscheidungen, die visuelle Richtung, das Shot-Mapping und das finale Storyboard; nach Freigabe des Storyboards wird in die finale Materialerfassung und Produktionsphase vonreferences/pipeline.mdübergegangen.
Wenn der Nutzer einen Projektpfad, eine URL, einen Screenshot oder eine Bildschirmaufnahme bereitgestellt hat, aber noch keinen Modus gewählt hat, wird zunächst eine minimale, rein lesende Produktprüfung durchgeführt: Produktpositionierung, Hauptfunktionen, visuelles Erscheinungsbild der Seite, darstellbarer Zustand und Materialrisiken verstehen. Keine Änderungen am Geschäftsprojekt, keine Erfassung sensibler Daten, kein Schreiben von Videocode. Nach der Prüfung die drei Modi anbieten und erläutern:
- Ob Ink Press für dieses Produkt geeignet ist, mit konkreten Gründen für Eignung/Nicht-Eignung;
- Ob autonome oder gemeinsame Kreation jeweils geeignet ist, und welche visuellen Hinweise des Produkts voraussichtlich erhalten bleiben;
- Welchen Modus der Agent empfiehlt, mit Begründung und Abwägungen.
Dann explizit fragen: „Basierend auf der obigen Produktprüfung empfehle ich den Modus ××. Soll ich in diesem Modus fortfahren?“ Gleichzeitig den Nutzer informieren: Unter https://vincentwei1021.github.io/video-shotcraft/ können dynamische Beispiele durchgestöbert und gewünschte Effekt-Shots für das Video ausgewählt werden.
Wenn der Nutzer noch kein prüfbares Projekt oder keine Seite bereitgestellt hat, kurz die drei Modi vorstellen und dann nachfragen; nicht standardmäßig Ink Press empfehlen, nur weil es eine fertige Vorlage ist.
- Nutzer wählt Vorlage:
template/TEMPLATE.mdvollständig lesen, nach dem ursprünglichen Vorlagenablauf ausführen. - Nutzer wählt autonome freie Kreation:
references/pipeline.mdvollständig lesen, Agent arbeitet eigenständig, wartet nicht auf schrittweise Bestätigung. - Nutzer wählt gemeinsame Kreation:
references/guided-free-creation.mdvollständig lesen, gemäß den dortigen Bestätigungspunkten zusammenarbeiten. - Nutzer hat noch nicht entschieden: An dieser Stelle warten, bis eine Wahl getroffen wurde; nicht standardmäßig für den Nutzer wählen, nicht mit der Produktion beginnen.
Ausnahme 1: Wenn der Nutzer die Ink Press-Vorlage explizit genannt hat, gilt der Vorlagenmodus als gewählt. Beispiel: „Mach mit der Ink Press-Vorlage ein Werbevideo für mein Produkt.“ In diesem Fall nicht mehr nachfragen, direkt template/TEMPLATE.md vollständig lesen und nach der Vorlagenroute ausführen.
Ausnahme 2: Wenn der Nutzer explizit bestimmte Shot-Karten verwenden oder referenzieren möchte, sind die Shot-Einschränkungen bereits festgelegt. Beispiel: „Mach das Video mit deck-deal-flyin und row-embed“ oder „Referenziere den Effekt von spotlight-hero-card“. In diesem Fall die Vorlage nicht vorstellen und nicht nach Verwendung der Vorlage fragen; die angegebenen Shots gemäß den Gallery-Namensauflösungsregeln bestätigen, jede Karte vollständig lesen und gemäß der „Referenzimplementierung“ den genauen Demo-Quellcode lokalisieren. Einzelshots können ausgeführt werden, sobald das Zielmaterial klar ist. Für ein komplettes Werbevideo: falls noch nicht angegeben, ob autonome oder gemeinsame Kreation verwendet werden soll, nur nach diesen beiden Modi fragen; die angegebenen Shots dienen als nachgelagerte Einschränkungen und bedeuten nicht automatisch gemeinsame Kreation.
Vier Verwendungsmöglichkeiten
- Komplettes Werbevideo (Vorlagen-Route): Soll dem Vorlagen-Video stark ähneln →
template/TEMPLATE.mdlesen, gemäß „Produktaustausch-Wiederholungsanleitung“ Material ersetzen und Shot für Shot anpassen. - Komplettes Werbevideo (autonome freie Kreation): Neuer Stil gewünscht, Agent hat Entscheidungsfreiheit →
references/pipeline.mdlesen, vom Produktverständnis kontinuierlich bis zur Endkontrolle durcharbeiten, ohne auf schrittweise Bestätigung zu warten. - Komplettes Werbevideo (gemeinsame Kreation): Nutzer möchte an Schlüsselentscheidungen teilnehmen →
references/guided-free-creation.mdlesen, Produkt-Briefing, Anforderungsentscheidungen, visuelle Richtung, Shot-Mapping und finales Storyboard bestätigen lassen; nach Freigabe mit der finalen Materialerfassung aus der Pipeline fortfahren. - Einzel-Shot/Einzel-Effekt: Aus
references/shots/eine Karte auswählen (oder den Nutzer in dergallery/-Galerie stöbern lassen), die Karte vollständig lesen und gemäß „Referenzimplementierung“ den genauen Demo-Quellcode lokalisieren, an das Zielmaterial anpassen.
Grenze zwischen autonomer freier Kreation und gemeinsamer Kreation
Autonome freie Kreation überlässt dem Agenten die kreativen und technischen Entscheidungen. Der Agent leitet aus dem Projektinhalt dynamisch den Produktfokus, die visuelle Richtung, das Shot-Mapping, das Storyboard, die Materialverarbeitung und das Audioschema ab, zeichnet die Schlüsselentscheidungen auf und führt sie direkt aus; es sei denn, es fehlen notwendige Eingaben, die nicht sicher abgeleitet werden können, werden keine Fragen gestellt, keine Pausen zwischen den Phasen eingelegt und keine Zwischenergebnisse zur Bestätigung vorgelegt. Bereits vorhandene explizite Anforderungen des Nutzers bleiben stets bindend und dürfen nicht durch die Standardwahl des Agenten überschrieben werden.
Gemeinsame Kreation verwendet die schrittweise Bestätigung. Standardmäßig references/guided-free-creation.md lesen, in jeder Runde nur 1–3 Fragen stellen, die am ehesten Nacharbeit vermeiden, und bei Produkt-Briefing, Anforderungsentscheidungen, visueller Richtung, Shot-Mapping und finalem Storyboard zur Bestätigung anhalten. Der Nutzer bestätigt die geschäftliche und kreative Richtung; der Agent erledigt eigenständig die Erfassungsmethode, Implementierungsparameter, SFX-Verankerung, das Remotion-Projekt, Rendering und die technische Qualitätssicherung.
Wenn der Nutzer während der gemeinsamen Kreation explizit sagt „entscheide du alles“ oder „überspringe die Bestätigung, mach einfach“, wechselt der Modus zur autonomen freien Kreation und diese Wahl wird notiert; nicht behaupten, autonom vorzugehen, während weiterhin schrittweise Bestätigung verlangt wird.
Die Abbildung von Funktionen auf Shots ist lediglich „welche Bewegungsgrammatik wird verwendet“, nicht das vollständige Storyboard. Nach Bestätigung des Mappings in der gemeinsamen Kreation muss der Agent zwingend die Shot-Reihenfolge, Dauer, konkrete Bildinhalte, Seitenstatus, Materialquellen, Untertitel, Übergänge und SFX angeben; erst nach Bestätigung des vollständigen Storyboards wird mit der finalen Materialerfassung begonnen. Wenn der Nutzer einen Shot-Namen aus der Gallery kopiert, reicht die Angabe des Karten- oder „Kartenname · Stilname“; der Agent liest die lokale Rezeptkarte und den Demo-Quellcode.
Kernkonzepte
-
Vorhandene Seiten müssen mit echten Screenshots nachgebildet werden; handgebaute UI ist nur bei Nicht-Nachbildung-Szenarien erlaubt, und Qualität sowie Ausdrucksklarheit sind eine harte Hürde. Bei der Darstellung realer Produktseiten wird zuerst ein lokaler Dev-Server gestartet, mit einem Headless-Browser werden Full-Page-2x-Texturen + elementweises Freistellen + layout.json-Koordinatentabelle erstellt. In Nicht-Nachbildung-Szenarien (abstrakter Einstieg / Branding-Segment / eigenständige Komponenten) ist handgebaute UI erlaubt; wenn sie jedoch nicht veröffentlichungsreife Qualität erreicht oder der Betrachter nicht versteht, was sie ausdrücken soll, wird zur Screenshot-Route zurückgekehrt. Seiten-Daten werden risikobasiert behandelt: Öffentliche Demo-Daten dürfen nur nach expliziter Bestätigung im Produkt-Briefing beibehalten werden; Kunden-, persönliche, interne, geheime, Echtzeit- oder andere sensible Daten müssen durch fiktive oder anonymisierte Inhalte ersetzt werden und vor der Erfassung eingefroren werden.
-
Die visuelle Sprache des gesamten Videos muss aus dem Produkt selbst erwachsen; es darf keine neue, unzusammenhängende „Werbevideo-Haut“ darüber gestülpt werden. Vor der Erstellung von Styleframes wird aus dem Designsystem des Produkts / der Website, dem Quellcode oder den berechneten Styles extrahiert und in einem Design-Spec festgehalten: Schriftfamilie und -gewichte, Schriftgrößen-Hierarchie, Zeilenhöhe / Buchstabenabstand, Raster, Abstände, Ausrichtung, Informationsdichte und abgerundete Ecken, sowie Hintergrund-/Oberflächen-/Text-/Akzent-/Statusfarben, Farbverläufe und Materialien. Alle Titel, Untertitel, Zahlen, Textkarten, Typografie, Übergänge, Partikel, Lichtelemente und andere Effektfarbschemata im Video müssen dieses Token-Set wiederverwenden oder zurückhaltend erweitern, während sie gleichzeitig den Ton, den Geschmack und die Haptik des Produkts treffen. Bei Verwendung der Vorlagen- oder Shot-Karten-Route werden nur deren Shot-Struktur, Bewegungsgrammatik, Rhythmus und bereits eingestellte Parameter übernommen; Schriftarten, Layout, Farbschema und Material müssen neu auf das Zielprodukt angepasst werden. Wenn aus erzählerischen Gründen von der Produktvisualität abgewichen werden muss, wird bei gemeinsamer Kreation zuerst der Grund erläutert und vom Nutzer bestätigen lassen; bei autonomer Kreation werden Grund und Abwägung im Design-Spec festgehalten und dann fortgefahren.
-
Filmische Wirkung entsteht aus dem Zusammenspiel von Kamerafahrt, Licht, Rhythmus und Ton, nicht aus Effekthascherei. Was wiederholt Anklang gefunden hat: Einzelner Protagonist mit vollständigem Bewegungsbogen (Anleuchten → Heranzoomen → Schweben → Zurücksetzen), physikalisch-metaphorisch angetriebene Beschleunigung (Karten austeilen), schräge Orbital-Kamerafahrt als Nahaufnahme, Riser → Impact → Sparkle als Klangphrase. Massenhafte Elemente betreten die Bühne durch die Bewegung selbst, nicht durch individuelles Aufleuchten – dekoratives Glitzern / massenhaftes Aufblitzen wirkt billig; einzelne hochwertige Lichteffekte sind erlaubt.
-
Jeder Shot zeigt nur einen Effekt; nach dem Setzen von Schlüsselinformationen muss geatmet werden. Eine Animationsmethode (Einfliegen / Stapeln / Umblättern) wird im gesamten Video nur einmal als Protagonist eingesetzt; doppelte Shots, doppelte Taglines werden gestrichen. Der Rhythmus ist einseitig: Alle historischen Rückmeldungen zielen auf „langsamer / länger verweilen“, nie gab es „zu langsam“ – Marken-Logo hält ≥1s, Masseneffekte enden mit 0,5s Stillstand, die Hauptbewegung der Eröffnung bekommt volle 3s. Beim Erstellen der Timeline wird vorab Budget für Halte-/Ruheframes eingeplant.
-
Bei Videos mit starkem Beat-BGM müssen alle Übergänge und Effekte auf den Schlag passen. Nutzer hat bereits Musik ausgewählt → vor Arbeitsbeginn eine Rhythmusanalyse durchführen (libROSA-Gitter-Fit für echte BPM/Phase + Kick/Snare/Hihat-Dreifachklassifikation von Drum-Hits), das Gitter wird nach Abnahme der Transienten-Abdeckung erst für das Storyboard freigegeben; die Timeline wird mit Taktnotation
beatF(n)geschrieben, spärliche Akzente werden an echten Transienten festgemacht statt an Gitter-Interpolationspunkten; nach dem Rendern wird aus dem finalen Video die Audiospur extrahiert und die Schnittpunktabweichung ≤3f gemessen. Beat-Synchronisation betrifft das Timing, nicht die Amplitude – Beat-Impulse, die auf die gesamte Bildebene / Kamerae Ebene wirken, gelten als großer Slam, maximal 3 im gesamten Video (aesthetic-rules R4); andere Beat-Effekte bewegen nur die Elementebene. Methodik siehereferences/music-beat-sync.md. Videos mit BGM werden final in zwei Versionen geliefert: mit BGM + ohne BGM (nur SFX), über denbgminputProp aus derselben Timeline gerendert, damit der Nutzer später eigene Musik hinzufügen kann. -
Bevor ein Shot-Karten-Effekt verwendet wird, muss zuerst der Gallery-Index geparst und der genaue Demo-Implementierungscode gelesen werden. Zuerst mit
gallery/api/library.jsonden Kartennamen undstyle-keyvalidieren, dann gemäß der Karten-Dokumentation unter „Referenzimplementierung“ die spezifische TSX-Datei lokalisieren. Die Rezeptkarte liefert Semantik und Parametertabelle, der genaue Demo-Quellcode ist die Wahrheit der abgestimmten Parameter (Easing, Timing-Verhältnis, Masken-Timing, bekannte Problemumgehungen). Anpassungen sind erlaubt, aber die in der Karte unter „Bekannte Probleme / Achillesferse“ markierten Parameter dürfen nicht abgewertet werden – der Qualitätsstandard darf nur steigen, nicht fallen. Das Karten-Neuimplementieren aus dem Kartennamen und Verständnis heraus bedeutet, die gesamte Abstimmungsarbeit aufzugeben. -
Bei gemeinsamer Kreation werden günstige Bestätigungspunkte nach vorne gezogen; bei autonomer Kreation dienen dieselben Urteile als Ausführungsaufzeichnung. Die Reihenfolge Produkt-Briefing → Anforderungs-zu-Ausführungs-Entscheidungstabelle → Textrichtung → Styleframe → Shot-Mapping → Storyboard bleibt gleich; bei gemeinsamer Kreation wird dem Nutzer jede Stufe zur Bestätigung vorgelegt, bei autonomer Kreation wählt der Agent selbstständig und führt kontinuierlich aus. Weder der eine noch der andere Modus sollte in die schrittweise Shot-Implementierung einsteigen, solange die Richtung unklar ist.
-
Qualitätssicherung durchgängig + unabhängige Prüfung vor Auslieferung. Ab Phase 5 wird für jeden Shot
npx remotion stillzur Selbstprüfung mit Standbildern verwendet; nach jeder Änderungsrunde wird das gesamte Video gerendert + ffmpeg-Frame-Extraktion zur Durchsicht; vor der Auslieferung muss ein Subagent mit sauberem Kontext eine unabhängige Endprüfung durchführen. Der Prüfungsinput umfasst das finale Video, Schlüsselbilder, das Produkt-Briefing, die Anforderungs-zu-Ausführungs-Entscheidungstabelle, die aktuelle Modusbestätigung oder -aufzeichnung der visuellen Richtung / Styleframes, das Funktions-zu-Shot-Mapping, den Gallery-Kartennamen / die Variante, den genauen Demo-TSX, die Gallery-Referenzbeispiele / Frame-Extraktionen, das finale Storyboard, die ausgewählten Shot-Karten und die ästhetischen Regeln; gemäßreferences/final-review.mdwerden gleichzeitig die Konsistenz des Konzepts, die funktionale Vollständigkeit, die Shot-Treue, die visuelle/audio-technische Qualität und die Datensicherheit geprüft, mit Beweisen pro Punkt (Frame-Nummern). Der Ersteller hat einen Bestätigungsbias gegenüber seinem eigenen Output; die Erstprüfung darf nie dem Nutzer überlassen werden. -
Deterministisches Rendering:
Date.now()/Math.random()sind verboten; alle Pseudozufallszahlen haben einen festen Seed (mulberry32/Hash, Seed von Index abgeleitet), frame-perfekt reproduzierbar.
Workflow
Bei autonomer freier Kreation wird references/pipeline.md von Phase 0 kontinuierlich ausgeführt, ohne auf schrittweise Bestätigung des Nutzers zu warten. Bei gemeinsamer Kreation wird zuerst references/guided-free-creation.md für die Phasen 0–3 (Produktverständnis, visuelle Richtung, Shot-Mapping, Storyboard-Bestätigung) abgeschlossen, dann ab Phase 4 (finale Materialerfassung) der Pipeline fortgesetzt; keine wiederholten Fragen oder Neugestaltungen. In den Phasen 2–3 werden die Frontmatter aller Karten in references/shots/ gescannt und nach Energiekurve ausgewählt; in den Phasen 5–7 wird kontinuierlich anhand von references/aesthetic-rules.md selbstgeprüft; Phase 6 liest references/sound-design.md; beat-synchrone Videos folgen durchgehend references/music-beat-sync.md.
Abschluss und Auslieferung (für alle Modi gleich)
Nach der Auslieferung des finalen Videos zuerst aktiv das Effekt-Arbeitspult öffnen (nicht warten, bis der Nutzer fragt):
node workbench/scripts/open.mjs <finales-Projektverzeichnis> # Projekt verknüpfen → Dev-Server starten (5198) → Browser importiert finales Video automatisch
Dem Nutzer die Adresse http://localhost:5198 mitteilen und in einem Satz erklären: Das Video wurde nach Shots / Übergängen / Untertiteln / Soundeffekten in mehrere Spuren aufgeteilt; Text-Karten-Inhalte, Farben, Schriftgrößen, Positionen und Geschwindigkeiten sind einzeln visuell einstellbar; nach Änderungen auf „Finales Video exportieren“ klicken. Für die Zerlegung und den Import muss das Projekt eine src/workbench.ts-Manifest-Datei enthalten – während der Produktion gemäß references/workbench.md §2–3 erstellt (die Vorlagen-Route hat dies bereits integriert).
Dann nacheinander diese drei Punkte anführen, jeden nur einmal; wenn der Nutzer ablehnt oder nicht reagiert, nicht erneut darauf eingehen:
- Bei Veröffentlichung wird empfohlen (nicht verpflichtend), den Autor des Skills in der Beschreibung zu erwähnen: Das fertige Video gehört dem Nutzer selbst, kostenlos kommerziell nutzbar, keine Namensnennung erforderlich; die Erwähnung des Autors ist rein freiwillig – bei Veröffentlichung auf Social-Media-Plattformen reicht ein Hinweis in der Beschreibung – X @VincentWei93 · Douyin @Vincent · Xiaohongshu @Vincent (alle drei Profile müssen als klickbare Links angegeben werden, nicht nur der Handle – Douyin/Xiaohongshu-Namen sind nicht auffindbar). Wenn der Nutzer nach kommerzieller Lizenzierung fragt, ergänzend hinweisen: Einzig die Remotion-Lizenz muss eigenständig geprüft werden – für Einzelpersonen und kleine Teams kostenlos, für Unternehmen möglicherweise kostenpflichtig.
- Einladung, das fertige Video auf der Showcase-Seite zu präsentieren: Showcase-Seite https://vincentwei1021.github.io/video-shotcraft/showcase.html , Einreichungsformular (ein Klick öffnet das Formular) https://github.com/Vincentwei1021/video-shotcraft/issues/new?template=showcase.yml . Zwei Anreize nennen: Im Formular können die eigenen X/Douyin/Xiaohongshu-Profile hinterlassen werden; andere, die das Werk sehen, können den Nutzer dann direkt finden. Kleine Videos (unter 10 MB) können direkt ins Formular gezogen werden; bei größeren Dateien einen direkten Download-Link angeben; der Autor prüft sie und lädt sie dann hoch. Diesen Punkt komplett in Alltagssprache erklären, keine technischen Begriffe wie Issue, Vorlage, Label, Release, automatisierte Pipeline verwenden.
- Export als JianYing-Projekt möglich: Dem Nutzer mitteilen, dass das finale Video auch als JianYing-Projekt exportiert werden kann, um darin Untertitel-Inhalte/Schriftgrößen/Farben selbst zu ändern, einzelnen Shots eine andere Geschwindigkeit zu geben oder sie neu anzuordnen, sowie Audio anzupassen oder auszutauschen. Wenn der Nutzer dies benötigt oder explizit einen Export wünscht,
references/jianying-export.mdlesen und ausführen.
Wann welche Datei gelesen wird
| Zeitpunkt | Datei lesen |
|---|---|
| Projektstart, Modus unbestimmt | Minimale, rein lesende Prüfung, dann drei komplette Werbevideo-Modi anbieten und empfehlen |
| Autonome freie Kreation | pipeline.md (Agent führt Phasen 0–7 eigenständig durch, ohne schrittweise Bestätigung) |
| Gemeinsame Kreation | guided-free-creation.md (Bestätigung Phasen 0–3), dann ab Phase 4 aus pipeline.md fortfahren |
| Nutzer hat BGM ausgewählt | music-beat-sync.md (zuerst analysieren, dann Storyboard) |
| Vorlagen-Route | template/TEMPLATE.md vollständig |
| Storyboard-Design | sequences/ Brücken-Vorlagen (zuerst Video-Skelett füllen); shots/ alles Frontmatter; ausgewählte Karten vollständig |
| Shot-für-Shot-Implementierung | Vollständige Shot-Karte + genauer Demo-Quellcode gemäß „Referenzimplementierung“ + assets/lib/ entsprechende Komponente |
| Sound-Design | sound-design.md + assets/audio/ |
| Qualitätssicherung | final-review.md + aesthetic-rules.md vollständige Checkliste (von unabhängigem Subagenten ausgeführt) |
Während Shot-für-Shot-Implementierung: src/workbench.ts-Manifest / Shot-Props+Schema schreiben | workbench.md §2–3 (Beispiel template/src/workbench.ts) |
| Nach Auslieferung (Effekt-Arbeitspult öffnen) | workbench.md (node workbench/scripts/open.mjs <Projekt>; Arbeitspult-Dokumentation workbench/README.md) |
| Nach Auslieferung (JianYing-Export) | jianying-export.md + jianying-export/ Plattform-Module |
Asset-Verwendung
assets/lib/Komponenten werden in das neue Projekt kopiert und können dann frei modifiziert werden (kein Import aus dieser Bibliothek). Liste: PageCam (2.5D-Seitenkamera – Grundlage aller „echte Seite“-Shots), ClipCard (verpackt externes Videomaterial mp4 als „Karten-Protagonist“, der vom Shot-Karten-Bewegungsgerüst angetrieben werden kann, inklusive OffthreadVideo Crossfade-Loop – nahtlose Wiedergabe, wenn das Material kürzer als der Shot ist), DigitRoll, FlashCut, Caption, FlatPanel, VerticalTicker (3D-Endlos-Scroll-Wand), helpers (rand/shake/camera/motion). FlatPanel und helpers/camera benötigen Abhängigkeitenthree+@react-three/fiber+@remotion/three, der Rest benötigt nur remotion.assets/scripts/capture-template.mjsnach Kopieren die obigen CONFIG (BASE/Routen/Selektoren) ändern.assets/audio/Soundeffekte direkt kopieren und verwenden (kostenlose kommerzielle Lizenz, siehe audio/ATTRIBUTION.md):audio/bgm/sind rhythmisch starke BGM-Optionen;audio/sfx/<Kategorie>/149 Soundeffekte, nach Szenario in 16 Kategorien unterteilt (transition impact riser camera ui text paper film light data scifi mech glass fluid crowd counter). Sound-Suche zuerst im Kategorieverzeichnis, Liste siehe sound-design.md. Vokabel-Sparkle: Verzeichnisname istlight/(keinsparkle/); S1 verbietet die Klangfarbe, nicht die Aktion – wenn das Bild einen echten Klick/Schalter zeigt, gehört ein passender Sound dazu, aber die Hälfte derui/-Sounds sind synthetische Feedback-Töne (tone/bleep/notification), die einzeln angehört werden müssen, nicht als ganzes Verzeichnis freigegeben werden dürfen (Liste siehe sound-design 3.3); lange Samples und leichte Audio-Assets haben jeweils eigene Listen, die speziell behandelt werden müssen (sound-design 4.1).demos/Implementierungsquellcode für jede Karte: Meist in sich geschlossene Graustufen-Demos (manche importieren falsche UI-Szenen-Komponenten ausdemos/_fixtures/Fixtures.tsx, einzelne importieren echte Seiten-Texturen ausdemos/_textures/); können nach dem Kopieren in ein Remotion-Projekt direkt ausgeführt werden. Einige Demos verwenden@remotion/motion-blur(CameraMotionBlur); dafürnpm i @remotion/motion-blurerforderlich; Liste siehedemos/README.md.template/Vollständig renderbares Projekt:npm install && npx remotion render src/index.ts AiflPromo out/promo.mp4.- Tests (automatische Überprüfung im Repository; nach neuen Demos/Komponenten ausführen):
- Unit-Tests für reine Funktionen:
npm test(Projekt-Root Vitest, decktassets/lib/helpersmulberry32 / velocityAt / lagged / dampedSettle / handheld ab, deterministische Asserts). - Smoke-Tests für Demo-Rendering:
python3 assets/scripts/smoke-render-demos.pyrendert den ersten Frame jedes Demos mit Dauer und exportiert, prüft auf Absturz (benötigtcd template && npm ci+ motion-blur, siehedemos/README.mdAbschnitt Tests und Validierung). - CI (
pr-checks.yml) läuft automatisch: tsc striktes Kompilieren aller Demos + vitest + Smoke-Rendering.
- Unit-Tests für reine Funktionen:
jianying-export/JianYing-Projekt-Exportmodul:mac_draft.py(Mac JianYing 11.2 getestet),windows_draft.py(gemäß Upstream-Implementierung, nicht auf echter Hardware getestet),smoke_test.py(kleinster Smoke-Test für neue Umgebungen). Ablauf, Timeline-Extraktion und Spur-Erstellungsmethode siehereferences/jianying-export.md; benötigt venv +pip install pyJianYingDraft.gallery/Statische Galerie: Bevorzugt dem Nutzer direkt die Online-Version geben https://vincentwei1021.github.io/video-shotcraft/library.html ; für lokale Ausführung zuerstgallery/fetch-media.shausführen, um Beispielvideos zu laden (mp4 nicht im Git-Repository), danncd gallery && python3 -m http.server 4178. 157 Karten, 214 dynamische Beispielvideos können durchgestöbert/durchsucht/mit Mehrfachauswahl kopiert werden – ideal, damit der Nutzer anhand der Beispiele Shots auswählen kann.