مسیر یادگیری

گام ۳ از ۶

نصب با NPM

نصب‌کنندهٔ محلی را اجرا کنید، طرح پیشنهادی را بخوانید و فقط سپس تغییرها را تأیید کنید.

آخرین بازبینی:

دربارهٔ تهیهٔ این راهنما

این راهنما با کمک هوش مصنوعی و بر پایهٔ مستندات عمومی پروژه تهیه شده است؛ تجربهٔ آزمایش روی همهٔ دستگاه‌ها یا بررسی انسانی مستقل را ادعا نمی‌کند. مسئول انتشار پروژه: AmirSina Zamanian.

منابع در پایان مقاله آمده‌اند. برای گزارش خطا یا پیشنهاد اصلاح، از مخزن پروژه استفاده کنید. گزارش خطا

در این صفحه

خلاصهٔ راهنما

برای شروع، دستور عمومی npx personal-agentic-os@latest را در ترمینال اجرا کنید. نصب‌کننده باید پیش از نوشتن فایل‌ها، مقصد و برنامهٔ راه‌اندازی را نشان دهد. کلیدها، اعتبارنامه‌ها و مسیرهای ناشناخته را تأیید نکنید.

اجرای نصب‌کننده

پیش‌نیازها را بررسی کنید و سپس npx personal-agentic-os@latest را اجرا کنید. برای دیدن فرمان‌های موجود از npx personal-agentic-os@latest --help استفاده کنید. دریافت بسته به دسترسی شبکه نیاز دارد؛ دریافت موفق بسته به معنی کامل‌شدن راه‌اندازی نیست.

پیش از نصب، نسخه و فرمان‌ها را بررسی کنید

ابتدا node --version و npm --version را اجرا کنید؛ بستهٔ عمومی به Node.js نسخهٔ ۲۰ یا بالاتر نیاز دارد. سپس در پوشه‌ای جدا از کد منبع پروژه، npx personal-agentic-os@latest --help را اجرا کنید. در زمان بازبینی این راهنما، نسخهٔ منتشرشده ۰.۱۲.۰ بود و راهنمای کد عمومی آن فرمان‌های setup، dashboard، sync، verify، bootstrap، details و memory-cleanup را نشان می‌داد. اگر نسخهٔ نمایش‌داده‌شده متفاوت است، همان نسخه را مبنای بررسی بگذارید؛ نمایش راهنما به معنی ساخته‌شدن Vault یا اتصال ابزارها نیست.

چه چیزی واقعاً بررسی شده است؟

در ۱۲ سپتامبر ۲۰۲۶، اطلاعات بسته از NPM خوانده شد و فرمان راهنمای نسخهٔ ۰.۱۰.۰ با npm exec --yes --ignore-scripts --package=personal-agentic-os@0.10.0 -- personal-agentic-os --help در پوشهٔ موقت اجرا شد؛ کد خروج صفر و عنوان نسخه تأیید شد. این آزمایش فقط دریافت و اجرای راهنمای CLI را پوشش می‌دهد، نه نصب کامل، مهاجرت حافظه یا سازگاری همهٔ سیستم‌عامل‌ها. اگر node یا npm پیدا نمی‌شود، ابتدا نصب و PATH آن‌ها را بررسی کنید. اگر دریافت بسته شکست می‌خورد، اتصال به رجیستری و متن خطا را بررسی کنید؛ از اجرای با sudo یا حذف Vault به‌عنوان راه‌حل عمومی استفاده نکنید.

طرح را پیش از اعمال بخوانید

حالت نصب، مقصد Vault، ابزارهای انتخابی و منابع را بررسی کنید. فقط طرحی را تأیید کنید که می‌شناسید. تله‌متری نصب اختیاری و پیش‌فرض خاموش است؛ گزارش آن شامل محتوای پروژه، متن گفتگو یا اطلاعات هزینه نیست.

پس از نصب و در صورت خطا

مسیر فایل تنظیمات خروجی را برای فرمان‌های بعدی نگه دارید. نصب NPM کارهای تکرارپذیر را انجام می‌دهد؛ شناسایی معنایی و مهاجرت حافظه با پرامپت رسمی نصب و تأیید شما انجام می‌شود. در خطای شبکه یا مجوز، علت را رفع کنید و وضعیت فایل‌های موجود را پیش از اجرای مجدد بررسی کنید.

بعد از نصب نسخهٔ ۰.۱۲ چه فرمان‌هایی در دسترس‌اند؟

در ۳ اکتبر ۲۰۲۶، راهنمای CLI در کد عمومی نسخهٔ ۰.۱۲.۰ بررسی شد: فرمان‌های bootstrap، details، full-context و memory-cleanup نمایش داده می‌شوند. این بررسی فقط وجود فرمان‌ها در راهنما را تأیید می‌کند؛ نصب شما، انتقال حافظه یا نتیجهٔ اجرای آن‌ها را اثبات نمی‌کند. بعد از نصب، اول Sync و verify را انجام دهید و فقط با شناسهٔ پروژهٔ درست سراغ خواندن زمینه بروید.
منبع این بخش

چک‌لیست پایان این مرحله

نصب را زمانی کامل بدانید که طرح تأییدشده اجرا شده، مسیر تنظیمات خروجی را در اختیار دارید و فقط آداپترهای انتخاب‌شده آماده شده‌اند. اگر پیام خطا دیده‌اید، آن را با حذف خودسرانهٔ Vault یا اجرای دوبارهٔ بدون بررسی پنهان نکنید. در ادامه، حالت حافظه و اتصال اولین ابزار را بررسی کنید؛ سپس اولین Sync را انجام دهید.

منابع و ادامهٔ مسیر

راهنماهای مرتبط

این راهنما به شما کمک کرد؟

پاسخ شما به‌صورت آمار تجمیعی برای انتخاب و بهبود محتوا ثبت می‌شود.