Command Palette

Search for a command to run…

ZarynZaryn
المفاهيم الأساسية·3 min read

ما هو zev

zev هو محرك موجَّه بالمحتوى للكود والبيانات ومخرجات تعلّم الآلة. في جوهره، يُخزَّن كل كائن — ملف، شجرة، commit، جزء من مجموعة بيانات، نقطة تفتيش لنموذج — بواسطة تجزئة (hash) محتواه الخاص، وتُبنى فوق هذه الفكرة الواحدة مجموعة متنامية من القدرات: تتبّع التاريخ، فهم ما تغيّر فعليًا، مزامنة الملفات الكبيرة بكفاءة، تشغيل تكامل مستمر (CI) يتجاوز العمل المكرر، وتتبّع النسب الكامل لنموذج من البيانات الخام إلى نتيجة منشورة. صُمم zev منذ البداية ليكون قابلاً للتوسّع. تاريخ الإصدارات هو الأساس، وليس السقف — نفس المحرك الذي يخزّن commits الخاصة بك يتتبّع أيضًا تجارب تعلّم الآلة، ويدمج أوزان النماذج، ويكتشف انحراف المقاييس، ويتحقق من قابلية إعادة الإنتاج، ويوثّق النتائج على السلسلة. تُضاف القدرات الجديدة كأوامر جديدة وأنواع عُقد IPLD جديدة على نفس مخزن الكائنات، وليست أنظمة منفصلة مُلحقة من الخارج. ## من أي شيء يتكوّن zev zev هو ثلاثة أجزاء متعاونة، كل منها بُني واختُبر بشكل مستقل قبل ربطها معًا: - **`zev`** — المحرك من سطر الأوامر. يُثبَّت محليًا، ويدير دليل عمل ومخزن كائنات محلي موجَّه بالمحتوى تحت `.zev/`، ويتحدث إلى خادم بعيد عبر HTTP أو SSH أو IPFS. - **`zev-api`** — الخادم. مكتوب بلغة Zig، يخزّن كائنات المستودع والبيانات الوصفية في PostgreSQL وعلى القرص، ويعرض واجهة برمجة JSON عبر HTTP، ويفرض المصادقة والتحكم في الوصول. - **`zev-ci`** — خدمة تكامل مستمر تشغّل خطوط الأنابيب في حاويات Docker معزولة، تُفعَّل بكل push إلى `zev-api`، وتتجاوز الخطوات التي رأت مدخلاتها تنجح من قبل. ## Zaryn: المنصة على الويب **Zaryn** ([zaryn.xyz](https://zaryn.xyz)) هي المنصة المستضافة المبنية فوق هذا المحرك — حيث تعيش المستودعات والمؤسسات والمشكلات (issues) وطلبات السحب (pull requests) والأشخاص فعليًا وتُستعرض. كل مستودع وcommit وملف مثبّت على Zaryn قابل للعنونة بنفس تجزئات المحتوى التي ينتجها عميل `zev` محليًا، لذا ما تراه على الويب هو نظرة مباشرة إلى نفس مخزن الكائنات، وليس نسخة منفصلة. تضيف Zaryn: - مستودعات للكود ونماذج تعلّم الآلة ومجموعات البيانات والوكلاء وتعريفات طوبولوجيا الشبكة، كل منها مع مشكلات وطلبات سحب ورسم بياني للمساهمين - مؤسسات لها هوية تشفيرية خاصة بها، بحيث يمكن التحقق من commits المصادَق عليها نيابة عن مؤسسة بشكل مستقل عن أي عضو بعينه - مراسلة وإشعارات فورية بين المستخدمين - تثبيت IPFS مع إثباتات موقَّعة، بحيث يمكن التحقق من أصالة الملف المثبَّت دون اتصال - خلاصة نشاط عامة وبحث دلالي كامل النص عبر commits والمستودعات - عمليات النشر على أي عنقود Kubernetes أو مضيف Docker عبر `zev-agent`: إصدارات موقّعة فقط، ونشر تدريجي (canary) مضبوط بمقاييس Prometheus، وأسرار من Vault ومديري الأسرار السحابية، وإصدارات عبر عدة أهداف على دفعات، وتصدير ومزامنة GitOps، وأدوار المشاريع، وسجل تدقيق، وتسجيل دخول موحّد (SSO) للمؤسسات — للأشخاص وأنظمة CI ووكلاء الذكاء الاصطناعي (`zev-deploy`، MCP) ## القدرات الأساسية **العنونة بالمحتوى في كل مكان.** يُعرَّف كل كائن بتجزئة محتواه الخاص. ملفان متطابقان في أي مكان من تاريخ المستودع يشغلان نفس الكائن تلقائيًا. **التقسيم إلى أجزاء للملفات الكبيرة.** تُقسَّم الملفات الكبيرة إلى أجزاء محدَّدة بالمحتوى، بحيث لا يتطلب تعديل صغير سوى نقل البايتات التي تغيّرت فعليًا. **مقارنة واعية بشجرة الصياغة المجردة (AST) للكود.** يحلّل zev كود Zig المصدري بمحلّل AST حقيقي ويُبلّغ عن التغييرات البنيوية — إعادة تسمية الدوال، تغيير التوقيع، تغيير الجسم — وليس فقط اختلافات نصية سطرًا بسطر. **تتبّع تجارب تعلّم الآلة ومجموعات البيانات.** تتتبّع `zev experiment` و`zev dataset` و`zev lineage` الفرضيات، وتقسيمات مجموعة البيانات، وتخصيص الأجزاء، والرسم البياني الكامل للنسب الذي يربط نموذجًا بالبيانات والنصوص البرمجية التي جاء منها. **مقارنة ودمج أوزان النماذج.** تقارن `zev wdiff` الموترات (tensors) مباشرة داخل ملفات `.safetensors` وPyTorch وNumPy. تدمج `zev merge-weights` نقاط التفتيش بالمتوسط، أو الاستيفاء الموزون، أو الاستيفاء الكروي (SLERP)، أو TIES-merging. **الانحراف والانحدار وقابلية إعادة الإنتاج.** تكتشف `zev drift` و`zev threshold` انحدار المقاييس مقابل خط أساس تلقائيًا؛ تُعيد `zev reproduce` تشغيل أمر مسجَّل وتتحقق من مخرجاته مقابل النتيجة المسجَّلة ضمن هامش تسامح. **النسب والذاكرة (memoization) لـCI.** يمكن لـCI تجاوز إعادة تشغيل خطوة كاملة في خط الأنابيب عندما يكون المزيج الدقيق من محتوى المصدر وصورة الحاوية والأمر قد نجح من قبل. **التوثيق والدمج الفدرالي.** ترسو `zev notarize` تجزئة لقطة (snapshot) على السلسلة. تدمج `zev fedmerge` العمل من ملف `.car` يُتبادل مباشرة بين مستودعين، دون الحاجة لأي خادم مركزي. ## لمن هذا موجّه بُني zev كنظام حقيقي وعامل — كل ميزة موصوفة في هذا التوثيق نُفّذت، ونُشرت على خادم حقيقي، وتم التحقق منها مقابل أوامر حقيقية وبيانات حقيقية قبل كتابتها هنا. هذا ليس مواصفات لسلوك مقصود؛ بل وصف لما يفعله النظام قيد التشغيل فعليًا.