پیش از اعتماد به Dashboard، اتصالها، نقشهٔ پروژهها و نتیجهٔ Sync را بررسی کنید.
آخرین بازبینی:
دربارهٔ تهیهٔ این راهنما
این راهنما با کمک هوش مصنوعی و بر پایهٔ مستندات عمومی پروژه تهیه شده است؛ تجربهٔ آزمایش روی همهٔ دستگاهها یا بررسی انسانی مستقل را ادعا نمیکند. مسئول انتشار پروژه: AmirSina Zamanian.
منابع در پایان مقاله آمدهاند. برای گزارش خطا یا پیشنهاد اصلاح، از مخزن پروژه استفاده کنید. گزارش خطا
⌕
جستوجو روی همین دستگاه انجام میشود.
در این صفحه
خلاصهٔ راهنما
Wizard ابتدا نقشهٔ پیشنهادی پروژهها و اتصالها را نشان میدهد و برای نوشتن حافظه تأیید میخواهد. پروژهها فقط با مسیر دقیق، هویت مخزن یا نشانگرهای محتوایی قوی ادغام میشوند؛ شباهت نام بهتنهایی کافی نیست. پس از Sync، وضعیتهای created، updated، unchanged و removed را بررسی کنید.
اولین همگامسازی
در تمام فرمانهای این راهنما، /absolute/path/to/config.json یک جاینگهدار است؛ آن را با فایل تنظیمات خروجی نصب خود جایگزین کنید. پس از تأیید نقشه، npx personal-agentic-os@latest sync /absolute/path/to/config.json را اجرا کنید. وضعیتهای created، updated، unchanged و removed را با تغییرات موردانتظار تطبیق دهید.
بررسی بدون تغییر داده
دستور npx personal-agentic-os@latest verify /absolute/path/to/config.json شواهد حافظه و یکپارچگی Sync را بدون تغییر دادهٔ پروژه بررسی میکند. سپس npx personal-agentic-os@latest dashboard /absolute/path/to/config.json را اجرا کنید و پوشش بستههای زمینه و موارد نیازمند بازبینی را ببینید.
نتیجهٔ بررسی را چطور بخوانید؟
سه مرحله را جدا نگه دارید: اجرای راهنمای CLI فقط در دسترس بودن فرمان را نشان میدهد؛ Sync با فایل تنظیمات واقعی روی منابع تأییدشده کار میکند؛ verify شواهد حاصل را بررسی میکند. فایل config را نسازید یا خالی جایگزین نکنید: مسیر خروجی نصب خود را داخل کوتیشن به فرمان بدهید، بهویژه اگر فاصله دارد. در اجرای نخست، نبود رکورد یا بستهٔ زمینه میتواند نیازمند تکمیل اتصال یا Sync باشد؛ آن را موفقیت یا مصرف صفر گزارش نکنید. خطای مسیر را با مسیر واقعی تنظیمات رفع کنید و خطای منابع را در اتصال همان ابزار پیگیری کنید.
مثال امن و محدودیت شواهد
الگوی فرمان با مسیر دارای فاصله: npx personal-agentic-os@latest verify "/absolute/path with spaces/config.json". این مسیر نمونه است و باید جایگزین شود؛ هیچ خروجی موفقی برای آن ادعا نمیکنیم. در بررسی ۳ اکتبر ۲۰۲۶، وجود verify در راهنمای کد عمومی نسخهٔ ۰.۱۲.۰ دیده شد؛ آزمایش قدیمی ویکی روی ۰.۱۰.۰ انجام شده بود و هیچکدام روی تنظیمات شخصی شما اجرا نشدهاند. برای گزارش اشکال، نسخه، نام فرمان و متن خطای پاکسازیشده کافی است؛ فایل تنظیمات، مسیرهای خصوصی، کلیدها و متن گفتگو را عمومی نکنید.
رفع اشکال و بهروزرسانی
در نبود داده، ابتدا مسیر تنظیمات، منابع انتخابی و نتیجهٔ اتصال را بررسی کنید؛ عدد ناموجود را صفر تفسیر نکنید. با npx personal-agentic-os@latest update /absolute/path/to/config.json وضعیت نسخه را بررسی کنید. بهروزرسانی الزامی در نسخههای پشتیبانیشده میتواند Sync را متوقف کند، اما فایلها را خودکار تغییر نمیدهد.
ادامهٔ ایمن کار
همگامسازی دورهای تنها با تأیید شما فعال میشود. پیشنهادهای بهینهسازی مشورتیاند: Preview بدون تغییر است، Apply تأیید و سابقهٔ محلی میخواهد و Rollback از بازنویسی تغییرات جدید کاربر خودداری میکند. قبل از هر اعمال تغییر، پیشنهاد و مسیرهای هدف را بخوانید.
آیا زمینهٔ پروژهٔ درست و کامل در دسترس است؟
پس از Sync، npx personal-agentic-os@latest bootstrap /absolute/path/to/config.json <project-id> را برای یک پروژهٔ مجاز اجرا کنید. خروجی فشرده باید سطح شواهد و تعداد رکوردهای جاافتاده را نشان دهد؛ کوتاه بودن آن به معنی کاملبودن حافظه نیست. برای دیدن دستهٔ کامل، details /absolute/path/to/config.json <project-id> "Decision" را اجرا و تا خالیشدن next صفحهبندی را دنبال کنید. full-context بستهٔ کامل همان پروژه را میخواند. پیش از دادن هر خروجی به مدل، منبع و دادهٔ حساس را بازبینی کنید.
برای پایان مسیر شروع، نتیجهٔ Sync باید با منابع انتخابی سازگار باشد و گزارش بررسی، موارد نیازمند رسیدگی را روشن کند. بستهٔ زمینهٔ یک پروژه را بررسی کنید: منبع و وضعیت تأیید اطلاعات باید مشخص باشد. کمبود داده یا قیمت را unavailable نگه دارید. فقط پس از این بررسیها دربارهٔ همگامسازی دورهای تصمیم بگیرید.