Communitygithub.com

0xsline/openchatcut

Wird verwendet, wenn ein OpenChatCut-Toolaufruf fehlschlägt oder eine unerwartete Form zurückgibt.

Was ist openchatcut?

Diese Fähigkeit dient als umfassende Fehlerbehebungsanleitung für die OpenChatCut-API, insbesondere für Toolaufrufe wie `edit_item`, `push_asset` und `import_media`. Sie beschreibt häufige Fehler und deren Lösungen, z. B. falsche JSON-Strukturen für Aktualisierungen (`updates`) oder Hinzufügungen (`adds`), Timeline-Überlappungen, Einschränkungen bei Arbeitsbereichspfaden (nur öffentliche HTTP(S)-URLs), Konvertierungsfehler bei Browser-Videos sowie spezifische Anforderungen für Bewegungsgrafiken (Motion Graphics). Die Anleitung ist für Entwickler und KI-Agenten konzipiert, die mit OpenChatCut in MCP-Umgebungen arbeiten, und bietet klare, schrittweise Anweisungen zur Fehlerbehebung, ohne den Benutzer zur erneuten Durchführung derselben Aktion aufzufordern. Sie unterstützt auch Hinweise zu lokalen Entwicklungsumgebungen und Timeline-Renderproblemen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0xsline/openchatcut/tree/HEAD/src/agent/skills/known-errors

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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 der json-Transaktion platziert: { "json": "{\"adds\":[{...}]}" }.
  • Verwenden Sie edit_item fü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ügbaren trackId, z. B. einem Update mit "trackId":"V2", oder fragen Sie den Benutzer, welche Ebene gewinnen soll.

Einschränkungen bei Arbeitsbereichspfaden:

  • push_asset am externen MCP akzeptiert nur öffentliche http(s)-URLs als filePath. 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_asset akzeptiert kein code-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-import und import_media.
  • Verwenden Sie import_media action=create_session und 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 tracks oder unknown_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 ffmpeg neu 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") erfordert width, height und duration oder durationInFrames.
  • MG-Code muss den OpenChatCut-Validator bestehen.
  • Ein root AbsoluteFill ist für generierten MG-Code nicht gültig; verwenden Sie ein skalierendes root div.
  • Vermeiden Sie die Deklaration einer lokalen Variable namens scale auf oberster Ebene im MG-Code. Der Validator/die Laufzeitumgebung kann diese Bezeichnung bereits reservieren; verwenden Sie einen spezifischen Namen wie uiScale.

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, Editor 5177 und View-Syncer 4850 absichtlich vom älteren 3000/5173/4848-Stack isoliert.

Hinweis zum Timeline-Frame-Renderer:

  • Wenn view_timeline_frames fü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 auf track_progress target=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.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

0xsline/openchatcut

Connect an MCP-capable coding agent to OpenChatCut and edit local video projects. Use when the user asks to install, connect, or set up OpenChatCut; inspect or edit an OpenChatCut project; work with its timeline, transcript, captions, media, generation, motion graphics, audio, color, or export tools; or recover from an OpenChatCut MCP error.

0xsline/openchatcut

Use when acquiring or importing media into a OpenChatCut project asset library for video editing or creation, including local/attached videos, user-provided paths, public media URLs, web video/audio/image assets, upload fallback decisions, and deciding between import_media, download_media, or manual user action.

0xsline/openchatcut

Use when a OpenChatCut video editing or creation workflow needs export, render, download, share, final delivery, subtitle-file export, render choice, local-only asset handling, or export fallback explanation.

0xsline/openchatcut

AI image generation via Fal.ai, gpt-image-2, nano-banana, MiniMax image-01, and xAI Grok Imagine. Use when the user wants to generate or create an image / picture / still.

0xsline/openchatcut

Music generation via Mureka, MiniMax, Atlas Cloud, and Sonilo. Use for instrumentals, songs, soundtracks, track/stem generation, covers, or video-conditioned scoring of the finished cut through `submit_music`.

0xsline/openchatcut

OpenChatCut product knowledge — UI layout, editor features, and how generation providers are configured. Use when the user asks about the product interface, how to use a feature, where to find something, or needs GUI guidance for something the agent cannot do directly. Also use as fallback when a task fails and the user needs to complete it manually in the UI. NOT for live project-state queries ("where are my folders?", "what's on my timeline?", "where is clip X?") — those are answered by `read_project`, not by this skill.

0xsline/openchatcut

AI shader generator for WebGL video effects, transitions, masks, and color grading (LUT / 调色 / 电影感 / film look). Use when the user wants a video effect (滤镜 / 特效), a transition (转场 / crossfade / wipe / cube / 3d), a mask (蒙版 / 遮罩 / reveal), a zoom / push-in (推近 / 推镜头), or a color grade — try the built-in effects (zoom, builtin LUTs) before generating a new shader.

0xsline/openchatcut

Use when checking whether agent edits are reflected in the OpenChatCut project and editor.

0xsline/openchatcut

AI video generation via Fal.ai, Seedance 2.0, Kling, MiniMax Hailuo, xAI Grok Imagine, and OFox. Use when the user wants to generate a video clip — text-to-video, image-to-video, first/last-frame transitions, reference-guided generation, multi-shot, or generatively editing / extending an existing clip.

0xsline/openchatcut

Text-to-Speech (TTS), voiceover, narration placement/sync, and custom sound effects (SFX) generator. Use when the user wants generated speech from text, wants to add/replace/align narration or voiceover for an existing video/timeline, wants to keep existing voiceover synced after visual retiming edits, needs voice audition/selection, or explicitly wants a newly generated/custom sound effect that is not available in the Sound Effects library.

0xsline/openchatcut

Use when the agent should ask the user for structured input with an in-chat form, including single-select, multi-select, text fields, style pickers, or voice audition choices.

Verwandte Skills