البدء مع SL5 Aura¶

المتطلبات الأساسية: لقد أكملت البرنامج النصي للإعداد وقمت بتكوين مفتاح التشغيل السريع الخاص بك. إذا لم يكن الأمر كذلك، راجع Installation section in README.md.

---

الخطوة 0: قم بتكوين مفتاح التشغيل السريع الخاص بك¶

                    اختر النظام الأساسي الخاص بك:

Linux/macOS — قم بتثبيت CopyQ وأنشئ أمرًا باستخدام اختصار عام:

touch /tmp/sl5_record.trigger

Windows — استخدم AutoHotkey v2 أو CopyQ. يتم تثبيت البرنامج النصي للإعداد تلقائيًا. ملف التشغيل هو: c:\tmp\sl5_record.trigger

                             > التفاصيل الكاملة: [README.md#configure-your-hotkey](../../README.i18n/README-arlang.md#configure-your-hotkey)

                               ## الخطوة 1: إملاءك الأول

ابدأ تشغيل Aura (إذا لم يكن قيد التشغيل بالفعل):
```
./scripts/restart_venv_and_run-server.sh
```

انتظر صوت بدء التشغيل — وهذا يعني أن Aura جاهزة.

انقر فوق أي حقل نصي (المحرر، المتصفح، المحطة الطرفية).
اضغط على مفتاح التشغيل السريع الخاص بك، وقل “Hello World”، ثم اضغط على مفتاح التشغيل السريع مرة أخرى. 4. شاهد النص يظهر.

لم يحدث شيء؟ تحقق من وجود أخطاء في log/aura_engine.log. الإصلاح الشائع لنظام CachyOS/Arch: sudo pacman -S mimalloc

                                                                      ---

       ## الخطوة الثانية: اكتب قاعدتك الأولى

                  أسرع طريقة لإضافة قاعدة شخصية:

         1. افتح `config/maps/plugins/sandbox/de-DE/FUZZY_MAP_pre.py`
                   2. أضف قاعدة داخل `FUZZY_MAP_pre = [...]`:

('Hello World', r'hello world', 0, {'flags': re.IGNORECASE})
#  ^ output        ^ pattern        ^ threshold (ignored for regex)

حفظ — تتم إعادة تحميل Aura تلقائيًا. لا حاجة لإعادة التشغيل.
قم بإملاء عبارة “hello World” وشاهدها تصبح “Hello World”.

راجع docs/FuzzyMapRuleGuide.md للحصول على مرجع القاعدة الكامل.

                ### أوما مودوس (اختصار للمبتدئين)

لا تعرف التعبير العادي حتى الآن؟ لا مشكلة.

  1. افتح أي `FUZZY_MAP_pre.py` فارغ في وضع الحماية

اكتب فقط كلمة واضحة في السطر الخاص بها (بدون علامات الاقتباس، بدون صف):
```
raspberry
```
حفظ — يكتشف نظام الإصلاح التلقائي الكلمة المجردة تلقائيًا يحوله إلى إدخال قاعدة صالح. 4. يمكنك بعد ذلك تحرير النص البديل يدويًا.

وهذا ما يسمى Oma-Modus — وهو مصمم للمستخدمين الذين يريدون الحصول على نتائج بدونها تعلم ريكس أولا.

                                                                      ---

                                   ## الخطوة 3: تعلم مع Koans

Koans عبارة عن تمارين صغيرة يعلم كل منها مفهومًا واحدًا. إنهم يعيشون في configmaps/koans deutsch/ وconfigmaps/koans english/.

                                                         ابدأ هنا:

                                   | المجلد | ماذا تتعلم |
                                                                |---|---|

يحتوي كل مجلد koan على FUZZY_MAP_pre.py مع الأمثلة المعلقة. قم بإلغاء التعليق على القاعدة، ثم احفظها، ثم قم بإملاء عبارة التشغيل - تم.

                                                                      ---

                                 ## الخطوة 4: المضي قدمًا

                                                    | ماذا | أين |
                                                                |---|---|
 | مرجع القاعدة الكاملة | `docs/FuzzyMapRuleGuide.md` |