Skip to main content

الذاكرة الدائمة للوكيل

ملفات المعرفة هي الذاكرة الدائمة للوكيل — حقائق طويلة المدى تبقى إلى أجل غير مسمى. بينما تلتقط الأحداث ما حدث ويضغط التجميع الجدول الزمني، تُخزّن ملفات المعرفة ما يعرفه وولفيش عنك وعن عالمك وتفضيلاتك.

الموقع

الملفات الخمسة الافتراضية

تُنشأ هذه الملفات الخمسة عند أول تشغيل. يمكنك إضافة المزيد من ملفات المعرفة — كل شيء في مجلد knowledge/ يُفهرَس ويصبح قابلاً للبحث. أنشئ books.md أو health.md أو أي تصنيفات تناسب حياتك.

كيف تُكتب المعرفة

تدخل المعرفة إلى النظام عبر ثلاثة مسارات:

1. التنقيح التلقائي (بقيادة LLM)

أثناء تمريرة الضغط الليلية، يعمل LLM عمل المنقِّح لا المستخرِج: يقرأ سجلَّ اليوم إلى جوار المحتوى الحالي لملفات المعرفة الخمسة ويعيد كتابة ما تغيّر منها كاملاً — قسم ## مرتَّب واحد لكل شخص ومشروع وموضوع؛ وشبه المكرر يُدمَج في سطر واحد؛ والتناقضات تُحسَم لأحدث الأدلة؛ والحشو يُحذَف فور رؤيته. وبنية الأقسام يفرضها التطبيق نفسه (فترويسات ## هي بالضبط ما تعرضه <memory_map>)، وكل ملف يُعاد كتابته يحتفظ بنسخته السابقة باسم <file>.md.bak بجواره، وتحريراتك اليدوية تنجو من التنقيح. واليوم الذي لا يحمل شيئاً دائماً ينتهي بلا أي تغيير. ومرة كل شهر تدقّق المراجعة العميقة في هذه الملفات نفسها تدقيقاً خصامياً — تطارد البنود البالية والأحكام التي انقلبت الأدلة عليها.

2. memory_save — مسار الكتابة الخاص بالنموذج

عندما تقول شيئاً مثل «تذكّر أنني أفضّل conventional commits» أو «اسم مديرتي سارة»، يستدعي الوكيل أداة memory_save:
عقد التشغيل يوجّه وولفيش لحفظ جملة واحدة مكتفية بذاتها كلما تعلّم شيئاً دائماً — تفضيلاً، أو قراراً، أو حقيقة مشروع، أو تفصيلة عن شخص — وألا يكتب ملفات الذاكرة بيده مباشرة أبداً. وتُزيل memory_save التكرار بنفس طريقة الترقية: حفظ حقيقة موجودة مسبقاً في الملف لا يفعل شيئاً. ويكون type افتراضياً technical عند إغفاله.

3. التعديل اليدوي

افتح أي ملف معرفة في محررك وعدّله. مراقب الملفات في brainstem يكتشف التغيير ويُعيد cortex فهرسته فوراً.

كيف تُقرأ المعرفة

ملفات المعرفة لا تُحقَن في الموجّه. بدلاً من ذلك، تُدرج خريطة <memory_map> مواضيع الملفات الخمسة المُنسَّقة — ترويسات مقاطعها ## — بحيث يعرف النموذج دائماً ما الحقائق الدائمة الموجودة القابلة للجلب:
عندما يكون موضوع ما ذا صلة، يسترجعه النموذج:
  • memory_get على file:brain/hippocampus/knowledge/preferences.md يُرجع الملف كاملاً
  • memory_search مع sources: "knowledge" يعثر على حقائق مفردة عبر جميع ملفات المعرفة
هذا مقصود: حقيقة حفظتها في مارس تكلّف صفر توكن في كل دورة إلى أن تحتاجها محادثة فعلاً — وعقيدة الاسترجاع تعني أن أي إشارة مُعرَّفة إليها ستُطلق بحثاً دون أن يُطلب ذلك.

مثال: preferences.md بعد عدة أسابيع

مثال: people.md

إرشادات التعديل

أخبر وولفيش أثناء المحادثة:
  • “تذكّر أن مفتاح API الخاص بي لـ Stripe في 1Password”
  • “سجّل أننا قررنا استخدام PostgreSQL بدلاً من MySQL للخدمة الجديدة”
  • “رحلتي إلى الرياض في 3 يونيو”
الوكيل يحفظ كل حقيقة عبر memory_save، موجَّهةً إلى ملف المعرفة المناسب.
ملفات المعرفة تعمل بشكل أفضل عندما تكون موجزة. كل إدخال يجب أن يكون حقيقة، وليس قصة — وmemory_save تفرض ذلك بتصميمها، إذ تأخذ جملة واحدة مكتفية بذاتها في كل مرة. استخدم ترويسات المقاطع ## لتجميع الحقائق: هذه الترويسات هي بالضبط ما تعرضه <memory_map> للنموذج (حتى 8 لكل ملف).

ملفات معرفة مخصصة

أنشئ أي ملف .md في مجلد knowledge/ وسيصبح جزءاً من ذاكرة الوكيل القابلة للبحث:
سيكتشفه مراقب الملفات في brainstem وسيُفهرسه cortex تحت مصدر knowledge، بحيث تعثر memory_search على محتواه مثل أي ذاكرة أخرى. يبقى أمران محجوزين للملفات الخمسة الافتراضية: أسطر مواضيع <memory_map> تسرد الملفات الخمسة المُنسَّقة فقط، وmemory_save لا تكتب إلا فيها — أما الملفات المخصصة فهي ملكك تصونها بيدك.