Community寫作與編輯github.com

阿拉伯語配音工具

為埃及方言或現代標準阿拉伯語的旁白和廣告文案進行預處理,確保 ElevenLabs 等 TTS 引擎能正確發音。適用於任何需要文字轉語音、廣告配音、IVR 提示或有聲書台詞的情境。

阿拉伯語配音工具 是什麼?

此技能專為處理阿拉伯語 TTS 引擎常見的發音問題而設計,特別是埃及方言和現代標準阿拉伯語。它提供了一個工作流程,從撰寫目標方言的文案開始,然後執行一個正規化器,將數字、百分比、貨幣、日期、域名和英文借詞轉換為對應的語音拼寫形式。正規化器支援埃及方言和 MSA 選項,並能自動添加暫停標記。此外,該技能還提供了手動規則(如變音符號、品牌名稱、借詞處理)和 ElevenLabs 音訊標籤的參考檔案,以進一步微調發音和情感表達。支援的平台包括所有使用 TTS 引擎的系統,重點是 ElevenLabs。文件中強調了永遠不要將數字留給引擎猜測、使用拉丁字母處理模糊的阿拉伯字母、僅在必要時添加變音符號等核心規則,並提供了實用的範例。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/a7aadly1987-hub/arabic-voice-ready/tree/HEAD

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

阿拉伯語配音工具 是做什麼的?

阿拉伯語 TTS 在可預測的地方會出錯。在生成音訊之前將其在文本中修正——每次重新生成都會耗費額度。

工作流程

  1. 以目標方言撰寫文案。 埃及廣告自然地使用 عامية(「اطلب دلوقتي」、「بس」、「في المية」)。保持句子簡短:一個句子一個想法,4–9 個詞。
  2. 對草稿執行正規化器——它會將數字拼寫為方言的實際發音,處理 %、範圍、千位分隔符、阿拉伯-印度數字、域名和常見借詞:
    node scripts/normalize.mjs "خصم 20% من 5 لـ 15 نوفمبر بـ 359 جنيه" --dialect=egy --pauses
    # خصم عشرين في المية من خمسة لِـخمستاشر نوفمبر بـ تلتمية وتسعة وخمسين جنيه
    
    --dialect=msa 會給出標準阿拉伯語數字(خمسة عشر,عشرون بالمئة)。--pauses 會在句子之間添加 [short pause](ElevenLabs v3/v4 音訊標籤)。
  3. 套用 references/pronunciation.md 中的手動規則,處理文案無法確定的內容:模糊詞上的變音符號、品牌名稱、埃及方言中的 ج / ق / ث / ذ、借詞的重音。
  4. 從 references/elevenlabs-tags.md 添加傳遞標籤——適量使用(每 2–3 個句子一個情感標籤)。
  5. 生成兩次錄製、聆聽,然後只修正出錯的詞。 在文案中記錄每次修正,以便下一次錄製保留它。

最重要的規則

  • 永遠不要將數字留給引擎猜測。 在埃及廣告中,「15」可能變成「خمسة عشر」,「20%」可能被讀成「عشرون بالمئة」。務必預先拼寫。
  • 當阿拉伯字母不明確時,將借詞轉為拉丁字母。 在埃及方言中,「ج」是硬 /g/,所以「جل」會讀成 gal。寫成 gel。如果斷掉,同樣處理 memory foam,.com → 「دوت كوم」。
  • 只在必要時添加變音符號。 完全標註元音的文字聽起來機械化。只對被誤讀的詞添加元音:「البِيضاء」、「خَصْم」、「كُمْفُورْت」。
  • 品牌名稱: 按照品牌自己的發音拼寫,在輔音簇上添加靜音符號:「ماكْس كُمْفُورْت」、「نُون」、「جُومْيا」。
  • 價格: 貨幣只說一次:「بـ تلتمية وتسعة وخمسين جنيه بدل أربعمية وتسعة وأربعين」。
  • 日期: 「من خمسة لِخَمَسْتاشَر نوفمبر」——ل 連接到數字;「خمستاشر」上的變音符號可防止它變成「خمسة عشر」。
  • 不要承諾無法證明的事。 廣告文案不得捏造價格、折扣或醫療聲明;從真實來源讀取數字。

檔案

  • scripts/normalize.mjs——零依賴正規化器(CLI + import { normalize, numberToWords })。
  • scripts/normalize.test.mjs——node --test scripts/normalize.test.mjs。
  • references/pronunciation.md——埃及方言發音陷阱與修正。
  • references/elevenlabs-tags.md——適用於阿拉伯語的音訊標籤。
  • examples/——前後對比文案。

相關技能