عن المشروع

يقدّم Caveman مكونين متكاملين لمساعدات البرمجة القائمة على الذكاء الاصطناعي. المكوّن الأوّل هو «مهارة» — ملف قواعد يُعيد صياغة الأجزاء النصيّة الطبيعية في ردّ الوكيل إلى أسلوبٍ مختزل شبيه بأسلوب الإنسان البدائي، مع إبقاء الكود والأوامر ومسارات الملفات ورسائل الخطأ دون تغيير. تُظهر الاختبارات في المستودع انخفاضًا متوسطًا في توكنات الإخراج يصل إلى نحو 65٪ عبر مجموعة من عشرة أوامر برمجية نموذجية. المكوّن الثاني هو وكيل محلي (proxy) يتوسّط بين الوكيل ومزوّد نموذج اللغة الكبير (LLM). يحلّل حمولات البيانات الواردة (JSON، وسجلات، وكود، وفروقات، ونتائج بحث، ونص/HTML) ويضغطها قبل إرسالها إلى الأعلى، مع الاحتفاظ بنسخة احتياطية في قاعدة بيانات SQLite للاسترداد الدقيق. تبلغ وفورات التوكنات الداخلة نحو 33٪ بشكلٍ عام، مع زيادات أكبر في السجلات الكبيرة أو بيانات CSV. التركيب مقسّم إلى «صخرة» صغيرة (المهارة) و«صخرة» أكبر (الوكيل). يمكن إضافة المهارة بأمر npx واحد وتفعيلها عبر الأمر /caveman داخل وكيل مدعوم. يُركَّب الوكيل عالميًا عبر npm ويُضبط بواجهة caveman CLI، التي يمكنها تغليف وكلاء مثل Claude Code وOpenAI Codex وGemini CLI وAider وKilo Code وQwen Code وopencode وHermes وOpenClaw وPi. كما يوفر أمر CLI سكريبت تثبيت كامل للكشف التلقائي والإعداد على أنظمة Unix أو Windows. يضم Caveman مجموعة أوامر للتحكّم في سلوكه: - /caveman [lite|full|ultra|wenyan‐lite|...|off] لاختيار مستوى الضغط. - caveman‐commit لرسائل التزام مختصرة. - caveman‐review لمراجعات كود في سطر واحد. - caveman‐compress لصغر ملفات Markdown. - caveman‐stats لعرض استخدام التوكنات. - caveman‐learn لتحليل بيانات الجلسات التاريخية واقتراح إصلاحات لتوفير التوكنات. وتشمل الأدوات الإضافية ضغط المتصفح، واسترجاع الذاكرة، وتحويل نص المهارة إلى صور بوضع البكسل، وتقارير تجارب A/B. يتضمن المشروع جداول معايرة مفصلة لكلٍّ من المهارة والوكيل، بالإضافة إلى توثيق حول كيفية العمل المضغوط لكل نوع حمولة وكيفية تطبيق ترتيب الصلة (BM25، والحداثة، وإشارات الخطأ) لتناسب السياق ضمن ميزانية التوكنات. جميع التحوّلات قابلة للعكس؛ يمكن استرجاع المحتوى الأصلي من التخزين المحلي. الخصوصية محلّ تركيز: تعمل المهارة والوكيل بالكامل على جهاز المستخدم، ولا يلزم حساب، وتُرسَل فقط إحصاءات استخدام مجهولة (أسماء الأوامر وعدد التوكنات) افتراضيًا. يمكن للمستخدمين تعطيل التتبع نهائيًا بأمر واحد أو بتعيين متغير بيئة. الترخيص مقسّم: المهارة وأمر CLI وSDKs والبرامج ذات الصلة مرخّصة تحت رخصة MIT، بينما صدر محرك التشغيل تحت رخصة BSL‐1.1 المصدر المتاحة التي تتحول إلى مفتوحة المصدر بالكامل بعد تاريخ التغيير. بشكلٍ عام، يهدف Caveman إلى خفض تكلفة وزمن استجابة البرمجة المساعدة بالذكاء الاصطناعي بجعل الوكلاء يقولون أقلّ ويقرأون أقلّ، دون المساس بالصحة أو القراءة.