استكشف مشاريع Jev وبْني مسارات قرارات احتمالية مْكتوبة الأنواع

شنو كيوفّر Awesome Jev

Awesome Jev هو دليل منتقى ومدعوم بالمصادر ديال المشاريع المبنية باستعمال Jev، وهو موديل System One ديال TypeSafe AI. ماشي SDK بحدّ ذاتو، ولكن هاد المستودع كيساعد المطوّرين يكتاشفو الموارد الرسمية، والزبناء ديال المجتمع، وأدوات التطوير، والتكاملات مع سير العمل، والعروض التوضيحية، وإعادات الإنتاج، ومشاريع التقييم.

Jev مصمّم للقرارات البرمجية المحدودة، ماشي لتوليد النصوص بشكل حر. كيجمع بين حالة البرنامج غير المهيكلة والأسئلة المقيّدة بالأنواع، ومن بعد كيرجّع أجوبة محدودة والاحتمالات المرتابطة بها. كود التطبيق كيبقى مسؤول على تحديد شنو يدير بهاد الأجوبة.

حالة البرنامج + أسئلة مقيّدة بالأنواع
→ أجوبة محدودة + احتمالات
→ منطق تطبيق حتمي

الدليل كيعطي الأفضلية للمشاريع اللي عندها كود مصدر عمومي، واستعمال واضح لـ Jev، وحدود موثّقة، وأدلة قابلة لإعادة الإنتاج. آخر مراجعة للإدخالات المدرجة كانت فـ 18 شتنبر 2026، ولكن المنظومة موصوفة بأنها جديدة وسريعة التغيّر.

فهم المبادئ الأساسية للقرار

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

• Choice: كيختار من مجموعة محدّدة ديال الأجوبة الممكنة. مناسب للتصنيف، والتوجيه، والفرز الأولي، واختيار الإجراء.
• Score: كينتج تقييماً محدوداً يقدر يعاون فترتيب الأولويات، وتحديد الأولوية، والتقييم المبني على شبكة معايير.
• Noul: كيمثّل قراراً احتماليّاً من نوع نعم، لا، أو غير معروف. يقدر يعاون فالتحقّق، والإشراف على المحتوى، والفحوصات، والضوابط الوقائية.

هاد البدائيات مفيدة ملي تقدر تحدّد النتائج المسموح بها من قبل. Jev ما كتقدّمش كبديل لمولّد نصوص عام الاستعمال.

حلقة القرار التصورية

ملف README ما كيعطيش الصياغة الخاصة بـ SDK، وداكشي علاش المثال التالي هو شبه كود تصوري، وماشي مثال قابل للتنفيذ مباشرة.

state = collect_relevant_program_state()
question = define_typed_question(
  allowed_answers = ["route_a", "route_b", "abstain"]
)

result = ask_jev(state, question)

if result.probability >= validated_threshold:
    apply_deterministic_action(result.answer)
else:
    request_human_review()

النمط المهم هو أن Jev كتقترح قراراً محدوداً مع الاحتمالات، بينما كود التطبيق العادي كيفرض العتبات، والصلاحيات، والآثار الجانبية.

اختار نقطة البداية

بدا بالمواد الرسمية قبل ما تعتمد على تكامل من المجتمع.

1. قرا مقدمة System One وJev باش تتعرّف على واجهة الموديل، والادعاءات المنشورة، والعروض التوضيحية، والتنبيهات.
2. استعمل التوثيق الرسمي لمراجعة المفاهيم، والبدائيات، وتفاصيل API، والأنماط، وتعليمات SDK الحالية.
3. زور TypeSafe AI باش تشوف نظرة عامة على المنتج ونقطة الولوج المبكر.
4. اختار SDK ديال TypeScript وJavaScript الرسمي أو SDK ديال Python حسب الستاك ديال التطبيق.

SDK ديال JavaScript وTypeScript كيوفّر أنواع الأجوبة المستنتجة. وSDK ديال Python كيدعم الاستعمال المتزامن وغير المتزامن. وبالنسبة لمقارنة المزوّدين، محوّل System One الرسمي لـ Python كيوفّر واجهة موحّدة لـ Jev ولمزوّدي LLM.

التثبيت والإعداد

Awesome Jev عبارة عن كتالوج، وبهذا ما عندوش بيئة تشغيل مشتركة للتطبيقات ولا أمر تثبيت شامل. الإعداد كيعتمد على SDK أو المشروع اللي غادي تختار. تبع هاد المسار باش ما تعتمدش على افتراضات قديمة.

1. اختار تنفيذاً محافظاً عليه. عطِ الأولوية لـ SDK رسمي فالتكامل الأول، ومن بعد فكّر فزبناء المجتمع إلا كنت محتاج لغة أو إطار عمل معيّن.
2. حلّ المستودع المختار. تبع README ديالو بخصوص تثبيت الحزم، والمصادقة، ومتغيّرات البيئة، ومتطلبات الإصدارات.
3. راجع توثيق API الحالي. تأكّد من المنشئات الدقيقة، وحقول الطلب، وأنواع الاستجابة، والسلوك غير المتزامن.
4. صايب سؤالاً مقيّداً بالأنواع وبسيطاً. بدا بمجموعة صغيرة ديال النتائج اللي ساهل يتفهمو وما كيتعارضوش.
5. سجّل الأجوبة والاحتمالات. خَلّي أدلة كافية باش تقيّم الدقة، والعتبات، والكمون، وحالات الامتناع عن الإجابة.
6. زِد ضوابط حتمية. ما تخليش جواباً احتماليّاً بوحدو يطلق إجراءً غير قابل للتراجع أو عالي التأثير.

زبناء ديال لغات وأطر عمل أخرى

الدليل فيه تكاملات من المجتمع لعدة بيئات. من بين الأمثلة typesafe-go لـ Go، وjev لـ Elixir وOTP، وlaravel-typesafe-jev لـ Laravel. ومستخدمو Python يقدرو حتى يفحصو jevclient غير المتزامن.

هاد المشاريع مستودعات مستقلة، وكل واحد عندو تعليمات الإعداد والتراخيص ديالو. الإدراج فـ Awesome Jev ما كيعنيش تزكية من طرف TypeSafe AI.

بني سير عمل أساسي بـ Jev

الخطوة 1: حدّد مهمة محدودة

اختار قرار عندو عدد محدود ديال النتائج الممكنة. من بين المهام المناسبة للبداية: توجيه طلب وارد لواحد الطابور، تنقيط سجل حسب شبكة تقييم، التحقق واش الأدلة كتدعم ادعاء، ولا ترتيب مجموعة صغيرة ديال المرشحين.

تعريف تصوري للتوجيه يقدر يكون بحال هكا:

الحالة:
  الطلب الوارد، سياق الحساب، البيانات الوصفية ديال السياسة

اختيار مهيكل:
  billing | technical_support | abuse_review | unknown

قاعدة التطبيق:
  وجّه غير إلا كان الجواب المختار كيوصل لعتبة مجرّبة

الخطوة 2: وفّر الحالة المرتابطة

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

الخطوة 3: طرح سؤال مهيكل

استعمل Choice لتصنيف محدود، وScore لتقييم داخل نطاق محدد، ولا Noul للتحقق من نوع نعم أو لا أو غير معروف. تبع التوثيق ديال SDK اللي اخترتي للصيغة الدقيقة ديال الطلب.

الخطوة 4: فسّر الاحتمال

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

if confident and action_is_allowed:
    continue_workflow()
elif review_is_available:
    send_to_human()
else:
    stop_safely()

الخطوة 5: خلّي التنفيذ حتمي

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

طبّق Jev على حالات استعمال شائعة

التوجيه الدلالي

فالتوجيه ديال HTTP، hono-jev-router كيوجّه طلبات Hono حسب المعنى. tiershift كيركّز على توجيه النماذج المقيّد بالسياسات لـ TypeScript وPython، بينما jev-codex-router كيختار النموذج ديال Codex، وإعدادات التفكير والسرعة فكل دورة.

تصفية البيانات وفرزها الأولي

jev-curate كيصفّي وكيقيّم تدفقات Parquet وJSONL. jevlogs كيفرز سجلات OpenTelemetry قبل التحليل الأكثر تكلفة. ومن بين الخيارات الموجّهة لقواعد البيانات إضافة PostgreSQL ديال pg-jev، وjevsql للتصفية والترتيب والتصنيف والتنقيط باستعمال شروط باللغة الطبيعية وبأسلوب شبيه بـ SQL.

الوكلاء والضوابط الوقائية

المشاريع الموجّهة للوكلاء كتبرهن كيفاش تقدر القرارات المهيكلة تكون بين النموذج والأدوات ديالو. jev-guard كيسند نتائج السماح أو الطلب أو الرفض لاستدعاءات الأدوات. winnow كيقيّم نتائج الأدوات قبل ما يضيفها لسياق Claude Code، وCanny كيسجّل الأدلة وكيطعن فادعاءات الإكمال اللي ما مدعماش.

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

الأنظمة التفاعلية والآنية

الدليل فيه ألعاب وتجارب فالروبوتات كتفصل بين الحكم الاحتمالي وقواعد العالم الحتمية. typesafe-snake كيدير قرار مهيكل واحد فكل دورة ديال اللعبة، بينما الكود كينشئ التحركات القانونية. heist-one كيستعمل Jev للحكم على الحراس، فحين أن الكود الحتمي كيتحكم فعالم اللعبة. jev-drone كيستكشف قرارات تكتيكية أبطأ فواحد التجربة ديال طائرة رباعية المراوح باستعمال MuJoCo.

نصائح متقدمة لقرارات موثوقة

عاير العتبات باستعمال البيانات ديالك

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

قس المخاطر الانتقائية ووقت الاستجابة

خلّي النظام يمتنع ملي ما تكونش الثقة كافية. من بعد، قسّ دقة القرارات المقبولة ونسبة الحالات اللي كتتم إحالتها لمسار احتياطي. jev-benchmarks كيوفّر تقييماً قابلاً لإعادة الإنتاج كيركّز على المعايرة والمخاطر الانتقائية ووقت الاستجابة.

قارن بين أساليب اتخاذ القرار

استعمل المقارنات المضبوطة ملي كتقرّر واش Jev مناسب لمهمّة معيّنة. Janus كيقيس فوقاش تستعمل Jev مقارنةً مع نماذج خرين وكيحوّل الطلب حسب النتيجة. مشروع typesafe-ai-benchmark كيوفّر بوّابة LLM كتحاكي شكل الخرج ديال System One باش تدير المقارنات.

تعامل مع التصنيفات الكبيرة بشكل递جي

إلى كان التصنيف أكبر من الحدّ المباشر ديال الاختيارات اللي كيقدر الموديل يتعامل معاها، قسّم القرار لمراحل محدودة بدل ما تعرض فضاء اختيارات مفتوح. jev-tree كيوضّح الاختيار递جي داخل تصنيفات كبيرة.

جمع بين التحقّق البنيوي والدلالي

التحقّق المحلي من المخطّط والحكم الدلالي كيحلّو جوج مشاكل مختلفين. zod-jev كيجمع بين التحقّق من البنية باستعمال Zod والتحقّق الدلالي باستعمال Jev. وحتى إلا كانو بجوج الطبقات موجودين، تحقّق من أداء المهمّة باستعمال بيانات كتمثّل الاستعمال الحقيقي.

حافظ على الأدلّة

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

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

استكشف النسخ المفتوحة بإمعان

الدليل كيربط حتى بواجهات مستقلة شبيهة بـ Jev وبإنجازات مفتوحة، من بينها openjev-sglang، وjevmlx، وopenvons، وopenjev. هاد المشاريع موصوفة بوضوح كمجهودات مستقلة وماشي إصدارات رسمية ديال TypeSafe.

ملي كتقيّم نسخة مفتوحة، تأكّد من توافق API، ومتطلبات الموديل، ودعم العتاد، وفرض القيود، ومعايرة الاحتمالات، والوسائط المدعومة، والحدود المنشورة. تشابه شكل الخرج ما كيضمنش سلوكاً مكافئاً.

ساهم بمشروع

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

Awesome Jev منشور برخصة CC0 1.0 Universal. كل مشروع مربوط كيحتافظ بالرخصة ديالو، لذلك راجع شروط داك المشروع قبل ما تستعمل الكود ديالو أو تعدّلو.

الخلاصة

Awesome Jev خريطة عملية للنظام البيئي الناشئ ديال System One. بدا بالوثائق الرسمية وSDK ديال اللغة ديالك، وبني قرار واحد مقيّد بالأنواع وبحدود واضحة، وخلي التنفيذ تحت تحكّم محدّد بشكل حتمي. قبل الاستعمال فالإنتاج، قيّم باستعمال بيانات كتمثّل الواقع، وعاير العتبات، وقس الامتناعات ووقت الاستجابة، واحتافظ ببديل بشري آمن فالحالات غير المؤكدة أو اللي عندها تبعات كبيرة.