Communitygithub.com

Chengfeng Export — Schnitte, Zooms, Untertitel in ein MP4

Rendert das fertige Talking-Head-Video: Schnittprotokoll, Punch-in-Zooms, Untertitel und HTML-Bildebenen werden in einem Durchgang in eine mp4 gebrannt. Erst Dry-Run zur Prüfung von Länge, Frames, Untertitel-Bildschirmen und Ebenen, dann Zusammensetzen → Überlagern → Komponieren → Verifizieren. Benötigt Google Chrome und ffmpeg 6+.

Was ist Chengfeng Export — Schnitte, Zooms, Untertitel in ein MP4?

Short-form Editing, Schritt 3 (Export): video-skill-ku-chengfeng-export. Der einzige Schritt, der wirklich Pixel zeichnet; alles davor ist live vorgeschaute Annotation. Meldet Warnungen wörtlich, wenn Untertitel oder Ebenen auf geschnittene Wörter zeigen, rendert standardmäßig in 2x bei Quell-Framerate und kann Zwischenframes zur Fehlersuche behalten.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/2789927464king-jpg/video-skill-ku/tree/HEAD/chengfeng-videocut-skills/plugins/chengfeng-videocut/skills/chengfeng-export

In Ihrer bevorzugten KI fragen

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

Dokumentation

Export (Finalprodukt)

Dies ist der letzte Abschnitt der Kette und die einzige Stelle im gesamten Produkt, an der tatsächlich Pixel gezeichnet werden.

Davor ist alles nur Annotation: Das Hauptbuch merkt sich, „welche Wörter abgespielt werden“, die Untertitel merken sich, „was auf dem Bildschirm steht“, die visuellen Ebenen merken sich, „welche Ebenen überlagert werden“, und die Vorschau setzt diese drei Dinge in Echtzeit für den Benutzer zusammen, ohne sie zu speichern. Der Export brennt sie in eine Datei.

Erforderlich:   edit-list.json (zwingend), subtitles.json, visuals.json + modules/
Ausgabe:       Finalvideo.mp4

Voraussetzung: Auf dem Rechner muss Google Chrome installiert sein (um Untertitel und Animationen als Bilder zu rendern). Die über eine Desktop-Installation bezogenen FFmpeg / FFprobe sind mit der App in das verwaltete Produktverzeichnis gelangt; eine reine CLI-Installation erfordert weiterhin ffmpeg ≥ 6 im System. Fehlt Chrome, wird ein klarer Fehler ausgegeben; versuchen Sie nicht, dies zu umgehen – ohne Chrome gibt es keine Untertitel- und Animationsebene.

Lesen und befolgen Sie zuerst den Abschnitt „Schlussfolgerungsstufen“ im Phasenvertrag der Business-Skill. Der Export tritt nicht in die Bearbeitungszustandsmaschine ein: Er ändert keine Projektdateien, führt keine CAS-Schreibvorgänge durch, ändert keine Stage. Die Ausgabe ist eine neue Datei; ein erneuter Durchlauf überschreibt sie. Daher ist keine Bestätigungskarte erforderlich.

0. Bereitschaft

Führen Sie zuerst die Bereitschaftsprüfung durch – ob die Skills auf dem neuesten Stand sind und die Runtime kompatibel ist; das Plugin-Root-Verzeichnis wird dort ebenfalls ermittelt (alle <PluginRoot> in diesem Dokument beziehen sich auf diesen Pfad). Nur wenn „Bereit“ gemeldet wird, fahren Sie fort; bei „Neue Sitzung erforderlich“ oder „Anhalten“ handeln Sie gemäß dessen Anweisungen (einschließlich des Verbots „keine selbstgebauten Ersatzoberflächen“). Die Business-Skill enthält keine eigene Umgebungslogik.

Wenn das Bereitschaftsergebnis runtime.kind=desktop-managed ist, verwenden Sie direkt die bereits installierten stabilen CLI-Tools, Medienwerkzeuge und denselben launchd/windows-task-Dienst der Desktop-App. Analysieren Sie keine Electron-Pfade, installieren Sie kein zusätzliches FFmpeg/Bun und starten Sie keine zweite Runtime.

Befehle

node "<PluginRoot>/scripts/ensure-running.cjs" --json
node "<PluginRoot>/scripts/videocut-cli.cjs" export <projekt> --dry-run --json          # Zuerst den Plan ansehen, keine Kodierung
node "<PluginRoot>/scripts/videocut-cli.cjs" export <projekt> --json                    # Finalvideo erstellen (Standard: 2x, Quell-Bildrate)
node "<PluginRoot>/scripts/videocut-cli.cjs" export <projekt> --out /pfad/Finalvideo.mp4 --json
node "<PluginRoot>/scripts/videocut-cli.cjs" export <projekt> --scale 1 --json          # Nur Quellgröße verwenden
node "<PluginRoot>/scripts/videocut-cli.cjs" export <projekt> --keep-work --json        # Zwischendateien und Einzelbild-PNGs für Fehlersuche behalten

Bei Nichtübereinstimmung der Identität, Portkonflikten oder fehlerhaftem Dienst von ensure-running sofort anhalten; es ist nicht erlaubt, temporär eine Vordergrundinstanz zu verwenden und dann mit dem Export fortzufahren.

Zwei Schritte, nicht nur den zweiten ausführen

① --dry-run zeigt zuerst den Plan an    Dauer, Frames, Anzahl der Untertitelbildschirme, Anzahl der Bildebenen, Anzahl der Zoom-Abschnitte, Ausgabegröße
                                        Dem Benutzer vorlesen. Wenn die Zahlen nicht stimmen, liegt der Fehler vorgelagert; zehn Minuten Kodierung werden ihn nicht beheben.
② Tatsächlicher Durchlauf                 assemble → overlay → compose → verify Vier-Schritt-Fortschritt

Die warnings im --dry-run müssen wörtlich wiedergegeben werden. Sie melden nur eine Sache: Einige Wörter in Untertitelbildschirmen oder Bildebenen wurden bereits abgeschnitten, daher erscheinen sie nicht im Finalvideo. Dies ist eine Entscheidung des vorgelagerten Prozesses, nicht etwas, das der Export verschweigen sollte.

Auflösung: Die Quelle ist die Obergrenze; zuerst die Quelle prüfen, dann über Vergrößerung nachdenken

Prüfen Sie vor dem Export die Quellauflösung (das source-Feld in --dry-run enthält sie bereits):

Quellbreite ≥2560 (Retina-natives Bildschirmvideo)  → --scale 1, Ausgabe entspricht den nativen Pixeln. Dies ist der beste Fall.
Quellbreite <1920 (z. B. 960×720)                   → Zuerst anhalten: Den Benutzer fragen, ob es einen HD-Export derselben Aufzeichnung gibt.
                                                    Bildschirmaufnahmewerkzeuge können oft denselben Durchlauf in 3-facher Auflösung neu exportieren.
                                                    Der Austausch der Quelle ist effektiver als jede Nachbearbeitung (siehe nächster Abschnitt). Wenn wirklich nicht vorhanden → --scale 2

--scale 2 ist bei niedrigauflösenden Quellen nützlich, weil: Die Vergrößerung des Rohmaterials macht es nicht schärfer, aber Untertitel und Animationen werden in der Ausgabegröße neu gezeichnet – das ist es, was der Betrachter tatsächlich liest. Wenn die Plattform erneut komprimiert, erhalten größere Bilder zudem eine höhere Bitrate.

Passen Sie --fps nicht an, um „schärfer“ zu machen. Die Bildrate folgt der Quelle; eine Änderung führt dazu, dass die Abtastung der Animationen und des Bildschirmvideos nicht mehr synchron sind.

Quellenaustausch: Wenn der Benutzer eine HD-Version derselben Aufnahme bereitstellt

Dies ist kein Teil des Exportprozesses – der Export selbst ist immer schreibgeschützt. Der Austausch ist ein separater Materialvorgang, der nach ausdrücklicher Zustimmung des Benutzers durchgeführt wird. Danach kehren Sie zum normalen Export zurück.

Zuerst prüfen, ob es dieselbe Aufnahme ist (die ersten beiden Kriterien reichen aus):

ffprobe -v error -show_entries format=duration -of csv=p=0 <datei1> <datei2>   # Dauer exakt in Millisekunden gleich
ffmpeg -v error -i <datei1> -map 0:a:0 -c copy -f md5 -                  # Audio-Stream bitweise identisch
# Dann 2–3 Frames zur visuellen Inhaltsvergleichung extrahieren, mit den Augen prüfen

Bitweise identischer Audio = identische Timeline: Das Wort-für-Wort-Transkript, Hauptbuch, Untertitel und Bildebenen sind alle an Wort-IDs gebunden – nichts muss geändert werden. Dies ist die Einlösung des Prinzips „Bindung an Wörter, nicht an Sekunden“ beim Quellenaustausch.

Vier Schritte zum Quellenaustausch (am 29. Juli 2026 tatsächlich einmal durchgeführt; Schritt ③ wurde damals vergessen, die Bearbeitungsvorschau meldete sofort „Generierung fehlgeschlagen“ – Fingerabdrücke sind nicht nur an einer Stelle gespeichert, mit grep alle alten Fingerabdrücke finden, bevor Sie handeln):

① Datei ersetzen      input/source.mp4 und uploads/source.mp4 sind Hardlinks –
                      beide löschen, neue Datei nach input/ kopieren, dann Hardlink zurück zu uploads/ erstellen
                      (macOS: ln; Windows: New-Item -ItemType HardLink)
② Fingerabdruck aktualisieren    source.sha256 in project.json auf den der neuen Datei setzen
③ Eine weitere Stelle prüfen     workbench.json enthält ebenfalls sourceSha256 als Fingerabdruck der Quelle,
                      und die Bearbeitungsvorschau-Pipeline prüft genau dieses Feld – wenn es fehlt, verweigert die Vorschau die Generierung.
                      (Dies ist das korrekte Verhalten des Produkts: Bei Nichtübereinstimmung des Fingerabdrucks lieber fehlschlagen, als alte Vorschau als neu auszugeben.)
④ Neu exportieren     --scale 1 – Der Austausch dient den nativen Pixeln, nicht der Vergrößerung.

Sicherheitsmaßnahme: Durchsuchen Sie mit Ihrem Suchwerkzeug alle *.json-Dateien im nach den ersten 8 Zeichen des alten Fingerabdrucks. Jede gefundene Stelle muss behandelt werden (Cache-Einträge wie preview-edited/current.json werden automatisch neu berechnet, manuelle Änderung nicht nötig).

Wenn der Audiostream unterschiedlich ist (neu aufgenommen, geschnitten, andere Dauer), handelt es sich nicht um einen Quellenaustausch, sondern um ein neues Projekt: Das Wort-für-Wort-Transkript muss neu transkribiert werden, alle Annotationen sind ungültig. Nicht erzwingen.

Abnahme: Drei Dinge, fehlt eines, gilt der Export nicht als abgeschlossen

① Befehl erfolgreich zurückgekehrt        Das Produkt zählt selbst Abmessungen, Frames und Audiospuren des Finalvideos und vergleicht sie Punkt für Punkt mit dem Plan.
                                          Bei Nichtübereinstimmung wird ein readback_mismatch-Fehler ausgegeben, die Datei bleibt als Beweis auf der Festplatte.
                                          Der Export gilt nicht als abgeschlossen.
② Frames extrahieren und Pixel prüfen     Aus dem Finalvideo Frames extrahieren und mit den Augen prüfen. Mindestens abdecken: einen Zoom-Abschnitt,
                                          einen Vollbild-Animation-Abschnitt, einen Abschnitt nur mit Untertiteln, einen Abschnitt an einer Ebenengrenze.
③ Menschliches Gehör prüfen              Niemand hat es jemals wirklich gehört; standardmäßig human listening UNVERIFIED notieren.

② Vorschaubilder nicht als Ersatz verwenden. Vorschau und Finalvideo sind zwei verschiedene Rendering-Pfade; die Abnahme soll prüfen, ob sie übereinstimmen – Vorschaubilder als Beweis für das Finalvideo zu verwenden, setzt das voraus, was überprüft werden soll.

Beurteilen Sie Zooms anhand von Unterscheidungsmerkmalen; der Gesamteindruck kann täuschen (am 29. Juli 2026 selbst erlebt): Nach einem 1,6-fachen Zoom sah der Bildschirm immer noch wie „eine ganze Seite“ aus, im Miniaturbild kaum vom Gesamtbild zu unterscheiden – ein korrekter Zoom-Frame wurde fälschlicherweise als „fehlender Zoom“ eingestuft, was zu 30 Minuten vergeblicher Nachverfolgung und zwei Neuexporten führte. Die richtige Methode ist, nach Beweisen zu suchen, die nur durch Beschneidung entstehen können: Halbe Elemente (eine Sprechblase, die in der Mitte abgeschnitten ist), verschwundene Randelemente (Seitenleiste, Titelzeile). Vergleichen Sie denselben Frame der Quelle – das klärt den Fall sofort.

Frames extrahieren mit ffmpeg:

ffmpeg -v error -ss 8.84 -i Finalvideo.mp4 -frames:v 1 -y frame.png

Wo nach Problemen suchen

--keep-work hinterlässt drei Dinge in .chengfeng-videocut/export/ des Projekts, die direkt anzeigen, „welche Hälfte falsch ist“:

assembled.mkv    Nur der Schnitt, ohne Überlagerungen. Fehler hier = Fehler im Hauptbuch oder im Schnitt.
overlay/*.png    Nur die Überlagerungen, transparenter Hintergrund. Fehler hier = Fehler im Untertitelstil oder Modul.
spans/*.mp4      Zusammengesetzte Segmente. Fehler hier = Fehler im Zoom oder in der Ausrichtung.

Referenztabelle:

Keine Untertitel/Animation im Finalvideo       Sind die overlay-PNGs vollständig transparent? Hat das Modul seek nicht akzeptiert?
Animation bleibt im ersten Frame stehen        Das Modul hat seek nicht implementiert, oder die GSAP-Timeline war nicht paused.
Ganze Bildfläche weiß                         Dem Modul fehlt `:root { color-scheme: dark }`
Zoom-Rahmen schief                             Die viewBox des Moduls und der zoom der Ebene sind nicht dasselbe Zahlenpaar.
Finalvideo kürzer als geplant                   Einem span fehlen Frames; Fehlermeldung in der compose-Phase prüfen.
Ebenengrenze flackert kurzes Originalvideo     overlay-Screenshots veraltet (Frame-Markierungsvalidierung fehlgeschlagen). Das Produkt belegt durch den Frame-Markierungsbalken am oberen Bildrand, zu welchem Frame jeder Screenshot gehört. Bei Wiederholung zuerst prüfen, ob die overlay-PNGs den Markierungsbalken oben haben und compose ihn durch crop entfernt hat.
Chrome nicht gefunden                          Google Chrome installieren, keinen anderen Rendering-Pfad verwenden.

Was nicht zu tun ist

  • „Export erfolgreich“ nicht als „Abnahme bestanden“ bezeichnen – Die erfolgreiche Rückkehr des Befehls bedeutet nur, dass das Produkt selbst konsistent ist, nicht dass das Bild korrekt ist.
  • Keine Vorschaubilder, DOM- oder Log-Auszüge als Ersatz für extrahierte Frames des Finalvideos verwenden.
  • Kein human listening PASS melden, wenn niemand zugehört hat.
  • Keine Projektdateien ändern, um den Export zum Laufen zu bringen (Untertitel bearbeiten, Ebenen löschen, Hauptbuch ändern). Der Export ist schreibgeschützt.
  • Keine Arbeit des vorgelagerten Prozesses im Export nachholen: Fehlen Untertitel, schreiben Sie sie; fehlen visuelle Ebenen, erstellen Sie sie. Flicken Sie hier nichts provisorisch zusammen.

Individual skills in this repo

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

2789927464king-jpg/video-skill-ku

剪辑环境的唯一管理者:就绪检查(skills 是否最新 → Runtime 是否配套)、Skills 更新激活、Runtime 安装与体检。用户说检查更新、安装剪辑环境、装播放器、检查剪辑环境、剪辑环境就绪了吗、配置转录凭证时使用;业务 Skill(剪口播/字幕/画面/导出)第 0 步也引用本 Skill 的就绪检查。不用于剪辑、字幕、画面、导出本身或项目数据迁移。

2789927464king-jpg/video-skill-ku

剪辑中文口播原素材:逐词转录、词典修字出修字表、五轮扫描找口误与重复、汇总表与重复句子表、打开 Studio 让用户复核、复盘沉淀用户偏好与词典。只产出一份已复核的删词账本,不切媒体、不做字幕、不做分镜动画。用户说剪口播、处理口误、生成口播基础素材、继续剪口播,或确认卡回传 action=return_cut_review 时使用。不要用于执行物理剪切、导出剪后视频、单独安装、单独打开工作台或口播分镜成片。

2789927464king-jpg/video-skill-ku

整理、脱敏并上报 chengfeng-videocut 的 GitHub Bug。用户说上报 Bug、反馈剪口播问题、提交 GitHub Issue、这个问题告诉开发者,或要求继续提交已预览的 Bug 草稿时使用。不要用于功能建议、普通排错、代码提交或未获用户确认的自动上报。

2789927464king-jpg/video-skill-ku

给剪好的口播做字幕:直接用已有的逐词稿加账本算出剪后时间(不必导出、不必重新转录)、用词典和作者文稿改写听错的专名、按句子分屏、在 Studio 里逐屏复核。用户说做字幕、加字幕、改字幕、重新分屏、字幕不对时使用。不要用于删词剪辑、物理剪切、分镜动画或成片渲染。

2789927464king-jpg/video-skill-ku

操作 chengfeng-videocut 剪辑工作台的已有工程,通过 Runtime CLI 查工程与词句位置、添加或替换画面覆盖层、移除画面、删除明确指定的词句或片段、拆分裁剪移动已有片段、调整画布比例并回读核验。用户说插入片段、删掉这句、移除动画、换个画面、调整顺序或管理时间线时使用;先区分画面覆盖与主轨顺延插入,不负责自动判断口误、创作动画、制作字幕、导出或排查安装故障。

2789927464king-jpg/video-skill-ku

Create Ian Xiaohei-style HTML/SVG motion illustrations for Chinese articles, scripts, storyboard scenes, workflow explanations, concept metaphors, and short video visual aids. Use when the user asks for 小黑 SVG、漫画感 HTML、分层 SVG 动效、把小黑生图做成 HTML/SVG、可编辑矢量动效、口播流程动画、手绘漫画动效、正文配图动画, or wants a Xiaohei illustration style adapted into controllable HTML/SVG/GSAP output instead of raster image generation.

2789927464king-jpg/video-skill-ku

给剪好的口播配画面:在录屏上盖 HTML 层(圈重点标注 / 小黑整屏动画 / 推近),层绑字幕屏、由播放器逐帧驱动、直接在预览里看。用户说做分镜、配画面、加动画、圈重点、B-roll、做 storyboard 时使用。不要用于删词剪辑、字幕、物理剪切或成片渲染。

2789927464king-jpg/video-skill-ku

剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper),提供开箱即用的 Python 接口,支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。全面适配 MacOS (Apple Silicon/Intel) 与 Windows,支持 v5.9+ (draft_info.json) 架构、工程自修复、智能配音字幕及录屏变焦。

Verwandte Skills