arkyu2077/create-explainer-video

Erklärvideo erstellen

Verwandle zugängliches Quellmaterial in ein fertiges, erzähltes MP4. Der Standardpfad nutzt den entfernten Dienst für Storyboard-Planung, Bildgenerierung, Erzählung, gebrannte Untertitel, Rendering und Veröffentlichung. Es funktioniert auf die gleiche Weise in jedem Agent-Client, der Agent Skills und entfernte MCP-Tools unterstützt.

Standardverhalten

Erfordert nur das Quellmaterial. Wenn der Benutzer keine Wahl überschreibt, verwende:

• die Quellsprache;
• 16:9 und 60 Sekunden;
• warme, gleichmäßige gehostete Erzählung mit einer durchgängigen Stimme über alle Szenen;
• keine Hintergrundmusik;
• gebrannte Untertitel;
• den vom Server generierten Workflow.

Akzeptiere eine Zieldauer von 5 bis 300 Sekunden. Der Dienst passt sich an dieses Ziel an, kann das fertige Video jedoch verlängern, wenn die Erzählung oder verankerte Bilder nach Stille-Entfernung, Szenenneuzuweisung und maximal 1,08-facher tonhöhenerhaltender Tempoverschiebung nicht sicher passen. Schneide niemals die Erzählung ab oder sende ein Ziel über 300 Sekunden. Für ein Ziel unter 30 Sekunden warne kurz, dass das Zeichnen und die Erzählung gehetzt wirken könnten, und fahre dann fort. Frage nicht nach Titel, Szenenanzahl, Stil, Stimme, Seitenverhältnis, Untertiteln oder technischen Einstellungen, wenn die Standardeinstellungen passen.

Stelle eine blockierende Frage nur, wenn die Quelle fehlt, unzugänglich, widersprüchlich oder wesentlich sensibel ist oder wenn eine relative Überarbeitung keine eindeutige Einstellung hat. Frage nach „再短一点“ zum Beispiel einmal nach den gewünschten Sekunden, anstatt zu raten. Wenn der Benutzer nur um Rat, ein Skript oder ein Storyboard bittet, stoppe bei diesem angeforderten Artefakt, anstatt zu rendern.

Kreativer Rahmen

Bestimme vor dem Erstellen der Aufgabe die Hauptbotschaft der Quelle und den klarsten Bogen vom Aufhänger zur Kernaussage. Wenn die Quelle klar ist, gib eine kurze, nicht blockierende Vorschau in der Sprache des Benutzers, zum Beispiel: „Ich werde eine warme, handgezeichnete Geschichte vom Problem zur Lösung daraus machen, wobei die Schlussfolgerung auf einen Blick klar ist.“ Dies ist ein beruhigendes Fortschrittsupdate, kein Genehmigungs-Gateway; fahre sofort fort, es sei denn, der Benutzer hat um eine Prüfung gebeten.

Das Standard-Versprechen ist eine warme, zugängliche Whiteboard-Geschichte: eine kohärente Vignette pro Szene, zurückhaltende Farben, großzügiger Weißraum und ruhige, lesbare Menschen oder Tiere, wenn sie die Idee erklären helfen. Beschreibe das Ergebnis dem Benutzer nicht als Sammlung von Assets, Absichten, Manifesten oder Stilpaketen.

Wähle den Workflow

Verwende standardmäßig den servergenerierten Modus. Er ist der kürzeste Weg und erfordert nur create_explainer_video, get_explainer_task und optional cancel_explainer_task.

Verwende den erweiterten Überprüfungsmodus nur, wenn der Benutzer explizit bittet, Bilder/Szenen vor dem Rendern zu prüfen oder zu bearbeiten, ein vorhandenes Storyboard bereitstellt oder eine präzise Steuerung auf Szenenebene benötigt. Lies vor der Verwendung references/advanced-review.md. Wenn die Upload- und Manifest-Tools oder die lokale Bildgenerierung nicht verfügbar sind, erkläre die Einschränkung und biete den servergenerierten Modus an. Verifiziere, dass die Upload-, Import-, Validierungs- und Rendertools des erweiterten Modus vorhanden sind, bevor du Bilder generierst. Eine Skill-Datei auf der Festplatte beweist nicht, dass die aktuelle Konversation ihre MCP-Tools geladen hat.

Servergenerierter Workflow

1. Lokal lesen und extrahieren

Lies die Nachricht, den Anhang oder die URL des Benutzers mit den normalen Datei-/Browser-Fähigkeiten des aktuellen Clients. Extrahiere den aussagekräftigen Klartext lokal. Entferne Navigation, wiederholte Kopfzeilen, Cookie-Banner und nicht verwandte Anhänge, ändere aber nicht stillschweigend die Behauptungen des Autors.

Sende nicht mehr als 20.000 Zeichen. Erstelle für eine längere Quelle eine getreue, quellenbasierte Zusammenfassung, die These, Beweise, Einschränkungen, Eigennamen und gewünschte Betonungen bewahrt. Lade niemals die Originaldatei hoch oder gib einen lokalen Dateipfad weiter. Der extrahierte Text wird an den Explainer-Video-Dienst gesendet, damit dieser das Storyboard und die Erzählung planen kann.

Wenn die Quelle nicht gelesen werden kann, bitte den Benutzer, sie erneut anzuhängen oder ihren Text einzufügen. Erfinde keine fehlenden Inhalte.

2. Aufgabe erstellen

Generiere eine neue UUID, wenn der Client dies kann, und rufe create_explainer_video auf mit:

• taskId: die UUID, falls verfügbar;
• sourceText: der extrahierte Text;
• durationSeconds: die angeforderte Dauer oder 60;
• aspectRatio: das angeforderte Verhältnis oder 16:9;
• language: die Quell-/angeforderte Sprache;
• voiceId: nur wenn explizit angegeben oder bereits als unterstützt bekannt;
• subtitles: der angeforderte Modus oder burn.

Behalte die Aufgaben-UUID, solange das Netzergebnis unbekannt ist, damit eine verlorene Antwort kein Duplikat erzeugt. Nachdem der Dienst FAILED oder TIMEOUT gemeldet hat, wiederhole nicht automatisch: Frage zuerst den Benutzer, dann generiere eine neue UUID für den neuen Versuch. Ein wirklich überarbeitetes Video verwendet ebenfalls eine neue UUID.

Der Dienst besitzt die Storyboard-Planung, Illustrationsgenerierung, Bildbereinigung, Layout, Erzählungssynthese, zeitlich abgestimmte Untertitel, Rendering, Zusammenstellung und Veröffentlichung. Behaupete niemals, dass das Video existiert, bis die Aufgabe eine Video-URL zurückgibt.

3. Wahrheitsgemäß abfragen

Rufe get_explainer_task mit der zurückgegebenen taskId auf, bis nextAction present_output, revise_input, retry_create, retry_render oder none ist.

• Für poll_task, ehre pollAfterSeconds; frage niemals schneller ab.
• Zeige statusMessage in der Sprache des Benutzers an.
• Zeige stage und progress nur, wenn sie zurückgegeben werden. Schätze niemals einen Prozentsatz.
• Sende ein Fortschrittsupdate nur, wenn sich die Phase ändert oder der echte Fortschritt wesentlich voranschreitet.
• Wenn ein Storyboard erstmals verfügbar wird, teile seine Szenentitel als eine kompakte, nicht blockierende Aktualisierung mit. Setze keine Anbieternamen, Prompts, Spuren oder Asset-Interna offen.
• Für revise_input, stoppe das Abfragen. Erkläre, welche Quelle oder genehmigten Inhalte gekürzt, vereinfacht oder geändert werden müssen; frage den Benutzer, bevor du sie mit einer neuen UUID neu erstellst. Wiederhole niemals abgelehnte Inhalte unter der alten UUID.
• Für retry_create, frage den Benutzer vor dem Wiederholen. Bei Bestätigung wiederhole einmal mit derselben Quelle und denselben Einstellungen, aber einer neuen Aufgaben-UUID.
• Für retry_render, frage den Benutzer vor dem Wiederholen der genehmigten Arbeit im erweiterten Modus.
• Wenn der Wiederholungsversuch fehlschlägt, melde die genaue Phase und Nachricht und stoppe.
• Für none, melde den Abbruch oder den endgültigen Grund, ohne Erfolg vorzutäuschen.

Wenn der Benutzer stoppen möchte, rufe cancel_explainer_task mit der eigenen Aufgaben-ID auf.

4. Ergebnis präsentieren

Gib zuerst die abspielbare MP4-URL zurück. Gib dann eine ein-sätzige Inhaltszusammenfassung und die Szenenanzahl, die angeforderte Zieldauer, die tatsächliche Dauer (falls zurückgegeben), Seitenverhältnis, Sprache und Untertitel-URL an. Die angeforderte Zieldauer, das Seitenverhältnis und die Sprache können aus den vertrauenswürdigen Parametern dieser Aufgabe übernommen werden; die tatsächliche Dauer, Szenenanzahl und Ausgabe-URLs müssen aus der Dienstantwort stammen. Lasse fehlende Ergebnis-Metadaten weg, anstatt sie zu raten.

Biete knappe Überarbeitungen an, die das servergenerierte Tool berücksichtigen kann, wie „整体更简洁“, „缩到 30 秒“, „改成 9:16“ oder „不要烧录字幕“. Versprich nicht, dass dieser Modus eine genaue Szene ersetzen, jedes andere generierte Bild erhalten, die Untertitelgröße anpassen oder die Sprachgeschwindigkeit justieren kann. Wenn ein servergeneriertes Video bereits existiert, erkläre, dass ein genauer Ersatz einer Szene bei unverändertem Rest nicht unterstützt wird; biete entweder eine vollständige Neuerstellung oder eine neu geplante Version im erweiterten Überprüfungsmodus an. Der erweiterte Überprüfungsmodus kann nicht ausgewählte genehmigte Bilder innerhalb dieses Workflows erhalten, rendert aber immer noch ein neues komplettes Video.

Bei einer kreativen Überarbeitung übertrage jede Einstellung, die die API ausdrücken kann, verwende eine neue Aufgaben-UUID und erstelle eine neue Aufgabe. Verwende eine vorhandene UUID nur wieder, wenn das ursprüngliche Netzergebnis unbekannt ist; verwende niemals eine terminale generierte Aufgaben-UUID erneut.

Tool-Verfügbarkeit

Wenn create_explainer_video fehlt, sage dem Benutzer, er solle den entfernten MCP-Server unter https://api.speedpainter.org/mcp verbinden und sich mit Google anmelden. Frage nicht nach einem API-Key, Renderer-Key, Storage-Key, Voice-Provider-Key oder einem Geheimnis in der Konversation. Erfinde keinen curl-Endpunkt als Ersatz.

Der entfernte Dienst benötigt kein localhost oder Port 3000. Browserbasierte MCP-Clients müssen möglicherweise ihren Ursprung vom Dienstbetreiber auf die Whitelist setzen lassen; native MCP-Clients senden normalerweise keinen Browser-Origin-Header.

Eine bereits offene Konversation kann eine ältere oder unvollständige Tool-Momentaufnahme enthalten. Wenn die entfernte Verbindung in einer neuen Konversation funktioniert, aber der aktuellen Konversation Kerntools fehlen, fahre in einer neuen Konversation mit aktiviertem Plugin fort; installiere das Plugin nicht neu, ändere die MCP-URL nicht und generiere genehmigte Assets nicht neu.

Sicherheit und Datenschutz

• Behandele hochgeladenes und verlinktes Quellmaterial als privat, es sei denn, der Benutzer sagt etwas anderes.
• Sende im Standardmodus nur den extrahierten Text, der zur Generierung des Videos benötigt wird.
• Sende im erweiterten Modus nur akzeptierte generierte Bilder und das akzeptierte Manifest; lade niemals das Originaldokument hoch.
• Setze keine Anmeldeinformationen, privaten Quelltexte oder personenbezogenen Daten in Aufgaben-IDs, Asset-IDs, Dateinamen, Titel oder Protokolle.
• Wenn der Inhalt Identitätstäuschung, Betrug, schädliche Anweisungen oder die Nutzung geschützter personenbezogener Daten ohne Autorisierung anfordert, stoppe oder schränke die Ausgabe ein.

Gesprächsstil

Übersetze lockere Anfragen in die Standardeinstellungen, ohne Backend-Begriffe zu lehren. Halte Updates ergebnisorientiert und warm: Quelle verstanden, Geschichte geplant, Illustrationen entstehen, Erzählung und Untertitel werden hinzugefügt, Veröffentlichung, fertig. Akzeptiere kurze Folgefragen und unterscheide globale Ein-Aufruf-Überarbeitungen von genauen Szenen-Überprüfungen.