ما المقصود بذاكرة مشروع مشتركة؟
هي سجل دائم لما يفهمه المشروع حاليًا: لماذا اختير تصميم، وما البديل الذي رُفض، وما الدليل، وما السؤال الذي لم يُحسم. تحفظ المعرفة التي سجّلتها الجلسات بدل الاعتماد على وجودها في محادثة أداة واحدة.
في Klypix تُحفظ هذه المعرفة في ملف قابل للنقل. يمكن لوكيل مدعوم استرجاع السياق المناسب لمهمته، ثم تسجيل نتيجة مفيدة. وعندما يُسجّل تصحيح صريح، يصبح القرار المصحّح هو الحالي ويبقى القديم مؤرشفًا مع تاريخ التصحيح وعلاقته به.
السجل لا يعيد بناء ما لم يُكتب، ولا يثبت صحة ما كُتب. يستطيع الإنسان فحص البطاقات ومراجعها وتعديلها في تطبيق Windows؛ ويظل فحص الكود والدليل جزءًا من العمل.
متى تكفي ملفات القواعد؟
يكفي ملف قصير مثل AGENTS.md أو CLAUDE.md غالبًا لاتفاقيات ثابتة: أمر الاختبار، وأسلوب الكود، وحدود المجلدات. وهو نص سهل المراجعة في Git. تأكد من أن الأداة التي تستخدمها تقرأ الملف الذي اخترته.
| الطريقة | متى تفيد؟ | ما الذي تتولاه أنت؟ |
|---|---|---|
| ملفات القواعد | التعليمات والاتفاقيات المستقرة التي تقرؤها الأداة. | مراعاة اختلاف الملفات التي تقرؤها الأدوات، وتسجيل أسباب التغيير يدويًا. |
| سجلات القرارات والمواصفات | تصاميم تحتاج إلى مراجعة بشرية وتاريخ واضح في Git. | كتابة القرارات وتصحيحها، وتوجيه الوكيل إلى السجل المناسب. |
| ذاكرة الأداة الخاصة | استمرار السياق داخل الأداة التي حفظته. | التحقق من موقع التخزين وكيفية إتاحته لأداة أخرى أو لزميل. |
| عقل مشروع مشترك | قرارات وأدلة وتصحيحات وأسئلة تتغير بين الجلسات والأدوات. | إعداد التكامل لكل أداة، والتقاط المعرفة المهمة، والتحقق من جودة الاسترجاع. |
يمكن الجمع بين هذه الأساليب. تحتفظ القواعد بالتوجيهات الثابتة، وتطلب من الوكيل الرجوع إلى العقل عندما يحتاج إلى تاريخ القرار وسياقه. وللمقارنة بين منتجات محددة، اقرأ دليل أدوات ذاكرة المشروع المشتركة بالإنجليزية.
مثال عملي: قرار، ثم جلسة جديدة، ثم تصحيح
لنفترض أن فريقًا اختار SQLite لنموذج أولي يعمل دون اتصال، ثم غيّر الاختيار إلى PostgreSQL عندما أصبح تعدد الكتّاب مطلبًا. هذا مثال توضيحي لا نتيجة اختبار لمنتجك.
- سجّل القرار وسببه. تطلب جلسة Claude Code تسجيل الاختيار ومبرره باستخدام
brain_note، مع مرجع إلى مواصفة أو ملف أو نتيجة اختبار عند توفره. - ابدأ جلسة جديدة في أداة أخرى. تستدعي جلسة Codex مثلًا
brain_syncمع المسار المطلق للمشروع ووصف المهمة ومسارات الملفات الدقيقة المتوقع تعديلها. تحصل على سياق مناسب للمهمة. - اسأل عن القرار. تستخدم الجلسة
brain_askلمعرفة قاعدة البيانات المختارة ولماذا اختيرت. تراجع المراجع والكود الحالي قبل العمل. - سجّل التصحيح صراحة. عند تغير المتطلبات، تسجّل الجلسة قرارًا يتضمن إشارة
CORRECTIONواسم القرار القديم والمبرر الجديد. التصحيح المقصود هو ما يربط الحالي بسابقه؛ لا يُفترض أن النظام يستنتج كل تغيير تلقائيًا. - تحقق من التسليم. تبدأ جلسة جديدة وتسأل مرة أخرى. افحص ظهور القرار الحالي، وإمكانية الرجوع إلى القرار السابق بوصفه مستبدلًا، ثم أكمل المهمة عبر
brain_sync.
يمكن استخدام brain_challenge قبل اعتماد اقتراح للبحث عن قرارات سابقة تعارضه. عدم ظهور اعتراض يعني عدم العثور على إشارة تعارض، ولا يعني أن الاقتراح ثبتت صحته.
كيف يختلف التكامل بين أدوات البرمجة؟
لا تحصل جميع الأدوات على مستوى الأتمتة نفسه. هذه المسارات موثّقة في تعليمات المحرك الرسمية بالإنجليزية:
| الأداة | مسار التكامل |
|---|---|
| Claude Code | أدوات MCP وخطافات لدورة الجلسة: سياق عند البداية ومع الطلب، والتقاط تلقائي للقرارات المكتوبة بعلامات مخصصة. |
| Codex | أدوات MCP وبوابة brain_sync. الخطافات اختيارية وتضيف سياقًا؛ ولا تلتقط القرارات تلقائيًا. استخدم brain_note للتسجيل الصريح. |
| Cursor وCline وVS Code / Copilot وGemini CLI وAntigravity | إعداد MCP داخل المشروع وقواعد تطلب من الوكيل استخدام العقل. الاسترجاع والتسجيل يعتمدان على استدعاء الأدوات، وليس على خطافات تلقائية مماثلة. |
| Windsurf | قواعد خاصة بالمشروع، والوصول إلى الأدوات عبر إعداد MCP العام للأداة. |
| Aider | قواعد للمشروع ومسار عبر سطر الأوامر، وليس اتصال MCP. |
| Claude Desktop | تعديل إعداد يدوي لمرة واحدة كما توضّح وثائق المحرك؛ لا يضبطه أمر التثبيت تلقائيًا. |
نجاح كتابة الإعداد لا يثبت أن المضيف سيستدعي الأدوات كما تتوقع. جرّب قراءة قرار وتسجيله وتصحيحه في الأدوات التي تستخدمها فعليًا قبل الاعتماد على التسليم.
كيف أشارك العقل مع زملائي؟
يمكن أن ينتقل السجل الدائم مع الكود عبر Git. نفّذ الإعداد داخل المشروع على كل جهاز:
npx klypix-mcp install- ينشئ الأمر
brain.klypixإذا لم يوجد، ويهيئ الأدوات المدعومة التي يكتشفها على الجهاز، ويتحقق من استجابة أدوات MCP. - أضف ملف العقل وملفات الإعداد والقواعد المطلوبة إلى المستودع مع الكود، وراجع ما ستشاركه قبل إضافته.
- يسجّل التثبيت أداة دمج
.klypixفي مستودعات Git. يمكن تسجيلها في نسخة أخرى بأمرnpx klypix-mcp git-driver install. التسجيل مطلوب على كل جهاز؛ إعداد Git المحلي لا ينتقل بمجرد نسخ المستودع. - عند الدمج، تُدمج البطاقات من الجانبين، ويُحتفظ بنسختين إذا تغيرت البطاقة نفسها بشكل مختلف. راجع تغييرات البطاقات بالأمر
npx klypix-mcp diff main، مع استبدالmainبفرع المقارنة المناسب لمستودعك.
النسخة التي لم تسجّل أداة الدمج تحصل على تعارض ملف ثنائي عادي. يحدث الدمج عند السحب أو الدمج في Git؛ ولا يجعل الجلسات على أجهزة مختلفة مرئية لبعضها. يبقى Git مسؤولًا عن تاريخ الكود والعقل.
الملف نفسه أرشيف ZIP موثّق يمكنك فكّه وفحصه، ومحلّله منشور ضمن المحرك المفتوح المصدر. تفاصيل قابلية النقل وما الذي يحتويه ملف المشروع.
ما حدود الخصوصية والتنسيق؟
- التنسيق الافتراضي محلي. الحضور وتنبيهات تداخل الملفات تخص الجلسات المتصلة تحت مستخدم النظام نفسه وعلى الجهاز نفسه. التنبيهات تعتمد على المسارات الدقيقة التي تعلنها الجلسات، وهي إرشادية ولا تمنع تعديل ملف.
- نقل السجل يختلف عن مشاركة الجلسة الحية. نقل
brain.klypixعبر Git يحمل المعرفة المسجّلة، ولا يحمل حضور الوكلاء على أجهزة زملائك. - أنت تشغّل الأدوات. لا ينشئ Klypix وكلاء البرمجة ولا يشغّلهم أو يوجّههم أو يشرف على تنفيذهم.
- الملف المحلي ليس ضمانًا لخصوصية كل الطلبات. يمكن أن يصل السياق المعطى لوكيل سحابي إلى مزوّده. راجع سياسة الخصوصية بالإنجليزية وإعدادات أدواتك قبل استخدام معلومات حساسة.
- المعرفة تحتاج إلى عناية. يبدأ العقل بما تسجّله، والتصحيح يحتاج إلى إشارة صريحة، والمصدر المسجّل يحتاج إلى تحقق. لا توجد ضمانات بأن الاسترجاع سيجد كل قرار أو أن الوكيل سيلتزم به.
ما الذي اختُبر، وما الذي لم يُختبر؟
في 24 سبتمبر 2026، أُجري اختبار المطابقة المنشور لمحرك klypix-mcp 1.86.2 على Windows مع Node 24.13.1، ونجحت فحوصه الخمسة عشر. تنشر Dahshan Labs النتيجة الخام ونطاق الاختبار ومصدر المشغّل لذلك الإصدار.
اختبر المشغّل مشروعًا مؤقتًا وعميلَي MCP معزولين: استرجاع السياق، وظهور الجلسات، والتداخل في الملفات، وتسليم ملاحظات التنسيق. وتستخدم أجزاء إضافية بيانات اختبار وآليات محاكاة للترحيل بين الأجهزة. هذا اختبار أجراه مؤلفو المحرك للبروتوكول؛ لا يثبت التقاطًا تلقائيًا داخل واجهات Claude Code أو Codex أو Cursor، ولا يمثل تجربة فعلية على كمبيوترين.
اختبار حفظ قرار وتصحيحه عبر جلسات جديدة
في اليوم نفسه، نجحت إحدى عشرة حالة تحقق في تجربة منفصلة باستخدام أربع عمليات MCP جديدة ومجلدات منزلية فارغة. سُجّل اختيار SQLite، ثم صُحّح صراحة إلى PostgreSQL، ثم نُقل ملف العقل وحده إلى مسار محلي آخر واستُرجع القرار الحالي منه.
يمكنك فحص القرارات والنصوص المعادة وحالات التحقق وتنزيل البرنامج لإعادة التجربة. استخدمت التجربة قرارًا اصطناعيًا واحدًا وتصحيحًا واحدًا واسترجاعًا لفظيًا بمصطلحات مشتركة؛ لا تقيس فهم الصياغات المختلفة أو دقة الاسترجاع في المشاريع الكبيرة، ولا أداء وكيل لغوي أو تفوق المنتج على غيره.
لتقييم ملاءمته لفريقك، اختبر قرارات حقيقية، وغيّر صياغة أسئلة الاسترجاع، وجرّب جلسة جديدة ونسخة المستودع عند زميل. التعليمات التفصيلية في تجربة التسليم بين الأدوات بالإنجليزية.
ابدأ بتجربة في مشروع واحد
اتبع تعليمات التثبيت الرسمية بالإنجليزية. اختر مشروعًا مناسبًا للتجربة، وسجّل قرارًا حقيقيًا وسببه ودليله. اسأل عنه من جلسة جديدة في أداة مدعومة أخرى، ثم سجّل تصحيحًا صريحًا وكرر السؤال. قيّم النص والمراجع التي عادت إليك.
لرؤية العقل مع الملفات والملاحظات والأدلة وتحريره بصريًا، حمّل تطبيق Klypix على Windows. المحرك المجاني لا يحتاج إلى هذا التطبيق. راجع الأسعار لمزايا السحابة والشروط الحالية.