الأسئلة الشائعة واستكشاف الأخطاء
حلول المشكلات الشائعة في الاتصال، قفل المستمع، وتشغيل سطح المكتب عن بُعد.
هل يفتح هذا الجسر أي منفذ وارد على الإنترنت؟#
لا. يعتمد الجسر كلياً على اتصالات HTTPS صادرة نحو واجهة ديسكورد (API v10) وعلى خدمة systemd محلية فقط. لا يوجد أي خادم ويب يستمع للخارج ولا منافذ مفتوحة في الجدار الناري.
لماذا لا يقرأ البوت رسائلي رغم ظهوره «متصلاً»؟#
تحقّق من نقطتين في بوابة مطوّري ديسكورد (Discord Developer Portal):
1. تفعيل خيار Message Content Intent تحت إعدادات Bot.
2. تطابق user_id وguild_id وchannel_id في ~/.gemini/config/discord_config.json مع خادمك الخاص؛ إذ يتجاهل المستمع أي حساب غير مصرّح له حمايةً لأمن محطة العمل.
ماذا يحدث إذا أرسلت رسالة أثناء تشغيل مهمة أمامية وأخرى في الخلفية؟#
ينفّذ discord_listener.py نظام تناوب تعاوني عبر ملف القفل (discord_sync.lock ودالة has_active_foreground_listener()): تتنازل خدمة systemd الخلفية فوراً لصالح المستمع الأمامي في الجلسة النشطة كي يصلك الرد داخل سياق الجلسة نفسها دون تعارض أو تكرار، ثم تستأنف الخلفية المراقبة بعد انتهاء الجلسة.
ماذا لو كانت واجهة Antigravity Desktop مغلقة تماماً؟#
أرسل !open من ديسكورد — أو أرسل رسالتك مباشرة:
1. يحاول discord_manager.py أولاً تشغيل واجهة سطح المكتب عبر إعادة بناء بيئة العرض (DISPLAY, WAYLAND_DISPLAY, XDG_RUNTIME_DIR, DBUS_SESSION_BUS_ADDRESS).
2. وإذا تعذّر الوصول إلى خادم اللغة خلال المهلة المحددة، يتراجع الجسر تلقائياً إلى تشغيل الجلسة عبر agy CLI الصامت مع إخطارك في الثريد نفسه حتى لا تفقد أي رسالة.
كيف أتأكّد أن رسائلي الإنجليزية تبقى بمحاذاة اليسار (LTR) حتى لو كان اسم الثريد عربياً؟#
الإصدار الحالي يطبّق فحصاً ثنائي المرحلة:
1. في التوجيه العام (GEMINI.md)، يقتبس الوكيل الأسئلة الإنجليزية بترويسة إنجليزية ويفصل الترويسة عن نص السؤال بسطر > فارغ.
2. في discord_hook.py، تفصل دالة _normalize_discord_quote_blocks() ترويسة الاقتباس عن جسم السؤال وتحقن محرف LRM (\u200E) في اقتباسات الإنجليزية، بينما تحفظ محارف RLM (\u200F) للسطور العربية دون أي تدخّل داخل المقاطع البرمجية.