Caveman لتقليل الرموز: مراقبة تكلفة وكيل الذكاء الاصطناعي

Caveman لتقليل الرموز: مهارة ووكيل وسيط بترخيص Apache-2.0 بحسب README، مع التثبيت والحدود والمقاييس التي تُراقَب في وكلاء الذكاء الاصطناعي.
Caveman réduire tokens : superviser le coût d'un agent IA

Caveman لتقليل الرموز: هذا هو وعد مستودع JuliusBrussee/caveman، وهو مهارة (skill) ووكيل وسيط (proxy) لوكلاء البرمجة مثل Claude Code وCodex وGemini CLI وغيرها. يطلب من الوكيل أن يجيب باختصار وأن يقرأ أقل. يعرض المستودع نحو 115 000 نجمة في نهاية أكتوبر 2026 بحسب صفحته على GitHub. ويذكر ملف README أنه بدأ مزحة في أبريل 2026.

بالنسبة إلى فريق التشغيل، لا تكمن المسألة في نبرة الوكيل بل في التكلفة: رموز (tokens) تُستهلك لكل جلسة ولكل أداة ولكل يوم، ولا يقيسها أحد حتى تصل الفاتورة. يعرض هذا المقال المشروع بحسب README، ثم يبيّن المقاييس التي ينبغي مراقبتها في رصد نماذج اللغة (LLM observability)، ومنها ما يوفّره المشروع نفسه.

تنبيه صدق: span.observer مدوّنة مستقلة ولم تثبّت Caveman. الأوامر والأرقام مأخوذة من README الذي قُرئ في 26 أكتوبر 2026؛ فهي ادعاءات المشروع وليست قياسات المدوّنة.

Caveman لتقليل الرموز: ما الذي يفعله المشروع

  • المؤلف والترخيص: المستودع يعود إلى Julius Brussee. يذكر README ترخيص Apache-2.0 للمستودع كله، وملف LICENSE هو فعلًا نص ترخيص Apache 2.0. ويتناول ملف LICENSING.md الإصدارات القديمة. أما الاسم «Caveman» والشعار فعلامتان تجاريتان للمؤلف.
  • أرقام قُرئت في 26 أكتوبر 2026: نحو 115 000 نجمة، ونحو 6 600 تفرّع (fork)، و1 886 إيداعًا (commit). لا تعرض الصفحة إصدارًا في شريطها الجانبي، لكن README يشير إلى ملاحظات الإصدار 4.0.0 ويثبّت الإصدار v4.0.1 في سكربتات التثبيت.
  • ستة أجزاء («rocks» في README): Say less (إجابات قصيرة)، وRead less (ضغط السجلات وJSON وCSV ومخرجات الاختبارات قبل أن يقرأها النموذج)، وAuto (اختيار النموذج ومستوى الجهد)، وBlocks (سكربتات قابلة لإعادة الاستخدام)، وWaste fixes (رصد الهدر)، وBrowse (صفحات ويب مضغوطة).

مبدأ الصوت المختصر: الجواب أولًا، وفكرة واحدة في كل جملة، لكن الشيفرة والأوامر والمسارات ورسائل الخطأ تبقى كما هي. ويؤكد README نقطة واحدة: المشروع لا يعيد كتابة مطالباتك (prompts) أبدًا، لأنه يستشهد بدراسة (Adobe Research) ترى أن ذلك يسوّئ الإجابات.

جولة في تقرير Caveman Learn

بحسب README، يرتّب الأمر caveman learn الأماكن التي تذهب إليها رموزك، انطلاقًا من سجل الوكلاء الموجود أصلًا على القرص. وينشر المستودع لقطة للتقرير الناتج.

تقرير Caveman Learn المنشور في README: ملخص وبطاقات توفير الرموز وترتيب مواضع الهدر (token sinks) ومخطط عمودي لعمق سياق الجلسات
Source : github.com

اللقطة من README المستودع (ترخيص Apache-2.0). تعرض ملخصًا وبطاقتي «Saved so far» و«Could have saved» وقائمة بمواضع الهدر (مثل ملف CLAUDE.md عام يضيف رموزًا في كل دور) ومخططًا لنسبة نافذة السياق التي تستخدمها كل جلسة. ويوضح التقرير أن الأرقام محسوبة بالرموز لا بالدولار، لأن سعر الرمز يتوقف على التخزين المؤقت. هذه القيم من جلسة تجريبية: وقيمك ستختلف.

التثبيت خطوة بخطوة بحسب README

  1. المتطلب: Node.js 22.13 أو أحدث. يذكر README أنظمة Mac وLinux وWindows.
  2. التثبيت بأمر واحد يكتشف وكلاءك ويعرض ما سيغيّره قبل التطبيق:
    npx @caveman-ai/cli@latest
  3. تحقق من الحالة بالأمرين caveman status وcaveman doctor. إن كان لديك Caveman قبل الإصدار 4.0، يطلب README كتابة @latest، وإلا تغلب النسخة المحلية القديمة.
  4. صيغة «المهارة فقط» دون الوكيل الوسيط:
    npx skills add JuliusBrussee/caveman -g

    ثم /caveman في الوكيل ($caveman في Codex)؛ والأمر stop caveman يعيد الوضع العادي.

  5. صيغة إضافة Claude Code:
    claude plugin marketplace add JuliusBrussee/caveman && claude plugin install caveman@caveman
مقتطف من README مشروع Caveman: أمر التثبيت npx والأوامر caveman status وon وlearn وstats وdoctor و/caveman-stats
Source : github.com

للإزالة يعطي README الأمر npx -y github:JuliusBrussee/caveman — –uninstall (مع –allow-git=root إضافةً على npm 12 أو أحدث). ويوفّر لنظام Windows سكربت PowerShell 5.1 أو أحدث. اقرأ هذه السكربتات قبل تشغيلها: فالأمر curl … | bash ينفّذ شيفرة بعيدة.

أي المقاييس تُراقَب لمتابعة الرموز

يوفّر Caveman الأمر caveman stats (سجل الرموز) والأمر /caveman-stats (الاستخدام الفعلي لجلسة Claude Code). وهذه عروض محلية. يحتاج الفريق أيضًا إلى قياس مستقل في جانب رصد نماذج اللغة. تحدد الاصطلاحات الدلالية في OpenTelemetry للذكاء الاصطناعي التوليدي لهذا الغرض السمتين gen_ai.usage.input_tokens وgen_ai.usage.output_tokens على الـspans، والمقياس gen_ai.client.token.usage. هذه الاصطلاحات بحالة Development وتوجد الآن في مستودع مخصص: راجع مقالنا عن تكلفة وكيل الذكاء الاصطناعي بالرموز مع OpenTelemetry للتفاصيل والتحفظات.

تكفي أربعة مؤشرات للبدء:

  • رموز الإدخال لكل جلسة: تتزايد في كل دور لأن السياق يتراكم. وهذا هو الجزء الذي يدّعي «Read less» تقليله.
  • رموز الإخراج لكل طلب: الجزء الذي يستهدفه الصوت المختصر.
  • عدد استدعاءات الأدوات لكل مهمة: الوكيل الذي يدور في حلقة يظهر هنا قبل أن تظهر الفاتورة.
  • المهام المنجزة: توفير في الرموز يُفشل مهامّ أكثر لا قيمة له. قِس الأمرين معًا.

منهج SRE: سجّل هذه المؤشرات أسبوعًا قبل التثبيت ثم أسبوعًا بعده، على مهام متقاربة. ودون خط أساس لا يمكن إثبات أي توفير. وإن كنت تضع أصلًا وكيلًا وسيطًا للضغط أمام نماذجك، فقارن مع Headroom لضغط سياق LLM الذي يعرض مقاييسه الخاصة. وللإمساك بما يفعله الوكيل راجع أيضًا T3 Code والتحكم بوكلاء البرمجة.

ما يدّعيه المشروع (وتحفظاته)

ينشر README أرقامًا كثيرة. هذه بعضها، مع التحفظات الواردة في README نفسه:

  • في عشرة أسئلة برمجية، يحصي README ‏6 983 رمز إخراج دون تعليمات، و4 334 مع «Answer concisely.»، و4 119 مع /caveman، و2 693 مع /ultracave. ويلاحظ أن «كن موجزًا» هو خط المقارنة الحقيقي وأن هذه القياسات تعود إلى قواعد الإصدار 3.1.0 دون إعادة تشغيل.
  • بالنسبة إلى «Read less»، يعلن README انخفاضًا بنسبة 33.2% في رموز الإدخال على جلسات كاملة (54 تشغيلًا لـClaude Code). ويوضح أن القياس يعود إلى أغسطس 2026 على محرك أقدم، وأن HTML يزداد سوءًا بنسبة 9.9% لعدم وجود ضاغط له.
  • بالنسبة إلى «Auto»، يعلن انخفاضًا في التكلفة بنسبة 54% على 85 مهمة، موضحًا أن التجربة نصف مكتملة وأن فارق الدرجات أصغر من أن يُستنتج منه.
  • تكلّف قواعد الصوت نحو 1 160 رمز إدخال، وإن كنت تدفع عن كل طلب (GitHub Copilot) فالإجابات الأقصر لا توفّر شيئًا.

هذه أرقام المؤلف على مجموعات مهامه. لا تعتبرها وعدًا لفريقك: قِس أرقامك أنت.

الحدود والنقاط المفتوحة

  • القياس عن بعد (telemetry) مفعّل افتراضيًا: بحسب قسم «Privacy» في README، ترسل واجهة CLI إحصاءات استخدام (الأوامر المنفّذة وعدد الرموز ومعرّف تثبيت عشوائي والنظام وعنوان IP)، لكن لا ترسل مطالباتك ولا شيفرتك ولا مساراتك. لإيقافها: caveman telemetry off أو DO_NOT_TRACK=1. احسم هذا قبل أي نشر في الشركة.
  • Auto يرسل بيانات: بعد تسجيل الدخول يرسل Auto إلى Caveman Cloud أحدث طلب لك وما يرفقه الوكيل به (CLAUDE.md والملفات المذكورة). لا تفعّله دون مراجعة أمنية. والأمر caveman off routing يوقفه.
  • أرقام داخلية: شعار المستودع على GitHub يتحدث عن «65% رموز أقل»، بينما يفصّل README نتائج شديدة التباين (8.5% رموز إخراج أقل في تجربة JetBrains المذكورة، و3% فقط أقل من «كن موجزًا» لـ/caveman). خذ التفصيل لا الشعار. ولم تقرأ span.observer الدراسات المذكورة (Adobe وJetBrains وElastic): فهي ادعاءات README.
  • النضج: المشروع من أبريل 2026 ويصونه، بحسب README، شخص واحد. وBlocks إصدار تجريبي (v0.1.0-rc.5)، ويشير README إلى أن الاستخدام في تطبيق Claude لم يُختبر بعد من البداية إلى النهاية.
  • التراخيص: تكتشف صفحة GitHub ترخيصي Apache-2.0 وMIT؛ ويقول README إن Apache-2.0 يشمل المستودع كله. اقرأ LICENSING.md للإصدارات القديمة وإشعارات الأطراف الثالثة.

أفضل الممارسات

  • ثبّت أولًا على جهاز اختبار واقرأ قائمة التغييرات التي يعرضها المثبّت.
  • أوقف القياس عن بعد واترك Auto مطفأً حتى تُعتمد سياسة البيانات.
  • قِس الرموز ونسبة النجاح قبل التثبيت وبعده، بالمهام نفسها.
  • احتفظ بتنبيهات التكلفة لدى مزوّدك، فهي مستقلة عن الأداة.
  • اترك الشيفرة والأوامر والأخطاء نصًا كاملًا: وراجع دائمًا الفروق (diff) قبل قبولها.

الأسئلة الشائعة

هل يوفّر Caveman الرموز فعلًا؟

ينشر README قياسات، لكنها من المؤلف، على مجموعات مهامه، مع تحفظات مكتوبة. احسب رموزك أنت قبل التثبيت وبعده.

هل Caveman مجاني ومفتوح المصدر؟

يذكر README ترخيص Apache-2.0 للمستودع كله. يتطلب وضع Auto حسابًا مجانيًا وتوجد خطة Free؛ وشروطها تعود إلى Caveman Cloud لا إلى ترخيص المستودع.

ماذا ينبغي مراقبته في الإنتاج؟

رموز الإدخال والإخراج لكل جلسة، وعدد استدعاءات الأدوات، ونسبة نجاح المهام، والاتصالات الصادرة من الأداة. وتوفّر اصطلاحات OpenTelemetry GenAI أسماء المقاييس.

الخلاصة

Caveman مشروع شائع وموثّق جيدًا، لكن أرقامه تبقى أرقام مؤلفه. وبالنسبة إلى فريق SRE فالنهج هو نفسه مع أي اعتمادية جديدة: اقرأ، وثبّت على نطاق صغير، وأوقف القياس عن بعد، وقِس الرموز قبل أن تصدّق التوفير. المصادر: مستودع JuliusBrussee/caveman واصطلاحات OpenTelemetry الدلالية للذكاء الاصطناعي التوليدي.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا لمؤلف Caveman ولا للمشاريع المذكورة. العلامات التجارية المذكورة تعود إلى مالكيها. الأدوات تتطور بسرعة: تحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
claude-mem mémoire persistante agents : installer et superviser

claude-mem ذاكرة دائمة للوكلاء: التثبيت والمراقبة

Next Post
Agent Reach CLI agents IA : lire Reddit, X et YouTube

Agent Reach لوكلاء الذكاء الاصطناعي: قراءة Reddit وX وYouTube

Related Posts