عن المشروع

Hippo هو طبقة ذاكرة لوكلاء البرمجة بالذكاء الاصطناعي، موزعة كحزمة npm باسم `hippo-memory`. فرضيته المعلنة هي أن الذاكرة الجيدة تعني معرفة ما يجب نسيانه: الذكريات التي تبين أنها خاطئة، أو تم استبدالها، أو لم تُستخدم أبدًا يجب أن ينخفض ترتيبها أو تختفي من الاستدعاء تمامًا. المشروع مرخص بترخيص MIT ويتطلب Node.js 22.16 أو أحدث. التخزين والاسترجاع تعيش الذكريات في قاعدة بيانات SQLite محلية في `.hippo/hippo.db`، مع نسخ markdown تُكتب بعد كل تغيير بحيث يكون المخزن قابلًا للقراءة البشرية والتتبع عبر git. البحث يعتمد على BM25 افتراضيًا، بدون نموذج وبدون اتصال بالشبكة؛ التضمينات هي تثبيت اختياري (Transformers.js محلي، أو مضمّنات API اختيارية من OpenAI أو Voyage أو Cohere). يذكر المشروع عدم وجود اعتماديات وقت تشغيل. خادم MCP وواجهة HTTP API يعرضان المخزن لأي عميل متوافق. التعلم من النتائج تُوصف آليتان بأنهما مقاستان: وضع علامة على ذكرى مسترجعة بأنها خاطئة يخفض ترتيبها، والاستخدام المتكرر يقوي الذكرى. `hippo supersede` يزيل حقيقة مستبدلة من الاستدعاء. الذكريات الموسومة بالخطأ تتلقى ضعف عمر النصف للذكريات العادية. عمر النصف الافتراضي هو 365 يومًا؛ يذكر README تقييمًا مسجلًا مسبقًا حيث فقدت 7 أيام النسخة الحالية من الحقيقة بشكل أكثر تكرارًا، بينما تعادل 730 يومًا وإيقاف الاضمحلال مع 365. الاضمحلال والتخزين ثلاثي الطبقات وتوحيد النوم موصوفة بأنها مستوحاة من الحُصين، ويذكر README أنه في اختباراتهم تعادل الاضمحلال مع تعطيل الاضمحلال وأن النوم خفض الاستدعاء. الإعداد والتكاملات `hippo init` عند تشغيله داخل مشروع ينشئ مخزن `.hippo/`، ويضيف كتلة مميزة إلى `CLAUDE.md` أو `AGENTS.md` موجود، ويثبت خطافات للوكلاء المكتشفين (إعدادات Claude Code، إضافة OpenCode، إدخالات `hooks.json` في Codex تتطلب ثقة لمرة واحدة)، ويجدول تشغيلًا يوميًا في الساعة 6:15 صباحًا. `hippo init --scan <folder>` يجد مستودعات git حتى ثلاثة مستويات عمق ويزرع كل منها من آخر 365 يومًا من الالتزامات. الأعلام `--no-hooks` و`--no-schedule` و`--no-learn` تتخطى أجزاء فردية. `hippo doctor` يتحقق من الإعداد. الميزات تغطي المستوردات صادرات ChatGPT وCLAUDE.md وقواعد Cursor وmarkdown والنص العادي، مع تشغيل تجريبي وكشف التكرارات. التقاط المحادثة يستخرج القرارات والقواعد والأخطاء والتفضيلات باستدلالات نمطية بدلًا من نموذج لغوي كبير. موصلات Slack وGitHub webhook تبتلع الأحداث كذكريات خام مع المصدر ومعالجة الحذف. أوامر إضافية تغطي لقطات المهام النشطة، ومسارات أحداث الجلسات، والتسليمات، ولوحة عمل محدودة للذاكرة العاملة، ومستويات الثقة (موثقة، ملاحظة، مستنتجة، قديمة)، وتتبع التعارضات، والإبطال عند التزامات الترحيل، والاستدعاء القابل للتفسير عبر `hippo recall --why`. ملاحظات الخصوصية الاستدعاء لا يجري أي اتصال بالشبكة افتراضيًا. يكشف README أن `hippo sleep` يرسل نص الذاكرة إلى Anthropic لاستخراج الحقائق عند تعيين `ANTHROPIC_API_KEY`، وأنه يمكن تعطيل ذلك في `.hippo/config.json`. معيد الترتيب المستضاف TypeSafe Jev اختياري ومتوقف افتراضيًا. الأدلة والتحفظات يربط README كل ادعاء بمعيار أو اختبار، بما في ذلك معيار التعلم التسلسلي، ونتيجة تقسيم LongMemEval oracle (R@5 = 74.0% مع BM25 فقط)، وتقييم خاص لمعيد الترتيب بـ 300 استعلام، ومجموعة Slack مرحلية. كما يذكر أن ادعاءً سابقًا بحجم معين تم سحبه، وأن آلية الاستبدال لم تُقاس بعد. يذكر المشروع أكثر من 3500 اختبار ضد قاعدة بيانات حقيقية بدون محاكاة للوحدات.