Communitygithub.com

Chengfeng Subtitle — Untertitel aus dem Schnittprotokoll

Untertitelt ein geschnittenes Talking-Head-Video direkt aus dem vorhandenen Wort-für-Wort-Transkript und dem Schnittprotokoll: Zeiten nach dem Schnitt werden berechnet, falsch verstandene Namen über Wörterbuch und Skript korrigiert, Sätze auf Bildschirme verteilt und jeder Bildschirm im Studio geprüft.

Was ist Chengfeng Subtitle — Untertitel aus dem Schnittprotokoll?

Short-form Editing, Schritt 2 (untertiteln): video-skill-ku-chengfeng-subtitle. Untertitel speichern Wort-IDs und Anzeigetext, nie Sekunden, daher wird das Timing jedes Mal aus dem Protokoll berechnet und veraltete Bildschirme werden genau gemeldet. Nach jedem weiteren Schnitt neu ausführen, dann an den Export übergeben.

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-subtitle

In Ihrer bevorzugten KI fragen

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

Dokumentation

Untertitel

Dies ist eine eigenständige Aktion, kein Teil eines Workflows. Sie wird ausgeführt, wann immer der Benutzer es anfordert – direkt nach dem Schnitt oder erneut, wenn nachträglich zwei Zeilen gelöscht wurden.

Es gibt nur eine Voraussetzung: Das Schnittprotokoll (‚Konto‘) muss vorhanden sein. Nicht weil dieser Schritt zeitlich nach dem Schnitt kommt, sondern weil ohne das Protokoll nicht bekannt ist, welche Wörter erhalten bleiben und an welcher Sekunde des fertigen Films sie liegen.

Benötigt   edit-list.json (Schnittprotokoll), transcript.json (Wort-für-Wort-Transkript)
Erzeugt    subtitles.json

Nach Abschluss wird angehalten – der Benutzer wird nicht zum nächsten Schritt aufgefordert.

Zunächst wird der Phasenvertrag des Geschäfts-Skills gelesen und ausgeführt, die Kriterien finden sich in den Untertitel-Korrekturregeln und die Schreibweise von Eigennamen im KI-Fachwörterbuch.

Wer entscheidet über was

Dies ist das Fundament, von dem alles Weitere abgeleitet wird.

Schnitt/Audio-Edit    entscheidet „welche Wörter bleiben, zu welcher Zeit“    ← einzige Quelle der Wahrheit für Zeit
Untertitel            entscheidet „was auf dem Bildschirm angezeigt wird“     ← einzige Quelle der Wahrheit für Anzeige

Ein Untertitel-Block speichert eine Liste von Wort-IDs + den anzuzeigenden Text, keine Sekundenangaben. Die Zeit wird jedes Mal aus dem Schnittprotokoll berechnet. Dadurch kann es keine zweite, abweichende Zeitachse zwischen den beiden Protokollen geben, und selbst ein ungültiger Block kann exakt identifiziert werden: „Die Wörter von Block 7 und 12 wurden geschnitten“, nicht die vage Aussage „Untertitel könnten veraltet sein“.

Untertitel speichern bewusst ihren eigenen Text. Das Transkript antwortet auf „Was wurde gesagt?“, der Untertitel auf „Was soll der Zuschauer sehen?“ – Satzzeichen, entfernte Füllwörter, die korrekte Schreibweise von Eigennamen – das darf und soll unterschiedlich sein. Wenn man ein und denselben String für zwei Zwecke zwingt, kann der Untertitel nie ein Komma einfügen.

0. Bereitschaft

Zunächst wird die „Bereitschaftsprüfung“ von Prüfung auf Updates ausgeführt – ob Skills aktuell sind, ob die Runtime kompatibel ist; das Plugin-Root-Verzeichnis wird dort ebenfalls bestimmt (alle <Plugin-Root> in diesem Befehl werden durch den dortigen Pfad ersetzt). Nur bei „Bereit“ wird fortgefahren; bei „Neue Sitzung erforderlich“ oder „Stop“ wird gemäß der dortigen Anweisung verfahren (einschließlich des Verbots „keine selbst gebastelten alternativen Oberflächen“). Der Geschäfts-Skill enthält keine eigene Umgebungslogik.

Falls das Bereitschaftsergebnis runtime.kind=desktop-managed ist, wird direkt die bereits installierte stabile CLI der Desktop-App und der zugehörige launchd-/windows-task-Dienst verwendet; es werden keine Electron-Pfade analysiert, keine zusätzlichen Abhängigkeiten installiert oder eine zweite Runtime gestartet.

1. Einstiegsprüfung

node "<Plugin-Root>/scripts/ensure-running.cjs" --json
node "<Plugin-Root>/scripts/videocut-cli.cjs" inspect "<Projektverzeichnis>" --json
PrüfungBei Nichterfüllung
edit-list.json existiert und enthält SegmenteMelde, dass das Schnittprotokoll fehlt, und fordere den Benutzer auf, zuerst den Audio-Edit durchzuführen. Führe den Schnicht nicht selbst durch.
transcript.json existiertDas Projekt ist nicht bereit, stoppen. Erstelle kein eigenes Transkript.

Prüfe nicht auf source_cut.mp4 und führe keine Transkription durch. Untertitel benötigen beides nicht – siehe nächster Abschnitt.

2. Textkorrektur: Zuerst Wörterbuch, dann Manuskript

Keine erneute Transkription erforderlich. Das vorhandene Wort-für-Wort-Transkript enthält bereits die Zeitstempel. Das Schnittprotokoll weiß, welche Abschnitte erhalten bleiben – die Position jedes Wortes in der fertigen Sequenz wird berechnet, nicht durch erneutes Abhören ermittelt:

Position des Wortes im Quellmaterial   ist im Transkript vorhanden
Welche Abschnitte bleiben              sind im Schnittprotokoll vorhanden
Position des Wortes in der Sequenz     ergibt sich aus beidem

Ein erneuter ASR-Durchlauf würde dasselbe nur noch einmal anhören, Geld und Zeit kosten und schlechtere Ergebnisse liefern – Eigennamen müssten erneut korrigiert werden. (transcript retranscribe ist ein Überbleibsel des vorherigen Designs, bei dem Untertitel durch erneute Transkription des geschnittenen Videos eine Zeitachse erhalten sollten. Nach der Umstellung auf ID-basierte Untertitel ist dieses Problem gelöst. Verwende es nicht für Untertitel.)

Zwei verschiedene Werkzeuge, beide werden verwendet.

# Wörterbuch: die festgelegte Schreibweise für den Sprecher, benötigt keine Beweise
node "<Plugin-Root>/scripts/videocut-cli.cjs" transcript dictionary "<Projektverzeichnis>" --dictionary "<Plugin-Root>/references/ai-term-dictionary.md" --json

# Manuskript: wird nur verwendet, wenn der Autor ein schriftliches Manuskript hat, jede Korrektur benötigt einen Beleg
node "<Plugin-Root>/scripts/videocut-cli.cjs" transcript align "<Projektverzeichnis>" --script "<Manuskriptdatei>" --json
Wörterbuch    wird immer so geschrieben                       ignoriert den Kontext, ändert direkt, listet die geänderten Stellen auf
Manuskript   wird nur geschrieben, wenn der Kontext passt    jede Änderung benötigt einen Beleg, bei Unstimmigkeit wird „unsicher“ gemeldet, es wird nicht geraten

Warum ist das Wörterbuch unverzichtbar und das Manuskript allein nicht ausreichend? Bei echten Projekten werden Aufnahmen wiederholt. In einem realen Projekt wurde derselbe Satz viermal aufgenommen, daher tritt der Kontext von „Steckverbinder“ und „Stecker ist“ mehrfach auf. align kann dann nur „unsicher“ melden – es rät nicht, weil ein falsch geschriebener Name schlimmer ist als ein überhörter. Von drei Vorkommen von „Stecker“ würde es nur eines korrigieren. Das Wörterbuch hat dieses Problem nicht: Im Werk dieses Sprechers ist „Stecker“ gleichbedeutend mit „Verbinder“.

Das Wörterbuch gibt es nur einmal, auf Plugin-Ebene in references/ai-term-dictionary.md: Es korrigiert das Transkript, das sowohl vom Audio-Edit als auch von den Untertiteln verwendet wird. Erstelle kein separates Wörterbuch innerhalb dieses Skills.

Die Änderungsliste muss angesehen werden. Das Wörterbuch ignoriert den Kontext, daher kann es auch Fehler machen – z. B. wenn der Sprecher tatsächlich „Skills“ (Claude Skills, Plural-Eigenname) sagt, dies aber zu „Skill“ normalisiert wird. Wenn ein Fehler auffällt, korrigiere das Wörterbuch, nicht die Befehlszeile.

transcript align meldet nur, es ändert nicht. Um die Vorschläge zu übernehmen, erstelle daraus [{wordId, text}] und führe es aus:

node "<Plugin-Root>/scripts/videocut-cli.cjs" transcript correct "<Projektverzeichnis>" --file "<Korrekturdatei>" --json

Nach der Korrektur des Transkripts werden die Untertitelblöcke, die diese Wörter referenzieren, im selben Schritt automatisch aktualisiert, gemeldet als subtitles.updated. Blöcke, die nicht geändert werden konnten (weil der Text manuell überschrieben wurde), werden in needsAttention gemeldet, damit der Benutzer sie überprüft – es wird nicht geraten.

Wenn weder das Wörterbuch noch das Manuskript eine korrekte Schreibweise bestätigen können, darf nicht geraten werden. Melde es dem Benutzer, damit er das Wörterbuch ergänzt – beim nächsten Video wird es automatisch korrekt sein. Einmaliges Erraten hilft nicht, denn beim nächsten Mal müsste wieder geraten werden.

3. Blockbildung (Splitten)

node "<Plugin-Root>/scripts/videocut-cli.cjs" subtitle build "<Projektverzeichnis>" --json

Vier Regeln, in dieser Reihenfolge:

① Hier wurde Text entfernt    Die entfernten Teile liegen auf der Zeitachse nebeneinander, haben aber inhaltlich nichts miteinander zu tun.
                              Entfernte „Stille“ zählt nicht – das Entfernen einer Pause mitten im Satz darf den Satz nicht aufteilen.
② Jegliches Satzzeichen       Vom ASR bereitgestellt, sowohl Punkte als auch Kommas – **der gleiche Granularitätsgrad wie beim Audio-Edit-Splitten**,
                              beide teilen an derselben Stelle. Satzzeichen sind stärker als jeder Zeitbeweis: Ein Sprecher kann zwei Sätze ohne Pause
                              hintereinander sagen, aber auch innerhalb eines Satzes eine Pause machen.
③ Absatzgrenzen + Pause       **Wird nur verwendet, wenn das Wort kein Satzzeichen hat.** Es geht davon aus, dass ein Satz endet, wenn kein
                              Satzzeichen vorhanden ist, aber die Absatzanalyse darauf hindeutet. Wenn ein Satzzeichen vorhanden ist, sollte Regel ②
                              mit Kommas greifen – sie berücksichtigt, ob der Block lang genug ist, Regel ③ tut dies nicht.
                              (Wenn Regel ③ auch an Grenzen mit Satzzeichen ausgelöst wird, kann dies in einem echten Projekt von 40 auf 43 Blöcke
                              führen, also mehr kleine Blöcke erzeugen.)
④ Zuschauer hört eine lange Pause   Für eine Teilung innerhalb eines Satzes ist eine längere Stille erforderlich.

Audio-Edit und Untertitel verwenden dieselben Satzzeichen und denselben Granularitätsgrad: Ein Komma = ein Segment / ein Block.

Fragmente (ein bis zwei Zeichen) werden zusammengelegt, jedoch nicht über Satzpunkte hinweg – „Du siehst“ beginnt einen neuen Satz, es ist kein Ende des vorherigen Satzes. Ein Zusammenlegen würde „…Grok CLI aufrufen Du siehst“ ergeben, zwei Sätze würden verschmelzen.

Kurze Sätze, die der Sprecher schnell sagt, bleiben erhalten (in einem echten Projekt dauerten „jeden Morgen“ und „Aufgabe ausführen“ jeweils 0,6 Sekunden). Das ist seine tatsächliche Sprechweise, kein Alarm. Ein Komma = ein Block erzeugt zwangsläufig solche Blöcke. Sie zu alarmieren bedeutet, normale Sprache zu alarmieren – wenn zu viele Alarme ausgelöst werden, liest sie niemand mehr.

Blöcke, die länger als ein Block sind, werden gleichmäßig auf mehrere Blöcke aufgeteilt, ein Block pro Zeile. Wenn dabei ein bis zwei Zeichen als Fragment übrig bleiben, deutet dies darauf hin, dass die Grenze bei Regel ② eigentlich kein Satzpunkt war – das Fragment wird an den vorherigen Block angehängt.

Der Befehl meldet vier Dinge, die alle überprüft werden müssen:

stale              Blöcke, die durch den Schnitt geändert wurden – genaue Angabe, welcher Block und welche Wörter fehlen
tooFast            Zu viele Zeichen, zu wenig Zeit zum Lesen
transcriptMoved    Das Transkript ist nicht mehr das ursprüngliche

Wenn bereits Untertitel vorhanden sind – hier anhalten und nachfragen

Ohne --replace wird der Befehl direkt abgelehnt. Dies ist die einzige Stelle in diesem Skill, an der die Zustimmung des Benutzers eingeholt werden muss, denn --replace zerstört die manuell erstellten Aufteilungen und Formulierungen, die der Benutzer möglicherweise selbst angepasst hat und die nicht automatisch wiederhergestellt werden können.

Benutzer möchte nur ein paar Zeichen ändern     Führe nicht „build“ aus. Lass ihn direkt in Studio ändern oder dir sagen, welche Blöcke geändert werden sollen.
Benutzer möchte alles neu machen                 Frage erst, ob er sicher ist, dann füge --replace hinzu.

4. Überprüfung: Block für Block in Studio

node "<Plugin-Root>/scripts/videocut-cli.cjs" open "<Projektverzeichnis>" --json

Nach dem Öffnen wechsle zur linken Spalte zum Reiter „Untertitel“. Eine Zeile = ein Block: Links die Nummer und die Zeit, rechts der Text. Klicke hinein, um direkt zu bearbeiten.

  • Eingabe = neuen Block ab der Cursorposition erstellen
  • Rücktaste am Zeilenanfang = mit vorherigem Block zusammenführen
  • Rechte Spalte „Parameter → Untertitel“: Wähle eine der vier Voreinstellungen für das gesamte Video aus
  • Auf dem Bildschirm siehst du die Untertitel direkt, Position und Schriftgröße sind proportional zum Bild – Vorschau und fertiges Video verwenden dieselben Werte

Bei der Überprüfung solltest du mindestens Folgendes bestätigen lassen: Sind die Eigennamen korrekt? Werden Zeichen verschluckt? Ist der Zeilenumbruch flüssig lesbar? Reicht die Anzeigedauer eines Blocks zum Lesen?

5. Ende bei subtitles.json

Dieser Abschnitt ist abgeschlossen. Kein physikalischer Schnitt, kein Storyboard, keine Animation, kein Rendering des fertigen Videos, und keine Aufforderung zum nächsten Schritt.

Die Berichterstattung muss getrennt erfolgen: Die strukturierte Rückmeldung des Produkts ist API/readback PASS; die echte visuelle Überprüfung durch eine Person im Projekt-Browser ist visual frame PASS; solange niemand tatsächlich überprüft hat, ob die Untertitel mit dem Bild übereinstimmen, lautet der Status human listening UNVERIFIED. DOM-, Screenshot- oder Dateiprüfungen sind kein Ersatz.

Grenze: Das Einbrennen ins Bild gehört nicht zu diesem Schritt

Die Ausgabemethode ist Einbrennen in das Bild, aber die Bilderzeugung erfolgt im Exportschritt. Die Ausgabe der Untertitel ist subtitles.json – alle darin enthaltenen Größenangaben sind Prozentsätze des Bildes, die beim Export einfach in Pixel der Ausgabeauflösung umgerechnet werden können. Beide Seiten verwenden dieselben Werte.

Das aktuell exportierte mp4 enthält keine Untertitel – dieser Schritt wurde noch nicht durchgeführt. Dieser Konsequenz muss im Bericht klar benannt werden. Sage nicht einfach „Untertitel sind fertig“ – der Benutzer könnte annehmen, dass das Endvideo sie enthält.

Wiederherstellung und Fehlerbehandlung

  • subtitles_exist: Es sind bereits Untertitel vorhanden. **Frage zuerst, verwende nicht direkt --replace. **
  • revision_conflict: Eine andere Stelle schreibt ebenfalls. Lese erneut, überschreibe nicht automatisch.
  • Wörterbuch meldet „Zeile N kann nicht gelesen werden“: Das ist eine Zeile mit defektem Tabellenformat. Es werden nur Tabellenzeilen (im Format | Korrekte Schreibweise | Häufig falsch erkannt |) verarbeitet; Prosa und Listen werden still ignoriert.
  • transcript correct meldet „must not change any word id, time or gap flag“: Der Korrekturvorschlag enthält Änderungen an der Zeit, nicht nur am Text. Korrigiere nur den Text, nicht die Zeit.
  • runtime_unhealthy: Kein Neuinstallieren in einer Schleife.
  • Kein Fehler darf dazu führen, dass „Transkription abgeschlossen“ als „Untertitel fertig“ gemeldet wird. Das ASR-Ergebnis ist das Rohmaterial, nicht das Endprodukt.

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

把剪好的口播烧成一个成片文件:账本切片段、推近、字幕、HTML 画面层,一次全部烧进 mp4。用户说导出、出成片、烧字幕、渲染、导出视频、生成最终文件时使用。不要用于生成删词候选、写字幕、做画面动画。

2789927464king-jpg/video-skill-ku

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

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