اشتراک کارتان روی Zaryn

کامیت‌هایتان تا وقتی **push** نکنید روی رایانهٔ خودتان می‌مانند. push آن‌ها را به Zaryn می‌فرستد؛ جایی که دیگران می‌بینندشان، پروژه را کلون می‌کنند و کار خودشان را برمی‌گردانند. **pull** کامیت‌های تازهٔ آن‌ها را به شما می‌رساند. ## ورود (برای هر رایانه یک بار) **تازه به Zaryn آمده‌اید؟** از داخل هر پوشهٔ پروژهٔ zev حساب بسازید: ```bash zev login zaryn.xyz --register your-username --email you@example.com ``` zev یک کد ۶ رقمی برایتان ایمیل می‌کند؛ وقتی خواست، واردش کنید. اگر پیش از رسیدن کد ترمینال را بستید، بعداً این‌طور تمامش کنید: ```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 ``` ```text Repository name: notes What kind of repository is this? 1) code 2) model 3) dataset 4) agent 5) topology Visibility? 1) public 2) private License? 1) MIT 2) Apache-2.0 3) GPL-3.0 4) BSD-3-Clause 5) Unlicense 6) None ``` `zev new` مخزن را روی Zaryn می‌سازد و نشانی‌اش را به‌عنوان یک **ریموت** به نام `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 دستور کلونش را آمادهٔ کپی نشان می‌دهد. کلون و دریافت دسته‌ای انجام می‌شوند: چند درخواست کل تاریخچه را می‌آورند (برای مخزن‌های بزرگ چهار درخواست هم‌زمان) و هر فایل پیش از ذخیره با هشش سنجیده می‌شود. فایل‌های بزرگ قطعه‌قطعه می‌آیند و دریافت بعدی فقط قطعه‌های تغییرکرده را می‌گیرد. برای مخزن‌های خصوصی باید با حسابی که دسترسی دارد وارد شده باشید. ## به‌روز ماندن (pull) ```bash zev pull ``` `zev pull` کامیت‌های تازهٔ شاخهٔ شما را از `origin` دانلود می‌کند و فایل‌هایتان را مطابقشان می‌کند. zev هرگز کاری را که کامیت نکرده‌اید بازنویسی نمی‌کند. اگر فایلی که تغییر داده‌اید جایگزین می‌شد، `zev pull` هیچ فایلی را تغییر نمی‌دهد و می‌گوید کدام فایل مانع است. کامیت‌های تازه همچنان ذخیره می‌شوند، پس چیزی از دست نمی‌رود. تغییراتتان را کامیت یا stash کنید، بعد `zev checkout <branch>` را بزنید تا فایل‌ها به‌روز شوند. ## روال کار تیمی وقتی چند نفر روی یک پروژه کار می‌کنند، این ترتیب جلوی بیشتر دردسرها را می‌گیرد: ```bash zev pull # ۱. آخرین کار همه را بگیرید # ...ویرایش فایل‌ها... zev add . zev commit -m "کاری که کردید" # ۲. کارتان را ذخیره کنید zev pull # ۳. هر چیز تازه از گام ۱ به بعد را بگیرید zev push # ۴. به اشتراک بگذارید ``` اگر کسی دیگر در حین کار شما push کرده باشد، پیش از push کردن pull کنید (گام ۳): `zev pull` کامیت‌های او را می‌آورد و فایل‌هایتان را به‌روز می‌کند، و بعد push شما روی آن‌ها قرار می‌گیرد. برای تغییرات بزرگ‌تر، روی یک [شاخه](/docs/fa/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 ``` با نام بردن ریموت و شاخه، به ریموت و شاخهٔ مشخصی push یا pull کنید: ```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 و عامل‌های هوش مصنوعی ماشینی که کسی پشتش نیست نمی‌تواند کد ایمیل را وارد کند. از روش device استفاده کنید که در مرورگر تأییدش می‌کنید، و به توکن فقط دسترسی‌هایی را بدهید که لازم دارد: ```bash zev login zaryn.xyz --device --client "build server" ``` یا توکنی را در متغیر محیطی `ZEV_TOKEN` (و سرور را در `ZEV_SERVER`) بگذارید. بخش «تنظیمات ← عامل‌های هوش مصنوعی و توکن‌ها» در Zaryn همهٔ توکن‌ها را نشان می‌دهد و می‌توانید هر کدام را هر وقت خواستید باطل کنید. [اسکریپت‌نویسی و عامل‌های هوش مصنوعی](/docs/fa/automation-and-agents) را ببینید.