حل المشكلات

حلول لأكثر المشكلات شيوعًا في تشغيل التطبيق، وتحذيرات ماك وويندوز، واتصال الإضافة، والبحث عبر الإنترنت.

ينطبق على: سطح المكتب 0.1 · الإضافة 0.1

التطبيق لا يعمل

• إذا ظهرت رسالة «تعذّر تشغيل Nishio» فاضغط «فتح مجلد السجلات». تشرح ملفات السجل ما حدث، فاحتفظ بها إن أردت الإبلاغ عن المشكلة.
• إذا ظهرت رسالة «توقفت خدمة خلفية بشكل غير متوقع» فاختر «إعادة تشغيل Nishio».
• الشريط الأحمر الذي يقول «تعذّر الاتصال بالخدمة المحلية. شغّل نيشيو وأعد المحاولة.» يعني أن النافذة فقدت الاتصال بالخدمة المحلية؛ اضغط زر التحديث، أو أغلق التطبيق وافتحه من جديد.
• في لينكس، إن لم يفتح ملف AppImage فتأكد أنه قابل للتشغيل (chmod +x). وتحتاج بعض التوزيعات إلى دعم FUSE لتشغيل ملفات AppImage، ويمكنك استخدام حزمة ‎.deb‎ بديلًا.

تحذيرات ماك وويندوز

• طلب سلسلة المفاتيح في التشغيل الأول: اختر «Always Allow». إن رفضته فقد يتعذر لاحقًا قراءة المفاتيح المحفوظة («تعذّر فك تشفير المفاتيح المحفوظة على هذا الجهاز»)، وعندها احذف المفتاح من «الإعدادات والفريق» وأضفه من جديد.
• Gatekeeper: إن رفض ماك فتح التطبيق لأنه لا يستطيع التحقق منه، فافتح System Settings ← Privacy & Security واضغط «Open Anyway»، أو اضغط على التطبيق مع Control واختر Open.
• SmartScreen في ويندوز: اضغط «More info» ثم «Run anyway». نسخة ويندوز غير موقّعة رقميًا حتى الآن.

الإضافة لا تتصل بالتطبيق

• يستخدم التطبيق العنوان 127.0.0.1:4310 عندما يكون المنفذ متاحًا. فإن كان برنامج آخر يستخدمه، يختار نيشيو منفذًا آخر متاحًا، ويجب أن يشير «عنوان API المحلي» في الإضافة إليه. ولا يعرض التطبيق المنفذ البديل بعد، لذا فأبسط حل هو إغلاق البرنامج الذي يستخدم المنفذ 4310 ثم إعادة تشغيل نيشيو.
• «تحتاج مزامنة التطبيق الاختيارية إلى إعادة الاقتران»: انتهت صلاحية الساعة أو أُغلق المتصفح. أنشئ رمزًا جديدًا لمرة واحدة وأعد الربط.
• «افتح الصفحة الرئيسية أو البحث أو فيديو أو Shorts أو قناة في YouTube»: الإضافة لا تقرأ إلا يوتيوب. وإن ثبّتها للتو فأعد تحميل تبويب يوتيوب وانتظر اكتمال عرض الصفحة.

البحث عبر الإنترنت والحصة

• «البحث الرسمي عبر الإنترنت يحتاج مفتاح YouTube API الخاص بك»: أضف مفتاحًا من «الإعدادات والفريق» ← «حسابات YouTube API». باقي التطبيق يعمل بدونه.
• «هذا لا يبدو مفتاح YouTube API»: انسخ المفتاح كاملًا من Google Cloud ← Credentials.
• «وصل المشروع إلى الميزانية المحلية أو حد YouTube»: انتظر التجديد عند منتصف الليل بتوقيت المحيط الهادئ، أو اطلب زيادة الحصة من Google. تبقى البيانات المحفوظة متاحة.

البدء من جديد

1. أنشئ نسخة احتياطية («الإعدادات والفريق» ← «إنشاء نسخة احتياطية موثقة») وانسخها إلى مكان آمن.
2. أغلق نيشيو.
3. أعد تسمية مجلد البيانات أو احذفه: ‎~/Library/Application Support/Nishio‎ في ماك، و‎%APPDATA%\Nishio‎ في ويندوز، و‎~/.config/Nishio‎ في لينكس.
4. افتح نيشيو مرة أخرى، وسيبدأ من جديد بشاشة الإعداد.