حل المشاكلTroubleshooting

كل ما يحدث يُكتب في ملف السجل:

%LOCALAPPDATA%\Programs\KaldrivoAI\voice_assistant.log

افتحه من أيقونة البرنامج ← «السجل»، ثم Ctrl+F وابحث عن الكلمة المتعلقة بالمشكلة. في النسخة المحمولة (بدون مثبّت) شغّل run_debug.bat، فهو يعرض الأخطاء وآخر سطور السجل.

Everything that happens is written to the log file:

%LOCALAPPDATA%\Programs\KaldrivoAI\voice_assistant.log

Open it from the tray icon → “Log”, then Ctrl+F for a word related to the problem. In the portable (no-installer) edition, run run_debug.bat: it shows errors and the last lines of the log.

• الإعدادات ← الخصوصية والأمان ← الميكروفون ← فعّل «السماح لتطبيقات سطح المكتب».
• عدة ميكروفونات؟ اكتب جزءاً من اسم الميكروفون في "mic_device"، مثل "USB".
• تأكد من الإنترنت؛ التعرّف على الكلام يعمل عبره.

• Settings → Privacy & security → Microphone → turn on “Let desktop apps access your microphone”.
• Several mics? Put part of the mic’s name in "mic_device", e.g. "USB".
• Check the internet; speech recognition runs online.

في config.json: يستيقظ بسهولة زائدة ← ارفع clap.threshold إلى 0.3–0.45. لا يلتقط التصفيق ← اخفضه إلى 0.12–0.18. أو استخدم Ctrl+Alt+K أو «استيقظ».

In config.json: wakes too easily → raise clap.threshold to 0.3–0.45. Misses claps → lower it to 0.12–0.18. Or use Ctrl+Alt+K or “wake up”.

تحتاج إنترنت، وتأكد أن wake_word.enabled = true. قلها وحدها بوضوح، ثم انتظر الشريط.

It needs internet; check that wake_word.enabled is true. Say it on its own, clearly, then wait for the bar.

• الجوال واللابتوب على نفس الواي فاي (وليس بيانات الجوال).
• جدار حماية ويندوز: يجب أن يكون KaldrivoAI مسموحاً على الشبكات الخاصة. إذا رفضته بالخطأ: أمان ويندوز ← جدار الحماية وحماية الشبكة ← السماح لتطبيق عبر جدار الحماية ← فعّل KaldrivoAI على Private.
• اجعل شبكة الواي فاي في البيت «خاصة» (Private) من إعدادات الشبكة.
• امسح رمز QR من جديد بعد إعادة تشغيل البرنامج.

• Phone and laptop on the same Wi-Fi (not mobile data).
• Windows Firewall must allow KaldrivoAI on Private networks. If you declined by mistake: Windows Security → Firewall & network protection → Allow an app through firewall → tick KaldrivoAI for Private.
• Set your home Wi-Fi network profile to Private in network settings.
• Scan the QR code again after the app restarts.

منفذ تصحيح الأخطاء اللاسلكي يتغيّر بعد إعادة تشغيل الجوال أو تغيير الشبكة. KaldrivoAI يعيد المحاولة ويبحث عن الجوال على الشبكة تلقائياً؛ إذا لم يجده، كرر خطوات الربط.

Wireless debugging changes its port after a phone reboot or Wi-Fi change. KaldrivoAI retries and searches for the phone on the network by itself; if it can’t find it, repeat the pairing steps.

• تأكد أن الكاميرا ترى يدك، والإضاءة جيدة.
• جوال ككاميرا: التطبيق شغّال (Start server)، ونفس الواي فاي، والرابط ينتهي بـ /video.
• ابحث في السجل عن hand mouse؛ إذا ظهر أنه غير متاح، فنسختك لا تتضمن مكوّن الكاميرا. تواصل معنا.

• Make sure the camera can see your hand, in good light.
• Phone as camera: the app is running (Start server), same Wi-Fi, and the address ends in /video.
• Search the log for hand mouse; if it says unavailable, your build doesn’t include the camera component — contact us.

النسخة التجريبية غير موقّعة رقمياً بعد. «Windows protected your PC» ← More info ← Run anyway. إذا حذف Defender الملف بالخطأ، استعده من سجل الحماية في أمان ويندوز.

The beta isn’t code-signed yet. “Windows protected your PC” → More info → Run anyway. If Defender removed it by mistake, restore it from Protection history in Windows Security.

أضف مفتاحك (الطريقة) وأعد تشغيل البرنامج. إذا كان المفتاح موجوداً، ابحث في السجل عن gemini أو research:.

Add your key (how) and restart the app. If a key is there, search the log for gemini or research:.

راسلنا على anasdesign1990@gmail.com مع وصف المشكلة وآخر سطور السجل. احذف مفتاحك من أي ملف ترسله.

Email anasdesign1990@gmail.com with what happened and the last lines of the log. Remove your key from anything you send.