             # ⬟ SL5 Aura - صوتك. القواعد الخاصة بك.

غير متصل بالإنترنت بنسبة 100%، إطار عمل المساعد الصوتي الذي يولي الأولوية للخصوصية.XSPACEbreakX حدد بالضبط ما يفعله صوتك - من كلمة واحدةXSPACEbreakX إلى نصوص بايثون الكاملة. لا سحابة. لا توجد بيانات تترك جهازك.XSPACEbreakX يعمل في المحطة الطرفية، أو المتصفح، أو كخدمة خلفية - على Linux، وmacOS، وWindows.

       | 👵 مبتدأ | 🎓 المتعلم | 🧑u200d💻 مطور |
                                                            |---|---|---|

| وضع OMA: فقط اكتب كلمة واحدة، وستقوم Aura بالباقي | تعلم مع Koans - مفهوم واحد في كل مرة | البرمجة النصية الكاملة لبايثون، والمكونات الإضافية، واستدعاءات واجهة برمجة التطبيقات | | 🗄️ إدارة الدولة | تنسيق Trino + Airflow، fzf، CopyQ، الأوامر الصوتية/الطرفية، واجهات مستخدم المتصفح |

⚡ ~2.87 J لكل اختبار (39 اختبارًا بمتوسط 0.34 ثانية · تم القياس باستخدام Eco-CI) · لا يوجد حساب سحابي

                                                       <التفاصيل>
                               <summary>البدء السريع</summary>

                                                 ## بداية سريعة
       1. قم بتنزيل هذا المستودع أو استنساخه

قم بتشغيل البرنامج النصي للإعداد لنظام التشغيل لديك (راجع مجلد “الإعداد/”): - Linux (Arch/Manjaro): bash setup/manjaro_arch_setup.sh ===> 🧩 اقرأ docs/LINUX_WAYLAND_dotool - Linux (Ubuntu/Debian): bash setup/ubuntu_setup.sh - Linux (openSUSE): bash setup/suse_setup.sh

Linux (NixOS): nix-shell setup/shell.nix ثم bash setup/nixos_setup.sh. ===> ⚠️ تجريبي — لم يتم اختباره من قبل المؤلفين، نرحب بالتعليقات! اكس سبيس بريك اكس - نظام التشغيل macOS: bash setup/macos_setup.sh - ويندوز: setup/windows11_setup_with_ahk_copyq.bat 3. ابدأ Aura: ./scripts/restart_venv_and_run-server.sh

اضغط على مفتاح التشغيل السريع وتحدث — full guide →

               **⚠️ متطلبات النظام والتوافق**

Windows: ✅ مدعوم بالكامل (يستخدم AutoHotkey/PowerShell). * macOS: ✅ مدعوم بالكامل (يستخدم AppleScript). * Linux (X11/Xorg): ✅ مدعوم بالكامل.
Linux (Wayland): ✅ مدعوم بالكامل (تم اختباره على KDE Plasma 6 / Wayland).
Linux (إصدار متجدد قائم على CachyOS / Arch): ✅ مدعوم بالكامل. يتطلب mimalloc (sudo pacman -S mimalloc) بسبب توافق glibc 2.43.
Linux (NixOS): 🧪 تجريبي — إعداد ساهم به المجتمع، ولم يتم اختباره بعد. إذا حاولت ذلك، يرجى فتح قضية أو العلاقات العامة مع النتائج التي توصلت إليها! اكس سبيس بريك اكس
Linux (Manjaro): جديد / تجريبي: يفتح مفتاح التشغيل السريع على مستوى النظام واجهة تعتمد على لوحة المفاتيح تشبه fzf حتى تتمكن من تشغيل أوامر Aura من أي مكان على سطح المكتب (منفصلة تمامًا عن النافذة النشطة). يتم حاليًا تنفيذ واختبار هذا المشغل الذي يعتمد على مفتاح التشغيل السريع على Linux (Manjaro)؛ قد تعمل توزيعات أخرى ولكنها تتطلب الإعداد. انظر في 👉 docs/Feature_Spotlight/CopyQ_Shortcut_Super_s.md XSPACEbreakX
```
                                        اكس سبيس بريك اكس
```

SL5 Aura عبارة عن مساعد صوتي متكامل غير متصل بالإنترنت مبني على Vosk (لتحويل الكلام إلى نص) وLanguageTool (للقواعد النحوية/الأسلوب)، ويتميز بوظيفة احتياطية Local LLM (Ollama) اختيارية للاستجابات الإبداعية والمطابقة الغامضة المتقدمة. إنه يحول صوتك إلى إجراءات ونص دقيق، مصمم للتخصيص النهائي من خلال نظام قواعد قابل للتوصيل ومحرك برمجة نصية ديناميكي. اكس سبيس بريك اكس الترجمات: هذا المستند موجود أيضًا في other languages.

ملاحظة: العديد من النصوص عبارة عن ترجمات تم إنشاؤها آليًا للوثائق الإنجليزية الأصلية وهي مخصصة للإرشاد العام فقط. وفي حالة وجود تناقضات أو غموض، فإن النسخة الإنجليزية هي التي تسود دائمًا. نحن نرحب بالمساعدة من المجتمع لتحسين هذه الترجمة!

                                                      </التفاصيل>

                                                       <التفاصيل>
                                   <summary>عرض توضيحي</summary>

                        ### 📺 العرض التجريبي للمحطة

نصيحة: للحصول على تجربة طرفية أفضل، راجع Zsh Integration.

                                         ### 🎥 فيديو تعليمي
                  [![SL5 Aura: HowTo crash SL5 Aura?](https://img.youtube.com/vi/BZCHonTqwUw/0.jpg)](https://www.youtube.com/watch?v=BZCHonTqwUw)

                                 *(الرابط البديل: [skipvids.com](https://skipvids.com/?v=BZCHonTqwUw))*

                                                      </التفاصيل>

                                                       <التفاصيل>
                       <summary>الميزات الرئيسية</summary>

                                       ## الميزات الرئيسية

خاص وغير متصل بالإنترنت: محلي 100%. لا توجد بيانات تترك جهازك على الإطلاق.
محرك البرمجة الديناميكية: تجاوز مجرد استبدال النص. يمكن للقواعد تنفيذ برامج Python النصية المخصصة (on_match_exec) لتنفيذ إجراءات متقدمة مثل استدعاء واجهات برمجة التطبيقات (على سبيل المثال، البحث في Wikipedia)، أو التفاعل مع الملفات (على سبيل المثال، إدارة قائمة المهام)، أو إنشاء محتوى ديناميكي (على سبيل المثال، تحية بريد إلكتروني تراعي السياق).
قواعد مدركة للسياق: تقييد القواعد على تطبيقات محددة. باستخدام only_in_windows، يمكنك التأكد من تشغيل القاعدة فقط إذا كان عنوان نافذة معين (على سبيل المثال، “Terminal” أو “VS Code” أو “Browser”) نشطًا. يعمل هذا عبر الأنظمة الأساسية (Linux وWindows وmacOS).
محرك التحويل عالي التحكم: ينفذ خط أنابيب معالجة يعتمد على التكوين وقابل للتخصيص بدرجة كبيرة. يتم تحديد أولوية القاعدة، واكتشاف الأوامر، وتحويلات النص بشكل كامل من خلال الترتيب التسلسلي للقواعد في الخرائط الغامضة، مما يتطلب التكوين، وليس الترميز.
الاستخدام المحافظ لذاكرة الوصول العشوائي: يدير الذاكرة بذكاء، ولا يتم تحميل النماذج مسبقًا إلا في حالة توفر ذاكرة وصول عشوائي كافية، مما يضمن الأولوية دائمًا للتطبيقات الأخرى (مثل ألعاب الكمبيوتر).
النظام الأساسي المشترك: يعمل على Linux وmacOS وWindows.
** مؤتمت بالكامل: ** يدير خادم LanguageTool الخاص به (ولكن يمكنك أيضًا استخدام خادم خارجي).
سرعة فائقة: يضمن التخزين المؤقت الذكي إشعارات “الاستماع…” الفورية والمعالجة السريعة.
إدارة الحالة الديناميكية عبر Trino: محرك تكوين مدرك للواجهة يفصل بين إعدادات “الكلام” و”المحطة الطرفية” و”الويب” - قم بتغيير الإعداد بدون تؤثر على الآخرين. يتضمن لوحة تحكم المشرف في الوقت الفعلي (المنفذ 8084). </التفاصيل>
```
                                                     <التفاصيل>
```

🔌 عمليات التكامل الجاهزة للاستخدام

اكس سبيس بريك اكس ## 🔌 عمليات التكامل الجاهزة للاستخدام

يأتي SL5-Aura مزودًا بنظام بيئي واسع يضم أكثر من 100+ مكون إضافي تم تكوينه مسبقًا. فيما يلي بعض النقاط البارزة:

                  ### التحكم الصوتي في OculiX / SikuliX IDE

يوفر SL5-Aura دعمًا صوتيًا من الدرجة الأولى لـ OculiX و SikuliX IDE. يتيح لك هذا التكامل “التحدث” برمز الأتمتة الخاص بك.

صوت إلى مقتطف: قل “انقر” أو “انتظر” أو “ابحث عن الكل”، وستقوم الخدمة على الفور بكتابة رمز Python الصحيح (على سبيل المثال، click("image.png")) في IDE.
التعرف على النوافذ: البرنامج المساعد حساس للسياق؛ يتم تنشيطه فقط عند التركيز على نافذة OculiX/SikuliX.
دعم اللغة الإنجليزية الذكية: مُحسَّن للعمل في “en-US” مع التركيز بشكل خاص على اللهجات غير الأصلية (مثل الصوتيات الألمانية-الإنجليزية)، مما يضمن دقة التعرف العالية للمجتمع العالمي.
قابل للتوسيع: يستخدم تنسيق FUZZY_MAP_pre.py سهل التحرير.

الحالة: تم الاعتراف به كمكون إضافي للمجتمع من قبل فريق OculiX (راجع Issue #204).

                            ### التحكم الصوتي LibreOffice IDE

                                       ### 0 م التحكم الصوتي

                                                                      ---

                                                      </التفاصيل>

                                                       <التفاصيل>
                                        <summary>التوثيق</summary>

                                                        ## التوثيق

للحصول على مرجع فني كامل، بما في ذلك جميع الوحدات والبرامج النصية، يرجى زيارة صفحة الوثائق الرسمية لدينا. يتم إنشاؤه تلقائيًا ويتم تحديثه دائمًا.

                                                           👉[**Go to Documentation sl5net.github.io/SL5-aura-service**](https://sl5net.github.io/SL5-aura-service/)


                                                ### حالة البناء
                                [![Linux Manjaro](https://img.shields.io/badge/Manjaro-Tested-27ae60?style=for-the-badge&logo=manjaro)](https://youtu.be/29xiwIW1ZHQ)

                        [![OculiX Compatible](https://img.shields.io/badge/OculiX-Compatible-blueviolet?style=for-the-badge&logo=python)](https://github.com/oculix-org/Oculix)
                                          <div محاذاة = "يسار">
         <a href="https://github.com/sl5net/SL5-aura-service/stargazers">

                                                      </التفاصيل>

                            👉 **اقرأ هذا بلغات أخرى:**

                                                                      ---

                                                       <التفاصيل>
                                        <summary>التثبيت</summary>

                                                            ## تثبيت

🎥 التثبيت السريع دون اعتدال (Manjaro/Arch Video)¶

شاهد عملية الإعداد الكاملة التي تستغرق 6 دقائق: * التحميل: ~3 دقائق

الإعداد والبدء الأول: ~3 دقائق (بما في ذلك معالج الترحيب)

                                                    👉 **[SL5 Aura Installation Live-Demo on YouTube](https://www.youtube.com/watch?v=29xiwIW1ZHQ)**

                      الإعداد هو عملية من خطوتين:

قم بتنزيل أحدث إصدار أو إصدار رئيسي ( https://github.com/sl5net/SL5-aura-service/archive/master.zip ) أو انسخ هذا المستودع على جهاز الكمبيوتر الخاص بك.
قم بتشغيل البرنامج النصي للإعداد لمرة واحدة لنظام التشغيل الخاص بك.

تتعامل نصوص الإعداد مع كل شيء: تبعيات النظام، وبيئة Python، وتنزيل النماذج والأدوات الضرورية (حوالي 4 جيجابايت) مباشرةً من إصدارات GitHub الخاصة بنا لتحقيق أقصى سرعة.

لنظام التشغيل Linux وmacOS وWindows (مع استثناء اللغة الاختياري)¶

لتوفير مساحة القرص وعرض النطاق الترددي، يمكنك استبعاد نماذج لغة محددة (de، en) أو كافة النماذج الاختيارية (all) أثناء الإعداد. يتم تضمين المكونات الأساسية (LanguageTool, Lid.176) دائمًا.

افتح محطة طرفية في الدليل الجذر للمشروع وقم بتشغيل البرنامج النصي لنظامك:

# For Ubuntu/Debian, Manjaro/Arch, macOS, or other derivatives
# (Note: Use bash or sh to execute the setup script)

bash setup/{your-os}_setup.sh [OPTION]

# For Arch-based systems (Manjaro, CachyOS, EndeavourOS, etc.):
`bash setup/manjaro_arch_setup.sh`

`sudo pacman -S mimalloc`


# Examples:
# Install everything (Default):
# bash setup/manjaro_arch_setup.sh

# Exclude German models:
# bash setup/manjaro_arch_setup.sh exclude=de

# Exclude all VOSK language models:
# bash setup/manjaro_arch_setup.sh exclude=all

# For Windows in an Admin-Powershell session

setup/windows11_setup.ps1 -Exclude [OPTION]

# Examples:
# Install everything (Default):
# setup/windows11_setup.ps1

# Exclude English models:
# setup/windows11_setup.ps1 -Exclude "en"

# Exclude German and English models:
# setup/windows11_setup.ps1 -Exclude "de,en"

# Or (recommend) - Run the BAT file: 
windows11_setup.bat -Exclude "en"

                                   #### لنظام التشغيل Windows

قم بتشغيل البرنامج النصي للإعداد بامتيازات المسؤول.

قم بتثبيت أداة للقراءة والتشغيل، على سبيل المثال، CopyQ أو AutoHotkey v2. وهذا مطلوب لمراقب كتابة النص.

يتم التثبيت تلقائيًا بالكامل ويستغرق حوالي 8-10 دقائق عند استخدام نموذجين على نظام جديد.

                          1. انتقل إلى مجلد "الإعداد".

انقر نقرًا مزدوجًا فوق windows11_setup_with_ahk_copyq.bat.

سيطالب البرنامج النصي تلقائيًا بامتيازات المسؤول.
يقوم بتثبيت النظام الأساسي، ونماذج اللغة، وAutoHotkey v2، وCopyQ.

بمجرد اكتمال التثبيت، سيتم تشغيل Aura Dictation تلقائيًا.

ملاحظة: لا تحتاج إلى تثبيت Python أو Git مسبقًا؛ البرنامج النصي يتعامل مع كل شيء.

                                                                      ---

                        #### التثبيت المتقدم / المخصص

إذا كنت تفضل عدم تثبيت أدوات العميل (AHK/CopyQ) أو تريد توفير مساحة القرص عن طريق استبعاد لغات معينة، فيمكنك تشغيل البرنامج النصي الأساسي عبر سطر الأوامر:

# Core Setup only (No AHK, No CopyQ)
setup/windows11_setup_with_ahk_copyq.bat

# Exclude specific language models (saves space):
# Exclude English:
setup/windows11_setup_with_ahk_copyq.bat -Exclude "en"

# Exclude German and English:
setup/windows11_setup_with_ahk_copyq.bat -Exclude "de,en"

                                                                      ---
                                                      </التفاصيل>

                                                       <التفاصيل>
                                    <summary>الاستخدام</summary>

                                                    ## الاستخدام

                                           ### 1. ابدأ الخدمات

                                                #### على Linux وmacOS

نص واحد يعالج كل شيء. يبدأ خدمة الإملاء الرئيسية ومراقب الملفات تلقائيًا في الخلفية.

# Run this from the project's root directory
./scripts/restart_venv_and_run-server.sh

                              #### على نظام التشغيل Windows

يتم بدء الخدمة عبر عملية يدوية مكونة من خطوتين:

** ابدأ الخدمة الرئيسية: ** قم بتشغيل start_aura.bat. أو ابدأ من .venv الخدمة باستخدام python3

2. قم بتكوين مفتاح التشغيل السريع الخاص بك¶

لتشغيل الإملاء، تحتاج إلى مفتاح تشغيل سريع عالمي يقوم بإنشاء ملف محدد. نوصي بشدة باستخدام الأداة المشتركة بين الأنظمة الأساسية CopyQ.

                                               #### توصيتنا: CopyQ

قم بإنشاء أمر جديد في CopyQ باستخدام اختصار عام.

                **الأوامر لنظام التشغيل Linux/macOS:**

touch /tmp/sl5_record.trigger

أمر لنظام التشغيل Windows عند استخدام CopyQ:

copyq:
var filePath = 'c:/tmp/sl5_record.trigger';

var f = File(filePath);

if (f.openAppend()) {
    f.close();
} else {
    popup(
        'error',
        'cant read or open:\n' + filePath
        + '\n' + f.errorString()
    );
}

أمر لنظام التشغيل Windows عند استخدام AutoHotkey:

; trigger-hotkeys.ahk
; AutoHotkey v2 Skript
#SingleInstance Force ; Stellt sicher, dass nur eine Instanz des Skripts läuft

;===================================================================
; Hotkey zum Auslösen des Aura Triggers
; Drücke Strg + Alt + T, um die Trigger-Datei zu schreiben.
;===================================================================
f9::
f10::
f11::
{
    local TriggerFile := "c:\tmp\sl5_record.trigger"
    FileAppend("t", TriggerFile)
    ToolTip("Aura Trigger ausgelöst!")
    SetTimer(() => ToolTip(), -1500)
}

                                          ### 3. ابدأ الإملاء!

انقر فوق أي حقل نصي، واضغط على مفتاح التشغيل السريع، وسيظهر إشعار “الاستماع…”. تحدث بوضوح، ثم توقف. سيتم كتابة النص المصحح لك.

                                                      </التفاصيل>

                                                                      ---

                                                       <التفاصيل>
        <summary>التكوين المتقدم (اختياري)</summary>

                        ## التكوين المتقدم (اختياري)

يمكنك تخصيص سلوك التطبيق عن طريق إنشاء ملف إعدادات محلي.

                             1. انتقل إلى الدليل `config/`.

قم بإنشاء نسخة من config/settings_local.py_Example.txt وأعد تسميتها إلى config/settings_local.py.
قم بتحرير config/settings_local.py (يتجاوز أي إعداد من ملف config/settings.py الرئيسي).

يتم تجاهل هذا الملف config/settings_local.py بواسطة Git افتراضيًا، لذلك لن يتم استبدال تغييراتك الشخصية بالتحديثات.

                ### بنية البرنامج الإضافي ومنطقه

تتيح نمطية النظام امتدادًا قويًا عبر الدليل plugins/.

يلتزم محرك المعالجة بشكل صارم بـ سلسلة الأولويات الهرمية:

ترتيب تحميل الوحدة (أولوية عالية): القواعد المحملة من حزم اللغات الأساسية (de-DE، en-US) لها الأولوية على القواعد المحملة من الدليل plugins/ (الذي يتم تحميله أخيرًا أبجديًا). اكس سبيس بريك اكس
الترتيب داخل الملف (الأولوية الدقيقة): داخل أي ملف خريطة محدد (FUZZY_MAP_pre.py)، تتم معالجة القواعد بدقة بواسطة رقم السطر (من الأعلى إلى الأسفل). اكس سبيس بريك اكس

تضمن هذه البنية حماية قواعد النظام الأساسية، في حين يمكن إضافة القواعد الخاصة بالمشروع أو القواعد المدركة للسياق (مثل تلك الخاصة بـ CodeIgniter أو عناصر التحكم في اللعبة) بسهولة كامتدادات ذات أولوية منخفضة عبر المكونات الإضافية.

                                                      </التفاصيل>

                                                       <التفاصيل>

النصوص البرمجية الأساسية لمستخدمي Windows

 ## البرامج النصية الأساسية لمستخدمي Windows

فيما يلي قائمة بأهم البرامج النصية لإعداد التطبيق وتحديثه وتشغيله على نظام Windows.

                                      ### الإعداد والتحديث

                                      * `chmod +x update.sh; ./update.sh`

setup/setup.bat: البرنامج النصي الرئيسي للإعداد الأولي للبيئة لمرة واحدة فقط.
or تشغيل powershell -Command "Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force; .\setup\windows11_setup.ps1"
update.bat: قم بتشغيل هذا من مجلد المشروع للحصول على الحصول على أحدث التعليمات البرمجية والتبعيات.
```
                                          ### تشغيل التطبيق
```

start_aura.bat: برنامج نصي أساسي لبدء خدمة الإملاء.

      ### البرامج النصية الأساسية والمساعد

aura_engine.py: خدمة Python الأساسية (تبدأ عادةً بواسطة أحد البرامج النصية أعلاه).

get_suggestions.py: برنامج نصي مساعد لوظائف محددة.

                                                    </التفاصيل>

🚀 الميزات الرئيسية والتوافق مع نظام التشغيل¶

                                                       <التفاصيل>

أسطورة التوافق مع نظام التشغيل

وسيلة الإيضاح للتوافق مع نظام التشغيل:XSPACEbreakX

🐧 Linux (على سبيل المثال، Arch وUbuntu)XSPACEbreakX * 🍏 macOSXSPACEbreakX * 🪟 ويندوزXSPACEbreakX

📱 Android (للميزات الخاصة بالهاتف المحمول)XSPACEbreakX

                                                                    ---

                                                    </التفاصيل>

المحرك الأساسي لتحويل الكلام إلى نص (Aura)¶

محركنا الأساسي للتعرف على الكلام ومعالجة الصوت دون اتصال بالإنترنت.

                                          اكس سبيس بريك اكس
                                                       <التفاصيل>
                                 <summary>هالة النواة</summary>

                    **هالة النواة/** 🐧 🍏 🪟XSPACEbreakX

├─ aura_engine.py (خدمة بايثون الرئيسية التي تنظم Aura) 🐧 🍏 🪟XSPACEbreakX ├┬ بث مباشر مباشر (التكوين والخرائط) 🐧 🍏 🪟XSPACEbreakX │├ تحميل خريطة خاصة آمنة (النزاهة أولاً) 🔒 🐧 🍏 🪟XSPACEbreakX ││ * سير العمل: يقوم بتحميل أرشيفات ZIP المحمية بكلمة مرور. اكس سبيس بريك اكس │├ معالجة النصوص وتصحيحها/ مجمعة حسب اللغة (على سبيل المثال، de-DE، en-US، …) XSPACEbreakX │├ 1. normalize_peptication.py (توحيد علامات الترقيم بعد النسخ) 🐧 🍏 🪟XSPACEbreakX │├ 2. التصحيح المسبق الذكي (FuzzyMap Pre - The Primary Command Layer) 🐧 🍏 🪟XSPACEbreakX ││ * تنفيذ البرنامج النصي الديناميكي: يمكن للقواعد تشغيل برامج Python النصية المخصصة (on_match_exec) لتنفيذ إجراءات متقدمة مثل استدعاءات واجهة برمجة التطبيقات، أو إدخال/إخراج الملفات، أو إنشاء استجابات ديناميكية.XSPACEbreakX ││ * التنفيذ المتتالي: تتم معالجة القواعد بشكل تسلسلي وتكون تأثيراتها تراكمية. تنطبق القواعد اللاحقة على النص الذي تم تعديله بواسطة القواعد السابقة.XSPACEbreakX ││ * معيار الإيقاف ذو الأولوية الأعلى: إذا حققت القاعدة تطابق كامل (^…$)، فسيتوقف مسار المعالجة بالكامل لهذا الرمز المميز على الفور. تعتبر هذه الآلية ضرورية لتنفيذ الأوامر الصوتية الموثوقة.XSPACEbreakX │├ 3. correct_text_by_languagetool.py (يدمج أداة اللغة لتصحيح القواعد النحوية/النمط) 🐧 🍏 🪟XSPACEbreakX │├ 4. محرك قواعد RegEx الهرمي مع تقنية Ollama AI الاحتياطية 🐧 🍏 🪟XSPACEbreakX ││ * التحكم الحتمي: يستخدم RegEx-Rule-Engine للأوامر الدقيقة ذات الأولوية العالية والتحكم في النص.XSPACEbreakX │├ المكون الإضافي لبحث المتجهات (التحميل البطيء): يتيح البحث الدلالي عن طريق ربط تضمينات Vector المحلية مع الطبقة الاحتياطية Ollama/LLM 🐧XSPACEbreakX ││ * Ollama AI (Local LLM) الاحتياطي: بمثابة فحص اختياري منخفض الأولوية لـ الإجابات الإبداعية، والأسئلة والأجوبة، والمطابقة الغامضة المتقدمة في حالة عدم استيفاء أي قاعدة حتمية.XSPACEbreakX ││ * الحالة: تكامل LLM محلي. │└ 5. التصحيح اللاحق الذكي (FuzzyMap)** – تحسين ما بعد LT** 🐧 🍏 🪟XSPACEbreakX ││ * يتم تطبيقه بعد LanguageTool لتصحيح المخرجات الخاصة بـ LT. يتبع نفس منطق الأولوية المتتالي الصارم مثل طبقة التصحيح المسبق.XSPACEbreakX ││ * تنفيذ البرنامج النصي الديناميكي: يمكن للقواعد تشغيل برامج Python النصية المخصصة (on_match_exec) لتنفيذ إجراءات متقدمة مثل استدعاءات واجهة برمجة التطبيقات (API)، أو إدخال/إخراج الملفات، أو إنشاء استجابات ديناميكية.XSPACEbreakX ││ * التراجع الضبابي: يعمل التحقق من التشابه الغامض (الذي يتم التحكم فيه بواسطة عتبة، على سبيل المثال، 85%) بمثابة طبقة تصحيح الأخطاء ذات الأولوية الأدنى. يتم تنفيذه فقط في حالة فشل تشغيل القاعدة الحتمية/المتتالية السابقة بالكامل في العثور على تطابق (القاعدة_الحالية_تطابق خطأ)، مما يؤدي إلى تحسين الأداء عن طريق تجنب عمليات التحقق البطيئة الغامضة كلما أمكن ذلك.
├┬ إدارة النماذج/ XSPACEbreakX │├─ prioritize_model.py (يعمل على تحسين تحميل/تفريغ النموذج بناءً على الاستخدام) 🐧 🍏 🪟XSPACEbreakX │└─ setup_initial_model.py (يقوم بتكوين إعداد النموذج لأول مرة) 🐧 🍏 🪟XSPACEbreakX ├─ مهلة التكيف VAD 🐧 🍏 🪟XSPACEbreakX ├─ مفتاح التشغيل السريع التكيفي (بدء/إيقاف) 🐧 🍏 🪟XSPACEbreakX ├─ التبديل الفوري للغة (تجريبي عبر التحميل المسبق للنموذج) 🐧 🍏XSPACEbreakX ├─ تنسيق تدفق الهواء (أتمتة سير العمل المستندة إلى DAG) 🐧 🍏 🪟 │ يتطلب Docker · واجهة المستخدم: http://localhost:8081 🐧 🍏 🪟XSPACEbreakX ├─ Trino State Engine (تكوين مدرك للواجهة لكل خطاب/محطة/ويب) 🐧 🍏 🪟 └─ يتطلب Docker · واجهة المستخدم الإدارية: http://localhost:8084 🐧 🍏 🪟XSPACEbreakX

                                         **SystemUtilities/**XSPACEbreakX
                ├┬ **إدارة خادم LanguageTool/** XSPACEbreakX

│├─ start_languagetool_server.py (تهيئة خادم LanguageTool المحلي) 🐧 🍏 🪟XSPACEbreakX │└─ stop_languagetool_server.py (إيقاف تشغيل خادم LanguageTool) 🐧 🍏 ├─ monitor_mic.sh (على سبيل المثال للاستخدام مع سماعة الرأس دون استخدام لوحة المفاتيح والشاشة) 🐧 🍏 🪟XSPACEbreakX

               ### **إدارة النماذج والحزم**XSPACEbreakX

أدوات للتعامل القوي مع نماذج اللغات الكبيرة.XSPACEbreakX

                **إدارة النماذج/** 🐧 🍏 🪟XSPACEbreakX

├─ أداة تنزيل النماذج القوية (أجزاء إصدار GitHub) 🐧 🍏 🪟XSPACEbreakX ├─ split_and_hash.py (أداة مساعدة لأصحاب الريبو لتقسيم الملفات الكبيرة وإنشاء مجاميع اختبارية) 🐧 🍏 🪟XSPACEbreakX └─ download_all_packages.py (أداة للمستخدمين النهائيين لتنزيل الملفات متعددة الأجزاء والتحقق منها وإعادة تجميعها) 🐧 🍏 🪟XSPACEbreakX

                                                      </التفاصيل>

                                                       <التفاصيل>
              <summary>مساعدو التطوير والنشر</summary>

             ### **مساعدو التطوير والنشر**XSPACEbreakX

البرامج النصية لإعداد البيئة والاختبار وتنفيذ الخدمة.XSPACEbreakX

نصيحة: يتيح لك glogg استخدام التعبيرات العادية للبحث عن الأحداث المثيرة للاهتمام في ملفات السجل الخاصة بك. XSPACEbreakX يرجى تحديد مربع الاختيار عند التثبيت لربطه بملفات السجل. اكس سبيس بريك اكس https://translate.google.com/translate?hl=en&sl=en&tl=ar&u=https://glogg.bonnefon.org/
اكس سبيس بريك اكس نصيحة: بعد تحديد أنماط التعبير العادي، قم بتشغيل python3 Tools/map_tagger.py لإنشاء أمثلة قابلة للبحث تلقائيًا لأدوات CLI. راجع Map Maintenance Tools للحصول على التفاصيل.

                             ثم ربما انقر نقرا مزدوجا
                                                "سجل/aura_engine.log".
                                          اكس سبيس بريك اكس
                                              **DevHelpers/**XSPACEbreakX
     ├┬ **إدارة البيئة الافتراضية/**XSPACEbreakX

│├ scripts/restart_venv_and_run-server.sh (Linux/macOS) 🐧 🍏XSPACEكسرX │└ scripts/restart_venv_and_run-server.ahk (Windows) 🪟XSPACEbreakX ├┬ **تكامل الإملاء على مستوى النظام/**XSPACEbreakX │├ تكامل Vosk-System-Listener 🐧 🍏 🪟XSPACEbreakX │├ scripts/monitor_mic.sh (مراقبة الميكروفون الخاصة بنظام التشغيل Linux) 🐧XSPACEbreakX │└ scripts/type_watcher.ahk (يستمع AutoHotkey للنص الذي يتم التعرف عليه ويكتبه على مستوى النظام) 🪟XSPACEbreakX └─ ** CI/CD Automation/**XSPACEbreakX └─ سير عمل GitHub الموسع (التثبيت والاختبار ونشر المستندات) 🐧 🍏 🪟 *(يعمل على إجراءات GitHub)*XSPACEbreakX

                                                      </التفاصيل>

                                                       <التفاصيل>
                     <summary>الميزات التجريبية</summary>
                                          اكس سبيس بريك اكس
   ### **الميزات القادمة / التجريبية**XSPACEbreakX

الميزات قيد التطوير حاليًا أو في حالة المسودة.XSPACEbreakX

                       **الميزات التجريبية/**XSPACEbreakX

├─ ENTER_AFTER_DICTATION_REGEX مثال لقاعدة التنشيط “(ExampleAplicationThatNotExist|Pi، الذكاء الاصطناعي الشخصي الخاص بك)” 🐧
├┬الإضافاتXSPACEbreakX │╰┬ Live Lazy-Reload (*) 🐧 🍏 🪟XSPACEbreakX (يتم تطبيق التغييرات التي تم إجراؤها على تنشيط/إلغاء تنشيط البرنامج المساعد وتكويناتها في عملية المعالجة التالية دون إعادة تشغيل الخدمة.)XSPACEbreakX │ ├ أوامر git (التحكم الصوتي لإرسال أوامر git) 🐧 🍏 🪟XSPACEbreakX │ ├ wannweil (خريطة الموقع ألمانيا-Wannweil) 🐧 🍏 🪟XSPACEbreakX │ ├ البرنامج المساعد للبوكر (مسودة) (التحكم الصوتي لتطبيقات البوكر) 🐧 🍏 🪟XSPACEbreakX │ └ 0 A.D. Plugin (مسودة) (التحكم الصوتي في لعبة 0 A.D) 🐧 XSPACEbreakX ├─ مخرج الصوت عند بدء الجلسة أو إنهائها (الوصف في انتظار المراجعة) 🐧 XSPACEbreakX ├─ مخرجات الكلام لضعاف البصر (الوصف في انتظار المراجعة) 🐧 🍏 🪟XSPACEbreakX └─ نموذج SL5 Aura Android (غير متصل بالإنترنت بشكل كامل حتى الآن) 📱XSPACEbreakX

---

(ملاحظة: توزيعات Linux المحددة مثل Arch (ARL) أو Ubuntu (UBT) مغطاة برمز Linux 🐧 العام. قد تتم تغطية الفروق التفصيلية في أدلة التثبيت.) </التفاصيل>

                                                       <التفاصيل>

انقر لرؤية الأمر المستخدم لإنشاء قائمة البرامج النصية هذه

{ find . -maxdepth 1 -type f \( -name "aura_engine.py" -o -name "get_suggestions.py" \) ; find . -path "./.venv" -prune -o -path "./.env" -prune -o -path "./backup" -prune -o -path "./LanguageTool-6.6" -prune -o -type f \( -name "*.bat" -o -name "*.ahk" -o -name "*.ps1" \) -print | grep -vE "make.bat|notification_watcher.ahk"; }

                                                      </التفاصيل>

                                                       <التفاصيل>
    <summary>نظرة عامة رسومية على البنية</summary>

                  ### نظرة عامة رسومية على البنية:

                                                               ![yappi_call_graph](../doc_sources/DeveloperGuide_Generating_ServiceCallGraph/yappi_call_graph_stripped.svg_20251024_010459.png "doc_sources/DeveloperGuide_Generating_ServiceCallGraph/yappi_call_graph_stripped.svg_20251024_010459.png")

                                          اكس سبيس بريك اكس
                                                               ![pydeps -v -o dependencies.svg scripts/py/func/main.py](../doc_sources/dependencies.svg)
                                                      </التفاصيل>

                                                       <التفاصيل>
                     <summary>النماذج المستخدمة</summary>

                                 # الموديلات المستعملة:

توصية: استخدم النماذج من Mirror https://github.com/sl5net/SL5-aura-service/releases/tag/v0.2.0.1 (ربما أسرع)

يجب حفظ هذه النماذج المضغوطة في مجلد “النماذج/”.

                                             `mv vosk-model-*.zipmodels/`

نموذج	الحجم	معدل/سرعة خطأ الكلمة	ملاحظات	الترخيص
vosk-model-en-us-0.22	1.8 جيجا	5.69 (اختبار الكلام المكتبي النظيف) 6.05 (tedlium) 29.78 (مركز الاتصال)	نموذج إنجليزي أمريكي عام دقيق	أباتشي 2.0
vosk-model-de-0.21	1.9 جرام	9.83 (اختبار Tuda-de) 24.00 (بودكاست) 12.82 (اختبار السيرة الذاتية) 12.42 (مل) 33.26 (mtedx)	الموديل الألماني الكبير للهواتف والسيرفرات	أباتشي 2.0

يقدم هذا الجدول نظرة عامة على نماذج Vosk المختلفة، بما في ذلك حجمها ومعدل خطأ الكلمات أو سرعتها والملاحظات ومعلومات الترخيص.

                                    - **نماذج فوسك:** [Vosk-Model List](https://alphacephei.com/vosk/models)
                                   - **أداة اللغة:**XSPACEbreakX
                                                         (6.6) [https://languagetool.org/download/](https://languagetool.org/download/)

                           **ترخيص أداة اللغة:** [GNU Lesser General Public License (LGPL) v2.1 or later](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html)

                                                                      ---
                                                      </التفاصيل>

                                               ## ادعم المشروع

إذا وجدت هذه الأداة مفيدة، يرجى التفكير في شراء القهوة لنا! يساعد دعمك في تعزيز التحسينات المستقبلية.

                                 [![ko-fi](https://storage.ko-fi.com/cdn/useruploads/C0C445TF6/qrcode.png?v=5151393b-8fbb-4a04-82e2-67fcaea9d5d8?v=2)](https://ko-fi.com/C0C445TF6)

                                                               [Stripe-Buy Now](https://buy.stripe.com/3cIdRa1cobPR66P1LP5kk00)