تقرأ claude-prospector ملفات JSONL التي يحفظها Claude Code لكل جلسة على جهازك، وتجيب عن سؤال يقول مؤلفها إن أمر /usage المدمج لا يجيب عنه: أين ذهبت رموزي في الأيام الماضية، ولأي نموذج ووكيل ومهارة ومشروع؟ وتقسم الاستهلاك على ثلاث نوافذ: خمس ساعات، وسبعة أيام، وسبعة أيام لـ Sonnet وحده. صُممت لـ Claude Code تحديدًا، فلا تصل إلى محادثات claude.ai ولا إلى Codex.
المهارات الخمس في الإصدار 0.16.0
- usage-analysis: تجيب داخل المحادثة عن أسئلة مثل «هل اقتربتُ من حد Sonnet؟» بملاحظتين أو ثلاث، لكل منها دليلها من البيانات، وما قد تعنيه، وسؤال عن نيتك بدل فرض تغيير.
- usage-dashboard: تعيد توليد لوحة HTML التفاعلية وتعطيك مسار الملف، دون أن تفسّر الأرقام.
- claude-audit: تحصي الوكلاء والمهارات في إعداداتك وإعدادات المشروع والإضافات المثبتة معًا، وتكشف الأسماء المتطابقة، والأوصاف المتقاربة بمقياس Jaccard من 0.5 فأكثر، والوكلاء الذين تنقصهم أدوات تذكرها مهاراتهم، ثم توصي بإبقاء كل عنصر أو تعديله أو حذفه، وتحفظ التقرير في مجلد .tmp داخل المشروع دون أن تغيّر إعداداتك.
- session-analysis: تحكم هل التزمت جلسة بما طلبتَه، وما الذي تُرك منه، وتقيّم الانحراف من 0 إلى 3. تشغيلها اختياري، ويقدّر مؤلفها كلفتها بألف إلى ثلاثة آلاف رمز من الجلسة.
- setup-prospector: تبحث عن Python 3.10 أو أحدث، وتنشئ بيئة venv خاصة بالإضافة، وتثبّت فيها الإصدار المطابق من الحزمة.
ثلاثة خطافات في الخلفية
أولها يعمل عند بدء كل جلسة، وينبّهك إن كان الإعداد ناقصًا أو قديمًا أو تالفًا. وثانيها يعمل قبل كل استدعاء لمهارة أو وكيل، ويسجّل اسم المهارة ووقتها دون نص طلبك، ولا يمكن إيقافه وحده بعد اكتمال الإعداد. وثالثها يعيد توليد اللوحة عند انتهاء الجلسة، وهو معطّل حتى تفعّله بالأمر /plugin reconfigure claude-prospector.
مثال: لوحة الأيام السبعة
تطلب من Claude Code إعادة توليد اللوحة لآخر سبعة أيام، فتشغّل مهارة usage-dashboard الأمر python -m claude_prospector dashboard --window 7d --no-open وتعيد إليك مسار ملف HTML. بحسب التوثيق، تضم اللوحة مقاييس للنوافذ الثلاث، وتوزيعًا يوميًا بين Opus وSonnet وHaiku، وجدولًا للوكلاء يتتبع الوكلاء الفرعيين حتى عشرة مستويات، واستخدام كل مهارة، ورموز كل مشروع، وتفاصيل كل جلسة.
التثبيت والمتطلبات
- تحتاج Claude Code، وPython 3.10 أو أحدث متاحًا باسم python الذي تستدعيه الخطافات، واتصالًا بـ PyPI لتنزيل الحزمة ومكتبة Jinja2 التي تعتمد عليها.
- فكّ ضغط الملف في مجلد ثابت، وشغّل
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"بعد وضع مسار المجلد الفعلي. هذا يحمّل الإضافة لتلك الجلسة فقط، ويشرح README الأصلي التثبيت الدائم. - شغّل
/setup-prospectorمرة واحدة ثم افتح جلسة جديدة بالأمر نفسه، وأعده بعد كل تحديث للإضافة أو على جهاز آخر. - أرفقتُ دليلًا عربيًا (README-AR.md) بهذه الخطوات.
حدود قبل أن تعتمد عليها
- الأرقام تقديرات من سجلات جهازك، وليست فاتورة رسمية. ونسب مقاييس الميزانية تُحسب من حدود تمرّرها أنت بالخيارات
--limit-5hو--limit-7dو--limit-sonnet-7d. - وحده ملف variance، الذي تكتبه session-analysis، يحفظ نص طلباتك حرفيًا، إلا إذا كُتب بالخيار
--redact-promptsللأمر variance-save. - يوثّق المؤلف أن خطاف انتهاء الجلسة يفشل برسالة خطأ عند التحميل بـ
--plugin-dir، لأن إعداد autoregen لا يُقرأ في هذا الطريق، فولّد اللوحة يدويًا.
المؤلف والترخيص
claude-prospector من تأليف Christopher Beaulieu بترخيص MIT، ومصدرها على GitHub؛ وما في هذه الصفحة مأخوذ من ملفاتها وتوثيق مؤلفها.
