HyperFrames 分镜下游预演适配

HyperFrames Storyboard-Nachgelagerter Previs-Adapter

Adapter-Version 0.4.0. Eingabe STORYBOARD_PREVIS_ADAPTER_V1, JSON-Zustandsprüfung SCOPED_STATE_V2; Bildidentität PREVIS_RENDER_CONTENT_V2. Kompiliert das von script-to-storyboard-prompts gelieferte endgültige Drehbuch in ein editierbares, überprüfbares 3D-Previs. Die ursprüngliche Segmentnummer, das Drehbuch und die Budgetversion bleiben unverändert. Three.js verwaltet Szene und Aktionen, HyperFrames exportiert frame-basiert.

Erste Schritte

Lies zuerst references/upstream-adapter.md, um das vom Benutzer angegebene vorgelagerte Projekt, das formale Segment, die gültige Drehbuchversion und die Budgetversion zu identifizieren. Lies den tatsächlichen Text, die Szenenanalyse, die Personen-/Szenen-/ Requisiten-Assets sowie den Textanfangs- und -endzustand. Die Eingabe kann eine Projektdatei oder eine lokalisierbare Sitzungsausgabe sein; es darf nicht verlangt werden, dass der vorgelagerte Prozess eine separate Storyboard-Design-Tabelle erstellt.

Übernimm die bestätigte Bildgröße, den vollständigen Stil, die Segmentlängenobergrenze, die berechnete Laufzeit, die Shot-Reihenfolge, die Körpergröße in Zentimetern, die Modellversion, die räumliche Ausrichtung, den Originaldialog, die Tonverantwortlichkeiten und den Enthüllungszeitpunkt. Frage nicht erneut nach bestätigten Elementen und verwende nicht das alte Demo-Standardformat 16:9/12 Sekunden als Projektvorgabe. Wenn die Renderauflösung und fps nicht angegeben sind, wähle eine für das Seitenverhältnis geeignete gerade Größe und 24 fps aus und dokumentiere dies als Previs-Technikparameter; dies darf nicht das Budget ändern oder die Handlung erweitern. Frage nur nach den für diese Anpassung fehlenden Elementen.

Die vorgelagerten sieben Schritte und die formale Segmentabdeckung werden weiterhin vom vorgelagerten System verwaltet. Dieser Adapter liest den autoritativen Zustand, schreibt seine eigenen Dateien in <Projekt>/previs/<formal_id>/<prompt_version>/ und ändert nicht die vorgelagerten next_required, Cursor, Überschreibungen, das Drehbuch oder das Budget. Wenn der Benutzer nur "Weiter" sagt, wird das aktuelle vorgelagerte Ziel ausgeführt; nur wenn die aktuelle Anfrage Previs enthält oder explizit für die Previs-Auslieferung ausgewählt wurde, wird dieser Adapter aktiviert. Innerhalb einer autorisierten Previs-Anfrage können Lesen, Aufbauen, Prüfen und Exportieren nacheinander abgeschlossen werden.

Unterstützt die vorhandenen Textauslieferungen von Zustand 1.8/V3 und die JSON-Projekte von 1.9/V4. JSON verwendet scripts/intake_storyboard.py für den reinen Lese-Extrakt; Freitext/Sitzungen werden vom Agenten tatsächlich gelesen und organisiert, wobei scripts/finalize_manual_intake.py verwendet wird, um den echten Beleg zu versiegeln. Keine automatische Migration oder Erraten alter Zustände. Die normale Weiterentwicklung anderer Segmente führt nicht automatisch zur Ungültigkeit des Zielsegments; eine erneute Anpassung erfolgt, wenn sich die Version dieses Segments, die zugehörigen Assets, der Anfang/Ende oder der ausgewählte Originaltext ändern. Wenn der alten STATE_JSON-Intake die Bereichsprüfungsdaten fehlen, wird explizit neu extrahiert, kein stilles Upgrade.

Verwende die einfachste Geometrie, die ausreicht, um Komposition, Positionierung, Verdeckung und Timing zu überprüfen. Stabile Farbcodes entsprechen den vorgelagerten Personen. Die Umgebung behält nur die relevanten Räume und Orientierungspunkte bei; bei detaillierten Aktionen werden Modelle mit Nutzungsrechten verwendet. Bild-, Aktions- und Kamerapflichten sind getrennt; es wird nicht versprochen, dass ein vereinfachtes Previs die nachgelagerte Modellgenerierung zwingen kann, Pixel für Pixel zu folgen.

Erstellung und Änderung

1. Empfangen und Mappen. Übernimm die vorgelagerten formal_id, prompt_version, budget_version, Asset-IDs, Shot-IDs und Zeitintervalle. Setze "Einstellungsgröße, Kameraposition", "Kamerabewegung und Motiv", "Komposition", "Bildinhalt" in geometrische Maße, Kamera, Blickpunkt und absolute Zeitsamples um; nicht spezifizierte Koordinaten werden als auszuführende Ergänzung markiert, keine Neu-Regie. Alle Shot- und Aktionszeiten sind relativ zur Sekunde 0 des aktuellen formalen Segments; eine One-Shot-Phase wird nicht in Schnitte unterteilt.
2. Einheitlichen Raum aufbauen. Verwende metrische Einheiten, Y-up, gib die Ausrichtung an. Richte die Szene, stabile Charakter-IDs, Requisiten-Zuordnungen, dynamische Strukturen wie Türen/Fenster ein. Charakterformen werden durch eindeutige Farbcodes unterschieden; gib geometrische Maße an, vermeide reine Bildschätzung von Proportionen.
3. Deterministische Animationen erstellen. Die Pose, Position, Kamera und der Türzustand in jedem Frame müssen ausschließlich durch t bestimmt werden. Keine kumulative Verschiebung, nicht fixierte Zufallszahlen oder vom vorherigen Frame abhängige Zustände für den Export verwenden. Animationsmaterial verwendet AnimationMixer.setTime(t) oder gleichwertige absolute Abtastung. Der Browser-Wiedergabe-Timer darf nur dieselbe renderAt(t) aufrufen.
4. Prüfen und Anpassen. Überprüfe für jeden Shot das Drehbuch, die Schnittpunkte und den Anfangs-/Endzustand. Verwende Bildauswahl, Zeitleiste, freie Ansicht, Kameraposition/FOV und Pfad-Keypoint-Editierung. Die Vorlage zeigt nur die aktuelle Shot-Trajektorie an, ändert nicht die Shot-Anzahl oder das Budget. Bestätigte Shots/Blockings können explizit gesperrt werden; lokales Rückgängigmachen macht nur die zuletzt gespeicherte Änderung des entsprechenden Ziels rückgängig. Wenn Änderungen die formalen fotografischen Fakten, die Geschichte, die Dauer, den Dialog oder den Enthüllungszeitpunkt betreffen, wird zur Überarbeitung an das vorgelagerte System zurückgegeben; die Regieabsicht darf nicht durch eine Vorlage ersetzt werden. Siehe Edit- und Bild-Feedback.
5. Prüfen und Exportieren. Führe eine Daten- und Quellenprüfung, eine Agenten-Raumstichprobe, einen tatsächlichen Frame-für-Frame-Export durch und überprüfe die Videospezifikationen, den Anfang/Ende und die Schnittpunkte. Prüfe nur bei explizitem framing.requiredActors auf das Betreten des Bildes; Raumwarnungen müssen bildlich bestätigt werden, keine programmatische Warnungsfreiheit als Medienabnahmeersetzen. Anmerkungen enthalten tatsächliche PNGs, Intra-Segment-Zeitcodes, Objekt-IDs, Koordinaten und Quellen; bei Quellenänderung als veraltet markieren, Verarbeitet und Abgenommen trennen.
6. Adapter-Produkt zurückgeben. Liefere ein sauberes Video, das Quellprojekt, die Quellzuordnung, eine wörtliche Kopie des Originaldrehbuchs, eine Zusatzbeschreibung des Referenzmaterials und den tatsächlichen Prüfbeleg. Das vorgelagerte Drehbuch oder vorhandene Modell-Adapteranpassungen bleiben die Prompt-Quelle; sie werden nicht durch automatisch generierte Kurzprompts aus der Vorlage ersetzt. Der Beleg repräsentiert nur die lokale Previs-Prüfung; die endgültige Modelleinreichung und Generierungsfähigkeit wird weiterhin vom entsprechenden Modell-Adapter behandelt.

Wiederverwendbare Startpunkte

assets/starter/ enthält Laufzeitbeispiele, einschließlich einer Review-Seite, absoluter Zeitabtastung, Speichern und Exportieren. Der Korridor, die Personen, die Requisiten, die drei Shots und das Türereignis sind Demonstrationsinhalte; beim Empfang des vorgelagerten Inputs werden Geometrie und Aktionen durch die tatsächlichen Eingaben ersetzt, diese Handlungselemente dürfen nicht automatisch übernommen werden. Wenn keine Bilder vorhanden sind, können Farbcodes als Platzhalter basierend auf dem gültigen Textarchiv verwendet werden, wobei ausdrücklich nur die räumliche und zeitliche Logik verifiziert wird.

node <skill-dir>/scripts/create_project.mjs <project-dir>
python -X utf8 <skill-dir>/scripts/intake_storyboard.py --state <vorgelagerter Zustand JSON> --budget <vorgelagertes Budget JSON> --formal-id FORMAL_1 --out <project-dir>/upstream-intake.json
cd <project-dir>
npm install
npm run prepare-libs

Nachdem das vollständige Drehbuch gelesen wurde, setze die tatsächlichen Assets, Shots und Aktionen zuerst in scene.json und Szenencode um und schreibe assetBindings, sourceAssetIds und adaptationMap. Führe dann die folgenden Bindungs- und Prüfbefehle aus; das Binden darf nicht übersprungen werden, da das Projekt sonst auf den Demo-Branch zurückfällt:

npm run bind-upstream
npm run validate
npm run studio

sourceAssetIds.scenes/props listet explizit die in diesem Segment tatsächlich verwendeten Asset-IDs auf; nicht verwendete Einträge schreiben []. Charaktere spezifizieren über assetBindings die LOOK/STATE-Version und Körpergröße. Numerische, Versions- und Abhängigkeitsprüfungen ersetzen nicht die semantische Überprüfung von Handlung, Dialog und Kameraführung.

studio.html zur Review, index.html für den sauberen Export. Klicke auf eine Person, um das Objekt auszuwählen, klicke auf einen leeren Bereich, um den Bildpunkt auszuwählen. Das Speichern eines einzelnen Shots/Keypoints enthält keine anderen Entwürfe; Konflikte werden klar angezeigt. Sperren wird serverseitig erzwungen, lokales Rückgängigmachen behält 100 Historieneinträge, externe Änderungskonflikte verweigern das Überschreiben. Capture speichert oder macht Kameraskizzen rückgängig, wechselt zur offiziellen Kameraposition, blendet die Auswahlbox aus und richtet sie am Videoframe aus.

npm run lint
npm run spatial-check
npm run snapshot
npm run render
npm run handoff
npm run feedback
node scripts/bundle.mjs --project . --out <Neues Lieferpaketverzeichnis außerhalb des Projekts>

Die obigen Befehle sind in der Vorlage package.json definiert. Abhängigkeiten sind auf die verifizierten Versionen HyperFrames 0.9.10 und Three.js 0.187.0 festgelegt; in neuen Umgebungen können sie aktualisiert werden, aber zuerst die aktuelle offizielle API prüfen, dann den Export wiederholen und validieren, nicht nur die Versionsnummer ändern.

Siehe Szenenvertrag für Felder, Vorgelagerter Adapter für Quellen/Überarbeitungen, Edit- und Bild-Feedback für Sperren/Rückgängig/Anmerkungen/räumliche Prüfungen. Nach Bedarf lesen: Render-Laufzeit, Übergabepaket und Tragbares Bundle. Übernommene und zurückgestellte externe Designs siehe Designgrundlage; externe Repositorien müssen nicht als Produktionsvorläufer verwendet werden.

Lieferbeurteilung

• Narrative Aktionen müssen erkennbar sein, Personen/Kamerapositionen/Requisiten haben eine konsistente Grundlage über die Shots hinweg. Die Achse, Verdeckung und Durchdringung müssen tatsächlich überprüft werden; bei beabsichtigtem Achsensprung erklären, welcher Shot die Richtung etabliert.
• Derselbe Zeitpunkt muss bei sequentieller Wiedergabe, direktem Sprung und umgekehrtem Sprung zum gleichen Zustand führen; mindestens eine nicht-sequentielle Abtastung verifizieren, z.B. 8 → 2 → 8.
• Der Originaldialog und die Tonzeit werden vollständig in der Zuordnung und im Beleg erhalten; nicht synthetisierter Ton, nicht implementierte Lippenbewegungen oder komplexe Aktionen werden explizit als ungeprüft markiert. Asset-Prompt geliefert, Bild vorhanden, Bild gelesen, Modell gebunden werden separat dokumentiert.
• Dasselbe formale Segment wird standardmäßig unabhängig exportiert; Zusammenstellungen oder segmentübergreifende Verkettungen erfordern eine entsprechende Anfrage und speichern die Versatzzuordnung separat. Dateigrenzen werden nicht automatisch zu Shots; vorherige Segmentereignisse werden nicht wiederholt, das Budget wird nicht verlängert oder gerundet; nicht-ganze Frame-Reste müssen die Quelluhr- und Zieluhrmapping explizit dokumentieren.
• Der Export verwendet die gespeicherten Shot-Daten. Der erste Frame ist vollständig geladen, kein schwarzer Frame, fehlende Ressourcen, versehentlich im Bild befindliche Review-UI oder Schnittpunkt-Artefakte.
• Der Export wird zuerst zwischengespeichert und geprüft, dann veröffentlicht; bei Fehlschlag bleibt das alte erfolgreiche Video erhalten. Sperren, Historie schreiben und Anmerkungen ändern nicht die Bildidentität; erst wesentliche Änderungen an Kameraposition/Pfad/Modell/Code machen alte Bildbelege ungültig. Die Review benötigt weiterhin vier zusammenhängende Konsistenzen. VERIFIED in Anmerkungen bedeutet nur, dass der Benutzer einen separaten Beleg registriert hat, ersetzt nicht die endgültige Modell-Medienabnahme.
• Die Modellgenerierung interpretiert Materialien, Gliedmaßen und Details neu. "Kompositions- und Aktionsabsichten, die erhalten bleiben müssen" und "Naturalistische Performance und Textur, die erlaubt sind" klar formulieren; keine Pixel- oder Skelettebene-Kontrolle versprechen.
• Der Abschlussbericht dokumentiert den tatsächlich abgeschlossenen und tatsächlich verifizierten Umfang. Wenn keine Charakter-Referenzen bereitgestellt oder kein nachgelagertes Modell ausgeführt wurde, werden die Farbblock-Charaktere nicht als Charakterkonsistenzverifikation und die Previs-Ausgabe nicht als endgültig generiertes Endprodukt beschrieben.