شنو كيدير awesome-jev-tools
awesome-jev-tools هو دليل منظم لمشاريع عمومية وممارسات ديال المطورين مبنية على Jev، وهو موديل System One ديال TypeSafe AI للقرارات المهيكلة. كيجمع أمثلة اللي كانت غتكون متفرقة بين نقاشات الإطلاق، ولوائح البوابات، ووسائل التواصل الاجتماعي، والمستودعات الفردية.
Jev ماشي موديل ديال الدردشة. عوض ما يولّد نصوص حوارية، كيقيم حالة غير مهيكلة مقابل سؤال مهيكل، وكيرجع قرار مهيكل، بحال اختيار أو نقطة أو قيمة منطقية، ومعاه درجة ديال الثقة. هاد الشي كيخليه مناسب لنقط القرار المحدودة داخل البرمجيات، بما فيها التوجيه، والتصنيف، والتنقيط، والتحقق، والضوابط الوقائية ديال الوكلاء.
هاد اللائحة مصممة باش تجاوب على جوج ديال الأسئلة العملية:
- فين كيتخذ Jev القرارات فمسارات عمل حقيقية أو كيتقال إنها إنتاجية؟
- شنو هي معماريات القرار اللي يمكن نقلها لمشاريع وصناعات أخرى؟
الإدراج ما كيعنيش التزكية. المسؤولين على الصيانة ما كيضمنوش باللي شي مدخل كيترجم، ولا كيدوز الاختبارات ديالو، ولا كيعطي نفس النتائج المنشورة، ولا آمن، ولا عندو رخصة مناسبة للاستعمال ديالك.
الخصائص الرئيسية ديال المستودع
فهرس المشاريع حسب الفئات
كل مدخل مقبول كينتمي بالضبط لفئة وحدة، مختارة حسب المجال التطبيقي المباشر ديالو. ملف README كيجمع ملفات الفئات الحالية، وكيخليك تشوف المداخل المقبولة مؤخرا بلا ما تحل كل صفحة فرعية.
الفئات الرئيسية كتشمل:
- التصنيف والتوجيه: اختيار الموديل، وتوجيه نية البريد الإلكتروني، وتصنيف عناصر المتصفح، واختيار المهارات، ومهام مشابهة.
- التحقق والضوابط الوقائية: بوابات مراجعة الكود، والموافقة على الأوامر، والدفاع ضد حقن التعليمات، وفحوصات ما قبل الالتزام، ومراقبة الوكلاء.
- التنقيط والترتيب: ترتيب الصلة، وتقييم المحتوى، وتنقيط جودة الكود، والتحقق من الاستشهادات، وإعادة ترتيب نتائج الاسترجاع.
- قرارات الوكلاء: أفعال محدودة فالمتصفح، وأحكام وكلاء البرمجة، وتشذيب السياق، وفحوصات إتمام المهام، وقرارات الروبوتات.
- وسم البيانات وتنظيمها: قرارات مهيكلة كتستعمل لتنظيم البيانات أو وسمها.
- التقييم والمقارنة المعيارية: مشاريع كتقيّم سلوك Jev أو كتقارن بين مسارات عمل اتخاذ القرار.
- المعايرة والبحث: أعمال مركزة على جودة القرار، والثقة، وأبحاث مرتبطة بها.
- البنية التحتية، وSDKs، والتكاملات: البوابات، والمكتبات، والإضافات، والبنية التحتية المساندة للمطورين.
- الفئات حسب المجال: الألعاب، والمحاكاة، والمالية، والتداول، والامتثال، والمسارات القانونية، ومراقبة المحتوى.
- الممارسات والنقاشات ذات الصلة: مواد مساندة كتستوفي قواعد التنظيم ديال المستودع.
README كيشير حتى للفئات اللي مازال كيتضاف ليها المحتوى. فلقطة الحالة الموثقة، ما كانت حتى شي مدخلة فـ Scientific Pipelines.
حدود صارمة للإدراج
اللائحة كتستبعد المصنفات، والموجهات، ووكلاء البحث العامين اللي غير كيشبهو للنمط بلا ما يستعملو Jev. وكتستبعد حتى النظرية الخالصة، والمصادر اللي ما يمكنش الولوج ليها، والادعاءات الغامضة، والتعليقات على الإطلاق بلا أداة خدامة أو نتيجة قابلة لإعادة الإنتاج، والكتابات الطويلة المدرجة مباشرة فاللائحة.
هاد الحدود كاتخلي الدليل مفيد للاكتشاف، ولكن ما كتعوضش التحقق التقني الدقيق.
التثبيت والإعداد
ما محتاجش تثبت شي حزمة باش تتصفح المشروع. أسهل اختيار هو تحل README ديالو فـ GitHub وتتبع روابط الفئات أو المشاريع.
إلى بغيتي تقلب محليا، أو تعدل، أو تساهم، نزّل المستودع باستعمال الرابط اللي كيبانو GitHub فالقائمة ديال الاستنساخ:
git clone <repository-url>
cd awesome-jev-toolsما كاين حتى شي خطوة ديال البناء أو إعداد ديال وقت التشغيل موصوفة للائحة نفسها. المحتوى الرئيسي ديالها هو README الجذري، زائد ملفات Markdown داخل المجلد categories.
تأكد من ملفات الفئات المتوفرة محليا:
ls categoriesمن بعد تقدر تحل README الجذري فمحرر أو تفحص ملف ديال فئة معينة. مثلا:
less README.md
less categories/verification-guardrails.mdالاستعمال الأساسي: كيفاش تلقى مشروع Jev مناسب
الخطوة 1: حدد القرار اللي محتاجاه البرمجية ديالك
بدا بسؤال محدود عوض وصف عام للمنتوج. قرر واش التطبيق ديالك محتاج يختار واحد الاختيار، أو يعطي نقطة، أو يجاوب على سؤال بنمط نعم/لا، أو يرتب المرشحين، أو يوقف فعلا غير آمن.
أمثلة على متطلبات مركزة:
- اختيار الموديل اللي خاصو يعالج طلبا.
- تحديد واش خاص السماح باستدعاء أداة، أو رفضو، أو تحويلو لإنسان.
- تنقيط الوثائق المسترجعة حسب فائدتها كدليل على الجواب.
- تحديد واش الوكيل سالى مهمة.
- تصنيف بريد إلكتروني وارد واش هو فاتورة أو رسالة عامة.
الخطوة 2: اختار أقرب فئة
استعمل المجال التطبيقي المباشر عوض كل الاستعمالات الثانوية الممكنة. موجه الموديلات كينتمي لفئة التصنيف والتوجيه، بينما بوابة سلامة الأوامر كتنتمي لفئة التحقق والضوابط الوقائية.
على سبيل المثال، إلا كنت محتاج تحمي واحد الوكيل من أوامر shell فيها مخاطرة، قلّب فإدخالات بحال jev-guard، jev-axi، ولا pi-jev. وإلا كنت محتاج ترتيب نتائج الاسترجاع، شوف jev-reranker ولا Jev Search.
الخطوة 3: قلّب فاللائحة المحلية
قلّب حسب المجال، نوع القرار، ولا سميّة التكامل. هاد الأوامر غير أمثلة على تصفّح المستودع المستنسخ:
grep -Rni "confidence" README.md categories/
grep -Rni "Choice" README.md categories/
grep -Rni "pre-commit" README.md categories/
grep -Rni "browser" README.md categories/البحث على Choice يقدر يبيّن سيرورات اختيار مكتوبة الأنواع. والبحث على confidence يقدر يعاونك تلقى المشاريع اللي كتوصف بشكل صريح التصعيد ولا السلوك ديال العتبة.
الخطوة 4: تبّع المشروع الأصلي
كل إدخال فاللائحة غير إشارة مختصرة. حلّ المشروع المرتابط وقرا التوثيق ديالو، الكود المصدري، الاختبارات، الأمثلة، متتبّع القضايا، والرخصة. ما تعتبرش الوصف القصير فـ awesome-jev-tools إرشادات كاملة للتنفيذ.
كيفاش تتحقق من إدخال قبل ما تعتمد عليه
- تأكّد بلي كينادي على Jev API. قلّب على طلب حقيقي فيه أسئلة مكتوبة الأنواع، وكود كيفكّك الجواب الراجع. README مزيان بوحدو ماشي دليل على التكامل.
- لقى اختبار قابل للتشغيل. فضّل اختبار، عرض عمومي، ولا مثال فيه الخرج المتوقع. بلا واحد من هادو، كيبقى الدليل قليل على أن التنفيذ خدام كيفما موصوف.
- تتبّع الادعاءات الكمية. أرقام الدقة، التأخير، الكلفة، والحجم خاصها تشير لمصدر ولا لقياس قابل لإعادة الإنتاج.
- فحص مضمون المستودع. حدّد شحال منو كود قابل للتنفيذ وشحال منو توثيق ديال التعليمات، مواد التخطيط، ولا هيكل أولي.
- راجع الرخصة. غياب الرخصة يقدر يمنع إعادة الاستعمال ولا التوزيع بشكل قانوني، حتى إلا كان المصدر باين للعموم.
- قيّم مؤشرات الصيانة. شوف تاريخ الالتزامات، القضايا المفتوحة، الاختبارات، نشاط الإصدارات، وواش تفاصيل التنفيذ المهمة موثّقة.
خود الحذر بزاف إلا بانُو فـ نفس الوقت عدة مستودعات من عند مؤلف واحد وبملفات شبه متطابقة بحال AGENTS.md وCLAUDE.md وSTATE.md وCHANGELOG.md. هاد المشاريع تقدر تكون شرعية، ولكن اللائحة كتوصي تتعامل معاها كإشارات أولية مازال ما متحقّقاش، ماشي كأدوات validated.
أمثلة على سيرورات الاكتشاف
اختيار معمارية التوجيه
افترض بلي بغيتي توجّه مهام البرمجة للنموذج المناسب. بدا من Classification and Routing وقارن مشاريع بحال jev-router وprismhq's jev-router وpi-jev-router.
وأنت كتراجعهم، حدّد:
- شنوما المرشحين اللي مسموح لـ Jev يختار منهم.
- شنو هي الحالة اللي كتترسل مع السؤال المكتوب الأنواع.
- واش الأجوبة ذات الثقة الضعيفة كترفض ولا كيتصعّد بها.
- شنو هو المكوّن اللي كينفّذ القرار.
- واش سياق المحادثة الموجود كيبقى بلا تغيير.
هاد المقارنة كتعاون تفرّق بين النمط القابل لإعادة الاستعمال والتفاصيل الخاصة بالتكامل.
تصميم بوابة للسلامة
فبوابة استدعاء الأدوات، درس المشاريع اللي كتجمع بين القواعد الحتمية، أحكام Jev، والمراجعة البشرية. مشروع pi-verdict المدرج، مثلاً، كيستعمل قواعد حتمية فالحالات الواضحة واختياراً مكتوب الأنواع من نوع السماح أو السؤال أو الرفض فاستدعاءات المنطقة الرمادية. والسياسة الموصوفة ديالو كترفض فحالة الأخطاء ولا انتهاء المهلة، وكتصعّد نتيجة السؤال للإنسان.
هاد الشي كيقترح معمارية عامة:
الإجراء الداخل
-> فحوصات حتمية
-> قرار Jev مكتوب الأنواع فالحالات الغامضة
-> تقييم الثقة ولا السياسة
-> السماح، الحظر، ولا تأكيد بشري
-> نتيجة مسجّلةالمخطط نمط قابل للنقل، وماشي إعداد صالح لكل الحالات. استعمل توثيق المشروع الأصلي ونموذج التهديد ديالك باش تحدّد القواعد المناسبة.
بناء مسار للترتيب
مشاريع الترتيب كتبرز كيفاش تقدر قرارات Jev تكمل كود التطبيق التقليدي. فمثال Jev Search المدرج، أحكام Jev كتقيّم صلة النتائج، بينما كود التطبيق كيدمج عناوين URL المكررة وكيجمع المطابقات ذات النقاط الأقل. وفـ jev-reranker، الأحكام كتقيّم الصلة والفائدة كدليل قبل ما تترتّب النتائج، ومع إمكانية تصفيتها باستعمال عتبة قابلة للضبط.
لذلك، يقدر مسار عملي للترتيب يخلي المسؤوليات الحتمية فالكود:
- جمع السجلات المرشحة.
- توحيدها وحذف التكرار منها.
- طرح سؤال مكتوب الأنواع على الصلة ولا الفائدة.
- ترتيبها حسب النتيجة ولا الاحتمال الراجع.
- تطبيق عتبة موثّقة إلا كانت التصفية مطلوبة.
- الاحتفاظ ببيانات وصفية كافية لفحص المرشحين المرفوضين والمقبولين.
نصائح متقدمة لاستعمال اللائحة
استخرج الأنماط عوض ما تنسخ التطبيقات كاملة
أكثر جزء قابل لإعادة الاستعمال فواحد الإدخال يقدر يكون هو الحدّ ديال القرار، ماشي الإطار البرمجي ولا اللغة ولا واجهة المستخدم. قلّب على البنيات اللي كتعاود، بحال اختيار المرشحين، التصعيد مع مراعاة درجة الثقة، المرشحات الأولية الحتمية، الإجراءات المحدودة، البدائل من بعد انتهاء المهلة، وطوابير المراجعة البشرية.
خلّي التقدير منفصل على التنفيذ
بزاف ديال الأدوات المذكورة كتستعمل Jev باش تخرّج قرار ضيّق، فحين الكود العادي كيتحكم فعتبات القرار، والأوزان، والآثار الجانبية، والإجراءات النهائية. هاد الفصل كيخلّي سياسة التنفيذ أسهل فالاختبار، وكيمنع نتيجة النموذج من أنها تاخد صلاحية غير محدودة بشكل تلقائي.
فضّل مجموعات محدودة ديال المرشحين
أمثلة التوجيه، وأتمتة المتصفح، والروبوتات كتقيّد غالباً الإجراءات المتاحة. اختيار مكتوب النوع بين مرشحين معروفين أسهل فالتحقق من تعليمات مولّدة بلا قيود. قبل ما تكيّف شي مشروع، وثّق بالضبط شنو هي الإجراءات اللي يمكن اختيارها وكيفاش كيتعالج الخرج غير الصالح.
صمّم سلوك الثقة المنخفضة من الأول
ما تحددش غير المسار الناجح. قرّر واش الثقة المنخفضة خاصها تفعّل مراجعة بشرية، تحافظ على الحالة الحالية، تستدعي نظام آخر، ولا توقف التنفيذ. اللائحة فيها أمثلة كتتراجع ملي كتكون مطابقة المهارات ضعيفة، وكتبعث الوصفات غير المؤكدة للمراجعة البشرية، ولا كترجع التحكم للمستخدم ملي ما كتدوزش فحوصات الاستقلالية العتبات ديالها.
اختبر حالات الفشل
قيّم انتهاء المهلات، وأخطاء الواجهات البرمجية، والقرارات غير السليمة، والمرشحين غير المتاحين، والمدخلات الغامضة. مسارات العمل الحساسة للسلامة خاصها يكون عندها بديل واضح. بعض البوابات المذكورة كترفض عند وقوع أخطاء أو انتهاء المهلات، بينما أنظمة أخرى كتفيّق وكيلاً فحالات بديلة محددة. السياسة الصحيحة كتتعلق بواش الفشل مع السماح بالمرور ولا الفشل مع الإغلاق كيشكل خطر أكبر.
تعامل بحذر مع الأرقام المصرّح بها
بعض الإدخالات كتعطي نتائج متعلقة بالتأخير، والدقة، والرموز، والتكلفة، ولا اختبارات السيناريوهات. حافظ على السياق ديال كل رقم. اختبار دخان ماشي بالضرورة معياراً للمقارنة، والنتيجة اللي كيصرّح بها المستودع ديالو ماشي تحقق مستقل. عاود قيّس الأرقام المهمة باستعمال عبء العمل ديالك قبل ما تاخد قرارات معمارية.
تبّع ملفات الفئات مباشرة
حيت إن README الجذري عبارة عن تجميع، ملفات الفئات كتعطي نظرة مركزة للبحث المتكرر. إلا كنت خدام بالأساس على الضمانات، تبّع categories/verification-guardrails.md. وبالنسبة لخدمة SDK ولا البوابات، تبّع categories/infra-sdks-integrations.md.
المساهمة بتصحيحات ولا مشاريع
إلا كان شي إدخال غير دقيق، ولا ما بقاش ممكن الوصول ليه، ولا ما بقاش كيوفي بالقواعد، حلّ issue ولا pull request. الحذف كيتعتبر مساهمة صالحة بحال الإضافة.
قبل الإرسال، راجع قواعد المساهمة الخاصة بالعمل بمساعدة الذكاء الاصطناعي والإرسالات بالجملة. خاص الإدخال المقترح يستعمل Jev مباشرة، ويقدّم مشروعاً ملموساً ولا ممارسة قابلة لإعادة الإنتاج، ويبقى متاحاً للعموم، ويناسب فئة أساسية وحدة.
المساهمة القوية خاصها تسهّل التحقق، بربطها بكود التنفيذ المعني، وأمثلة قابلة للتشغيل، واختبارات، وأدلة على الادعاءات الكمية، وترخيص واضح.
الخلاصة
الأفضل تستعمل awesome-jev-tools كخريطة لاكتشاف الأدوات، ماشي ككتالوغ ديال الحزم ولا كلائحة تزكية. بدا بقرار مكتوب النوع ودقيق، قلّب فالفئة الأقرب، تفحّص التنفيذ المرتبط، تحقّق من الأدلة والترخيص ديالو، واستخرج أصغر معمارية قابلة لإعادة الاستعمال. بهاد الطريقة تقدر تتعلم من مسارات العمل الموجودة باستعمال Jev بلا ما تفترض أن كل مشروع فاللائحة واجد للاستعمال فالإنتاج.