عن المشروع

Covel هو إطار عمل ألعاب تقمّص أدوار بالذكاء الاصطناعي الوكيل، استوديو قابل للعب، وبنيته معيارية. تفصل البنية بين النواة (الجدولة، تجميع السياق، الأدوات، التحقق، الحفظ، العرض)، وحزم الإضافات (سلوكيات اللعب مثل وقت تشغيل الوكلاء والدوال، واجهة المستخدم، المخططات، الأدوات، الأحداث، الإسقاطات، وخطافات دورة الحياة)، وحزم العوالم القابلة للنقل (المعارف، الشخصيات، القواعد، افتراضات الإضافات، كتل الذاكرة، المهام، العناصر، الصور الشخصية، والمناظر). يتضمن وضعان للعب: وضع المسرح، وهو رواية بصرية كاملة الشاشة مع خلفيات المشاهد، صور الشخصيات، حوار بآلة كاتبة، طبقات خيارات، وتوليف الخلفيات عند الطلب للمواقع الجديدة؛ ووضع القصة، وهو نصي مع أدوار مسرودة، إجراءات مقترحة، نماذج مضمّنة، وخط زمني للوكيل لكل دور. الإضافات هي حزم قدرات وليس أدوارًا ثابتة. أمثلة مضمّنة تشمل أوقات تشغيل الوكلاء مثل narrator وcodex وcore-quest؛ أوقات تشغيل الدوال مثل pregame وdice-check/roller وscene-cast؛ حزم مختلطة مثل npc-graph وتوليد الصور؛ خطافات دورة الحياة مثل cost-gate وstory-guard وdirector؛ وعقود واجهة المستخدم أو البيانات مثل memory وcharacter-blueprint وcharacter-presence. تكتشف النواة القدرات وoutputKind دون تفرع على معرفات الإضافات المحددة، مما يبقي المكونات قابلة للاستبدال. تتضمن آليات ألعاب RPG المدمجة فحوصات نرد مسبقة التمرير مع إيصالات حساب مرئية، سجل مهام يتتبع تلقائيًا، مخزون يديره اللاعب، ومقاييس تأثر لكل شخصية غير لاعبة؛ وكلها إضافات اختيارية، ويمكن للعوالم تزويد مهام افتتاحية، معدات بدء، وتأثر أولي. بعد كل دور، يتيح إسقاط حقائق WorldIR المشترك إعادة استخدام نفس الأدلة من إضافات المهام والمخزون والتأثر والموسوعة والعلاقات. تُعلن حزم العوالم عبر world.yaml وWORLD.md واستيرادات WorldData؛ ويمكن لـpluginPolicy تحديد الإضافات كإلزامية أو موصى بها أو مستبعدة، ويمكن لـmemoryBlocks إضافة ذاكرة خاصة بالنوع الأدبي مثل الأدلة أو سجلات الإشارات. يقدّم الإطار كتالوجات واجهة مستخدم zh-CN وen-US وru-RU، ويدعم تعليمات الإضافات الموضّعة، وملفات العوالم، وبيانات الشخصيات، والقواعد مع الرجوع إلى المصادر الأصلية. يجمع Trace Inspector التنفيذ حسب الجلسة والدور، ويعرض أوقات التشغيل، والتدفقات، وطلبات LLM، والأدوات، والرسائل، والحالة، وأحداث الخطافات، بالإضافة إلى عرض بيانات الجلسة والتكلفة. التخزين محلي أولًا باستخدام SQLite على القرص؛ في وضع ويب تبقى مفاتيح API في localStorage بالمتصفح، بينما في وضع سطح المكتب تُحفظ كنص صريح في ~/.covel/keys.env. يوفر المشروع إصدارات سطح مكتب لـmacOS Apple Silicon وWindows x64، وتشغّل المصدر عبر pnpm مع أهداف الويب والخادم. تشمل الحزم المضمّنة Mistport Chronicles وHaruka Academy وEmberback Relay. يمكن للمؤلفين توليف حزمة عالم عبر تدفق AI Create World أو إنشاء إضافات عبر create-plugin. الإصدار الحالي v0.0.32 في مرحلة الوصول المبكر، وقد تتغير واجهات API وبيانات العوالم وبيانات الإضافات بين الإصدارات. المشروع مرخّص بموجب MIT، وميزات مجتمع ومركز التسوق على خارطة الطريق.