جسر ديسكورد لمحطة العمل
English GitHub

الرئيسية الدردشة المباشرة ومعالجة الاتجاه الثنائي (RTL/LTR)

الدردشة المباشرة ومعالجة الاتجاه الثنائي (RTL/LTR)

كيف يعالج الجسر اللغة العربية والإنجليزية في وقت واحد، ويدير الاقتباسات، والمرفقات الصوتية والنصية.

صُمّمت قناة المحادثة المباشرة لتعمل بالانسيابية نفسها التي تتحدّث بها مع زميل هندسي، سواء أكتبت بالعربية الخالصة أم بالإنجليزية أم بمزيج من العربية والمصطلحات التقنية والمسارات البرمجية.

التوجيه الحواري المباشر من تطبيق ديسكورد على الهاتف إرسال النتائج تلقائياً عند انتهاء الدور

كيف يحفظ الجسر اتجاه العربية والإنجليزية (RTL/LTR)؟#

أحد أشهر العيوب في الجسور النصية ثنائية اللغة أن يؤدي وسم أو ترويسة عربية واحدة قبل سؤال إنجليزي إلى قلب محاذاة السؤال الإنجليزي نحو اليمين (RTL)، أو أن تفسد محارف الاتجاه الخفية (\u200E / \u200F) الأوامر البرمجية عند نسخها من الهاتف.

يعالج discord_hook.py هذه المشكلة عبر خمس آليات دقيقة:

  1. التعرّف الذكي على لغة الفقرة (is_arabic_text): - يزيل علامات الاقتباس البرمجي `...` ووسوم HTML والروابط وبدايات القوائم (>, -, #, 1.) قبل فحص أول حرف اتجاهي قوي وفق معيار Unicode UAX #9. - يعتمد معيار التعرّف التسميات الإنجليزية المعروفة (Discord, Question, Prompt, Attached, Voice, Note, Warning, Error) بوصفها LTR حتى لو تضمّن السطر عنواناً عربياً داخل الثريد، ولا يصنّف السطر عربياً إلا إذا بدأ بحرف عربي أو غلبت فيه العربية بأكثر من الضعف.
  2. فصل ترويسة الاقتباس عن جسم السؤال (_normalize_discord_quote_blocks): - في Markdown (CommonMark / GFM)، يؤدي سطران متتاليان من نوع > بدون سطر > فارغ بينهما إلى دمجهما في فقرة <p> واحدة ترث اتجاه أول حرف! - يفرض الجسر وجود سطر > فارغ بين ترويسة الاقتباس ونص السؤال المقتبس:
    • للسؤال الإنجليزي: > **Discord — \` (``):**يتبعه>ثم> ""`.
    • للسؤال العربي: > **سؤال من ديسكورد — \<الثريد>` (`<الكاتب>`):**يتبعه>ثم> "نص السؤال"`.
    • كما يصحّح discord_hook.py تلقائياً أي ترويسة عربية أُرسلت سهواً فوق سؤال إنجليزي ويحوّلها إلى ترويسة إنجليزية.
  3. حقن محارف العزل في الاقتباسات فقط دون لمس الشيفرة: - يضيف LRM (\u200E) بعد علامة > في اقتباسات الإنجليزية حتى لا تتأثر باتجاه ثريد عربي أو رسالة سابقة. - يضيف RLM (\u200F) وعزل LRM`code`RLM على السطور العربية خارج المقاطع البرمجية. - لا يلمس أبداً محتوى `...` ولا كتل ```...``` حتى تظل الأوامر والرموز صالحة للنسخ واللصق.

استيعاب الرسائل الصوتية والصور والمرفقات النصية#

عندما ترسل وسائط عبر ديسكورد: - الصوتيات (.ogg, .m4a, .mp3, .wav) والصور (.png, .jpg, .webp): تُنزَّل إلى مجلّد مؤقت معزول وتُمرَّر للوكيل بصيغة روابط file:// محلية ليسمعها أو يقرأها متعددَ الوسائط. - الملفات النصية والبرمجية (.txt, .md, .json, .csv, .yaml, .yml, .py, .sh, .log): يقرأ discord_listener.py محتواها حتى 30 KB ويحقنه تلقائياً داخل نص الرسالة بين محدّدات واضحة (--- Content of \file` ---)، مما يوفّر على الوكيل جولة كاملة من قراءة الملفات. - **عودة المخرجات**: أي صورة أو مخطّط أو ملفPDFيولّده الوكيل ويُشير إليه في الرد (حتى20 MB) يرفعهdiscord_hook.py` تلقائياً داخل خيط المحادثة نفسه.

اقرأ الدليل المختصر على GitHub