← العودة الى التوثيق
دليل تثبيت macOS
سيرشدك هذا الدليل خلال تثبيت Sokuji على انظمة macOS. يتوفر Sokuji كمثبت .pkg غير موقع يتضمن برنامج تشغيل صوت افتراضي لقدرات معالجة صوت محسنة.
تحميل لنظام macOSمتطلبات النظام
- macOS 10.15 (Catalina) او احدث
- معالج Apple Silicon (M1/M2/M3/M4) او Intel (x86_64)
- 4 جيجابايت رام كحد ادنى (8 جيجابايت موصى بها)
- 200 ميجابايت مساحة قرص متاحة
- صلاحيات المسؤول (مطلوبة لتثبيت برنامج تشغيل الصوت الافتراضي)
- اتصال بالانترنت لخدمات الترجمة بالذكاء الاصطناعي
- ميكروفون ومكبرات صوت/سماعات
خطوات التثبيت
الخطوة 1: تحميل Sokuji
قم بزيارة صفحة الاصدارات الرسمية على GitHub لتحميل احدث اصدار من Sokuji لنظام macOS.
تحميل مثبت PKG
- Sokuji-x.x.x-arm64.pkg - لاجهزة Mac بمعالج Apple Silicon (M1/M2/M3/M4)
- Sokuji-x.x.x-x64.pkg - لاجهزة Mac بمعالج Intel
- يتضمن كل مثبت تطبيق Sokuji وبرنامج تشغيل الصوت الافتراضي
- حجم الملف حوالي 150-200 ميجابايت
نصيحة: غير متاكد من الاصدار المناسب؟ انقر على قائمة Apple () ← "حول هذا الـ Mac" للتحقق من نوع المعالج. اذا رايت "Apple M1/M2/M3/M4"، اختر اصدار arm64. اذا رايت "Intel"، اختر اصدار x64.
مثبت PKG غير موقع، مما يعني انك ستحتاج الى اتخاذ خطوات خاصة لتثبيته (موضح في الخطوة التالية).
الخطوة 2: التحضير للتثبيت
نظرا لان مثبت PKG غير موقع، سيحظره macOS افتراضيا. تحتاج الى ازالة سمة الحجر الصحي قبل التثبيت.
ازالة سمة الحجر الصحي (مطلوب)
- افتح Terminal (التطبيقات ← الادوات المساعدة ← Terminal)
- اكتب او الصق الامر التالي (استبدل x.x.x برقم الاصدار):
sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-arm64.pkg
لاجهزة Mac بمعالج Intel، استخدم:sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-x64.pkg - اضغط Enter وادخل كلمة مرور المسؤول عند المطالبة
- سيكتمل الامر بصمت (عدم وجود مخرجات يعني النجاح)
ماذا يفعل هذا؟ يزيل هذا الامر علامة الحجر الصحي التي يضيفها macOS للملفات المحملة. انه آمن وضروري لمثبتات PKG غير الموقعة.
هذه الخطوة حاسمة! بدون ازالة سمة الحجر الصحي، لن يتمكن مثبت PKG من الفتح او التثبيت.
الخطوة 3: تثبيت PKG
الآن بعد تحضير المثبت، يمكنك تثبيت Sokuji وبرنامج تشغيل الصوت الافتراضي.
عملية التثبيت
- حدد موقع ملف
.pkgالمحمل في مجلد التنزيلات (مثلSokuji-x.x.x-arm64.pkgاوSokuji-x.x.x-x64.pkg) - انقر نقرا مزدوجا على ملف PKG لبدء التثبيت
- سيفتح مثبت macOS - انقر على "متابعة" للمتابعة
- راجع تفاصيل التثبيت وانقر على "تثبيت"
- ادخل كلمة مرور المسؤول عند المطالبة (مطلوبة لتثبيت برنامج التشغيل)
- انتظر حتى يكتمل التثبيت (عادة 1-2 دقيقة)
- انقر على "اغلاق" عند انتهاء التثبيت
ما يتم تثبيته
- Sokuji.app - يتم تثبيته في /Applications
- SokujiVirtualAudio.driver - برنامج تشغيل الصوت الافتراضي يتم تثبيته في /Library/Audio/Plug-Ins/HAL
- سيقوم المثبت تلقائيا باعادة تشغيل CoreAudio لتحميل برنامج التشغيل
كلمة مرور المسؤول مطلوبة لان المثبت يحتاج الى تثبيت برنامج تشغيل صوت على مستوى النظام. يمكّن برنامج تشغيل الصوت الافتراضي ميزات معالجة الصوت المتقدمة.
الخطوة 4: التشغيل الاول
بعد التثبيت، قد تحتاج الى منح Sokuji اذن التشغيل لانه تم تحميله من خارج App Store.
فتح Sokuji لاول مرة
- انتقل الى مجلد التطبيقات
- ابحث عن Sokuji في القائمة
- انقر بزر الماوس الايمن (او Control-انقر) على Sokuji
- حدد "فتح" من القائمة السياقية
- عند ظهور مربع حوار الامان، انقر على "فتح" للتاكيد
ملاحظة: اذا اكملت الخطوة 2 بشكل صحيح، قد لا ترى اي تحذيرات امنية.
طريقة بديلة
اذا استمر macOS في حظر Sokuji:
- افتح تفضيلات النظام ← الامان والخصوصية
- انتقل الى علامة التبويب عام
- يجب ان ترى رسالة حول حظر Sokuji
- انقر على "فتح على اي حال"
يظهر تحذير الامان هذا فقط عند التشغيل الاول. بعد ذلك، يمكنك فتح Sokuji بشكل طبيعي من Launchpad او التطبيقات.
الخطوة 5: تكوين Sokuji
الآن بعد تشغيل Sokuji، لنقم بتكوينه للاستخدام الاول:
الاعداد الاولي
- امنح اذونات الميكروفون عندما يطلب macOS ذلك
- حدد لغة الواجهة المفضلة لديك
- اختر مزود الذكاء الاصطناعي (OpenAI، Google Gemini، الخ.)
- ادخل مفتاح API للمزود المحدد
- حدد لغات المصدر والهدف للترجمة
- اختر اجهزة الصوت (يجب ان ترى "Sokuji Virtual Audio" في القائمة)
- اختبر اعداد الميكروفون ومكبرات الصوت
تهانينا! Sokuji جاهز الآن للاستخدام. تم تثبيت برنامج تشغيل الصوت الافتراضي وهو متاح في قائمة اجهزة الصوت. انقر على زر الميكروفون لبدء الترجمة في الوقت الفعلي.
استكشاف الاخطاء واصلاحها
"الحزمة تالفة ولا يمكن فتحها" او PKG لا يتم تثبيته
يحدث هذا عندما لم تتم ازالة سمة الحجر الصحي من ملف PKG:
- افتح Terminal (التطبيقات ← الادوات المساعدة ← Terminal)
- نفذ:
sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-*.pkg - ادخل كلمة المرور عند المطالبة
- حاول تثبيت PKG مرة اخرى
"لا يمكن فتح Sokuji لانه من مطور غير معروف"
يحدث هذا اذا لم تقم بتشغيل امر xattr قبل التثبيت:
- انقر بزر الماوس الايمن على تطبيق Sokuji في التطبيقات
- حدد "فتح" من القائمة
- انقر على "فتح" في مربع الحوار الذي يظهر
الميكروفون لا يعمل
اذا لم يتمكن Sokuji من الوصول الى الميكروفون:
- افتح تفضيلات النظام ← الامان والخصوصية ← الخصوصية
- حدد الميكروفون من الشريط الجانبي الايسر
- تاكد من ان Sokuji محدد في القائمة
- اذا لم يكن مدرجا، اعد تشغيل Sokuji وامنح الاذن عند المطالبة
لا يوجد اخراج صوتي
اذا لم تتمكن من سماع الصوت المترجم:
- افتح تفضيلات النظام ← الصوت ← الاخراج
- حدد جهاز الاخراج المفضل لديك
- تحقق من ان حجم الاخراج غير مكتوم
- في Sokuji، تحقق من ان جهاز الاخراج الصحيح محدد
التطبيق يتعطل على اجهزة Mac بمعالج Intel او مشاكل في الاداء
تاكد من تحميل المثبت الصحيح لجهاز Mac الخاص بك:
- Apple Silicon (M1/M2/M3/M4): استخدم
Sokuji-x.x.x-arm64.pkg - Intel: استخدم
Sokuji-x.x.x-x64.pkg - تحقق من نوع المعالج: قائمة Apple () ← "حول هذا الـ Mac"
- اذا استخدمت المثبت الخاطئ، حمل الاصدار الصحيح من صفحة الاصدارات
- اذا استمرت الاعطال مع المثبت الصحيح، تحقق من Console.app لسجلات الاعطال وابلغ عنها على GitHub
برنامج تشغيل الصوت الافتراضي لا يظهر
اذا لم ترَ "Sokuji Virtual Audio" في اجهزة الصوت:
- تحقق مما اذا كان برنامج التشغيل مثبتا:
ls /Library/Audio/Plug-Ins/HAL/ - اذا لم يكن موجودا، قد تحتاج الى اعادة تثبيت Sokuji
- اذا كان موجودا، حاول اعادة تشغيل CoreAudio:
sudo killall coreaudiod - تحقق من تفضيلات النظام ← الصوت لمعرفة ما اذا كان الجهاز يظهر
التثبيت يتطلب كلمة مرور المسؤول
هذا طبيعي ومطلوب:
- يحتاج مثبت PKG الى تثبيت برنامج تشغيل صوت على مستوى النظام
- تتطلب برامج تشغيل الصوت على مستوى النظام صلاحيات المسؤول للتثبيت
- ادخل كلمة المرور عند المطالبة - هذا آمن ومتوقع
- اذا لم يكن لديك صلاحيات المسؤول، اتصل بمسؤول النظام