Communitygithub.com

mting314/projetos-de-legendas

Usado ao finalizar um AfterTalk do ProSeka (ou similar) `_translated.ass` para lançamento, após a revisão de texto QC — as etapas de layout e publicação em um só lugar: (1) aplicar estilos posicionais PiP/deslocamento de música, (2) detectar e corrigir linhas que renderizam 3+ linhas, (3) encontrar segmentos de legendas fixas (cortando o atraso inicial, PV, story watchalong e música/2DMV), e (4) escrever o título e descrição do YouTube. Autossuficiente: executa `apply_positional_styles.py`, `detect_long_lines.py`, `find_segments.py` e `hardsub_trim.sh`, e incorpora as regras de estilo do texto do YouTube. Os scripts ficam em `scripts/` na raiz do repositório de projetos. Compõe com a habilidade `aegisub-ass` para verificação de renderização.

O que é projetos-de-legendas?

Esta habilidade automatiza o processo final de lançamento de legendas traduzidas para AfterTalks do ProSeka (ou conteúdo similar). Ela combina quatro etapas essenciais de pós-QC em um único fluxo de trabalho determinístico: (1) aplicação de estilos posicionais para PiP (picture-in-picture) e subtítulos deslocados por música, garantindo que as legendas não sobreponham o conteúdo na tela; (2) detecção e correção de linhas que renderizam em 3 ou mais linhas, usando divisão inteligente ou reescrita; (3) identificação de segmentos para legendas fixas (hardsub), como atraso inicial, PV, watchalong da história e música/2DMV, com detecção de fade e corte preciso; (4) geração do título e descrição no estilo do YouTube, prontos para publicação. A habilidade é autossuficiente e utiliza scripts Python e shell localizados em `scripts/` no repositório do projeto. Ela é projetada para a plataforma ProSeka AfterTalk, mas é adaptável para workflows similares de legendagem. Cada etapa é independente e reversível, e a habilidade se integra com a skill `aegisub-ass` para verificação visual da renderização final. Ela garante que o layout esteja correto, que as linhas longas sejam evitadas e que os cortes editoriais sejam confirmados com o usuário antes da renderização cara.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Lançamento do AfterTalk (posicionamento → legendas fixas → publicação)

A etapa final em um _translated.ass, após a revisão de texto QC em quatro dimensões (que está em subtitle_review_guide.md). Quatro etapas, cada uma apoiada por um script determinístico em scripts/ na raiz do repositório de projetos, para que esta habilidade apenas forneça julgamento. Execute tudo a partir da raiz do repositório de projetos (os caminhos abaixo são scripts/...).

  1. Estilos posicionais — reposiciona as legendas para que não interfiram com o conteúdo na tela.
  2. Comprimento da linha — sinaliza + corrige qualquer linha que renderize 3+ linhas (faça após o posicionamento, pois as linhas PiP/deslocamento de música quebram em linhas mais estreitas e são as principais culpadas).
  3. Segmentos de legendas fixas — encontra os intervalos de fala do apresentador e os queima.
  4. Título e descrição do YouTube — escreve o texto de lançamento.

1. Estilos posicionais (PiP / deslocamento de música)

Reposiciona as legendas para que nunca fiquem sobre o conteúdo na tela. O pipeline pré-atribui os nomes dos estilos aos intervalos de linha corretos, mas geralmente os envia como cópias simples do estilo principal (margens erradas) sem \pos nas linhas PiP. O script corrige ambos, copiando o layout de uma referência conhecida; esta habilidade resolve os nomes de estilo por episódio em papéis (eles diferem por personagem).

PapelQuandoEstilo de referência (Colors of Pure Sense)Recebe \pos?
pipcâmera do apresentador / arte de cartão preenche a tela; legendas ficam no meio do quadroPiP (Alinhamento 8, margens 100/800/50)sim — {\pos(650,750)} por linha
shiftum MV 2D/3D toca no canto inferior direito; desloca as legendas para a esquerda para liberarDefaultOnibe - Shifted (Alinhamento 2, margens 100/730/60)não — as margens do estilo fazem isso

Descubra os estilos posicionais do alvo, então infira o papel a partir de tokens no nome (PiP→pip; Shifted/Side Song/Shift→shift) e confirme com o usuário:

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

Aplique (copia apenas Alinhamento + MarginL/R/V — cor/fonte preservados; ignora Comment: e linhas já posicionadas; idempotente, --dry-run):

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

Mapeamento: ESTILO_ALVO:ESTILO_REF[:X,Y]; --pip/--shift repetível por personagem. Confirme que o alvo e a referência compartilham o mesmo PlayResX/Y.

Verifique renderizando (delegue à habilidade aegisub-ass): reajuste o tempo de uma linha pip e uma linha shift para 0:00:00.00–0:00:05.00, renderize um quadro sobre cinza sólido e confirme que o texto pip fica no meio do quadro e o texto shift libera o canto inferior direito.


2. Comprimento da linha (máximo 2 linhas na tela)

3+ linhas é uma prática ruim (sobrecarga visual, espaço ocupado na tela). A contagem de linhas depende do empacotamento real do libass sob o estilo de cada linha, então meça renderizando. Execute após o posicionamento (PiP quebra ~1020px, Side-Song ~1090px vs principal ~1320px — as estreitas são as culpadas) e após qualquer edição de texto (uma reformulação altera o empacotamento).

Detecta (renderiza cada linha sob seu estilo sobre preto, conta linhas por projeção):

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

Para cada linha sinalizada, ofereça ao usuário ambas as correções e aplique a escolha:

  • Dividir em dois eventos em um limite de cláusula (vírgula, e/mas/então, que, final de frase) com scripts/split_subtitle_line.py --line N --before "<cláusula>" --transcript <t.json>. Ele define a divisão de tempo em uma pausa real: estimativa proporcional ao comprimento e, em seguida, ajusta para a maior lacuna de palavra dentro de ±1s dela (rejeitando pausas distantes no meio da frase e qualquer ajuste que deixe uma metade muito curta para ler). Preserva a redação exata + \pos.
  • Reformular mais curto, preservando significado + estilo casual.

Prefira divisão para duas cláusulas/frases reais ou uma pausa natural ...; reformule para uma única respiração. Re-renderize cada correção candidata e confirme ≤2 linhas antes de apresentar/aplicar, em seguida, re-execute o detector — o alvo é 0 sinalizadas. (Requer pillow + numpy via uv run --with.)


3. Segmentos de legendas fixas (encontrar intervalos de retenção → queimar)

Um AfterTalk intercala fala do apresentador (manter) com watchalongs (cortar): atraso inicial, um PV/digest de abertura, o watchalong da história do jogo e a música/2DMV. As regiões de corte são linhas Comment: que não renderizam (ou nada), então aparecem como lacunas na timeline Dialogue renderizada. find_segments.py as encontra e, com --transcript, informa se cada lacuna é silenciosa (segura) ou áudio de watchalong.

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

Leia as regiões CORTADAS: ~0 palavras = silencioso (seguro para descartar); muitas palavras = um watchalong de história/música que você está intencionalmente cortando (seu próprio áudio, não fala do apresentador). Confirme o plano de corte com o usuário antes de renderizar — cortar é uma decisão editorial, e a renderização é cara. Registre os intervalos no notes.md do projeto em "Segmentos".

Limites conscientes de fade: passar --mkv (ou --hardsub, que reutiliza seu MKV) faz com que ele execute blackdetect perto de cada limite e puxe o corte para fora de qualquer fade de origem. Watchalongs/MVs desvanecem para/preto em suas bordas; a margem pode empurrar um corte para dentro de um fade, e dois meios-fades adjacentes ao corte se encontrando em uma junção de concatenação produzem um flash preto. Ele emite limites de sub-segundos — nenhuma legenda perdida (a região de margem é livre de legendas). O script relata, por exemplo, fim 0:51:00->0:50:59.69 (fade de origem).

Em seguida, legendas fixas (a flag --hardsub imprime este comando; deve fazer legendas fixas antes de cortar — cortar invalida os timestamps do .ass):

uv run python scripts/hardsub_trim.py "<nome>.mkv" "<nome>_translated.ass" "<nome>_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

Lida com codificação GPU paralela (h264_nvenc), composição automática de overlay de carta VA/gachapin popups.json, transições suaves de fade-in/fade-out de 0,4s de vídeo + áudio nos limites dos segmentos e concatenação no vídeo final.


4. Título e descrição do YouTube

Escreva-os no notes.md do projeto (## Título do YouTube, ## Texto do YouTube).

Título — [ENG SUB] <Título do Evento> Aftertalk feat. <Nome do VA> (<Personagem>'s VA) exemplo [ENG SUB] Gazing Upon the Night Sky's Fading Stars Aftertalk feat. Karin Isobe (Saki's VA).

Texto — dois parágrafos, casuais e entusiasmados, voz de resumo (fãs que querem um resumo, não um teaser). Regras de estilo:

  1. Sem travessões (—). Use vírgulas, parênteses ou orações separadas. Varra o rascunho e substitua qualquer — antes de salvar.
  2. Abra com o enquadramento da série: Este episódio do ProSeka AfterTalk tem <nome do VA> (voz de <personagem>) cobrindo <evento/tópico>.... É uma série recorrente, então "este episódio de", não "no AfterTalk."
  3. Teça personalidade na substância. A espinha dorsal é a cobertura substantiva (história, arte do cartão, música, gravação); emparelhe cada tópico com um detalhe de personalidade desse mesmo tópico (por exemplo, discutindo a música e atrapalhando "2DMV"). Não coloque as partes bobas em seu próprio parágrafo.
  4. Sem frases de gancho ("Bônus:", "Não perca...", "Mais:"). Mantenha a voz descritiva de resumo em todo o texto.

Termine com Vídeo original: <url>.

Estrutura a espelhar: parágrafo 1 identifica VA + evento + enquadramento (apresentação solo/dupla, o que ela assiste); parágrafo 2 cobre história/gravação, ilustrações de cartão e a música/MV, com personalidade entrelaçada. Consulte Grow Glorious Glow Aftertalk/notes.md ou Gazing Upon the Night Sky's Fading Stars Aftertalk/notes.md para exemplos práticos.


5. Upload para o YouTube

Após criar as legendas fixas e escrever notes.md, execute scripts/youtube_upload.py para enviar o vídeo finalizado:

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

O script extrai automaticamente o título e a descrição de notes.md, verifica comprimentos, solicita confirmação e envia via YouTube Data API v3 (upload retomável).


Proteções

  • Posicionamento: apenas Alinhamento + MarginL/R/V mudam; nunca recolorir; nunca tocar linhas Comment: ou sobrescrever um \pos existente.
  • Segmentos: cortar é editorial — confirme antes da renderização (cara); registre os intervalos em notes.md; a contagem de palavras do transcript diz por que uma lacuna é um corte.
  • Os scripts retornam erro em estilos/caminhos desconhecidos — corrija os argumentos em vez de forçar.

Habilidades Relacionadas