شنو هو awesome-jev؟
awesome-jev هو كاتالوغ منظم ديال أمثلة عمومية كتهم Jev، وهو موديل القرارات System One ديال TypeSafe AI. بلا ما ينظم الموارد حسب الكاتب، المقال، ولا المستودع، كيجمعها حسب القرار اللي خاص يتاخد، بحال اختيار أداة، ترتيب السياق، تصنيف تهديد، ولا تقرير واش خاص المعلومة تبقى محفوظة.
هاد المستودع غير فهرس، ماشي منتوج Jev ولا SDK. وما عندوش علاقة رسمية بـ TypeSafe AI، والإدراج فيه ما كيعنيش التوصية. الهدف ديالو هو يعاون المطورين يلقاو تطبيقات، يفحصو المكونات اللي كتستعمل، ويفهمو التحفظات المهمة قبل ما يعتمدوا شي نمط.
إدراج فالكاطالوغ كيعني أن الرابط خدام وأن شي واحد راجعو. ما كيعنيش أن التطبيق صحيح، آمن، فعال، ولا مناسب للاستعمال فالإنتاج.
فهم Jev
Jev كياخذ الحالة وأسئلة مكتوبة بأنواع محددة، ومن بعد كيرجع أجوبة بأنواع محددة مع درجة ثقة معايرة. مخصص لقرارات سريعة ورخيصة داخل حلقة الوكيل، وماشي لتوليد نصوص طويلة.
الكاطالوغ كيتبع ثلاثة مكونات أساسية ديال Jev:
- Choice: كتستعمل ملي خاص يتاخد قرار بين اختيارات متاحة.
- Score: كتستعمل ملي خاص عنصر ولا مرشح ياخذ نقطة من نوع محدد.
- Noul: كتستعمل لحكم فردي ولا قضية معينة.
ما تفترضش أن الترتيبات المختلفة ديال هاد المكونات قابلة للتبديل. الـ README كينبه بالخصوص أن Choice وحدة بين عدة اختيارات وNoul وحدة لكل اختيار كيجاوبو على أسئلة مختلفة. هاد الفرق مصدر شائع لأخطاء فالتطبيق.
Jev كياخذ مدخلات نصية، بما فيها السلاسل، كائنات JSON، ولوائح ديال النصوص. السياق الموثق فالطلب هو 64,000 توكن، منها 32,000 توكن متاحة للحالة زائد أطول سؤال. ما كايناش أوزان منشورة للموديل، وبالتالي ما يمكنش تشغيل Jev محليا.
الخصائص الرئيسية ديال الكاطالوغ
تنظيم مبني على القرارات
الفهرس الرئيسي كيجمع الإدخالات حسب أنماط قرارات قابلة لإعادة الاستعمال. هاد الشي كيسهل الإجابة على أسئلة بحال «كيفاش الوكلاء كيختارو الأدوات؟» بلا ما تبقى كتقلب فمقالات ما عندهاش علاقة غير حيث ذكرت Jev.
واجهات قابلة للبحث والمشاركة
الموقع القابل للبحث كيوفر فلاتر، بطاقات الإدخالات، مدرج تكراري للتغطية، وروابط قابلة للمشاركة. وكيشمل حتى واجهات مخصصة لـ المكونات والتوافق.
بيانات الأدلة والتحفظات
الإدخالات كتعرف المصدر، لغة التطبيق، والمكونات اللي كيستعملها الكود فعليا. وقد تحمل حتى تحفظات بحال الوضع الخفي، أرقام المورّد، غير موثّق، ولا بلا ترخيص. الملاحظات الكاملة مخزنة فـ catalog.json وكتبان فالموقع.
فجوات التغطية والبحث
واجهة التغطية كتبرز شحال من مثال عمومي كاين لكل نمط قرار. الصفر كيعني فجوة فالبحث، ماشي مشكل فالعرض. هاد الشي مفيد لاكتشاف الأنماط الراسخة، وكذلك لتحديد الاستعمالات المحتملة اللي ما برهن عليها حتى حد علنيا لحد الآن.
قياسات مستقلة
قسم مخصص كيسلط الضوء على النتائج المقيسة بلا ما يعتمد على الادعاءات الترويجية. عدة إدخالات كتبلغ على نتائج سلبية ولا محايدة، من بينها تقييمات كان فيها Jev أضعف من ملخص موجود، أو تعادل فيها مع مصنف حالي، أو زاد فحجم المدخلات المفوترة بلا ما يقدم تحسنا مهما فزمن الاستجابة.
التثبيت والإعداد
الخيار 1: استعمل الكاطالوغ المستضاف
ما كاين حتى تثبيت ضروري للبحث العادي. حل الموقع المستضاف، اختار نمط القرار، وراجع الإدخالات المطابقة.
- حل الموقع القابل للبحث.
- اختار عمودا من المدرج التكراري للتغطية باش تصفي حسب نمط القرار.
- حل شي إدخال وراجع المصدر، اللغة، المكونات، والتحفظات ديالو.
- نسخ الرابط الناتج إلا بغيتي تشارك العرض المصفى.
الخيار 2: نسخ المستودع
نسخ المشروع إلا بغيتي تفحص البيانات المصدرية، التوثيق، الأمثلة، ولا سكريبتات التوليد محليا.
git clone https://github.com/kydlikebtc/awesome-jev.git
cd awesome-jevالـ README كيتولد من catalog.json. المستودع كيوصي المساهمين يعدلو الكاطالوغ بلا ما يعدلو الـ README المتولد مباشرة. باش تعاود تبنيه، شغل الأمر الموثق من جذر المستودع:
python3 scripts/build_readme.pyالـ README ما كيحددش خطوات تثبيت إضافية فالمواد المقدمة. راجع ملفات المستودع وإعدادات الأتمتة قبل ما تبدل الكاطالوغ ولا تتحقق منو.
الاستعمال الأساسي: لقا تطبيق مناسب
الخطوة 1: حدد القرار
بدا بالقرار اللي خاص النظام ديالك ياخذ، ماشي بتسمية تقنية عامة. مثلا:
- شنو هي الأداة اللي خاص الوكيل يستعمل من بعد؟
- شنو هي الملفات اللي خاصها تدخل فالسياق ديال المراجعة؟
- واش نتيجة أداة سابقة ما زالت مهمة؟
- شنو هي فئة التهديد اللي كتناسب خبر معين أكثر؟
الخطوة 2: اختار النمط المطابق
ستعمل الهيستوغرام ديال التغطية فالموقع ولا الأقسام ديال أنماط اتخاذ القرار فـ README. إلا كان الآگنت خاصّو يختار شنو يدير من بعد، بدا بـ اختيار الأداة. الكاتالوگ فيه أمثلة كتمتد من استدعاء الدوال واقتراح المهارات، حتى للتحكم فالمتصفح ومراجعة الصلاحيات.
الخطوة 3: صفّي حسب الـ primitive
استعمل عرض الـ primitives إلا كانت البنية ديالك كتشير من اللول لنوع السؤال. اختيار فعل من مجموعة مسدودة يقدر يوجّهك لأمثلة Choice، بينما أحكام الصلة المستقلة تقدر توجّهك لأمثلة Score ولا Noul.
خاصّك تعتبر تسميات الـ primitives أوصافاً لشنو كينادي عليه الكود المشار ليه، وماشي ضمانات بأن التنفيذ اختار أحسن primitive.
الخطوة 4: قرا التحذيرات
قبل ما تفتح مشروع مربوط، شوف وسوم التحذير والملاحظة ديال الكاتالوگ. مثلاً، تكامل معلّم بـ وضع الظل يقدر يكون مربوط بالنظام، ولكن كيتمنع عمداً من التأثير على التسميات ولا الكاشات ولا التنبيهات ديال الإنتاج.
الخطوة 5: فتّش فالمصدر الأصلي
استعمل الكاتالوگ باش تلقى المشاريع، ومن بعد تحقّق من السلوك فالمستودع ولا التوثيق المربوط. تأكد كيفاش كيتبنى الـ state، وكيفاش كتتحدّد أنواع الأسئلة، وشنو هي العتبات المستعملة، وشنو كيوقع ملي كتكون الثقة ضعيفة.
أمثلة ديال مسارات البحث
تعلّم الـ primitives الثلاثة
إلا كانت هادي أول مرة كتتعرّف فيها عليهم، تبع ترتيب القراءة اللي كيقترحو المستودع:
- قرا دليل البدء السريع الرسمي على طلب فيه أسئلة Choice وScore وNoul.
- قرا القيود المعروفة ديال Jev 1.13.
- تفقد مثال الـ primitives الثلاثة فكاتالوگ.
المستودع كيوضح بأن المثال المحلي ديالو تراجع حقل بحقل مقارنةً مع المرجع الرسمي ديال API، ولكن ما تخدمش ضد الـ API الحي. حافظ على هاد الفرق ملي كتقيّمو.
البحث فاختيار الأدوات
فترض أنك كت صمّم آݣنت خاصّو يختار أداة وحدة من كاتالوگ كبير. قلّب على نمط اختيار الأدوات وقارن بين تطبيقات بحال:
- الـ cookbook الرسمي ديال استدعاء الدوال، اللي كيربط الطلبات بدوال مكتوبة الأنواع باستعمال أسئلة من مجموعة مسدودة.
- الـ cookbook ديال اقتراح المهارات، اللي كيقيم واش كاينة الحاجة لمهارة وكيصنّف المهارات المرشحة.
- تحويل البحث التجريبي ديال Jev فـ FastMCP، اللي كيدير تصنيف أولي قبل ما يقيّم الأدوات اللي بقات فاللائحة القصيرة.
- المزوّد ديال Composio، اللي كيعيد بناء استدعاءات الأدوات وكيعالج حالات الامتناع ولا الحالات اللي كتحتاج التأكيد.
المقارنة بين هاد الإدخالات كتكشف اختيارات معمارية كان غادي يخبيها تصنيف بسيط حسب الشعبية، بحال الاسترجاع على مراحل، والامتناع الصريح، والتعامل المنفصل مع التأكيد.
تقييم اختيار السياق
إلا بغيتي Jev يصنّف الملفات ولا الذكريات، بدا بأمثلة مقيسة، ماشي بعروض ترويجية. الكاتالوگ كيوضح بأن تجربة مراجعة السياق بلا أخطاء استعملات Score وحدة لكل ملف مرشح، ولقات زيادة مادية فالإدخال المفوتر تقريباً بلا أي تحسن فمدة التنفيذ. هاد النتيجة ما كتثبتش بأن النمط ديماً غير فعّال، ولكن كتعطي سبباً ملموساً باش تقارنو مع خط أساس أبسط.
نصائح متقدمة
فضّل القياسات المستقلة
عطِ الأولوية للإدخالات ديال الاختبارات اللي كتنشر المنهجيات، وخطوط الأساس، والإخفاقات، والأدلة الخام ولا القابلة لإعادة الإنتاج. الكاتالوگ كيسلّط الضوء على تقييم ضغط السياق ديال Hermes Agent حيث قارن Jev مع ملخّص موجود من قبل ونشر قرار عدم اعتماد هاد المقاربة.
حتى النتيجة المحايدة تقدر تكون مفيدة. تكامل worldmonitor بقا فـ وضع الظل من بعد ما لقا تقييم أعمى بأن Jev غير تعادل مع النموذج الحالي. هادا نموذج عملي لاختبار نظام قرار جديد بلا ما تسمح ليه مباشرةً يأثر على سلوك الإنتاج.
اختبر الحساسية لترتيب الخيارات
تقرير مستقل واحد لقا بأن عكس ترتيب الخيارات بدّل احتمالاً بما يكفي باش يدوز عتبة 0.9. النتيجة ما تعاوداتش، وبالتالي ما خاصّش تعتبر الحجم ديالها عالمياً. ولكن كتقترح اختباراً مهماً للمتانة:
- دير نفس القرار بالترتيب الأصلي ديال الخيارات.
- خلّط ولا عكس الخيارات بلا ما تبدّل المعنى ديالها.
- قارن الأجوبة المختارة وقيم الثقة.
- تحقق واش دازت العتبات التشغيلية.
إلا بدّل ترتيب بسيط وما عندوش تأثير فالمعنى سلوك الإنتاج، فالعتبة تقدر تكون أقل استقراراً مما كيبان.
قارن ميزانيات متكافئة وخطوط أساس بسيطة
ديماً قارن Jev مع النظام اللي غادي يعوّضو. دخل بدائل بسيطة بحال الترتيب حسب الحداثة، والقواعد الحتمية، ومصنّف موجود، ولا أداة متخصصة لإعادة التصنيف. ملي كتختلف ميزانيات السياق، قارن النتائج بميزانيات متساوية باش يعزل التقييم جودة القرار وماشي الإدخال الزائد.
فرّق بين الخرج المكتوب الأنواع والخرج الصحيح
الأجوبة المكتوبة الأنواع كتحسّن سهولة الدمج، ولكن ما كتضمنش بأن القرار الأساسي صحيح. تحقّق من الدقة، والمعايرة، ومدة الاستجابة، والتكلفة، وسلوك الإخفاق على بيانات كتمثّل التطبيق ديالك.
صمّم للامتناع والمراجعة
الأمثلة فلكاتالوگ فيها الامتناع الصريح، وحالات كتحتاج التأكيد، ونشرات فـ وضع الظل، وخصائص كتتفعّل باختيار المستخدم. هاد الأنماط مفيدة خصوصاً ملي يقدر جواب خاطئ وبثقة عالية يطلق فعلاً غير آمن ولا غالي.
تحقق من التوافق قبل التنفيذ
راجع وثائق التوافق ديال المستودع باش تعرف الفروقات بين المنصات. ما تفترضش باللي الأمثلة المكتوبة بPython ولا JavaScript ولا TypeScript ولا Go ولا بشي لغة خرا كتعرض نفس السلوك ولا نفس تفاصيل الدمج.
استعمل معطيات الكاتالوغ بالطريقة الصحيحة
ملي كتعدّل فالمشروع، اعتابر catalog.json هو المصدر الرسمي للحقيقة، ومن بعد عاود ولّد README. شارات المستودع كتبرهن باللي معطيات الكاتالوغ مرخّصة بـCC0-1.0 وكود المشروع مرخّص بـMIT، ولكن خاصك تبقى كتفحص المشاريع المرتابطة واحد بواحد حيث الترخيص ديالها يقدر يختلف ولا ما يكونش موجود.
أخطاء شائعة خاصك تتفاداها
- اعتبار الكاتالوغ تزكية: الإدراج غير كيعني باللي الرابط تراجع وتأكد باللي خدام.
- اختيار الأمثلة غير حسب عدد النجوم: الشعبية ما كتثبتش الصحة ولا المعايرة ولا الملاءمة.
- الخلط بين Choice وأحكام Noul المستقلة: هاد الترتيبات كيجاوبو على أسئلة مختلفة.
- الثقة فالأرقام ديال أداء المورّد بلا خط أساس: عطِ الأولوية للقياسات المستقلة والقابلة لإعادة الإنتاج.
- تجاهل النتائج السلبية: التجارب الفاشلة ولا المحايدة كتقدم غالباً أكثر توجيهات هندسية قابلة للتطبيق.
- افتراض باللي المخرجات المهيكلة كاتضمن الصحة: تحقّق من القرارات باستعمال حقيقة مرجعية معلّمة ولا مبرّرة بطريقة أخرى.
- التعديل مباشرة فـREADME المولّد: حدّث
catalog.jsonوشغّل سكريبت البناء عوض داكشي.
الخلاصة
awesome-jev كيتستعمل أحسن كخريطة بحث مبنية على الأدلة لعمليات دمج Jev. بدا بالقرار اللي خاص النظام ديالك ياخدو، صفّي الأمثلة حسب النمط والبدائيّة، شوف التحذيرات، وتحقّق من كل ادعاء فالمصدر الأصلي. قبل ما تعتمد شي تصميم، عاود نفّذو على المعطيات ديالك، وقارنو مع خطوط أساس بسيطة، واختبر استقرار الثقة، وخطّط للامتناع عن القرار ولا للمراجعة البشرية.