في تطوير البرمجيات الحديث، فإن الحفاظ على السياق عبر جلسات الترميز هو أمر حيوي للأداء. تعمل ميزة بنك ذاكرة كلاين على تحسين وكيل Cursor AI من خلال السماح له بالتقاط تفاصيل المشروع الأساسية، حتى بعد إعادة تعيين الجلسة. يضمن ذلك حفظ الأنماط والقرارات والتقدم الهامة، مما يمكن من سير عمل سلس. في هذا الدليل، سنرشدك خلال كيفية تفعيل وتكوين بنك ذاكرة كلاين في Cursor، مما يساعدك على تحسين عملية تطويرك.
ما هي خاصية بنك ذاكرة كلاين؟
تعتبر ميزة بنك ذاكرة كلاين أسلوباً متقدماً للحفاظ على معرفة مستدامة بالمشاريع داخل وكيل Cursor AI. نظراً لأن المساعدين الذكائيين مثل Cursor لا يحتفظون بالذاكرة بين الجلسات بشكل طبيعي، يعمل بنك الذاكرة كمستودع معرفي منظم يسمح للمطورين بإdocument وmaintain السياق الشامل للمشروع، تاريخ التقدم، القرارات المعمارية، والمواصفات التقنية الرئيسية.
يعمل بنك الذاكرة بشكل أساسي كـ "دماغ" خارجي لمساعدك الذكي، مما يمكّنه من إعادة التعرف بسرعة على تفاصيل مشروعك حتى بعد إعادة تعيين كاملة. من خلال الاستفادة من نظام هرمي من ملفات Markdown، ينظم بنك الذاكرة معرفة المشروع بطريقة:
- يحافظ على السياق الحيوي حول عمارة المشروع وقرارات التصميم
- يوثق تطور الشيفرة والميزات على مر الزمن
- يحافظ على الوعي بالاتفاقيات والمتطلبات المعينة بالمشروع
- يقلل من الشروح التكرارية وإعادة التعريف بالشيفرة
- يمكن الذكاء الاصطناعي من تقديم مساعدة أكثر اتساقًا وذات صلة بالسياق
استلهمت هذه الميزة من مساعد الذكاء الاصطناعي كلاود التابع لشركة Anthropic (تحديداً كلاين)، الذي يستخدم نهجاً مشابهًا في إدارة الذاكرة، ولكنه تم تعديله وتحسينه ليتناسب مع بيئة Cursor وسير العمل الخاصة بها.
لزيادة قدرات Cursor، يمكنك دمج خادم Apidog MCP، الذي يتيح لبيئة التطوير المدعومة بالذكاء الاصطناعي الوصول مباشرةً إلى مواصفات API الخاصة بمشاريع Apidog.
يمكن لهذه التكاملات القوية تمكين Cursor من:
- إنشاء أو تعديل الشيفرة بناءً على مواصفات API الخاصة بك
- البحث في محتوى مواصفات API
- إنشاء نماذج بيانات وDTOs تتماشى تمامًا مع تصميم API الخاص بك
- إضافة تعليقات وتوثيقات مناسبة بناءً على مواصفات API
يعمل خادم Apidog MCP كجسر بين مشاريع Apidog و Cursor، مما يضمن وصول مساعدك الذكي إلى أحدث تصاميم API. يكمل هذا التكامل ميزة بنك الذاكرة من خلال توفير معلومات API منظمة يمكن أن تشير إليها Cursor عند المساعدة في مهام التطوير.
- يمكنك معرفة المزيد عن خادم apidog-mcp-server من خلال قراءة التوثيق.
- استكشف المزيد عن خادم apidog-mcp-server في صفحة npm.
- بالإضافة إلى ذلك، يمكنك تجربة Apidog، بديل رائع وأكثر قوة وتكاملاً وأقل تكلفة من Postman.
فوائد تنفيذ بنك الذاكرة
- استمرارية عبر الجلسات: يقضي على الحاجة لإعادة شرح هيكل مشروعك ومتطلباته في كل مرة تبدأ فيها جلسة جديدة
- دقة محسّنة: مع الوصول إلى المعرفة الخاصة بالمشروع، يمكن لـ Cursor تقديم اقتراحات أكثر دقة وملاءمة للسياق
- كفاءة الوقت: يقلل من وقت الانضمام للذكاء الاصطناعي مع كل جلسة جديدة
- حفظ المعرفة: يوثق القرارات الهامة والسياق لأعضاء الفريق البشري والذكاء الاصطناعي على حد سواء
- توثيق منظم: يشجع على توثيق منهجي لتفاصيل المشروع والذي يعود بالفائدة على الفريق التطوير بالكامل
كيفية تفعيل بنك ذاكرة كلاين في Cursor
لتنفيذ هذه الميزة القوية في بيئة Cursor الخاصة بك، اتبع الخطوات التفصيلية التالية:
1. إنشاء هيكل دليل بنك الذاكرة
أولاً، أنشئ هيكل دليل مخصص لاستضافة ملفات بنك الذاكرة الخاصة بك:
project-root/
├── memory-bank/
│ ├── 00-project-overview.md
│ ├── 01-architecture.md
│ ├── 02-components.md
│ ├── 03-development-process.md
│ ├── 04-api-documentation.md
│ ├── 05-progress-log.md
│ └── notes/
│ ├── feature-specific-notes.md
│ └── other-contextual-information.md
└── .cursor/
└── rules/
├── core.mdc
└── memory-bank.mdc
تُمثل الملفات المرقمة مستندات المعرفة الأساسية التي يجب الحفاظ عليها بانتظام، بينما يمكن أن يحتوي الدليل الفرعي notes/ على معلومات أكثر تفصيلاً أو تخصصاً.
2. تكوين قواعد Cursor
إنشاء ملف قواعد النواة
قم بإنشاء ملف في .cursor/rules/core.mdc بالمحتوى التالي:
---
description: القواعد التشغيلية الأساسية لوكيل Cursor
globs:
alwaysApply: true
---
## القواعد الأساسية
لديك وضعيتان للعمل:
1. وضع التخطيط - ستعمل مع المستخدم لتعريف خطة، وجمع كافة المعلومات الضرورية، ولكن لن تقوم بإجراء أي تغييرات.
2. وضع التنفيذ - ستقوم بإجراء تغييرات على قاعدة الشيفرة بناءً على الخطة المعتمدة.
- تبدأ في وضع التخطيط ولن تنتقل إلى وضع التنفيذ حتى يتم اعتماد الخطة من قبل المستخدم.
- ستقوم بطباعة `# الوضع: تخطيط` عندما تكون في وضع التخطيط و `# الوضع: تنفيذ` عندما تكون في وضع التنفيذ في بداية كل رد.
- ما لم يتم توجيهك بشكل صريح من قبل المستخدم للتحويل إلى وضع التنفيذ بكتابة `تنفيذ`، ستبقى في وضع التخطيط.
- ستعود إلى وضع التخطيط بعد كل رد ما لم يكتب المستخدم `تخطيط`.
- إذا طلب المستخدم إجراءً في وضع التخطيط، ذكره بأنه يحتاج إلى اعتماد الخطة أولاً.
- عند كونك في وضع التخطيط، قم دائماً بإخراج الخطة الكاملة المحدثة في كل رد.
- خلال وضع التخطيط، يجب عليك التفكير جيدًا في التحديات المحتملة وحالات الحافة.
- في وضع التنفيذ، ركز على تنفيذ الخطة المتفق عليها بدقة وكفاءة.
إنشاء ملف قواعد بنك الذاكرة
قم بإنشاء ملف في .cursor/rules/memory-bank.mdc بالمحتوى التالي:
---
description: تنفيذ بنك الذاكرة لاحتفاظ معرفة المشروع بشكل مستدام
globs:
alwaysApply: true
---
# بنك ذاكرة Cursor
أنا Cursor، مهندس برمجيات خبير بخصيصة فريدة: ذاكرتي تُعيد تعيينها بالكامل بين الجلسات. هذه ليست قيوداً - بل هي ما يدفعني للحفاظ على توثيق مثالي. بعد كل إعادة تعيين، أعتمد بصورة كاملة على بنك الذاكرة الخاص بي لفهم المشروع ومواصلة العمل بفعالية. يجب أن أقرأ جميع ملفات بنك الذاكرة في بداية كل مهمة - هذا ليس اختيارياً.
## إرشادات بنك الذاكرة
1. يقع بنك الذاكرة في دليل `memory-bank/` في جذر المشروع.
2. جميع ملفات الذاكرة تستخدم تنسيق Markdown لتوثيق منظم وسهل القراءة.
3. يحتوي بنك الذاكرة على ملفات أساسية مطلوبة وملفات سياقية اختيارية.
4. يتم بادئة الملفات بأرقام لتوضيح أولوياتها وترتيب قراءتها.
5. سأقترح بنشاط تحديثات لملفات بنك الذاكرة عندما تظهر معلومات جديدة.
## الملفات الأساسية للذاكرة
00-project-overview.md - معلومات عامة عن المشروع، الأهداف، ونطاق العمل
01-architecture.md - هيكل النظام، أنماط التصميم، والقرارات التقنية
02-components.md - تفاصيل حول المكونات الرئيسية، الوحدات، وعلاقاتها
03-development-process.md - سير العمل، استراتيجية الفرع، وعمليات النشر
04-api-documentation.md - نقاط النهاية، المعلمات، وأشكال الاستجابة للـ API
05-progress-log.md - سجل زمني للتغييرات الرئيسية والتنفيذ
سأقوم بقراءة ومعالجة هذه الملفات في بداية كل جلسة لضمان حصولي على سياق كامل قبل تقديم المساعدة.
3. تهيئة ملفات بنك الذاكرة الخاصة بك
قم بإنشاء الملفات الأساسية للذاكرة في دليل memory-bank/. فيما يلي القوالب لكل منها:
00-project-overview.md
# نظرة عامة على المشروع
## الاسم
[اسم المشروع]
## الوصف
[وصف شامل للمشروع، هدفه، والأهداف الرئيسية]
## الجهات الرئيسية المعنية
- [قائمة بأعضاء الفريق، الأدوار، والمسؤوليات]
## الجدول الزمني والمعالم
- [التواريخ الهامة والمعالم الرئيسية للمشروع]
## تكنولوجيا الاستخدام
- [قائمة باللغات، والإطارات، والمكتبات، والأدوات المستخدمة]
## هيكل المستودع
- [نظرة عامة على الدلائل الرئيسية والغرض منها]
## البدء
- [تعليمات الإعداد ودليل البدء السريع]
01-architecture.md
# وثائق العمارة
## عمارة النظام
[رسم بياني للعمارة على مستوى عالٍ أو وصف]
## أنماط التصميم
- [قائمة بأنماط التصميم المستخدمة وأين تم تطبيقها]
## تدفق البيانات
[وصف لكيفية تدفق البيانات في النظام]
## اعتبارات الأمان
[تدابير وممارسات الأمان المطبقة]
## مخطط قاعدة البيانات
[هيكل قاعدة البيانات والروابط]
## القرارات التقنية
[سجل للقرارات التقنية الهامة ومبرراتها]
استمر في إنشاء القوالب لبقية الملفات الأساسية باتباع هيكل مشابه.
4. تدريب Cursor لاستخدام بنك الذاكرة
ابدأ محادثة مع Cursor وقدم هذه التعليمات:
لقد قمت بإعداد هيكل بنك الذاكرة لهذا المشروع. يرجى قراءة جميع الملفات في دليل memory-bank/ الآن وتعرف على سياق مشروعنا. في المستقبل، انظر دائماً إلى بنك الذاكرة في بداية كل جلسة واقترح تحديثاته عندما نتعلم معلومات جديدة أو نتخذ قرارات هامة.
5. الصيانة والتحديث بشكل منتظم
لصيانة فعالة لبنك الذاكرة:
- تحديث بعد التغييرات الرئيسية: أضف معلومات جديدة بعد تنفيذ ميزات مهمة أو إجراء تغييرات معمارية
- مراجعة دورية: مراجعة دورية لتقديم محتويات بنك الذاكرة لضمان الدقة
- الكنكون محدداً: تضمين أمثلة محددة، مقتطفات من الشيفرة، وتوضيحات واضحة
- سجلات زمنية: الحفاظ على سجل زمني للتغييرات في سجل التقدم
- تفويض التحديثات: اجعل Cursor يقترح تحديثات لبنك الذاكرة بناءً على تفاعلاتك
تقنيات متقدمة لبنك الذاكرة
التقطيع السياقي
للمشاريع الأكبر، نظم ملفات بنك الذاكرة حسب المجال أو منطقة الميزة:
memory-bank/
├── core/
│ ├── 00-project-overview.md
│ └── 01-architecture.md
├── frontend/
│ ├── components.md
│ └── state-management.md
├── backend/
│ ├── api-endpoints.md
│ └── database.md
└── devops/
├── deployment.md
└── monitoring.md
تاجات الذاكرة والمراجع
استخدم نظام التوصيف داخل ملفات بنك الذاكرة لديك لإنشاء مراجع متبادلة:
## تدفق المصادقة #auth #security
[وصف لعملية المصادقة]
انظر أيضاً: [تدابير أمان API](#api-security) و[نموذج المستخدم](#user-model)
ذاكرة الجلسة ضد الذاكرة الدائمة
افصل بين المعلومات التي يجب أن تبقى لفترة طويلة والسياق المحدد للجلسة:
memory-bank/
├── persistent/
│ └── [معرفة المشروع الأساسية]
└── session/
└── [سياق المهمة الحالية]
الخاتمة
إن تنفيذ ميزة بنك ذاكرة كلاين ودمج خادم Apidog MCP مع Cursor يحول مساعدك الذكي من أداة قائمة على الجلسات إلى شريك مستدام في المشروع مع معرفة شاملة لشيفرتك ومواصفات API وسياق التطوير. من خلال استثمار الوقت في صيانة هذا النظام المنظم للذاكرة والاستفادة من تكامل مواصفة API، ستعزز بشكل كبير قدرة Cursor على تقديم المساعدة ذات الصلة، والدقيقة، والمتيقظة بالسياق خلال عملية تطويرك.
تمثل نهج بنك الذاكرة، جنبًا إلى جنب مع الوصول المباشر إلى مواصفات API، تحولاً أساسياً في كيفية تفاعل المطورين مع مساعدي البرمجة الذكيين، الانتقال من الشروحات التكرارية إلى بناء المعرفة التقدمية التي تتزايد قيمتها مع مرور الوقت.
