كيفاش تثبّت وتستعمل FlashAlign للمحاذاة عند الطلب ديال النماذج

شنو هو FlashAlign؟

FlashAlign هو نظام مفتوح المصدر من Aevonix Research كيسمح بتطبيق بروفايلات المحاذاة على نماذج اللغة المدعومة حسب الحاجة. تقدر تختار البروفايلات مع كل طلب، ولا تخليها مفعلة فكل الطلبات اللي كيدوزو عبر FlashAlign. هاد البروفايلات خدامة مع الأوزان الأساسية والمكمّمة المدعومة بلا ما تبدلها بشكل دائم.

البروفايلات الأولية V1 اللي مرفقة كتركز على تقليل الرفض. FlashAlign يقدر يخدم مباشرة، أو يندمج مع Hermes ولا OpenClaw، أو يتصل بهارنس مخصص. الاستدلال المُدار كيتطلب Linux وكارت شاشة NVIDIA.

FlashAlign كيبدل غير استدعاءات النموذج اللي كدوز عبر المسارات المهيأة ولا عنوان البوابة. الهارنس ديالك هو المسؤول على تحديد شكون يقدر يرسل الرسائل وشنو هي الأدوات اللي تقدر تخدم.

الخصائص الرئيسية

• بروفايلات حسب الطلب: بدّل مع كل طلب بين البروفايلات اللي راه محمّلين من طرف محرك الاستدلال.
• تشغيل قابل للعكس: طبّق البروفايلات بلا ما تبدل أوزان النماذج المدعومة بشكل دائم.
• جوج طرق للتفعيل: خصّص البروفايلات لجهات اتصال موثوقة، أو طبّق بروفايل على كل طلب كيدوز عبر المسار باستعمال وضع Always On.
• التحكم فإرث الأدوات: فالوضع ديال جهات الاتصال الموثوقة، اختار الأدوات اللي مسموح ليها تمرّر البروفايل المفعّل للأعمال المفوّضة.
• تكاملات الهارنس: استعمل FlashAlign مع Hermes أو OpenClaw أو العملاء المباشرين أو الهارنسات المخصصة.
• موائمات المراسلة: الموائمات المدمجة كتشمل الرسائل المباشرة ديال WhatsApp وRCS، مع دعم اختياري لـ SMS وTelegram.
• إجراءات حماية الإعداد: برنامج التثبيت كيكتاشف النماذج والهارنسات المحلية، كيختار بروفايل مناسب، كيتحقق من التفعيل، كينشئ مفتاح توقيع للنشر، وكيدير نسخة احتياطية من الإعدادات اللي تبدلات.
• فحص البروفايل: راجع تثبيت النموذج، والمشغلات، والمواقع، والرتب، والهاشات ديال البروفايل قبل الإعداد.

النماذج والمحركات المدعومة

FlashAlign 1.1.1 كيسرد خمسة بروفايلات أولية للنماذج مع دعم المحركات التالي:

• DeepSeek V4.1 Flash 1017: vLLM أو TensorFold.
• GLM 5.3 Full: TensorFold.
• GLM 5.3 Flash: TensorFold أو SGLang.
• Qwen3.8-27B: TensorFold أو vLLM أو SGLang أو llama.cpp.
• Gemma 4 26B A4B: TensorFold أو vLLM أو SGLang أو llama.cpp.

كاينين أربعة بروفايلات مدمجة وصغيرة فالمستودع. بروفايل DeepSeek كيستعمل حمولة tensor أصلية بحجم 1.09 GB، وكيحمّلها الإعداد من إصدار عام وكيتيقن منها باستعمال checksum. ما كاين لا مستودع خاص لا تسجيل دخول مطلوب.

المتطلبات

قبل ما تثبّت FlashAlign، تأكد باللي البيئة ديالك كتوفر المتطلبات المناسبة:

• مضيف استدلال Linux فيه كارت شاشة NVIDIA.
• Python 3.10 أو أحدث للإعداد والموائمات.
• تطابق بنية CPU وGPU عند استعمال حزم TensorFold.
• نقطة تحقق مدعومة للنموذج وبروفايل مطابق.
• محرك كيطبق عقد محرك FlashAlign.
• بالنسبة للعملاء المتوافقين مع OpenAI، دعم Chat Completions.
• بالنسبة لـ OpenClaw، واجهة API أصلية متوافقة، وNode 24.22.1 أو أحدث فالسلسلة 24.x، أو 26.12.1 أو أحدث فالسلسلة 26.x.

شوف دليل التوافق ديال المشروع باش تعرف متطلبات العتاد، ونقاط التحقق المثبتة، وحدود المحركات، والقنوات، ودعم التفويض.

تثبيت FlashAlign

1. حمّل نموذج مدعوم

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

2. نسخ المستودع وتشغيل المعالج

git clone https://github.com/Aevonix/FlashAlign.git
cd FlashAlign
bash ./install.sh --auto

المعالج كيقلب على النماذج المحلية والهارنسات المدعومة، كيختار بروفايل مطابق، كيحضّر المحرك، وكينشئ مفتاح توقيع للنشر. أثناء الإعداد، اختار إما جهات اتصال موثوقة أو Always On. إلا اخترتي جهات الاتصال الموثوقة، قرر حتى واش الأدوات خاصها ترث البروفايل.

تكاملات الدردشة كتعيد تشغيل البوابات المختارة من بعد الإعداد. أما الإعداد من الطرفية المحلية، فكيطبع الأمر المطلوب لتشغيلها.

3. تأكد من التفعيل

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

التثبيت باستعمال نموذج ومحرك محددين

استعمل --model-path ملي كتحتاج تختار نقطة تحقق محلية معينة. مثلا، الأمر التالي كينشئ نشر مستقل للمحرك لنموذج Qwen محلي عبر vLLM:

bash ./install.sh --engine-only --backend vllm --model-path /models/qwen38-27b --yes

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

الاتصال بمحرك موجود

إلا كان محرك استدلال متوافق خدام من قبل، شغّل برنامج التثبيت التفاعلي بلا --auto:

bash ./install.sh

دليل الإعداد كيغطي الاتصال والتفعيل، بينما دليل اختيار المحرك كيشرح التركيبات المدعومة ديال النماذج والواجهات الخلفية.

اختيار طريقة التفعيل

جهات اتصال موثوقة

جهات الاتصال الموثّقة هي الوضع الافتراضي. كتطبّق البروفايل المختار غير على الرسايل المرتابطة بقناة وحساب وجهة اتصال مصادق عليهم. كل دورة جديدة خاصها توصل عبر القناة الموثّقة. غير تحطّ معرّف المرسل داخل نص الرسالة ما كيعطيش الولوج.

هاد الوضع كيحصر abliteration فالمستخدمين والقنوات المصادق عليهم، وكيقلّل من خطر أن مستخدم غير مصرّح ليه يفعّلو عبر حقن خبيث فالتعليمات. مخرجات الأدوات والتنفيذ كيبقاو مرتبطين بالحمايات والصلاحيات اللي مطبّقها الـ harness.

مفعّل ديما

مفعّل ديما كيطبّق البروفايل المكوّن على كل طلب كيدوز عبر FlashAlign، بما فيها طلبات الأدوات والـ subagents. الوضع المختار كيبقى محفوظ من بعد إعادة التشغيل، وكيغلب إعدادات المحاذاة الخاصة بكل أداة، وما كيعلّمش المتصلين على أنهم موثّقين. الطلبات كتفشل إلا ما قدرش يتطبّق البروفايل المكوّن.

ثبّت مباشرة فالوضع مفعّل ديما بهاد الأمر:

bash ./install.sh --auto --mode always_on

الـ harnesses المخصّصة والعملاء المتوافقين مع OpenAI يقدرو يستعملو بوابة Always On ديال المشروع. ردّ بالك: الطلبات اللي كتدوز خارج مسارات FlashAlign أو البوابة ديالو ما كيتحكّمش فيها FlashAlign.

الموافقة على جهات الاتصال وسحبها

فالوضع ديال جهات الاتصال الموثّقة، استعمل سكريبت التسيير باش توافق على مرسل. بدّل رقم الهاتف والحساب النموذجيين بمعرّفات كيتعرّف عليهم الـ harness ديالك:

python3 hermes-owner-mode/manage.py --store ~/.config/owner-mode/approvals.json approve whatsapp +15550000011 --account default

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

سحب الموافقة على جهة الاتصال بهاد الأمر:

python3 hermes-owner-mode/manage.py --store ~/.config/owner-mode/approvals.json revoke whatsapp +15550000011 --account default

السحب كيأثر على طلبات النموذج اللاحقة، بما فيها الخدمة المفوّضة. وما كيوقّفش وضع Always On.

التحكّم فاش الأدوات تورّث البروفايل

وضع جهات الاتصال الموثّقة كيخلّيك تحدّد إعداداً افتراضياً وقت التثبيت وتبدّل إعداد الأدوات بشكل فردي بالاسم. مثلاً:

python3 hermes-owner-mode/manage.py --store ~/.config/owner-mode/approvals.json tool delegate_task off
python3 hermes-owner-mode/manage.py --store ~/.config/owner-mode/approvals.json tool sessions_spawn on

الأداة المفعّلة تقدر تمرّر البروفايل النشيط للخدمة الموثّقة التابعة ليها. الأداة المعطّلة كتستعمل النموذج العادي وما كتمرّرش أي بروفايل للأدوات التابعة ليها. الـ harness ديالك كيبقى هو اللي كيتحكّم واش مسموح للأداة تنفّذ.

Always On كيتجاهل هاد العلامات الخاصة بكل أداة وكيطبّق البروفايل على كل طلب موجّه لأداة أو subagent. FlashAlign كيحافظ على العلامات باش تبقى متاحة إلا رجعتي من بعد لوضع جهات الاتصال الموثّقة.

بدّل الوضع بلا إعادة التشغيل

تقدر تبدّل نشر الـ harness الموجود لوضع Always On بلا إعادة تشغيل:

python3 hermes-owner-mode/manage.py --store ~/.config/owner-mode/approvals.json mode always_on

رجع للولوج المعتمد على جهات الاتصال بهاد الأمر:

python3 hermes-owner-mode/manage.py --store ~/.config/owner-mode/approvals.json mode verified

اختيار الوضع كيبقى محفوظ من بعد إعادة التشغيل، ولكن تبديل الأوضاع ما كيعادش يفعّل نشراً اللي كان تعطّل من قبل. فالتثبيتات اللي كتستعمل المحرّك بوحدو، بدّل الوضع من خلال خطوة التفعيل فمعالج الإعداد.

إعداد متقدّم ونصائح للفحص

تعرّف على البيئة قبل ما تدير تغييرات

شغّل وضع الكشف باش تفحص النماذج والـ harnesses واختيارات الإعداد المتاحة أولاً:

bash ./install.sh --detect

حمّل البروفايلات من مجلد آخر

وجّه المثبّت لمجلد بروفايلات مخصّص بهاد الأمر:

bash ./install.sh --profiles /path/to/profiles

خاص البروفايلات تبقى مطابقة للنموذج والمحرّك المختارين. راجع بيانات البروفايل قبل التفعيل، وما تفترضش أن بروفايل واحد قابل للتبديل بين جميع نقاط التحقّق.

فحص محتوى البروفايل

استعمل دليل فحص البروفايلات ديال المستودع باش تتحقّق من تثبيت النموذج، والمشغّلات، والمواقع، والرتب، والـ hashes ديال بروفايل محلي. هاد الشي مفيد خصوصاً قبل نشر بروفايل محمّل أو مخزّن بشكل منفصل.

خطّط للتحميل والتبديل

FlashAlign يقدر يبدّل فكل طلب غير بين البروفايلات اللي راه محمّلين من قبل فالمحرّك. تحميل نموذج أو بروفايل آخر خطوة تحضيرية منفصلة وقد يعاود يشغّل المحرّك. باش يكون التوجيه سريع، حمّل البروفايلات اللي محتاجها التطبيق ديالك قبل ما تبدا تستقبل الطلبات.

دمج عميل أو harness مخصّص

للوصول البرمجي المباشر، تبع دليل المحرّك المباشر وعميل Python. مطوّرو الـ harness يقدرو يستعملو الخطافات المشروحة فـ توثيق الـ harness المخصّص. ووسائط الرسائل الأخرى تقدر تطبّق واجهة المكيّف الموثّقة.

اعتبارات أمنية وتشغيلية

• فضّل جهات الاتصال الموثّقة ملي خاص استعمال البروفايل يبقى محدود فالقنوات والحسابات والمرسلين المعروفين.
• استعمل «دائماً مفعّل» غير ملي كل طلب كيتبعث عبر المسار المكوَّن خاصّو يتوصل بالبروفايل.
• ما تعتبرش المعرّف المكتوب فالنص ديال الرسالة دليل على هوية المرسل.
• خلّي صلاحيات الهارنس وضوابط تنفيذ الأدوات مفعّلة؛ FlashAlign ما كيعوّضهمش.
• تأكّد من استجابة البروفايل الفعليّة من بعد الإعداد أو تغييرات التكوين.
• راجع النموذج الأمني ديال المشروع، وحدود التوافق، ونتائج التحقّق قبل النشر فالإنتاج.

الخلاصة

كيقدّم FlashAlign طريقة قابلة للتراجع لتطبيق بروفايلات المحاذاة المدعومة بلا ما يبدّل أوزان النموذج بشكل دائم. بدا بنموذج مثبّت ومحرّك متوافق، واستعمل المُثبّت لتحضير النشر والتحقّق منّو، واختار «جهات الاتصال الموثّقة» أو «دائماً مفعّل» حسب متطلبات الولوج ديالك. فالنشرات الأكثر تعقيداً، كيوفّرو فحص البروفايل، والتوريث حسب كل أداة، والولوج المباشر للمحرّك، وخطافات الهارنس المخصّصة تحكّماً إضافياً.

FlashAlign متاح بموجب ترخيص AGPL-3.0-only، مع تراخيص تجارية متوفّرة للمنتجات ذات المصدر المغلق والخدمات المستضافة. شروط النموذج والبروفايل والتبعيات كتبقى منفصلة.