شارك عملك على Zaryn

تبقى إيداعاتك على حاسوبك حتى **ترسلها** (push). الإرسال ينقلها إلى Zaryn حيث يراها الآخرون ويستنسخون المشروع ويرسلون عملهم. و**الجلب** (pull) يأتيك بإيداعاتهم الجديدة. ## سجّل الدخول (مرة لكل حاسوب) **جديد على Zaryn؟** أنشئ حسابًا من داخل أي مجلد مشروع zev: ```bash zev login zaryn.xyz --register your-username --email you@example.com ``` يرسل لك zev رمزًا من 6 أرقام؛ اكتبه عند الطلب. وإن أغلقت الطرفية قبل وصول الرمز، أكمل لاحقًا بهذا: ```bash zev login zaryn.xyz --register your-username --code 123456 ``` **لديك حساب بالفعل** (أنشأته على الموقع)؟ سجّل الدخول عبر متصفحك: ```bash zev login zaryn.xyz --device ``` يعرض zev رابطًا ورمزًا. افتح الرابط، وتأكد من تطابق الرمز، واختر ما يُسمح لهذا الحاسوب بفعله، ووافق. لمعرفة الحساب الذي سجّلت به أو لتسجيل الخروج: ```bash zev whoami zev logout ``` يُحفظ تسجيل دخولك في `~/.config/zev/credentials` ولا يقرؤه غيرك. كل أوامر zev تستخدمه، فلا تنسخ رموز الوصول أبدًا. ## ضع مشروعك على Zaryn من مجلد مشروعك: ```bash zev new ``` ينشئ `zev new` المستودع على Zaryn ويحفظ عنوانه **مستودعًا بعيدًا** (remote) باسم `origin`. ثم أرسل إيداعاتك: ```bash zev push ``` دون أي شيء بعده، يرسل `zev push` الفرع الذي أنت عليه إلى `origin`. مشروعك الآن على `https://zaryn.xyz/your-username/notes`. ## احصل على نسخة من مشروع (استنساخ) ```bash zev clone someone/their-project cd their-project ``` ينشئ `zev clone` مجلدًا باسم المشروع، وينزّل سجله كاملًا، ويضع الملفات في مكانها، ويضبط `origin` على المكان الذي جاء منه. أضف اسم مجلد لتضعه في مكان آخر، أو `--branch` لتبدأ على فرع آخر: ```bash zev clone someone/their-project my-copy --branch dev ``` صفحة كل مستودع على Zaryn تعرض أمر استنساخه جاهزًا للنسخ. يجري الاستنساخ والجلب على دفعات: بضعة طلبات تحمل السجل كله (أربعة في الوقت نفسه للمستودعات الكبيرة)، وكل ملف يُتحقق منه بتجزئته قبل حفظه. الملفات الكبيرة تأتي على قطع، والجلب اللاحق ينزّل القطع التي تغيّرت فقط. المستودعات الخاصة تتطلب أن تكون مسجّلًا بحساب له صلاحية الوصول. ## ابقَ محدَّثًا (الجلب) ```bash zev pull ``` ينزّل `zev pull` الإيداعات الجديدة لفرعك من `origin` ويحدّث ملفاتك لتطابقها. لا يكتب zev أبدًا فوق عمل لم تودعه. إن كان سيستبدل ملفًا غيّرته، فلن يغيّر `zev pull` أي ملف وسيخبرك أي ملف يعترض. الإيداعات الجديدة تُحفظ رغم ذلك فلا يضيع شيء. أودِع تغييراتك أو ضعها جانبًا (stash)، ثم شغّل `zev checkout <branch>` لتحديث ملفاتك. ## روتين الفريق عندما يعمل عدة أشخاص على مشروع واحد، يجنّبك هذا الترتيب معظم المتاعب: ```bash zev pull # 1. احصل على أحدث عمل الجميع # ...عدّل الملفات... zev add . zev commit -m "ما فعلته" # 2. احفظ عملك zev pull # 3. احصل على أي جديد منذ الخطوة 1 zev push # 4. شارك ``` إن أرسل شخص آخر أثناء عملك، فاجلب قبل أن ترسل (الخطوة 3): `zev pull` يأتي بإيداعاته ويحدّث ملفاتك، ثم يُوضع إرسالك فوقها. للتغييرات الأكبر، اعمل على [فرع](/docs/ar/branches) وافتح طلب دمج بـ `zev pr`، ليراجعه زملاؤك قبل دخوله `main`. ## المستودعات البعيدة *المستودع البعيد* عنوان مسمّى لنسخة أخرى من المستودع. يُعدّ `zev new` و`zev clone` المستودع `origin` لك. لعرض المستودعات البعيدة أو تغييرها: ```bash zev remote zev remote add upstream team/project zev remote show upstream zev remote remove upstream ``` أرسل إلى مستودع بعيد وفرع محددين أو اجلب منهما بذكر اسميهما: ```bash zev push upstream feature-x zev pull upstream main ``` ### العناوين | العنوان | المعنى | |---|---| | `owner/repo` | مستودع على Zaryn | | `owner/repo@dev` | ... على فرعه `dev` | | `https://zaryn.xyz/owner/repo` | الرابط من متصفحك: أي صفحة من المستودع تعمل، ويُحفظ `?branch=` | | `example.com/owner/repo` | مستودع على خادم zev آخر، باسم موقعه | | `localhost:8090/owner/repo` | خادم zev خاص بك (المنفذ يعني HTTP عاديًا) | | `file:///home/me/backup` | مجلد آخر على هذا الحاسوب | | `ipfs://<cid>` | لقطة منشورة على IPFS | `zev push` و`zev pull` و`zev clone` تعمل مع كل هذه العناوين. (عناوين SSH غير مدعومة بعد.) ## الخوادم وCI ووكلاء الذكاء الاصطناعي الآلة التي لا يجلس أحد أمامها لا تستطيع كتابة رمز البريد. استخدم طريقة الجهاز التي توافق عليها في متصفحك، وامنح الرمز الصلاحيات التي يحتاجها فقط: ```bash zev login zaryn.xyz --device --client "build server" ``` أو ضع رمز وصول في متغير البيئة `ZEV_TOKEN` (والخادم في `ZEV_SERVER`). قسم الإعدادات الخاص بوكلاء الذكاء الاصطناعي والرموز على Zaryn يعرض كل الرموز ويتيح لك إلغاء أي منها في أي وقت.