إدارة ذاكرة مساحة العمل

يبيّن هذا الدليل كيف تتعامل مع مخزن معرفة مساحة العمل.

قبل أن تبدأ، اعرف أن واجهة الذاكرة سطح للمراجعة لا للتأليف. يكتب الوكلاء الحقائق والسياسات عبر propose_fact وpropose_policy، ويستبدلونها عبر supersede_fact وsupersede_policy. يكتب remember عنصرًا في الطبقة الساخنة محصورًا بالجلسة، وقد يرقّيه consolidate_memory لاحقًا إلى حقيقة. تُحصَد قرارات الاجتماع المسجّلة في نطاق decisions، ولا يُحصَد شيء عند اكتمال تشغيلات الوكيل. عملك هنا أن تقرأ ما كتبوه، أو تصحّحه، أو تلغي تفعيله، أو تحذفه.

تجد الذاكرة في الإعدادات ← مساحة العمل ← الذاكرة (/workspaces/<id>/settings/memory). ليست بندًا في المستوى الأعلى من الشريط الجانبي.

علامات التبويب الثلاث

في الصفحة ثلاث علامات تبويب بالضبط. تعرض الحقائق والسياسات عددًا حيًا، والشبكة لا تعرض عددًا:

الحقائق: كل حقيقة في مساحة العمل، مع عدد الحقائق التي لم تُستبدَل
السياسات: قواعد معيارية مجمّعة حسب النطاق، مع عدد النشطة منها
شبكة المعرفة: لوحة تفاعلية للنطاقات والموضوعات والحقائق والسياسات

النطاق ليس شيئًا تنشئه. يظهر النطاق حين يكتب وكيل أول حقيقة أو أول سياسة فيه، ولا عنصر لإنشاء نطاق في أي موضع من الواجهة.

مراجعة حقيقة وتصحيحها

افتح علامة تبويب الحقائق.
استخدم مربع البحث لتضييق القائمة. هو مرشّح يطابق النص جزئيًا في نطاق كل حقيقة وموضوعها ومحتواها، بلا فهرس كلمات مفتاحية وبلا ترتيب حسب الصلة.
استخدم «تصفية حسب النطاق» لعرض كل النطاقات، أو الحقائق على مستوى مساحة العمل وحدها، أو حقائق مستودع واحد.
استخدم مبدّل الترتيب للاختيار بين الأحدث والثقة.
انقر عنصر التحرير في صف الحقيقة.

يتيح حوار التحرير تغيير ما يلي:

النطاق: نقل الحقيقة بين النطاقات
الموضوع: وسمها القصير
المحتوى: نص المعرفة
الثقة: منزلق بخطوات 5%

احفظ ليُكتب التعديل. لا زر إضافة حقيقة، والحوار لا يُفتح إلا على صف موجود.

عرض الحقائق المستبدَلة

في علامة تبويب الحقائق مفتاح عرض المستبدَلة. الحقائق المستبدَلة مخفية افتراضيًا، ويُظهرها هذا المفتاح، وفيه سجل التدقيق، لأن الاستبدال لا يحذف.

حذف حقيقة

استخدم عنصر الحذف في صف الحقيقة وأكّد. هذا حذف حقيقي لا استبدال: استعمله للحقائق التي كان تسجيلها خطأ من الأصل، ودع الوكلاء يستبدلون الحقائق التي انتقل محتواها.

إدارة السياسات

تجمّع علامة تبويب السياسات السياسات النشطة حسب النطاق، وتنزل غير النشطة إلى قسم غير نشطة في أسفل الصفحة. لكل سياسة:

تحرير
حذف
إلغاء التفعيل / تفعيل: الخيار القابل للتراجع، وعادةً هو الصحيح. لا تصل إلى مطالبات الوكيل إلا السياسات النشطة.

وكما في الحقائق، لا عنصر إنشاء.

استكشاف شبكة المعرفة

تعرض علامة تبويب شبكة المعرفة النطاقات والموضوعات والحقائق والسياسات في لوحة عقد يمكن التنقّل فيها: إزاحة اللوحة، وتكبيرها، وسحب العقد. النقر على عقدة يفتح ورقة تفاصيلها، ومنها تصل إلى حوارات التحرير نفسها. وهي أسرع سبيل لمعرفة النطاقات التي فيها محتوى فعلًا.

تحرير الذاكرة العاملة لوكيل

الذاكرة العاملة مسودة خاصة لكل وكيل، تُحقن في مطالبته عند الإرسال. يكتبها الوكلاء بأنفسهم بـ record_observation وupdate_my_notes، وتستطيع قراءتها وتحريرها مباشرة:

الإعدادات ← مساحة العمل ← الوكلاء ← اختر الوكيل ← علامة تبويب الذاكرة.

أذونات الوصول

تربط أذونات الوصول إلى الذاكرة دور الوكيل بإذن (none، read، write) لكل نطاق. تُكتب بعمليات memory_access_grant.*.

أمران في طريقة تحديد الإذن:

القراءات مفتوحة عند الفشل. إن لم يوجد صف إذن لزوج (role, domain)، فالإذن الفعلي read. الكتابة الوحيدة التي ترمي استثناءً من غير write هي propose_policy. كتابات الحقائق لا تخضع لبوابة الإذن.
مفتاح الأذونات هو دور الوكيل. إذا غاب agent_role، ضبطته أدوات الاقتراح على general افتراضيًا. إذن مكتوب لدور آخر لا ينطبق على هؤلاء الوكلاء، وينطبق عليهم إذن general.

البحث ليس واحدًا في كل موضع

ثلاثة أشياء مختلفة تُسمّى «بحث الذاكرة»، ولا تتفق فيما بينها:

أين	ماذا يفعل
مربع البحث في علامة تبويب الحقائق	مرشّح مطابقة جزئية على الحقائق المحمّلة في العميل أصلًا
عملية RPC `memory_fact.search`	بحث كلمات مفتاحية بـ FTS5 فقط، فالعميل الخفيف لا يستطيع إرسال تضمين مع الاستعلام، ويبقى البحث الهجين داخل المضيف
أداة `search_memory` من جهة الوكيل	`keyword` أو `semantic` أو `hybrid` (الافتراضي). يدمج الهجين أربعة أصوات: المعجمي، والدلالي، والزمني، والبياني

لذا لن يرتّب الوكيل وصفحة الذاكرة الاستعلام نفسه ترتيبًا واحدًا. إذا أردت أن تتحقق مما يسترجعه الوكيل فعلًا، فاسأله.

التضمينات

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