مزامنة Git
تربط مزامنة Git دليل قاعدة معرفة بمستودع Git بعيد، فتجلب سجلّ الإصدارات ومزامنة الفريق إلى مستندات Markdown الخاصة بك. وهي الأساس لميزات التعاون في Moraya — إذ تُبنى مراجعة الفريق ومراجعة الذكاء الاصطناعي فوقها.
المتطلّبات
تستدعي مزامنة Git أمر git في نظامك مباشرةً، لذا تحتاج إلى تثبيت Git على جهازك. ومعظم البيئات المهنية تمتلكه بالفعل.
ربط قاعدة معرفة
يمكنك ربط قاعدة معرفة بمستودع بعيد باتجاهين:
- الاستنساخ (Clone) لمستودع موجود إلى قاعدة معرفة محلية جديدة.
- التهيئة والدفع (Init & push) — تحويل قاعدة معرفة محلية موجودة إلى مستودع ودفعها إلى مستودع بعيد فارغ.
بمجرّد الربط، يتتبّع Moraya مقدار تقدّم نسختك المحلية أو تأخّرها عن المستودع البعيد ويعرض حالة المزامنة في الواجهة.
العمليات اليومية
| الإجراء | ما يفعله |
|---|---|
| Pull | جلب تحديثات المستودع البعيد ودمجها |
| Push | إرسال إيداعاتك المحلية إلى المستودع البعيد |
| Commit | تحضير الملفات المتغيّرة وتسجيل إيداع مع رسالة |
| Status | معرفة الملفات المعدّلة أو المضافة أو المحذوفة |
| History | تصفّح سجلّ الإيداعات للمستودع أو لملف واحد |
| Diff | مقارنة إصدارات مستند |
بيانات الاعتماد والأمان
لا تُخزَّن رموز الوصول أبداً كنص عادي ولا تُضمَّن في عنوان المستودع البعيد. يحتفظ Moraya بها في سلسلة مفاتيح نظام التشغيل ويحقنها فقط طوال مدّة تنفيذ أمر git عبر GIT_ASKPASS:
- تُستخرج الرموز من سلسلة المفاتيح لكل عملية ولا تُكتب أبداً على القرص داخل المستودع.
- تُتحقَّق وسائط git مقابل قائمة سماح — وتُرفض الرايات المعرّضة للحقن مثل
--upload-packو--receive-pack. - تُرشَّح متغيّرات بيئة العمليات الفرعية، ويُقتطع مخرج الأمر بحيث لا تتسرّب مسارات الملفات والتفاصيل الداخلية.
- للعمليات مهل زمنية (يُمنح الاستنساخ مدّة أطول من عمليات السحب والدفع الاعتيادية).
ما يُزامَن
تُزامَن ملفات Markdown الخاصة بك كالمعتاد. كما يحتفظ Moraya بدليل .moraya/ في قاعدة المعرفة لبيانات التعاون — تُشارَك سلاسل المراجعة وحالة القفل مع فريقك عبر المستودع نفسه، بينما تُستبعَد الآثار المحلية على الجهاز (فهارس البحث، القواعد المشتقّة).