مفاهیم اصلی·۴ دقیقه مطالعه
zev چیست
zev یک موتور آدرس‌دهی‌شده بر اساس محتوا برای کد، داده و مصنوعات یادگیری ماشین است. در هسته آن، هر شیء — یک فایل، یک درخت، یک کامیت، یک بخش از یک دیتاست، یک چک‌پوینت مدل — با هش محتوای خودش ذخیره می‌شود، و مجموعه‌ای رو به رشد از قابلیت‌ها بر پایه همین یک ایده ساخته شده: ردیابی تاریخچه، فهمیدن اینکه واقعاً چه چیزی تغییر کرده، همگام‌سازی کارآمد فایل‌های بزرگ، اجرای CI که کار تکراری را رد می‌کند، و دنبال کردن کامل شجره‌نامه یک مدل از داده خام تا یک نتیجه منتشرشده.
zev از ابتدا برای گسترش طراحی شده است. تاریخچه نسخه پایه است، نه سقف — همان موتوری که کامیت‌های شما را ذخیره می‌کند، آزمایش‌های یادگیری ماشین را نیز ردیابی می‌کند، وزن‌های مدل را ادغام می‌کند، انحراف معیارها را تشخیص می‌دهد، تکرارپذیری را تأیید می‌کند و نتایج را روی زنجیره بلوکی گواهی می‌کند. قابلیت‌های جدید به‌صورت دستورات جدید و انواع گره‌های IPLD روی همان مخزن شیء اضافه می‌شوند، نه به‌عنوان سیستم‌های جداگانه که کنارش پیچ شده باشند.
## zev از چه چیزی ساخته شده
zev سه بخش هم‌کار است که هرکدام به‌طور مستقل ساخته و آزمایش شده‌اند پیش از اینکه به هم متصل شوند:
- **`zev`** — موتور خط فرمان. به‌صورت محلی نصب می‌شود، یک دایرکتوری کاری، یک مخزن شیء محلی آدرس‌دهی‌شده بر اساس محتوا در `.zev/` را مدیریت می‌کند، و با یک سرور راه دور از طریق HTTP، SSH یا IPFS ارتباط برقرار می‌کند.
- **`zev-api`** — سرور. با زبان Zig نوشته شده، اشیاء مخزن، مانیفست‌ها و متادیتا را در PostgreSQL و روی دیسک ذخیره می‌کند، یک API با فرمت JSON از طریق HTTP ارائه می‌دهد و احراز هویت و کنترل دسترسی را اعمال می‌کند.
- **`zev-ci`** — یک سرویس یکپارچه‌سازی مداوم که پایپلاین‌ها را در کانتینرهای ایزوله‌شده Docker اجرا می‌کند، با هر push به `zev-api` فعال می‌شود، و مراحلی که ورودی‌های آن‌ها قبلاً موفق بوده‌اند را رد می‌کند.
## Zaryn: پلتفرم وب
**Zaryn** ([zaryn.xyz](https://zaryn.xyz)) پلتفرم میزبانی‌شده‌ای است که روی این موتور ساخته شده — جایی که مخازن، سازمان‌ها، ایشوها، پول ریکوئست‌ها و افراد واقعاً زندگی می‌کنند و مرور می‌شوند. هر مخزن، کامیت و فایل پین‌شده روی Zaryn با همان هش‌های محتوایی قابل آدرس‌دهی است که ابزار خط فرمان `zev` به‌صورت محلی تولید می‌کند، پس آنچه در وب می‌بینید یک نمای مستقیم از همان مخزن شیء است، نه یک کپی جداگانه. Zaryn اضافه می‌کند:
- مخازن برای کد، مدل‌های یادگیری ماشین، دیتاست‌ها، عامل‌ها و تعاریف توپولوژی شبکه، هرکدام با ایشو، پول ریکوئست و گراف مشارکت‌کنندگان
- سازمان‌ها با هویت رمزنگاری‌شده خودشان، به‌طوری‌که کامیت‌های تأییدشده به نمایندگی از یک سازمان می‌توانند مستقل از هر عضو خاص تأیید شوند
- پیام‌رسانی و اعلان‌های بلادرنگ بین کاربران
- پین کردن IPFS با گواهی‌های امضاشده، به‌طوری‌که اصالت یک فایل پین‌شده به‌صورت آفلاین قابل تأیید است
- یک فید فعالیت عمومی و جستجوی معنایی کامل در متن کامیت‌ها و مخازن
- استقرار روی هر کلاستر Kubernetes یا میزبان Docker از طریق `zev-agent`: فقط بیلدهای امضاشده، انتشار قناری با کنترل متریک‌های Prometheus، اسرار از Vault و سرویس‌های مدیریت اسرار ابری، انتشار موج‌به‌موج روی چند مقصد، خروجی و همگام‌سازی GitOps، نقش‌های پروژه، گزارش ممیزی و ورود یکپارچه (SSO) برای سازمان‌ها — قابل استفاده برای افراد، CI و عامل‌های هوش مصنوعی (`zev-deploy`، MCP)
## قابلیت‌های اصلی
**آدرس‌دهی بر اساس محتوا در همه‌جا.** هر شیء با هش محتوای خودش شناسایی می‌شود. دو فایل یکسان در هر جای تاریخچه یک مخزن، به‌طور خودکار یک شیء واحد را اشغال می‌کنند.
**تکه‌بندی برای فایل‌های بزرگ.** فایل‌های بزرگ به تکه‌های تعریف‌شده بر اساس محتوا تقسیم می‌شوند، پس یک ویرایش کوچک فقط نیازمند انتقال بایت‌هایی است که واقعاً تغییر کرده‌اند.
**تفاوت‌یابی آگاه از AST برای کد.** zev کد منبع Zig را با یک تجزیه‌گر واقعی AST تجزیه می‌کند و تغییرات ساختاری — تغییر نام تابع، تغییر امضا، تغییر بدنه — را گزارش می‌دهد، نه فقط تفاوت‌های متنی خط‌به‌خط.
**ردیابی آزمایش و دیتاست یادگیری ماشین.** `zev experiment`، `zev dataset` و `zev lineage` فرضیه‌ها، تقسیم‌بندی‌های دیتاست، تخصیص بخش‌ها و گراف کامل شجره‌نامه‌ای که یک مدل را به داده و اسکریپت‌هایی که از آن‌ها آمده متصل می‌کند، ردیابی می‌کنند.
**تفاوت‌یابی و ادغام وزن مدل.** `zev wdiff` تنسورها را مستقیماً درون فایل‌های `.safetensors`، PyTorch و NumPy مقایسه می‌کند. `zev merge-weights` چک‌پوینت‌ها را با میانگین‌گیری، درون‌یابی وزن‌دار، درون‌یابی کروی (SLERP) یا TIES-merging ادغام می‌کند.
**انحراف، رگرسیون و تکرارپذیری.** `zev drift` و `zev threshold` رگرسیون معیارها را نسبت به یک خط پایه به‌طور خودکار تشخیص می‌دهند؛ `zev reproduce` یک دستور ثبت‌شده را دوباره اجرا می‌کند و خروجی آن را با نتیجه ثبت‌شده در محدوده یک تلورانس بررسی می‌کند.
**شجره‌نامه و به‌خاطرسپاری برای CI.** CI می‌تواند اجرای مجدد یک مرحله پایپلاین را به‌طور کامل رد کند وقتی ترکیب دقیق محتوای منبع، تصویر کانتینر و دستور قبلاً یک‌بار موفق بوده است.
**گواهی و ادغام فدرال.** `zev notarize` هش یک اسنپ‌شات را روی زنجیره بلوکی لنگر می‌اندازد. `zev fedmerge` کار را از یک فایل `.car` که مستقیماً بین دو مخزن مبادله شده ادغام می‌کند، بدون نیاز به هیچ سرور مرکزی.
## این برای چه کسی است
zev به‌عنوان یک سیستم واقعی و کارکننده ساخته شده — هر قابلیتی که در این مستندات توضیح داده شده، پیاده‌سازی شده، روی یک سرور واقعی مستقر شده و در برابر دستورات واقعی و داده‌های واقعی تأیید شده است پیش از اینکه اینجا نوشته شود. این مشخصات رفتار موردنظر نیست؛ توصیف کاری است که سیستم در حال اجرا واقعاً انجام می‌دهد.