klypix-mcp: ذاكرة مشتركة لـ Claude Code وCodex وCursor

ثبّته في مجلد المشروع

افتح الطرفية داخل مجلد المشروع، ثم شغّل:

node --version
npx klypix-mcp install
npx klypix-mcp doctor

ينشئ المثبّت عقلًا إن لم يوجد، ويضبط تكامل أدوات البرمجة التي يكتشفها. ويكتب إعدادات في المشروع ومجلد المستخدم؛ راجع تفاصيل الأذونات. أعد فتح أداة البرمجة أو توصيل خادم MCP، واسمح بالأدوات عندما يطلب منك مضيفك ذلك.

التثبيت التفاعلي يفعّل البحث المحلي بالمعنى افتراضيًا. استخدم --no-semantic لتخطيه، أو --semantic لتفعيله في التثبيت غير التفاعلي. يتطلب تنزيلًا أوليًا للنموذج؛ وبدونه يكون البحث بالكلمات. مسار إضافة Claude يختلف؛ راجع تعليماته.

كيف يختلف التكامل بين الأدوات؟

راجع إعداد Cline وCopilot وGemini CLI وWindsurf وAider وحدود كل تكامل.

جرّب قرارًا، ثم جلسة جديدة، ثم تصحيحًا

استخدم مشروعًا تجريبيًا، أو استبدل المثال بقرار حقيقي قبل حفظه. ما يلي استدعاءات أدوات ينفّذها وكيلك، وليست أوامر طرفية. استبدل /absolute/path/to/project بالمسار الكامل للمشروع. النطاق files: [] يعني أن التجربة لا تتضمن تعديل ملفات الكود.

1. سجّل القرار وسببه

brain_sync { project: "/absolute/path/to/project", phase: "start",
  intent: "Record the trial storage decision", files: [] }
brain_note { area: "Storage",
  text: "Use SQLite for the trial project database because this prototype runs on one machine." }
brain_sync { project: "/absolute/path/to/project", phase: "complete" }

2. افتح جلسة جديدة في المشروع نفسه

يمكنك الانتقال إلى أداة أخرى مدعومة. اطلب استرجاع القرار:

brain_sync { project: "/absolute/path/to/project", phase: "start",
  intent: "Review the trial storage decision", files: [] }
brain_ask { question: "Which database does the trial project use, and why?" }

تحقق من أن البطاقة المسترجعة تذكر SQLite وسبب استخدامه.

3. صحّح القرار واسأل مرة أخرى

brain_note { area: "Storage",
  text: "CORRECTION: Use PostgreSQL instead of SQLite for the trial project database because the trial now needs concurrent writes from several machines." }
brain_ask { question: "Which database does the trial project use now, and why?" }
brain_sync { project: "/absolute/path/to/project", phase: "complete" }

افحص البطاقات: ينبغي أن يظهر PostgreSQL بوصفه القرار الحالي، وأن يبقى SQLite في السجل بوصفه قرارًا مستبدلًا. يجب أن يسمّي التصحيح القرار السابق؛ كلمة CORRECTION وحدها لا تضمن مطابقته. هذه تجربة لمسار الحفظ والاسترجاع، وليست مقياسًا لدقة الاسترجاع في مشروع كبير.

شارك السجل مع الفريق عبر Git

أضف brain.klypix وإعدادات المشروع المدارة إلى مستودعك. ثبّت المحرك في كل نسخة من المستودع، ثم اسحب التحديثات وراجع التغييرات. يضبط المثبّت برنامج دمج البطاقات في مستودعات Git؛ أما النسخة التي لم يُثبّت فيها فتواجه تعارضًا ثنائيًا عاديًا. انظر خطوات الفريق. احتفظ أيضًا بملفات القواعد الثابتة وسجلات القرارات المعتمدة.

الحدود وحل المشكلات

• الأدوات غير ظاهرة؟ أعد توصيل المضيف وراجع doctor. سلامة الإعداد لا تثبت أن المضيف حمّل الأدوات.
• القرار غير موجود؟ تأكد من مسار المشروع ونجاح brain_note. العقل الجديد لا يعرف تاريخًا لم يُسجّل.
• التنسيق المستقل محلي. حضور الجلسات وتنبيهات تداخل الملفات يقتصران على الجهاز ومستخدم نظام التشغيل نفسيهما. التنبيهات استشارية.
• راجع حدود الخصوصية. الاسترجاع محلي، لكن سياقًا يُرسل إلى وكيل سحابي قد يصل إلى مزوّده. إعداد النموذج والتحديثات قد يستخدمان الشبكة. راجع تفاصيل الأذونات.
• الإزالة: تعليمات الإزالة تميّز بين تثبيت الجهاز وملفات كل مشروع. لا تعدّل brain.klypix يدويًا.