صوت غير متصل على مستوى النظام للأوامر أو الرسائل النصية، نظام قابل للتوصيل

خدمة SL5 Aura - الميزات والتوافق مع نظام التشغيل

مرحبًا بك في خدمة SL5 Aura! يقدم هذا المستند نظرة عامة سريعة على ميزاتنا الرئيسية وتوافقها مع نظام التشغيل.

الهالة ليست مجرد ناسخ؛ إنه محرك معالجة قوي وغير متصل بالإنترنت يحول صوتك إلى إجراءات ونصوص دقيقة.

إنه مساعد كامل وغير متصل بالإنترنت مبني على Vosk وLanguageTool، وهو مصمم للتخصيص النهائي من خلال نظام قواعد قابل للتوصيل ومحرك برمجة نصية ديناميكي. اكس سبيس بريك اكس اكس سبيس بريك اكس الترجمات: هذا المستند موجود أيضًا في other languages.

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

                  [![SL5 Aura (v0.7.0.2): A Deep Dive Under the Hood – Live Coding & Core Concepts](https://img.youtube.com/vi/tEijy8WRFCI/maxresdefault.jpg)](https://www.youtube.com/watch?v=tEijy8WRFCI)
                                  ( https://skipvids.com/?v=tEijy8WRFCI )

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

  • خاص وغير متصل بالإنترنت: محلي 100%. لا توجد بيانات تترك جهازك على الإطلاق.

  • محرك البرمجة الديناميكية: تجاوز مجرد استبدال النص. يمكن للقواعد تنفيذ برامج Python النصية المخصصة (on_match_exec) لتنفيذ إجراءات متقدمة مثل استدعاء واجهات برمجة التطبيقات (على سبيل المثال، البحث في Wikipedia)، أو التفاعل مع الملفات (على سبيل المثال، إدارة قائمة المهام)، أو إنشاء محتوى ديناميكي (على سبيل المثال، تحية بريد إلكتروني تراعي السياق).

  • محرك التحويل عالي التحكم: ينفذ خط أنابيب معالجة يعتمد على التكوين وقابل للتخصيص بدرجة كبيرة. يتم تحديد أولوية القاعدة، واكتشاف الأوامر، وتحويلات النص بشكل كامل من خلال الترتيب التسلسلي للقواعد في الخرائط الغامضة، مما يتطلب التكوين، وليس الترميز.

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

  • النظام الأساسي المشترك: يعمل على Linux وmacOS وWindows.

  • ** مؤتمت بالكامل: ** يدير خادم LanguageTool الخاص به (ولكن يمكنك استخدام خادم خارجي أيضًا).

  • سرعة فائقة: يضمن التخزين المؤقت الذكي إشعارات “الاستماع…” الفورية والمعالجة السريعة.

                                                          ## التوثيق

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

                                                                [**Go to Documentation >>**](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/D9ylPBnP2aQ)

Linux Ubuntu Linux Suse macOS Windows 11

                   [![Documentation](https://img.shields.io/badge/documentation-live-brightgreen)](https://sl5net.github.io/SL5-aura-service/)

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

🇬🇧 English | 🇸🇦 العربية | 🇩🇪 Deutsch | 🇪🇸 Español | 🇫🇷 Français | 🇮🇳 हिन्दी | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇵🇱 Polski | 🇵🇹 Português | 🇧🇷 Português Brasil | 🇨🇳 简体中文

                                                                      ---

                                                            ## تثبيت

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

  1. انسخ هذا المستودع إلى جهاز الكمبيوتر الخاص بك.

  2. قم بتشغيل البرنامج النصي للإعداد لمرة واحدة لنظام التشغيل الخاص بك.

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

                                  #### لنظام Linux وmacOS وWindows

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

# For Ubuntu/Debian, Manjaro/Arch, macOs  or other derivatives

bash setup/{your-os}_setup.sh

# For Windows in Admin-Powershell

setup/windows11_setup.ps1

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

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

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

                                                                      ---

                                                    ## الاستخدام

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

                                                #### على Linux وmacOS

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

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

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

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

  1. ** ابدأ الخدمة الرئيسية: ** قم بتشغيل start_dictation_v2.0.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. ابدأ الإملاء!

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

                                                                      ---


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

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

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

  1. قم بإنشاء نسخة من settings_local.py_Example.txt وأعد تسميتها إلى settings_local.py.

  2. قم بتحرير “settings_local.py” لتجاوز أي إعداد من ملف “config/settings.py” الرئيسي.

(ربما) يتم تجاهل هذا الملف “settings_local.py” بواسطة Git، لذلك (ربما) لن يتم استبدال تغييراتك الشخصية بالتحديثات.

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

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

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

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

  2. الترتيب داخل الملف (الأولوية الدقيقة): داخل أي ملف خريطة محدد (FUZZY_MAP_pre.py)، تتم معالجة القواعد بدقة بواسطة رقم السطر (من الأعلى إلى الأسفل). اكس سبيس بريك اكس

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

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

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

  • setup/setup.bat: البرنامج النصي الرئيسي للإعداد الأولي للبيئة لمرة واحدة فقط.

  • or تشغيل powershell -Command "Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force; .\setup\windows11_setup.ps1"

  • update.bat: قم بتشغيل هذه العناصر من مجلد المشروع احصل على أحدث التعليمات البرمجية والتبعيات.

                                              ### تشغيل التطبيق

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

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

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

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

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

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

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

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

                                                                        ---

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

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

                                          اكس سبيس بريك اكس
                    **هالة النواة/** 🐧 🍏 🪟XSPACEbreakX

├─ dictation_service.py (خدمة Python الرئيسية التي تنظم Aura) 🐧 🍏 🪟XSPACEbreakX ├┬ بث مباشر مباشر (التكوين والخرائط) 🐧 🍏 🪟XSPACEbreakX │├ معالجة النصوص وتصحيحها/ مجمعة حسب اللغة (على سبيل المثال، de-DE، en-US، …) XSPACEbreakX │├ 1. normalize_peptication.py (توحيد علامات الترقيم بعد النسخ) 🐧 🍏 🪟XSPACEbreakX │├ 2. التصحيح المسبق الذكي (FuzzyMap Pre - The Primary Command Layer) 🐧 🍏 🪟XSPACEbreakX ││ * تنفيذ البرنامج النصي الديناميكي: يمكن للقواعد تشغيل برامج Python النصية المخصصة (on_match_exec) لتنفيذ إجراءات متقدمة مثل استدعاءات واجهة برمجة التطبيقات، أو إدخال/إخراج الملفات، أو إنشاء استجابات ديناميكية.
││ * التنفيذ المتتالي: تتم معالجة القواعد بشكل تسلسلي وتكون تأثيراتها تراكمية. تنطبق القواعد اللاحقة على النص الذي تم تعديله بواسطة القواعد السابقة.XSPACEbreakX ││ * معيار الإيقاف ذو الأولوية الأعلى: إذا حققت القاعدة تطابق كامل (^…$)، فسيتوقف مسار المعالجة بالكامل لهذا الرمز المميز على الفور. تعتبر هذه الآلية ضرورية لتنفيذ الأوامر الصوتية الموثوقة.XSPACEbreakX │├ 3. correct_text_by_languagetool.py (يدمج أداة اللغة لتصحيح القواعد النحوية/النمط) 🐧 🍏 🪟XSPACEbreakX │└ 4. التصحيح اللاحق الذكي (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

                                         **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

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

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

                                              **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

   ### **الميزات القادمة / التجريبية**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 "dictation_service.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"; }

                                                      </التفاصيل>


 ### انظر بشكل بياني لترى ما هو موجود خلفك:

                                                               ![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)


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

توصية: استخدم النماذج من 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)