التوثيق

إعداد الخادم

يحوّل الإدخال الصوتي الكلام إلى دخل طرفية: تحدّث بدل الكتابة، مع صقل LLM اختياري للنسخ قبل الإرسال. يعمل التعرف خادم ASR محليًا بنماذج على الجهاز — يبقى الصوت والنص على جهازك. تغطي هذه الصفحة جانب الخادم؛ أما تجربة سطح المكتب ففي استخدام العميل.

بطاقة Local ASR Server

افتح قسم Voice بواجهة الويب وفعّل التعرف الصوتي. تدير بطاقة Local ASR Server عملية vterm-voice الخاضعة للإشراف:

  • ‏Load on Startup — بدء خادم ASR مع الخلفية;
  • ‏Bind Address (127.0.0.1 محلي فقط / 0.0.0.0 كل الواجهات) و Port (الافتراضي 8398) — حيث ينصت طرف ASR;
  • ‏Model Directory + Local Model — اختر من الفهرس المدمج: عائلتا Qwen3-ASR وFun-ASR وParakeet، كل ببدائل full / 8-بت / 4-بت. يجلب Download النموذج من Hugging Face أو ModelScope إلى المجلد مع شريط تقدم حي؛ وتُعرض أوامر git clone يدوية احتياطًا، وتوسم النماذج الموجودة على القرص متاحة;
  • ‏Device — خلفية الاستدلال (Auto و CPU و CUDA و Vulkan و Metal)، كما يبلغ الخادم;
  • ‏Access Token — سر مشترك للطرف؛ زر النرد يولده;
  • يحفظ Save البطاقة (تبقى التعديلات مسودة محلية حتى ذلك)، ويتحكم Start Server / Stop Server في العملية. ويعكس أيقونة الحالة في عنوان البطاقة قابلية الوصول وحالة النموذج (محمل / يُحمَّل / خطأ).
قسم Voice — بطاقة Local ASR Server بالنموذج والجهاز والرمز

تنازع CUDA: حين تحتل برنامج استدلال CUDA آخر بطاقة الرسوم مسبقًا (مثل llama.cpp يشغّل نموذجًا محليًا)، فإن ترك vterm-voice يستخدم CUDA أيضًا قد يبطئ كليهما بشدة. عندها اضبط Device على CPU — نماذج ASR المدمجة هذه سريعة بما يكفي على المعالج.

المزود والاختبار

يسرد منسدل المزودين إضافات ASR — إشارة الإضافة المدمجة vibe-voice إلى هذا الخادم المُشرف، فاختيارها هو كيف تستخدم اللوحة نماذجك المحلية.

تجربة Test كل شيء دون عميل: Record (ميكروفون ← موجة ← نسخ) و Live (تعرف متدفق)، كلّـ بأزمنته وزر نسخ.

منطقة Test — تبويبات Record وLive