a7aadly1987-hub/árabe-voice-ready

Árabe Voice Ready

El TTS en árabe falla en lugares predecibles. Corrígelos en el texto antes de generar audio — cada regeneración cuesta créditos.

Flujo de trabajo

1. Escribe el guion en el dialecto objetivo. Los anuncios egipcios suenan naturalmente en عامية («اطلب دلوقتي», «بس», «في المية»). Mantén las oraciones cortas: una idea por oración, 4–9 palabras.
2. Ejecuta el normalizador sobre el borrador — escribe los números como los dice el dialecto, maneja %, rangos, separadores de miles, dígitos arábigo-indios, dominios y préstamos comunes:

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

   --dialect=msa da números en فصحى (خمسة عشر، عشرون بالمئة). --pauses añade [short pause] entre oraciones (etiquetas de audio ElevenLabs v3/v4).
3. Aplica las reglas manuales en references/pronunciation.md para lo que un script no puede decidir: diacríticos en palabras ambiguas, nombres de marca, las letras ج / ق / ث / ذ en egipcio, acento en préstamos.
4. Añade etiquetas de entrega desde references/elevenlabs-tags.md — con moderación (una etiqueta de emoción cada 2–3 oraciones).
5. Genera 2 tomas, escucha, luego corrige solo las palabras que fallaron. Anota cada corrección en el guion para que la siguiente toma lo mantenga.

Reglas que más importan

• Nunca dejes dígitos para que el motor los adivine. «15» puede convertirse en «خمسة عشر» en un anuncio egipcio, «20%» puede leerse «عشرون بالمئة». Siempre pre-escribe.
• Préstamos → escritura latina cuando la letra árabe es ambigua. En egipcio, «ج» es una /g/ fuerte, por lo que «جل» se lee gal. Escribe gel. Lo mismo para memory foam si falla, .com → «دوت كوم».
• Diacríticos solo donde sea necesario. El texto completamente vocalizado suena robótico. Añade una vocal solo a una palabra que fue mal leída: «البِيضاء», «خَصْم», «كُمْفُورْت».
• Marcas: escríbelas como las dice la marca, con sukun en grupos consonánticos: «ماكْس كُمْفُورْت», «نُون», «جُومْيا».
• Precios: di la moneda una vez: «بـ تلتمية وتسعة وخمسين جنيه بدل أربعمية وتسعة وأربعين».
• Fechas: «من خمسة لِخَمَسْتاشَر نوفمبر» — la ل se une al número; diacríticos en «خمستاشر» evitan que se convierta en «خمسة عشر».
• No prometas lo que no puedes probar. Los guiones publicitarios no deben inventar precios, descuentos ni afirmaciones médicas; lee los números de la fuente real.

Archivos

• scripts/normalize.mjs — normalizador sin dependencias (CLI + import { normalize, numberToWords }).
• scripts/normalize.test.mjs — node --test scripts/normalize.test.mjs.
• references/pronunciation.md — dificultades de pronunciación egipcia y correcciones.
• references/elevenlabs-tags.md — etiquetas de audio que funcionan bien con árabe.
• examples/ — guiones antes/después.