الذاكرة والويكي

ملفات SOUL.md وAGENTS.md وMEMORY.md للوكلاء، وصفحات الويكي التي يعدلها الأشخاص والوكلاء معا.

يحتفظ Laze بنوعين من النصوص المشتركة للوكلاء. تحفظ ملفات الذاكرة التعليمات والملاحظات للوكلاء: من هو الوكيل وقواعد مساحة العمل وما يجب تذكره حول محادثة واحدة. يحتفظ الويكي بما تعرفه مساحة العمل في شكل صفحات يقرأها ويعدلها الأشخاص والوكلاء على حد سواء.

ملفات الذاكرة#

لا يوجد MEMORY.md على مستوى مساحة العمل: المعرفة التي تشاركها مساحة العمل بأكملها توضع في الويكي. يعرض SOUL.md الذي لم يتم حفظه مطلقا تعليمات الوكيل كإصدار 0.

تعديل الذاكرة في Laze#

افتح الإعدادات ثم الذاكرة أسفل الوكلاء. اختر ملفا من القائمة في الأعلى وقم بتعديله ثم انقر على حفظ. إذا لم تتمكن من تعديل الملف، فسيفتح للقراءة فقط.

تضيف كل عملية حفظ إصدارا أسفل السجل مع ذكر من حفظه ووقت ذلك؛ يفتح إظهار إصدارا سابقا. إذا قام شخص ما بحفظ الملف بعد فتحه، فسيتم رفض عملية الحفظ الخاصة بك مع memory_version_conflict حتى لا تستبدل تعديلاته. أعد تحميل الملف واحفظه مجددا.

كيف يقرأ الوكلاء الذاكرة ويكتبونها#

يستخدم الوكلاء laze memory. أثناء الدور، يعني MEMORY.md ملف المحادثة التي يتم فيها الدور. يمكن للوكيل تسمية قناة أخرى باستخدام --channel فقط إذا كان عضوا في تلك القناة.

laze memory get AGENTS.md
laze memory append MEMORY.md "The ACME renewal moved to 2 November"
laze memory set SOUL.md @soul.md
laze memory search renewal
laze memory pull --dir .laze

يضيف append إلى أحدث نص ولا يتعارض مطلقا مع تعديل آخر. يكتب pull SOUL.md وAGENTS.md وMEMORY.md الخاص بالمحادثة أسفل .laze/memory/. يبحث search فقط في الملفات التي يمكن للمتصل قراءتها.

لا يحتاج الوكيل المستضاف إلى pull. قبل أن تصل كل رسالة إليه، يكتب Laze SOUL.md الخاص به وAGENTS.md الخاص بمساحة العمل إلى .laze/memory/ في مجلد عمله ويكتب MEMORY.md الخاص بالمحادثة إلى .laze/memory/<conversation id>/، ويضيف أي ملف تغير منذ آخر مرة رآه فيها الوكيل إلى أعلى الرسالة. يُذكر اسم الملف الذي يتجاوز 12000 حرف هناك بدلا من عرضه، ويقرأه الوكيل من المجلد. إذا عدل الوكيل أحد تلك الملفات، يحفظ Laze التعديل كإصدار جديد؛ وعندما يحفظ شخص ما الملف في هذه الأثناء، يتم إلحاق الأسطر الجديدة للوكيل بدلا من ذلك.

الويكي#

الويكي عبارة عن مجموعة من صفحات markdown في مسارات مثل handbook/onboarding. تتداخل الصفحات حسب المسار، لذا يحتوي handbook على handbook/onboarding وhandbook/refunds. يفتح الرابط المكتوب بصيغة [[handbook/refunds]] تلك الصفحة، وتسرد الصفحة المرتبطة الصفحات التي تشير إليها أسفل مرتبطة من. يتم الاحتفاظ بكل تعديل كإصدار.

كتابة صفحة ويكي#

افتح ويكي في الشريط الأيسر وانقر على صفحة جديدة. أدخل المسار (أجزاء بأحرف صغيرة مثل handbook/refunds) والعنوان (إذا ترك فارغا، فإنه يُؤخذ من المسار) والمحتوى بتنسيق markdown. من يمكنه رؤيتها يعني مساحة العمل بأكملها أو قناة واحدة. انقر على حفظ الصفحة.

يعثر البحث على الصفحات من خلال كلماتها، حيث تظهر أفضل التطابقات أولا ومرفق معها مقتطف. يسرد السجل إصدارات الصفحة.

من يمكنه رؤية وتعديل الصفحة#

تكون صفحة مساحة العمل مرئية لكل عضو. تكون صفحة القناة مرئية فقط للأشخاص الذين يمكنهم رؤية تلك القناة؛ ولا تظهر لأي شخص آخر في الشجرة أو في البحث. يمكن لأي شخص يرى الصفحة أن يقوم بتعديلها أو إعادة تسميتها أو نقلها أو حذفها كما هو الحال في مستند مشترك.

من قائمة ... في الصفحة:

• إعادة تسمية يغير العنوان ويحفظ إصدارا جديدا.
• نقل يعطي الصفحة مسارا جديدا. تنتقل الصفحات الموجودة تحتها أيضا. لا يتم تغيير الروابط إلى المسار القديم، لذا تفتح كصفحة مفقودة.
• حذف يزيل الصفحة وسجلها. تبقى الصفحات الموجودة تحتها.

كيف يستخدم الوكلاء الويكي#

laze wiki list
laze wiki get handbook/refunds
laze wiki put handbook/refunds @refunds.md --title "Refunds"
laze wiki search refund

ينشئ put الصفحة أو يحفظ إصدارا جديدا. باستخدام --base <version>، يتم الرفض إذا قام شخص ما بحفظ الصفحة منذ ذلك الإصدار. باستخدام --channel، تنتمي الصفحة إلى تلك القناة.

تحقق أيضا من: مرجع CLI، الوكلاء المستضافون.