كل الأوامر

الأوامر مجمّعة حسب ما تفعله، والمجموعات مرتبة من اليومي إلى المتخصص. معظم الناس يحتاجون إلى المجموعات الثلاث الأولى فقط. في الطرفية، يسرد `zev help` كل الأوامر، ويشرح `zev help <command>` استخدام أمر واحد. اضغط `/` في هذه الصفحة للبحث. **في أسطر الاستخدام:** `<name>` شيء تكتبه أنت، و`[name]` اختياري، و`a | b` أحدهما. ## قائمة سريعة | أريد أن… | الأمر | |---|---| | أبدأ مشروعًا جديدًا | [`zev init`](#zev-init) | | أنسخ مشروعًا من Zaryn | [`zev clone`](#zev-clone) | | أرى ما غيّرته | [`zev status`](#zev-status)، [`zev diff`](#zev-diff) | | أختار ما أحفظه | [`zev add`](#zev-add) | | أحفظ نسخة | [`zev commit`](#zev-commit) | | أرى السجل | [`zev log`](#zev-log)، [`zev show`](#zev-show) | | أتراجع عن تغييرات ملف | [`zev restore`](#zev-restore) | | أحذف ملفًا | [`zev rm`](#zev-rm) | | أضع عملي جانبًا لحظة | [`zev stash`](#zev-stash) | | أعمل على شيء منفصل | [`zev branch`](#zev-branch)، [`zev checkout`](#zev-checkout) | | أجمع الفروع | [`zev merge`](#zev-merge) | | أرسل عملي إلى Zaryn | [`zev push`](#zev-push) | | أحصل على عمل الآخرين | [`zev pull`](#zev-pull) | | أطلب مراجعة | [`zev pr`](#zev-pr) | ## بدء مشروع ### zev init يجعل المجلد الحالي (أو المجلد الذي تسمّيه) مستودع zev. ينشئ مجلدًا مخفيًا `.zev` للسجل ولا يلمس ملفاتك. ```bash zev init zev init my-project ``` ### zev clone ينسخ مستودعًا إلى حاسوبك: سجله كاملًا، وملفاته، و`origin` مضبوطًا على مصدره. يُسمّى المجلد باسم المستودع ما لم تعطه اسمًا. ```text zev clone <address> [folder] [--branch <name>] ``` ```bash zev clone someone/project zev clone someone/project my-copy --branch dev zev clone someone/project@dev zev clone https://zaryn.xyz/someone/project ``` ### zev config يقرأ إعدادات هذا المستودع ويغيّرها. أهمها اسمك وبريدك. ```bash zev config set user.name "اسمك" zev config set user.email "you@example.com" zev config list ``` ## العمل اليومي ### zev status يعرض أين أنت: الفرع، وما هو مجهّز للإيداع التالي، وما غيّرته دون تجهيز، والملفات المحذوفة، والملفات الجديدة غير المتتبَّعة. كل قسم يخبرك بالأمر التالي. ```bash zev status zev status --json # للسكربتات ``` ### zev add يجهّز التغييرات، أي يختارها للإيداع التالي: الملفات الجديدة والمتغيرة والمحذوفة. ```bash zev add notes.md # ملف واحد zev add src # مجلد كامل zev add . # المشروع كله zev add old.txt # old.txt محذوف: يجهّز الحذف ``` الملفات المطابقة لـ `.zevignore` تُتخطى، والملفات غير المتغيرة منذ آخر إيداع لا تُجهَّز، لذا تشغيل `zev add .` آمن دائمًا. ### zev commit يحفظ كل ما جهّزته إيداعًا جديدًا مع رسالة تصفه. ```bash zev commit -m "إصلاح زر الدخول على الشاشات الصغيرة" ``` ### zev diff يعرض الأسطر المتغيرة: `+` مضاف و`-` محذوف. ```text zev diff [file | folder] تغييراتك غير المجهّزة zev diff --staged [file] ما سيحتويه الإيداع التالي zev diff <commit> [<commit>] [-- file] بين الإيداعات ``` ### zev log يسرد الإيداعات، الأحدث أولًا. ```bash zev log zev log --oneline zev log -n 30 ``` ### zev show يعرض إيداعًا واحدًا وما غيّره. دون إيداع يعرض الأحدث. ```bash zev show zev show 5f7f5e22 zev show HEAD~1 ``` **تسمية الإيداعات:** حيثما طلب zev إيداعًا يمكنك كتابة `HEAD` أو `HEAD~2` أو اسم فرع أو اسم وسم أو بداية معرّف الإيداع (4 أحرف على الأقل). ### zev restore يتراجع عن تغييرات الملفات. ```text zev restore <file | folder | .>... تخلّص من تغييراتك: عودة إلى آخر إيداع zev restore --staged <file | folder | .>... ألغِ التجهيز: تبقى تغييراتك خارج الإيداع التالي ``` ما تتخلص منه بـ `zev restore` لم يُودَع قط، فلا يمكن استعادته. إن كنت قد تحتاجه لاحقًا فاستخدم [`zev stash`](#zev-stash). ### zev rm يحذف ملفًا متتبَّعًا ويجهّز الحذف للإيداع التالي. ```bash zev rm old.txt zev rm --cached secrets.env # أوقف التتبع وأبقِ الملف ``` يرفض zev حذف ملف فيه تغييرات غير مودعة؛ `--force` يحذفه رغم ذلك. ### zev stash يضع تغييراتك غير المودعة جانبًا ويعطيك مجلدًا نظيفًا، ثم تعيدها لاحقًا. ```text zev stash [save [message]] ضع التغييرات جانبًا zev stash list اعرضها zev stash pop [id] أعِد الأحدث واحذفه zev stash apply [id] أعِده واحتفظ به zev stash drop [id] احذفه ``` ## الفروع انظر [الفروع والدمج](/docs/ar/branches) للقصة كاملة. ### zev branch ```bash zev branch # اعرض الفروع zev branch new-search # أنشئ فرعًا zev branch -d new-search # احذفه ``` ### zev checkout ينتقل إلى فرع آخر ويحدّث ملفاتك لتطابقه. لا يكتب أبدًا فوق عملك غير المودع دون `--force`. ```bash zev checkout new-search zev checkout -b new-search # أنشئه وانتقل إليه ``` ### zev switch مثل `zev checkout`. و`zev switch -c <new-branch>` ينشئ فرعًا وينقلك إليه. ### zev merge يُدخل إيداعات فرع آخر إلى الفرع الذي أنت عليه. ```text zev merge <branch> zev merge <branch> --resolve عندما غيّر الطرفان الأسطر نفسها zev merge --continue | --abort ``` ### zev rebase يعيد تطبيق إيداعات فرعك فوق فرع آخر. إن توقف بسبب تعارض، استخدم `zev merge <branch> --resolve`. ### zev cherry-pick ينسخ إيداعًا واحدًا إلى فرعك: `zev cherry-pick 47bec4f5`. ### zev tag يعطي إيداعًا اسمًا ثابتًا، عادةً لإصدار. ```bash zev tag v1.0 zev tag list zev tag -d v1.0 ``` ## المشاركة على Zaryn ### zev login يسجّل دخول هذا الحاسوب إلى Zaryn، مرة لكل حاسوب. ```bash zev login zaryn.xyz --register sara --email sara@example.com zev login zaryn.xyz --device ``` ### zev whoami يعرض الخادم والحساب الذي سجّلت به. ### zev logout ينسى تسجيل الدخول المحفوظ على هذا الحاسوب. ### zev new ينشئ المشروع الحالي على Zaryn ويربطه بوصفه `origin`. ### zev push يرسل إيداعاتك. دون شيء بعده يرسل فرعك الحالي إلى `origin`. ```bash zev push zev push origin feature-x ``` ### zev pull يجلب الإيداعات الجديدة ويحدّث ملفاتك، دون أن يكتب فوق تغييرات لم تودعها. ```bash zev pull zev pull origin main ``` ### zev remote ```bash zev remote zev remote add upstream team/project zev remote remove upstream ``` ## العمل مع الآخرين ### zev pr يفتح طلب دمج من فرعك الحالي، ويصوغ العنوان والوصف من إيداعاتك. `zev pr list | view <n> | merge <n>`. ### zev issue يفتح البلاغات (issues) ويديرها: `zev issue --title "…"`، `zev issue list`. ### zev fork-repo ينشئ نسختك من مستودع شخص آخر على Zaryn: `zev fork-repo someone/project --clone`. ### zev ci `zev ci enable` يشغّل CI لمستودع، و`zev ci status` يعرض آخر التشغيلات. ### zev mcp خادم MCP ليستخدم وكيل ذكاء اصطناعي Zaryn عبر zev: `claude mcp add zaryn -- zev mcp`. ## اعرف أكثر ### zev blame لكل سطر من ملف، الإيداع والمؤلف اللذان غيّراه آخر مرة: `zev blame src/login.js`. ### zev bisect يجد الإيداع الذي أفسد شيئًا بتنصيف السجل: `zev bisect start`، `zev bisect bad`، `zev bisect good <commit>`، `zev bisect reset`. ### zev search يبحث في الإيداعات والتجارب والمقاييس: `zev search commits login`. ### zev compare يضع إيداعين أو فرعين جنبًا إلى جنب: `zev compare branches main feature`. ## الشبكات الخاصة والأمان ### zev net ينضم بهذا الجهاز إلى شبكة فريقك الخاصة (Premium) عبر WireGuard: `sudo zev net up <owner>/<network>`، `zev net status`، `zev net share <port>`. ### zev encrypt يشفّر ملفات مستودع خاص على أجهزتك: `zev encrypt on | share | recovery | unlock | approve | rotate`. ### zev verify-storage يتحقق بالبراهين أن الخادم يخزّن كل ما أرسلته آخر مرة. ### zev advisory يعلن إيداعات مخترقة لإبلاغ أصحاب كل ما بُني عليها. و`zev taint check` بوابة CI. ### zev identity يعرض مفتاح التوقيع لهذا المستودع. و`zev sign <cid>` و`zev verify <cid>` للتوقيع والتحقق. ### zev notarize يثبّت تجزئة لقطة أو إيداع على سلسلة كتل. ### zev audit تقرير كامل عن المنشأ. ## تعلم الآلة | الأمر | ما يفعله | |---|---| | `zev metrics set\|show\|list\|compare` | تسجيل أرقام (الدقة، الخسارة…) مع الإيداعات | | `zev check` | بوابة تراجع لـ CI | | `zev threshold set\|list` | الحدود التي يفرضها `zev check` | | `zev history <metric>` | اتجاه مقياس عبر الإيداعات | | `zev sdiff` | فرق دلالي: المقاييس وبنية الشيفرة | | `zev experiment …` | تتبع فرضية حتى نتيجتها | | `zev dataset …` | مجموعات البيانات وأجزاؤها وأين استُخدمت | | `zev lineage …` | ما صُنع من ماذا | | `zev context …` | أي التغييرات جاءت من بشر أو من نماذج ذكاء اصطناعي | | `zev wdiff <a> <b>` | مقارنة ملفات أوزان النماذج | | `zev merge-weights <a> <b> --output <out>` | دمج نقاط الحفظ | | `zev drift …` | ملاحظة انحراف المقاييس | | `zev reproduce …` | التحقق من إعادة إنتاج تشغيل | | `zev snapshot …` | لقطات مسمّاة للمستودع | | `zev suggestions` | أنساب مستنتجة من أوزان النماذج | ## متقدم `zev hook`، `zev gc`، `zev export`/`import`/`archive-info`، `zev publish`، `zev ipfs`، `zev ipns`، `zev peer`، `zev dag`، `zev ipld`، `zev graft`، `zev fedmerge`، `zev fork`، `zev fetch-range`، `zev cat`/`hash`، `zev verify-release`/`verify-sth`. التفاصيل في [النسخة الإنجليزية](/docs/en/commands#advanced). ## zev نفسه ### zev self ```bash zev self update zev self uninstall ``` ### zev version `zev --version` يطبع الإصدار. ### zev help `zev help` يسرد كل الأوامر، و`zev help <command>` يشرح أمرًا واحدًا، ويقترح الأمر الأقرب عند الخطأ الإملائي.