Bekannte Fehler
edit_item Aktualisierungs-Rohform:
- Falsch:
{ "id": "abc", "fromFrame": 30 } - Richtig:
{ "json": "{\"updates\":[{\"id\":\"abc\",\"fromFrame\":30}]}" } - Verwenden Sie dieselbe
updates-Form für gängige Verschiebungen, Trimmungen und Spuränderungen.
edit_item Hinzufügungs-Rohform:
- Das neue Element wird im
adds-Array derjson-Transaktion platziert:{ "json": "{\"adds\":[{...}]}" }. - Verwenden Sie
edit_itemfür einfache Videoplatzierung, z. B.{ "json": "{\"adds\":[{\"type\":\"video\",\"assetId\":\"...\",\"fromFrame\":0}]}" }.
Timeline-Überlappung:
- Fehlertext:
Overlap: updated item at ... would overlap existing item at ... on this track. - Erzwingen Sie nicht das Schreiben oder löschen Sie das störende Element stillschweigend.
- Wiederholen Sie die
edit_item-Transaktion mit einer expliziten verfügbarentrackId, z. B. einem Update mit"trackId":"V2", oder fragen Sie den Benutzer, welche Ebene gewinnen soll.
Einschränkungen bei Arbeitsbereichspfaden:
push_assetam externen MCP akzeptiert nur öffentliche http(s)-URLs alsfilePath. Es lehnt lokale Pfade, Arbeitsbereichspfade und Chat-Anhangspfade ab.- Übergeben Sie für Bewegungsgrafiken den JSX-Quellcode über
create_motion_graphic_from_code({ code:"...", name, width, height, durationInFrames }).push_assetakzeptiert keincode-Argument mehr inline. - Das Kopieren lokaler Medien in den Arbeitsbereich ist nicht die Lösung für Video-/Audio-/Bild-/GIF-Importe; verwenden Sie stattdessen
asset-importundimport_media. - Verwenden Sie
import_media action=create_sessionund führen Sie dann einmalig den OpenChatCut-Medienimport-Helfer mit dem zurückgegebenen Token für clientseitige Dateien aus.
Fehler bei der Browser-Videokonvertierung:
- Fehlertexte enthalten oft
Unable to convert video without dropping audio/video tracksoderunknown_source_codec. - Führen Sie den OpenChatCut-Medienimport-Helfer erneut aus; er übernimmt die frontendseitige Konvertierung und zeigt einen benutzeraktionierbaren Fehler an, falls die Konvertierung unmöglich ist.
- Bitten Sie den Benutzer nicht, dieselbe Datei über die Editor-Benutzeroberfläche erneut zu importieren – der Konvertierungspfad ist derselbe, der Fehler wird sich wiederholen. Beheben Sie die Quelle (lokal mit
ffmpegneu kodieren) oder wählen Sie eine andere Datei. - Löschen Sie nach dem Hochladen/Transkribieren des Ersatz-Assets das fehlgeschlagene Original-Asset, falls es ungenutzt ist. Der endgültige Medienpool sollte wie ein erfolgreicher Import aussehen, nicht wie ein fehlgeschlagener Import mit einem Ersatz.
Anforderungen für Bewegungsgrafiken (Motion Graphics):
push_asset(type:"motion-graphic")erfordertwidth,heightunddurationoderdurationInFrames.- MG-Code muss den OpenChatCut-Validator bestehen.
- Ein root
AbsoluteFillist für generierten MG-Code nicht gültig; verwenden Sie ein skalierendes rootdiv. - Vermeiden Sie die Deklaration einer lokalen Variable namens
scaleauf oberster Ebene im MG-Code. Der Validator/die Laufzeitumgebung kann diese Bezeichnung bereits reservieren; verwenden Sie einen spezifischen Namen wieuiScale.
Lokaler Dev-Zero-Hinweis:
- Wenn das Backend auf einem nicht standardmäßigen Port läuft, verwenden Sie eine passende Zero-View-Syncer-Konfiguration.
- In diesem POC sind Backend
3010, Editor5177und View-Syncer4850absichtlich vom älteren3000/5173/4848-Stack isoliert.
Hinweis zum Timeline-Frame-Renderer:
- Wenn
view_timeline_framesfür einen Frame fehlschlägt, kann der Projekt-Schreibpfad dennoch intakt sein – wiederholen Sie den Vorgang mit weniger Frames oder einer anderen Zeit, bevor Sie etwas schlussfolgern. - Assets, die noch auf
blob:-Platzhaltern sind (Upload läuft), werden als leer gerendert; warten Sie auftrack_progresstarget=upload, bevor Sie einen leeren Frame als Fehler behandeln. - Melden Sie keinen visuellen Erfolgsnachweis, es sei denn, das Tool gibt Bildinhalte zurück, die den Zielframe sichtbar bestätigen.