Communitygithub.com

mting314/Untertitelungsprojekte

Verwendet beim Fertigstellen einer `_translated.ass` nach der QC-Textphase für die Veröffentlichung von ProSeka AfterTalks (oder ähnlichem). Führt Layout- und Veröffentlichungsschritte an einem Ort zusammen: PiP-/Song-Shift-Positionsstile, Erkennung und Korrektur von Zeilen mit 3+ Zeilen, Finden von Hardsub-Segmenten und Erstellung von YouTube-Titel und -Beschreibung.

Was ist Untertitelungsprojekte?

Dieses Skill automatisiert die letzten Schritte vor der Veröffentlichung eines untertitelten ProSeka AfterTalk-Videos. Es ist für Entwickler und Nutzer von KI-Agenten gedacht, die mit Untertitelungsprojekten arbeiten, insbesondere mit Aegisub und Python-Skripten. Das Skill besteht aus vier Hauptschritten: Anwenden von Positionsstilen, um Untertitel von Bildschirminhalten fernzuhalten, Erkennen und Korrigieren von Zeilen, die auf 3+ Zeilen umbrechen, Identifizieren von Hardsub-Segmenten (wie Einleitungsverzögerungen, PVs, Story-Watchalongs und Songs), und Schreiben von YouTube-Titel und -Beschreibung. Es ist plattformunabhängig, setzt aber Python 3 und die genannten Skripte voraus. Die Skripte sind deterministisch und werden im `scripts/`-Verzeichnis des Projekt-Repositorys ausgeführt; das Skill liefert das nötige Urteilsvermögen für die Konfiguration der einzelnen Schritte. Es arbeitet mit dem `aegisub-ass`-Skill zur Render-Überprüfung zusammen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mting314/subtitling-projects/tree/HEAD/.claude/skills/aftertalk-launch

In Ihrer bevorzugten KI fragen

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

Dokumentation

AfterTalk-Veröffentlichung (Positionierung → Hardsub → Veröffentlichung)

Der letzte Durchlauf für eine _translated.ass nach der vierdimensionalen QC-Textprüfung (diese befindet sich in subtitle_review_guide.md). Vier Schritte, jeder unterstützt von einem deterministischen Skript in scripts/ unter dem Projekt-Repository-Root, sodass dieses Skill nur die Beurteilung liefert. Alles vom Projekt-Repository-Root aus ausführen (Pfade unten sind scripts/…).

  1. Positionsstile – Untertitel neu positionieren, damit sie keine Bildschirminhalte überdecken.
  2. Zeilenlänge – Zeilen markieren und korrigieren, die auf 3+ Zeilen umbrechen (nach Positionsänderung durchführen, da PiP/Side-Song-Zeilen schmaler umbrechen und die Hauptverursacher sind).
  3. Hardsub-Segmente – Die Bereiche des Host-Gesprächs finden, die behalten werden, und sie einbrennen.
  4. YouTube-Titel + Beschreibung – Den Veröffentlichungstext schreiben.

1. Positionsstile (PiP / Song-Shift)

Untertitel neu positionieren, damit sie nie Bildschirminhalte überdecken. Die Pipeline weist die Stil-Namen vorab den richtigen Zeilenbereichen zu, liefert sie aber normalerweise als einfache Kopien des Hauptstils (falsche Ränder) ohne \pos auf PiP-Zeilen. Das Skript korrigiert beides, indem es das Layout von einer bekannten Referenz kopiert; dieses Skill löst die epodenspezifischen Stilnamen in Rollen auf (sie unterscheiden sich pro Charakter).

RolleWannReferenzstil (Colors of Pure Sense)Erhält \pos?
pipHost-Kamera / Kartenkunst füllt den Rahmen; Untertitel sitzen in der BildmittePiP (Ausrichtung 8, Ränder 100/800/50)ja — {\pos(650,750)} pro Zeile
shiftEin 2D/3D-MV läuft unten rechts; Untertitel nach links verschieben, um es freizuhaltenDefaultOnibe - Shifted (Ausrichtung 2, Ränder 100/730/60)nein — Stilränder erledigen es

Ermitteln Sie die Positionsstile des Ziels, leiten Sie dann die Rolle aus den Namensbestandteilen ab (PiP→pip; Shifted/Side Song/Shift→shift) und bestätigen Sie mit dem Benutzer:

f="projects/Project Sekai/Aftertalk/<event>/<name>_translated.ass"
grep -oE "^Dialogue: [0-9]+,[^,]+,[^,]+,[^,]+\" "$f" | awk -F, '{print $4}' | sort | uniq -c
grep "^Style:" "$f"

Anwenden (kopiert nur Ausrichtung + MarginL/R/V – Farbe/Schrift bleiben erhalten; überspringt Comment: und bereits positionierte Zeilen; idempotent, --dry-run):

python3 scripts/apply_positional_styles.py "projects/Project Sekai/Aftertalk/<event>/<name>_translated.ass" \
  --reference "projects/Project Sekai/Events/Colors of Pure Sense/Colors of Pure Sense_translated.ass" \
  --pip   "<Char> - PiP:PiP:650,750" \
  --shift "<Char> - Side Song:DefaultOnibe - Shifted" \
  --dry-run

Mapping: TARGET_STYLE:REF_STYLE[:X,Y]; --pip/--shift wiederholbar pro Charakter. Bestätigen Sie, dass Ziel und Referenz dieselbe PlayResX/Y haben.

Durch Rendern überprüfen (an das aegisub-ass-Skill delegieren): Zeitsteuern Sie eine pip- und eine shift-Zeile auf 0:00:00.00–0:00:05.00, rendern Sie einen Frame über flachem Grau und bestätigen Sie, dass der pip-Text in der Bildmitte und der shift-Text unten rechts frei steht.


2. Zeilenlänge (max. 2 Zeilen auf dem Bildschirm)

3+ Zeilen sind schlechte Praxis (Augenbewegung, Bildschirmplatz). Die Zeilenanzahl hängt vom tatsächlichen Umbruch von libass unter dem Stil jeder Zeile ab, also messen Sie durch Rendern. Nach der Positionierung ausführen (PiP umbricht ~1020px, Side-Song ~1090px vs. Hauptstil ~1320px – die schmalen sind die Übeltäter) und nach jeder Textbearbeitung (eine Umformulierung ändert den Umbruch).

Erkennung (rendert jede Zeile unter ihrem Stil über Schwarz, zählt Zeilen mittels Projektion):

uv run --with pillow --with numpy python3 scripts/detect_long_lines.py \
  "projects/Project Sekai/Aftertalk/<event>/<name>_translated.ass"

Bieten Sie dem Benutzer für jede markierte Zeile beide Korrekturen an und wenden Sie seine Wahl an:

  • Aufteilen in zwei Events an einer Satzgrenze (Komma, und/aber/also, dass, Satzende) mit scripts/split_subtitle_line.py --line N --before "<Klausel>" --transcript <t.json>. Es setzt die Zeitteilung auf einen echten Atemzug: proportionale Längenschätzung, dann Einrasten auf die größte Wortlücke innerhalb ±1s davon (Ablehnung von entfernten Pausen mitten im Satz und jedem Einrasten, das eine Hälfte zu kurz zum Lesen hinterlässt). Behält genauen Wortlaut + \pos.
  • Kürzer umformulieren unter Beibehaltung von Bedeutung + lässigem Stil.

Teilung bevorzugen für zwei echte Sätze/Satzteile oder eine natürliche ...-Pause; umformulieren für einen einzelnen Atemzug. Jeden Kandidatenfix erneut rendern und ≤2 Zeilen bestätigen, bevor Sie ihn präsentieren/anwenden, dann den Detektor erneut ausführen – Ziel ist 0 Markierungen. (Erfordert pillow + numpy via uv run --with.)


3. Hardsub-Segmente (Behalte-Bereiche finden → einbrennen)

Ein AfterTalk mischt Host-Gespräch (behalten) mit Watchalongs (schneiden): Einleitungsverzögerung, ein eröffnendes PV/Digest, der In-Game-Story-Watchalong und das Lied/2DMV. Geschnittene Bereiche sind nicht-rendernde Comment:-Zeilen (oder nichts), erscheinen also als Lücken in der gerenderten Dialogue-Zeitleiste. find_segments.py findet sie und meldet mit --transcript, ob jede Lücke still (sicher) oder Watchalong-Audio ist.

python3 scripts/find_segments.py "projects/Project Sekai/Aftertalk/<event>/<name>_translated.ass" \
  --transcript "projects/Project Sekai/Aftertalk/<event>/<name>_transcript.json" \
  --hardsub "projects/Project Sekai/Aftertalk/<event>/<name>.mkv:projects/Project Sekai/Aftertalk/<event>/<name>_final.mp4"

Lesen Sie die CUT-Bereiche: ~0 Wörter = still (sicher zu entfernen); viele Wörter = ein Story/Song- Watchalong, den Sie absichtlich schneiden (eigenes Audio, kein Host-Gespräch). Bestätigen Sie den Schnittplan mit dem Benutzer vor dem Rendern – Schneiden ist eine redaktionelle Entscheidung, und das Rendern ist aufwändig. Notieren Sie die Bereiche in der notes.md des Projekts unter "Segmente".

Fade-bewusste Grenzen: Durch Übergabe von --mkv (oder --hardsub, das sein MKV wiederverwendet) wird blackdetect in der Nähe jeder Grenze ausgeführt und der Schnitt so gelegt, dass er jegliches Quell-Fade meidet. Watchalongs/MVs blenden an ihren Rändern zu/von Schwarz; die Polsterung kann einen Schnitt in ein Fade schieben, und zwei schnittbenachbarte Halb-Fades, die an einer Concat-Verbindung aufeinandertreffen, erzeugen einen schwarzen Blitz. Es gibt Unter-Sekunden-Grenzen aus – keine Untertitel gehen verloren (der Polsterbereich ist untertitelfrei). Das Skript meldet z.B. Ende 0:51:00->0:50:59.69 (Quell-Fade).

Dann Hardsub (das --hardsub-Flag gibt diesen Befehl aus; muss vor dem Trimmen erfolgen – Trimmen macht .ass-Zeitstempel ungültig):

uv run python scripts/hardsub_trim.py "<name>.mkv" "<name>_translated.ass" "<name>_hardsubbed.mp4" \
  0:01:37 0:05:27  0:10:53 0:27:40  0:36:05 0:51:00  0:52:25 1:00:09

Behandelt parallele GPU-Kodierung (h264_nvenc), automatisches Compositing von popups.json VA-/Gachapin-Overlay-Karten, sanfte 0,4s Video- + Audio-Fade-In/Fade-Out-Übergänge an Segmentgrenzen und Verkettung zum endgültigen Video.


4. YouTube-Titel + Beschreibung

Schreiben Sie diese in die notes.md des Projekts (## YouTube-Titel, ## YouTube-Text).

Titel – [ENG SUB] <Event-Titel> Aftertalk feat. <VA-Name> (<Charakter>'s VA) z.B. [ENG SUB] Gazing Upon the Night Sky's Fading Stars Aftertalk feat. Karin Isobe (Saki's VA).

Text – zwei Absätze, lässig und begeistert, zusammenfassender Ton (Fans, die eine Zusammenfassung wollen, keinen Teaser). Stilregeln:

  1. Keine Gedankenstriche (—). Verwenden Sie Kommas, Klammern oder trennen Sie Sätze. Überprüfen Sie den Entwurf und ersetzen Sie alle — vor dem Speichern.
  2. Beginnen Sie mit der Serienrahmung: Diese Folge von ProSeka AfterTalk hat <VA-Name> (Synchronsprecherin von <Charakter>) über <Event/Thema>... Es ist eine wiederkehrende Serie, also "diese Folge von", nicht "im AfterTalk."
  3. Verweben Sie Persönlichkeit mit Substanz. Das Rückgrat ist die inhaltliche Abdeckung (Geschichte, Kartenkunst, Lied, Aufnahme); kombinieren Sie jedes Thema mit einem Persönlichkeitsdetail aus demselben Thema (z.B. das Lied besprechen und über "2DMV" stolpern). Verbannen Sie die albernen Teile nicht in einen eigenen Absatz.
  4. Keine Hooksätze („Bonus:", „Nicht verpassen:", „Plus:"). Behalten Sie den beschreibenden zusammenfassenden Ton bei.

Enden Sie mit Originalvideo: <url>.

Struktur zum Nachahmen: Absatz 1 identifiziert VA + Event + Rahmung (solo/duo Host, was sie sieht); Absatz 2 behandelt Geschichte/Aufnahme, Kartenillustrationen und das Lied/MV, mit eingewobener Persönlichkeit. Siehe Grow Glorious Glow Aftertalk/notes.md oder Gazing Upon the Night Sky's Fading Stars Aftertalk/notes.md für ausgearbeitete Beispiele.


5. YouTube-Upload

Nach dem Hardsubbing und Schreiben der notes.md führen Sie scripts/youtube_upload.py aus, um das fertige Video hochzuladen:

uv run --script scripts/youtube_upload.py \
  --video "projects/Project Sekai/Aftertalk/<event>/<name>_hardsubbed.mp4" \
  --notes "projects/Project Sekai/Aftertalk/<event>/notes.md"

Das Skript extrahiert automatisch Titel und Beschreibung aus notes.md, überprüft die Längen, fordert eine Bestätigung an und lädt über die YouTube Data API v3 (wiederaufnehmbarer Upload) hoch.


Leitplanken

  • Positionsstile: Nur Ausrichtung + MarginL/R/V ändern; niemals umfärben; niemals Comment:-Zeilen berühren oder ein vorhandenes \pos überschreiben.
  • Segmente: Schneiden ist redaktionell – vor dem (teuren) Rendern bestätigen; die Bereiche in notes.md protokollieren; die Transkript-Wortanzahl sagt Ihnen, warum eine Lücke ein Schnitt ist.
  • Die Skripte brechen bei unbekanntem Stil/Pfad ab – korrigieren Sie die Argumente, anstatt zu erzwingen.

Verwandte Skills