# موجّه صوتي — Liu Terminal

> الموجّه الصوتي في Liu Terminal. أملِ في أي جزء عبر Cmd+Shift+M — يعمل Whisper large-v3-turbo على الجهاز بمئة لغة، أو استخدم واجهة كلام سحابية.

URL: https://liu.software/ar/docs/voice/  
Language: ar  
Updated: 2026-10-17

انطق موجّهًا وسيكتبه Liu في الجزء الذي تنظر إليه. يعمل Whisper large-v3-turbo على جهازك — بلا شبكة ولا حساب — أو يمكنك توجيهه إلى واجهة كلام سحابية بدلًا من ذلك.

## كيفية التفعيل

اضغط Cmd+Shift+M لبدء التسجيل واضغطها مجددًا للإيقاف. تظهر بطاقة في الزاوية السفلية اليمنى تعرض شكلًا موجيًا حيًّا لما يسمعه الميكروفون. يتوقف التسجيل أيضًا من تلقاء نفسه بعد ثانيتين من الصمت متى تحدثت فعلًا، وعند حدّ أقصى صارم كي لا يسجّل اختصار منسيّ إلى ما لا نهاية. وEsc يلغي.

**أين يذهب النص:** الجزء الذي عليه التركيز، لا «الوكيل». أنت تنظر إلى جزء واحد وتتوقع الكلمات حيث مؤشرك — وهذا ما يجعلها تعمل أيضًا في صدفة عادية وفي REPL وفي أي واجهة سطر أوامر تصدر لاحقًا. تتحول أسطر النص الجديدة إلى مسافات، لأن حرف الإرجاع ليس مسافة بيضاء لدى واجهة الوكيل: إنه يرسل الموجّه. أنت من يقرر وقت الإرسال، إلا إذا فعّلت الإرسال التلقائي.

## الواجهات الخلفية

- **محلي (افتراضي)** — يُنزَّل Whisper large-v3-turbo مرة واحدة من الإعدادات › Voice (547 ميغابايت) ويُحفظ بجوار بقية النماذج ضمن Application Support. يعمل عبر Metal على شرائح Apple، وعبر مسار C محمول في غير ذلك، مع واجهة Vulkan تجريبية تصل معطّلة. لا يغادر الصوت الجهاز أبدًا.
- **API** — تُرسَل التسجيلة بدلًا من ذلك إلى نقطة تفريغ سحابية: OpenAI أو Groq أو ElevenLabs أو أي خادم متوافق مع OpenAI عبر عنوان أساسي مخصّص. يبقى المفتاح في config.json أو في متغيّر البيئة المعتاد للمزوّد، ولا يظهر أبدًا في سطر أوامر العملية. مفيد على عتاد بلا مسار GPU، أو إن كنت تفضّل عدم استضافة نموذج بحجم 547 ميغابايت.

## الميكروفون واللغة

يسرد الإعدادات › Voice كل أجهزة الإدخال ويثبّت ما تختاره عبر معرّفه الدائم، لا عبر الاسم أو الموضع — إذ يبلّغ ميكروفونان USB متطابقان الاسم نفسه، وتتحرك الفهارس مع توصيل الأجهزة وفصلها. وهذا أهم مما يبدو: يتبدّل الجهاز الافتراضي للنظام من تلقاء نفسه عند توصيل سماعة أو شاشة بكاميرا، والإدخال الخاطئ لكن العامل يرسم شكلًا موجيًا أيضًا — لكن للغرفة الخطأ.

يقدّم منتقي اللغة خيار Auto إضافة إلى كل اللغات المئة التي دُرِّب عليها النموذج. يكلّف Auto خطوة فك ترميز إضافية في النافذة الأولى، وهو مصيب أكثر بكثير من تثبيت خاطئ، ولذلك يأتي أولًا.

## الإملاء بلغة والإرسال بالإنجليزية

فعّل «To English» فيصلك النص بالإنجليزية مهما كانت لغتك. ثمة تفصيل يستحق المعرفة: إن large-v3-turbo نموذج مقطّر دُرِّب على التفريغ وحده ولا يستطيع تنفيذ مهمة الترجمة في Whisper إطلاقًا — وإذا طُلب منه ذلك أعاد ثلاث نقاط بدل خطأ. يكتشف Liu ذلك من النموذج نفسه ويمرّر النص عبر محرّك Translate الخاص به، فتعمل الميزة مع النموذج المرفق. أما على واجهة الـ API أو على large-v3 كامل، فتتم الترجمة عند المصدر في خطوة واحدة.

## الإعداد

كل شيء في تبويب Voice داخل الإعدادات، ويُحفظ في config.json:

- `voice_enabled`, `voice_backend` (0 = local, 1 = API)
- `voice_model_path`, `voice_lang`, `voice_translate`
- `voice_input_device`, `voice_auto_submit`
- `voice_max_seconds`, `voice_silence_stop_sec`
- `voice_api_provider`, `voice_api_model`, `voice_api_key`, `voice_api_base_url`

الافتراضيات هي الواجهة المحلية واكتشاف اللغة تلقائيًا وتسجيل بحد أقصى 120 ثانية والتوقف بعد ثانيتين من الصمت عقب الكلام، مع تعطيل الترجمة والإرسال التلقائي. ترفع واجهة API التسجيل إلى الموفر المحدد، بينما تبقي الواجهة المحلية الصوت على الجهاز.