نصب با یک دستور و npm

نصب با یک دستور

نصب‌کنندهٔ مستقیم بستهٔ متناسب با سیستم را می‌گیرد، اثر انگشت SHA-256 آن را بررسی می‌کند و محیط اجرا و ابزارها را آماده می‌کند. نیازی به نصب دستی Python، Node یا ابزار کنترل رایانه نیست. اینترنت لازم است؛ برای دانلود به حساب یا کلید نیاز نداری.

macOS؛ Apple Silicon

در Terminal اجرا کن:

curl -fsSL https://api.sarovi.ir/install.sh | bash

نصب در ~/.sarovi انجام می‌شود. میان‌بر فرمان در ~/.local/bin قرار می‌گیرد و برای zsh یا bash به مسیر فرمان‌های نشست‌های بعدی اضافه می‌شود. با sudo اجرا نکن. پس از آماده‌شدن ابزارها، ساروی باز می‌شود و ورود با مرورگر را شروع می‌کنی. دفعات بعد یک پنجرهٔ تازهٔ Terminal باز کن و sarovi بنویس.

نسخهٔ فعلی برای M1 و جدیدتر است؛ Macهای Intel و Linux بستهٔ آماده ندارند. بستهٔ macOS هنوز notarized نیست. راهنمای macOS.

Windows؛ x64

PowerShell معمولی را باز کن؛ نیازی به Run as administrator نیست:

irm https://api.sarovi.ir/install.ps1 | iex

بسته در %LOCALAPPDATA%\Sarovi نصب می‌شود. دستور به PATH حساب خودت و میان‌بر Sarovi به منوی Start اضافه می‌شود. نصب‌کننده فقط برای پردازش نصب خودش از اجرای فایل PowerShell استفاده می‌کند؛ سیاست اجرای سراسری دستگاه تغییر نمی‌کند. اگر سیاست سازمانی دانلود یا اجرای برنامه را مسدود می‌کند، با مدیر دستگاه هماهنگ کن.

این نسخه Windows 10/11 x64 را هدف می‌گیرد؛ Windows on ARM پشتیبانی نشده است. راهنمای Windows.

روش npm

اگر Node.js 18 یا جدیدتر داری:

npm install -g sarovi
sarovi

بستهٔ npm یک راه‌انداز سبک است. هنگام npm install هیچ اسکریپت نصبی اجرا نمی‌کند؛ در اولین اجرای sarovi ابزارهای کامل دانلود و آماده می‌شوند. این روش نیز فقط macOS روی Apple Silicon و Windows x64 را پشتیبانی می‌کند. بستهٔ رسمی در npm با نام sarovi منتشر می‌شود. بسته و ابزارهای کامل فقط از نشانی‌های HTTPS ساروی دریافت می‌شوند.

اگر npm برای پوشهٔ نصب سراسری خطای دسترسی داد، از نصب‌کنندهٔ مستقیم استفاده کن یا prefix کاربری npm را تنظیم کن. اجرای Sarovi با sudo لازم نیست. Homebrew هنوز روش منتشرشده‌ای برای این نسخه ندارد.

بررسی اسکریپت پیش از اجرا

در macOS می‌توانی ابتدا نصب‌کننده را ذخیره و بخوانی:

curl -fsSL https://api.sarovi.ir/install.sh -o install-sarovi.sh
less install-sarovi.sh
bash install-sarovi.sh

در Windows نشانی https://api.sarovi.ir/install.ps1 را در مرورگر یا ویرایشگر متن باز کن. هر دو نصب‌کننده قبل از بازکردن بسته، SHA-256 ثابت همان نسخه را بررسی می‌کنند؛ اگر تطبیق نداشته باشد نصب متوقف می‌شود.

به‌روزرسانی و ترمیم

گفتگو و کار در حال اجرا را تمام کن و Sarovi را ببند. همان دستور نصب مستقیم را دوباره اجرا کن. فایل‌های برنامه و وابستگی‌ها آماده می‌شوند؛ تنظیمات، گفتگوها و حساب موجود حفظ می‌شوند. نصب‌کنندهٔ macOS گزینهٔ --no-start و نسخهٔ PowerShell گزینهٔ -NoLaunch دارد تا بعد از نصب گفتگو باز نشود.

به‌روزرسانی بستهٔ npm فقط راه‌انداز را عوض می‌کند؛ برای ترمیم یا به‌روزرسانی محیط کامل نصب‌کنندهٔ مستقیم را دوباره اجرا کن. به‌روزرسانی پس‌زمینه‌ای انجام نمی‌شود.

حذف راه‌انداز npm

npm uninstall -g sarovi

این دستور راه‌انداز npm را حذف می‌کند؛ محیط اجرا، گفتگوها و حساب محلی باقی می‌مانند. پیش از حذف کامل، sarovi logout را برای پاک‌کردن اعتبارنامهٔ محلی اجرا کن و اتصال را در رایانه‌های متصل قطع کن. محل نگهداری داده‌ها در حریم خصوصی آمده است.

نصب متوقف شد

اتصال اینترنت و فضای دیسک را بررسی و دستور را دوباره اجرا کن. گزارش نصب در ~/.sarovi/install.log در macOS یا %LOCALAPPDATA%\Sarovi\install.log در Windows است. برای پشتیبانی فقط قسمت مربوط به خطا را بفرست و اطلاعات حساس را حذف کن. بستهٔ ZIP نیز در صفحهٔ دریافت هست.