Sprachaufnahmen schneiden (Koubo)
Von einem Video zu einem manuell überprüften Löschungsprotokoll (Cuts + EDL), ohne Medien-Dateien anzufassen.
Sieben Schritte in einer Linie:
0 Bereit Bereitschaftsprüfung durch Verweis auf „Updates prüfen“ (dieses Skill enthält keine Umgebungslogik)
1 Anlegen Echtes Video → Cloud-Wort-für-Wort-Transkription → Produktprojekt erstellen → Dienst starten → Status zurücklesen
2 Zeichen korrigieren Wörterbuch korrigiert Transkriptionsfehler (allgemein + benutzerspezifisch) → Korrekturtabelle ausgeben
3 Löschen Präferenzen & Regeln lesen → Fünf Durchläufe, jeder nur eine Kategorie, nur Zeilen notieren
4 Zusammenfassen Löschungszusammenfassungstabelle + Satzwiederholungstabelle → Selbstprüfung anhand der Tabellen
5 Freigeben Vollständig einreichen → Zwei Tabellen dem Benutzer präsentieren → Studio zur manuellen Überprüfung öffnen
6 Rückblick & Übergabe Vorschlag mit Endversion vergleichen → Drei Schubladen archivieren → Vier Dinge berichten
Keine Medien schneiden: Eine Änderung im Protokoll dauert Millisekunden, ein Schnitt ist eine unwiderrufliche Datei. Am Ende dieses Skills befindet sich kein neues Video auf der Festplatte. Das Skill übernimmt semantische Urteile und Orchestrierung; die Produkt-Runtime ist der alleinige Schreiber für Projekte, Cuts und Studio-Status.
Der Benutzer spricht nur an drei Stellen: Fortsetzen oder Neustarten des gleichen Quellprojekts (nur wenn bereits geschnitten), Studio-Überprüfung, Abschlussbestätigung. Der Rest ist unidirektionale Berichterstattung ohne Warten auf Antwort. Das Erfolgskriterium jedes Schritts ist sein Output: Keine Tabelle, kein Abschluss.
Zunächst lesen und ausführen Die Phasenvereinbarung des Geschäfts-Skills. Die Entsprechung der Schritte hier zu den Phasen im Vertrag: 1=preflight+Product state readback, 5=proposal+Product CAS, Freigabe=project-level review binding. Die drei Phasen nach dem Vertrag (Bestätigung, Ausführung, Abnahme) gehören zum Export-Skill.
Die Herkunft der Unfälle für jede Regel befindet sich im Unfallbuch – Regeln im Haupttext, Geschichten dort.
0. Bereit
Zunächst führen Sie die „Bereitschaftsprüfung“ aus Updates prüfen aus – ob Skills aktuell sind, ob Runtime passt; das Plugin-Stammverzeichnis wird dort ebenfalls lokalisiert (im Befehl bei <Plugin-Stamm> den dortigen Pfad einsetzen). Nur mit „Bereit“ weitermachen; bei „Neue Sitzung erforderlich“ oder „Stopp“ gemäß dessen Anweisungen handeln (einschließlich des Verbots „Keine selbstgebauten Ersatzoberflächen“).
Wenn das Bereitschaftsergebnis runtime.kind=desktop-managed ist, teilt es sich denselben stabilen Einstiegspunkt und den launchd/windows-task-Dienst mit der CLI-Installation; direkt weitermachen; kein Electron-Installationsverzeichnis suchen, kein Bun/FFmpeg nachinstallieren oder eine zweite Runtime starten.
1. Anlegen: Echtes Eingabe → Transkription → Produktprojekt erstellen
Was zu tun ist: Das lokale echte Video und die Cloud-Wort-für-Wort-Transkription des Benutzers dem Produkt übergeben, atomar anlegen, Dienst starten, Status zurücklesen.
# Nach Cloud-Wort-für-Wort-Transkription (erzeugt Transkript-Kandidaten im Aufgabenverzeichnis):
node "<Plugin-Stamm>/scripts/videocut-cli.cjs" project create "<Projektverzeichnis>" --video "<Video-Datei im Aufgabenverzeichnis>" --transcript "<Wort-für-Wort-Transkript im Aufgabenverzeichnis>" --json
node "<Plugin-Stamm>/scripts/ensure-running.cjs" --json # Produkt deklarativ sicherstellen, dass der dauerhafte Dienst läuft (5190)
node "<Plugin-Stamm>/scripts/videocut-cli.cjs" workflow get "<Projektverzeichnis>" --json # Product state readback
node "<Plugin-Stamm>/scripts/videocut-cli.cjs" cuts get "<Projektverzeichnis>" --json
Regeln:
- Nur das vom Benutzer bereitgestellte echte Sprachaufnahme-Video oder ein bestehendes echtes Projekt akzeptieren; ohne echte Medien stoppen, keine Platzhalter-Videos verwenden
- Transkription nur mit der in der aktuellen Umgebung zugelassenen Cloud-ASR; Fallback auf lokale ASR verboten; bei fehlender Cloud-ASR
missing_cloud_transcription_adaptermelden, kein Studio öffnen, kein Transkript fälschen --video/--transcriptmüssen echte Dateien im Aufgabenverzeichnis sein; Seitenverhältnis nicht übergeben – das Produkt leitet es automatisch von der tatsächlichen Videogröße ab (Runtime 0.4.4+). Nur bei explizitem Wunsch des Benutzers nach einem speziellen Seitenverhältnis--aspect-ratio W:Hhinzufügen- Bei vorhandenen Standardprojekten erst
inspectzur Bestätigung und Wiederverwendung, keine doppelte Erstellung vonprojectId; wenn dasselbe Video bereits geschnitten wurde, Benutzer fragen: Fortsetzen oder Neustart (einer der drei Sprechpunkte).project prepareist ein idempotenter Compiler, nur zur Wiederherstellung nach Unterbrechung oder bei explizitem Refresh verwenden; bei Unterbrechung einfach erneut ausführen project createist der einzige Einstieg: Kein Medienarchiv, keine Upload-Sitzung oder zusätzliches Skill; das Skill darf nicht zuerstproject.jsonschreiben- Der Dienst muss durch das Skript als
healthy=true,runtimeMode=launchd(macOS) oderruntimeMode=windows-task(Windows), versionskompatibel und URL als kanonischer 5190 bestätigt werden, bevor fortgefahren wird; bei Fehlschlag strukturierten Fehler durchreichen und stoppen, keine Fallbacks auf Vordergrund, Portwechsel oder Töten unbekannter Prozesse - Beide Readbacks müssen auf dieselbe
projectIdverweisen, workflow stage und die drei Revisionen von Project / Cuts / EditList speichern; bei Fehlen oder Inkonsistenz stoppen
2. Zeichen korrigieren: Zeichen richtigstellen, Korrekturtabelle ausgeben
Was zu tun ist: Vor allen Löschungsentscheidungen mit dem Wörterbuch Transkriptionsfehler korrigieren – falsche Zeichen führen zu falschen Entscheidungen; falsch gehörte Zeichen sind keine überflüssigen Wörter, die durch Löschung nicht behoben werden können.
node "<Plugin-Stamm>/scripts/videocut-cli.cjs" transcript dictionary "<Projektverzeichnis>" --dictionary "<Plugin-Stamm>/references/ai-term-dictionary.md" --json
Überprüfen Sie mit Ihrem Datei-Tool, ob $HOME/.chengfeng-videocut/dictionary.md existiert; falls ja, noch einmal durchführen (Übergangslösung: CLI akzeptiert derzeit nur eine Datei, in zwei Durchläufen; es kann nur ergänzen, nicht rückgängig machen – vollständige Benutzerprioritätszusammenführung wird nach Veröffentlichung der Multi-Wörterbuch-CLI erfolgen):
node "<Plugin-Stamm>/scripts/videocut-cli.cjs" transcript dictionary "<Projektverzeichnis>" --dictionary "$HOME/.chengfeng-videocut/dictionary.md" --json
Output: Korrekturtabelle – die applied-Listen beider Aufrufe zu einer kleinen Tabelle zusammenführen (Originalwort → geändert zu → Kontext), dem Benutzer melden. Nach der Korrektur muss diese Tabelle angesehen werden – Wörterbücher können ohne Kontext auch Fehler machen; bei Fehlern das Wörterbuch ändern, nicht anderswo Patches setzen.
Nur wenn das Wörterbuch nicht ausreicht und der Autor ein Skript hat, einmalige kontextbezogene Ausrichtung hinzufügen:
node "<Plugin-Stamm>/scripts/videocut-cli.cjs" transcript align "<Projektverzeichnis>" --script "<Datei des Sprachskripts>" --json # Nur melden, nicht ändern
node "<Plugin-Stamm>/scripts/videocut-cli.cjs" transcript correct "<Projektverzeichnis>" --file "<Korrekturdatei>" --json
Regeln:
- Nur Text ändern, nicht Zeit, Wortanzahl, wordId – das Produkt vergleicht Wort-für-Wort Zeitstempel, bei Änderung direkte Ablehnung
- Nur Schreibweise ändern, nicht Bedeutung – tatsächliche Fehler und Wiederholungen gehören zu unvollständigen Sätzen und Neuformulierungen, die in den Löschungsbereich fallen
- Wenn das Wörterbuch nichts enthält und das Skript nicht bestätigt werden kann, nicht raten: Melden und dem Benutzer überlassen, das Wörterbuch zu ergänzen. Ein erfundener Name ist schlimmer als ein falsch gehörter Name
- Chinesische Umgangssprache originalgetreu erhalten: Wenn „叉“ oder „大模型“ gesagt wird, ist es das, was gesagt wurde
- Das Wörterbuch ist eine Hürde, die jede Transkription passieren muss (dieselbe Audio zweimal transkribieren kann unterschiedliche Ergebnisse liefern, siehe Unfallbuch)
Text nach Satzzeichen segmentieren: Jedes Wort in der Transkription hat ein Satzzeichen, ein Komma ein Absatz, ein Punkt eine Zeile; Untertitel verwenden dieselben Satzzeichen, beide Seiten haben identische Segmentierung. Bei Projekten vor dem 28.07.2026 ohne Satzzeichen node "<Plugin-Stamm>/scripts/videocut-cli.cjs" transcript regroup "<Projektverzeichnis>" --json ausführen, um Absätze neu zu schneiden (Wort-für-Wort-Prüfung von id/Zeit/Text unverändert, sicher für bereits geschnittene Projekte); für Satzzeichen muss neu transkribiert werden – Satzzeichen existieren in alten Transkriptionen überhaupt nicht.
3. Löschen: Fünf Durchläufe, jeder nur eine Kategorie
Was zu tun ist: Material lesen, dann die Wiedergabereihenfolge komplett fünfmal lesen, jedes Mal mit nur einem Kriterium. Ein Kriterium pro Lesedurchgang führt zu deutlich höherer Qualität als sechs gleichzeitig; jeder Durchlauf produziert wenig Output und ist überprüfbar.
Zuerst Material lesen:
node "<Plugin-Stamm>/scripts/videocut-cli.cjs" transcript playback "<Projektverzeichnis>" --json
Dann mit Ihrem Datei-Lese-Tool $HOME/.chengfeng-videocut/cut-preferences.md lesen (Benutzerpräferenzen, was der Benutzer gesagt hat, zählt; Datei existiert nicht = neuer Benutzer, überspringen).
Kriterien in Semantische Löschungsregeln (Prinzipien + Fälle). Priorität: Benutzerpräferenz > Benutzerfall > Allgemeiner Fall.
Durchlauf 1 – Wiederholung Satzübergreifende Wiederholung, Satzinterne Wiederholung (objektivste: zweimal identisch)
Durchlauf 2 – Unvollständige Sätze & Neuformulierungen Halb abgebrochener Satz, mit anderer Formulierung neu begonnen
Durchlauf 3 – Versprecher & Wiederholung Falsche Zahlen, Eigennamen, Wörter, danach richtige Version
Durchlauf 4 – Englische Stockungen Wortanfang / Buchstabe / Silbenwiederholung
Durchlauf 5 – Füllwörter & Modalpartikel Subjektivste, abhängig von Benutzerpräferenz zur Dichte und Toleranz
Jeder Durchlauf hat feste Aktionen: Nach Fällen des Typs suchen → bei Fund eine Zeile notieren (wordIds + Typ + Risiko) → keine anderen Typen beurteilen. Bereits markierte Wörter in späteren Durchläufen überspringen, Konflikte erst in der Zusammenfassung lösen.
Regeln:
- Urteile nur mit der Wiedergabereihenfolge von
transcript playback, nicht selbst austranscript.jsonzusammensetzen – „zweimal gesagt“ wird durch nebeneinanderliegende Wiedergabe erkannt; selbst zusammengesetzt können Sprünge in der Nummerierung als fehlender Inhalt fehlinterpretiert werden (siehe Unfallbuch) - Löschung hat nur zwei Zustände: „gelöscht / nicht gelöscht“; KI-Begründung erzeugt keinen dritten Zustand „Löschung vorgeschlagen“
- Versprecher, Wiederholungen, unvollständige Sätze standardmäßig die erste Instanz löschen, die zweite behalten; lange Sätze, ganze Sätze, Neuformulierungen erfordern hohe Risikoüberprüfung
- Normale Pausen werden nicht vom Skill berechnet: Zusammenführung benachbarter Stille und
natural-pause-v2werden deterministisch vom Produkt ausgeführt
4. Zusammenfassen: Zwei Tabellen, erst dann handeln
Was zu tun ist: Die Zeilen der fünf Durchläufe in zwei Tabellen zusammenführen – dies ist der Output dieses Schritts und das, was dem Benutzer präsentiert wird.
Löschungszusammenfassungstabelle (jede Löschungsentscheidung einzeln):
| # | Zeit | Typ | Gelöscht | Übrig gelesen als | Risiko | Grundlage |
|---|-------|--------|------------------|------------------|-----|----------|
| 1 | 00:12 | Wiederholung | 这个功能呢 | 这个功能它其实 | Niedrig | Fall R2 |
| 2 | 02:31 | Neuformulierung | 比如我就让他跟踪 | 比如我让grok跟踪 | Hoch | Fall R5 |
Satzwiederholungstabelle (mehrmals gesagte Sätze – die Wort-für-Wort-Tabelle zeigt nicht, „wie oft aufgenommen, welche Version behalten“, was der Benutzer am meisten überprüfen möchte):
| Satz (Anfang) | Wie oft gesagt | Welche Version behalten | Welche Versionen gelöscht | Risiko |
|-----------------|--------|---------------|------------|-----------------|
| 因为今天有什么… | 3 | 3. Version 00:08 | 1., 2. Version | Niedrig – drei Versionen im Wesentlichen identisch |
| 多数Agent能搜… | 2 | 2. Version 04:40 | 1. Version | Hoch – zwei Versionen unterscheiden sich, genau zuhören |
Dann Selbstprüfung: Den gelöschten Volltext entsprechend der Tabelle in der Wiedergabereihenfolge vollständig durchlesen; unverständliche Zeilen zurücknehmen. Dies ist die Definition der Überprüfung: KI prüft selbst noch einmal, nicht den Benutzer fragen; unsicher = nicht auflisten (zwei Zustände).
5. Freigeben: Studio erst bei manueller Prüfung öffnen
Was zu tun ist: Vollständige Kandidaten einreichen, die zwei Tabellen dem Benutzer präsentieren, dann die Produkt-Überprüfungsseite öffnen, damit der Benutzer selbst prüft.
node "<Plugin-Stamm>/scripts/videocut-cli.cjs" cuts get "<Projektverzeichnis>" --json # Cuts eigene Revision abrufen
node "<Plugin-Stamm>/scripts/videocut-cli.cjs" cuts set "<Projektverzeichnis>" --file "<Vorschlagsdatei>" --expected-revision "<Cuts aktuelle Revision>" --json
Kandidaten referenzieren nur stabile wordIds:
{
"schemaVersion": 1,
"cutWordIds": ["word-12", "word-13"],
"reasons": [
{ "wordIds": ["word-12", "word-13"], "kind": "repeat", "risk": "low" }
]
}
Einreichungsregeln:
- Der Kandidat ist das vollständige Ergebnis dieser Runde, kein Inkrement –
cuts setist ersetzend; die Übergabe eines Inkrements würde die semantischen Löschungen der vorherigen Runde stillschweigend verlieren (siehe Unfallbuch); beim Einreichen des Kandidaten nichtinitialization.baselineCutWordIdslesen oder manuell zusammenführen (das Produkt fügt automatisch Pausen-Baseline ein) reasonspersistieren, wahrheitsgemäß schreiben; das Produkt entfernt Teile, die sich auf nicht gelöschte Wörter beziehen- Nicht direkt
cut-selection.json,project.jsonoder Ereignisprotokolle schreiben cuts get.data.revisionist die Revision von Cuts,workflow get.data.revisiondie des Projekts, nicht vermischen- Nach erfolgreicher Einreichung unbedingt
noLongerCutsehen (Anzahl der diesmal nicht mehr gelöschten Wörter): Wenn nicht null und nicht absichtlich zurückgenommen = Inkrement eingereicht, zurückgehen und vollständigen Satz erneut einreichen; auch bei"unknown"sehen - Anschließend sofort erneut
workflow get+cuts getausführen, umcut_review_readyund die drei Revisionen zu bestätigen; bei Inkonsistenz stoppen, niemals direkt JSON schreiben oder automatisch überschreiben - Nach der Einreichung die
<Vorschlagsdatei>im Aufgabenverzeichnis behalten – Schritt 6 benötigt sie für den Rückblick (die reasons werden nach Benutzerbearbeitung vom Produkt entfernt, eine Rückverfolgung aus dem Protokoll ist danach unzuverlässig)
Dann zuerst die Tabellen präsentieren, dann die Seite öffnen: Die beiden Tabellen dem Benutzer senden, damit er mit den Tabellen ins Studio zur Überprüfung geht.
node "<Plugin-Stamm>/scripts/ensure-running.cjs" --json # Vor dem Öffnen erneut idempotent sicherstellen
node "<Plugin-Stamm>/scripts/videocut-cli.cjs" open "<Projektverzeichnis>" --json # Vom Produkt zurückgegebene Projekt-URL abrufen
node "<Plugin-Stamm>/scripts/ensure-studio.cjs" --url "<Produkt-Projekt-URL>" --view koubo --json # Fähigkeits-Gate: Bestätigen, dass 5190 die koubo-Ansicht registriert hat
Regeln:
- Nur wenn das Gate
ok=truezurückgibt, den Codex-eigenen Browser mitstudio.urlöffnen, dann die Automatik stoppen und auf Benutzeraktionen (Markieren, Wiederherstellen, Speichern) warten - Vor dem Öffnen
productUrl's#project/<projectId>strikt mit derprojectIddes Readbacks vergleichen und anstage=cut_review_readysowie die drei Revisionen binden –ok=truedes Gates bestätigt nur die Produktfähigkeit, ersetzt nicht die projektbezogene Bindung; bei Inkonsistenz erneut Readback durchführen studio_capability_missing: Stoppen und auf Versionsinkompatibilität hinweisen, kann$chengfeng-report-bugvorschlagen; nicht aufgrund von?view=kouboin der URL annehmen, dass die neue Oberfläche existiert; kein Fallback auf alte Aufgaben-Panels- Nicht „Arbeitsbereich öffnen“ als ersten Schritt der Aufgabe betrachten; nicht auf alte
review.html, 8898/8899 zugreifen; nicht Studio DOM steuern oder Medienelemente direkt ändern; keine unabhängigen Audiospuren oder Platzhalter-Untertitelspuren erstellen
6. Rückblick & Übergabe: Vom Benutzer bearbeitete Arbeit nicht wegwerfen
Nach Abschluss der Benutzerüberprüfung zuerst zurücklesen:
node "<Plugin-Stamm>/scripts/videocut-cli.cjs" workflow get "<Projektverzeichnis>" --json
node "<Plugin-Stamm>/scripts/videocut-cli.cjs" cuts get "<Projektverzeichnis>" --json
Rückblick (Übergangslösung, wird nach Veröffentlichung des cuts diff-Befehls des Produkts ersetzt): Die in Schritt 5 gespeicherte <Vorschlagsdatei> mit der endgültigen cutWordIds vergleichen –
- Vom Benutzer wiederhergestellt (im Vorschlag enthalten, in Endversion nicht) = KI hat falsch gelöscht. Anhand der selbst geschriebenen reason im Vorschlag fragen: Bei welcher Kategorie lag der Fehler?
- Vom Benutzer nachgelöscht (in Endversion enthalten, nicht im Vorschlag und nicht in
initialization.baselineCutWordIds-Pausen-Baseline) = KI hat übersehen. Fragen: Zu welchem Typ gehört das, warum wurde es nicht erkannt? (Baseline wird hier nur zum Ausschließen von Pausenwörtern verwendet, immer noch verboten, sie in die Einreichung zu integrieren)
Drei Schubladen archivieren:
- Geschmacksunterschiede →
~/.chengfeng-videocut/cut-preferences.mdanhängen (vom Agenten gepflegtes Markdown, nur eigenen Abschnitt anhängen und umschreiben; bei Nichtexistenz Datei erstellen) - Eigennamenfehler →
~/.chengfeng-videocut/dictionary.mdanhängen (zweispaltige Tabelle, vor dem Anhängen auf Duplikate prüfen) - Regel-Lücken → Im Abschnitt „Aufzuwertende Fälle“ der Präferenzdatei eine Notiz machen; bei drittem Auftreten desselben Typs dem Benutzer melden und vorschlagen, in allgemeine Fälle aufzuwerten (Skills-Repository erst nach menschlicher Prüfung ändern)
- Auch bei null Abweichungen notieren: Eine Zeile „Vollständig übernommen“ in der Präferenzdatei für das Projekt
Vier Dinge berichten: Anzahl gelöschter Wörter, eingesparte Sekunden; aktuelle Stage (sollte cut_review_ready sein); drei Revisionen von Projekt / Cuts / EDL; Rückblick-Zusammenfassung (Vorschlag N Einträge, davon übernommen X, wiederhergestellt Y, nachgelöscht Z, Hauptunterschied in einem Satz). Dann den Benutzer informieren, dass der nächste Schritt der Export ist.
Keine Bestätigungskarte einblenden, keinen Schnitt ausführen – Die Bestätigungskarte für den physischen Schnitt gehört zum Export-Skill; diese Karte muss die Revision zum Zeitpunkt der Benutzerbestätigung einfrieren.
return_cut_review: Zuerst erneut node "<Plugin-Stamm>/scripts/ensure-running.cjs" --json ausführen, dann zum selben Studio zurückkehren und die Überprüfung fortsetzen; keinen Rückblick auslösen, Rückblick nur einmal bei endgültiger Übergabe.
Berichtsebenen: Produktstrukturierte Revision als API/readback PASS; Echte Browser-Frame-Prüfung ist visual frame PASS; Wenn niemand tatsächlich zugehört hat, immer human listening UNVERIFIED, nicht durch Wiedergabe, DOM, Screenshot oder Media-Erkennung ersetzbar.
Wiederherstellung und Fehler
revision_conflict: Status erneut lesen, die gerade erfolgte Bearbeitung des Benutzers erklären, nicht automatisch überschreibenruntime_unhealthy: Nicht in einer Schleife neu installierenservice_identity_mismatch/service_port_conflict: Stoppen, kein Fallback auf Vordergrund, kein Portwechsel, keine unbekannten Prozesse töten- Seite geschlossen, aber Dienst läuft noch: Workflow lesen und von aktuellem Status fortsetzen, kein neues Projekt erstellen
- Bei keinem Fehler darf „Protokoll geschrieben“ als „bereits geschnitten“ ausgegeben werden – bis zu diesem Abschnitt wurde keine Mediendatei erstellt
Anmerkung: Dieses Skill akzeptiert lokale echte Videos und Cloud-Wort-für-Wort-Transkriptionen direkt zur Eingabe ins Produkt; dies ist die Anforderung des Vertrags für preflight. Beide müssen real existieren, damit alle Urteile möglich sind.