a7aadly1987-hub/arabic-voice-ready

Arabic Voice Ready

O TTS em árabe falha em pontos previsíveis. Corrija-os no texto antes de gerar o áudio — cada regeneração custa créditos.

Fluxo de Trabalho

1. Escreva o roteiro no dialeto alvo. Anúncios egípcios soam naturais em عامية («اطلب دلوقتي», «بس», «في المية»). Mantenha frases curtas: uma ideia por frase, 4–9 palavras.
2. Execute o normalizador no rascunho — ele escreve os números como o dialeto os pronuncia, lida com %, intervalos, separadores de milhares, dígitos arábico-índicos, domínios e empréstimos comuns:

   node scripts/normalize.mjs "خصم 20% من 5 لـ 15 نوفمبر بـ 359 جنيه" --dialect=egy --pauses
   # خصم عشرين في المية من خمسة لِـخمستاشر نوفمبر بـ تلتمية وتسعة وخمسين جنيه
   

   --dialect=msa dá números em فصحى (خمسة عشر، عشرون بالمئة). --pauses adiciona [short pause] entre frases (tags de áudio ElevenLabs v3/v4).
3. Aplique as regras manuais em references/pronunciation.md para o que um script não pode decidir: diacríticos em palavras ambíguas, nomes de marcas, as letras ج / ق / ث / ذ no egípcio, ênfase em empréstimos.
4. Adicione tags de entrega de references/elevenlabs-tags.md — com moderação (uma tag de emoção a cada 2–3 frases).
5. Gere 2 takes, ouça e corrija apenas as palavras que falharam. Anote cada correção no roteiro para que o próximo take mantenha a melhoria.

Regras Mais Importantes

• Nunca deixe dígitos para o mecanismo adivinhar. «15» pode se tornar «خمسة عشر» em um anúncio egípcio, «20%» pode ser lido «عشرون بالمئة». Sempre escreva por extenso.
• Empréstimos → escrita latina quando a letra árabe for ambígua. No egípcio, «ج» é um /g/ duro, então «جل» é lido gal. Escreva gel. O mesmo para memory foam se falhar, .com → «دوت كوم».
• Diacríticos apenas onde necessário. Texto totalmente vocalizado soa robótico. Adicione uma vogal apenas em palavras mal lidas: «البِيضاء», «خَصْم», «كُمْفُورْت».
• Marcas: soletre como a marca as pronuncia, com sukun em encontros consonantais: «ماكْس كُمْفُورْت», «نُون», «جُومْيا».
• Preços: diga a moeda uma vez: «بـ تلتمية وتسعة وخمسين جنيه بدل أربعمية وتسعة وأربعين».
• Datas: «من خمسة لِخَمَسْتاشَر نوفمبر» — o ل se junta ao número; diacríticos em «خمستاشر» impedem que se torne «خمسة عشر».
• Não prometa o que não pode provar. Roteiros de anúncios não devem inventar preços, descontos ou alegações médicas; leia números da fonte real.

Arquivos

• scripts/normalize.mjs — normalizador sem dependências (CLI + import { normalize, numberToWords }).
• scripts/normalize.test.mjs — node --test scripts/normalize.test.mjs.
• references/pronunciation.md — armadilhas e correções de pronúncia egípcia.
• references/elevenlabs-tags.md — tags de áudio que funcionam bem com árabe.
• examples/ — roteiros antes/depois.