محیط برنامه‌نویسی Google Antigravity (ادیتور اختصاصی هوش مصنوعی توسعه‌یافته توسط تیم Google DeepMind) در حال حاضر یکی از قدرتمندترین ابزارهای دستیار کدنویسی مستقل در دنیاست. با این حال، استفاده از این نرم‌افزار در ایران با چالش‌های کلافه‌کننده‌ای همراه است؛ از خطای مشهور ۴۰۳ و تحریم حساب کاربری گرفته تا قطع شدن ناگهانی کدنویسی در حین چت با هوش مصنوعی یا قفل شدن ادیتور.

خبر خوش این است که برای رفع این مشکلات نیازی به دستکاری‌های پیچیده شبکه، تغییر تنظیمات کارت شبکه ویندوز یا وارد کردن دستورات طولانی ترمینال در هر بار اجرای برنامه ندارید. در این راهنما، تمامی ارورهای رایج را به صورت دقیق بررسی می‌کنیم و نحوه حل خودکار همه آن‌ها با یک کلیک را توضیح می‌دهیم.

۱. چرا فعال کردن وی‌پی‌ان یا فیلترشکن معمولی مشکل را حل نمی‌کند؟

بسیاری از دوستان وقتی برای اولین بار با خطای زیر مواجه می‌شوند:

HTTP 403 Forbidden HTTP 403: "Your current account is not eligible for Antigravity, because it is not currently available in your location."

بلافاصله فیلترشکن سیستم را روشن می‌کنند یا در نرم‌افزارهایی مثل v2rayN یا NekoBox حالت TUN Mode را فعال می‌کنند. اما باز هم می‌بینند که یا برنامه اصلاً لاگین نمی‌شود، یا وسط تولید کد خطای Agent terminated رخ می‌دهد و نشست اکانت گوگل می‌پرد. دلیل فنی این اتفاق چیست؟

۲. نیازی به تنظیم دستی پروکسی ندارید؛ چرا دستکاری دستی اشتباه است؟

در اینترنت ممکن است آموزش‌هایی ببینید که به شما می‌گویند برای اجرای برنامه شورت‌کات بسازید و فلگ‌های طولانی کرومیوم مانند --proxy-server یا قوانین --host-resolver-rules را به صورت دستی وارد کنید، یا دستورات پیچیده‌ای در پاورشل تایپ کنید.

خطرات و سختی‌های روش دستی:
  • کاربران عادی با دیدن فلگ‌های پیچیده ترمینال احساس ترس و سردرگمی می‌کنند و نگران به هم ریختن ویندوز خود می‌شوند.
  • با تغییر پورت فیلترشکن یا جابجایی بین v2rayN و کلش، تمام آن دستورات دستی از کار می‌افتند و باید دوباره پورت‌ها را اصلاح کنید.
  • روشن کردن حالت سنگین TUN کل پکیج‌منیجرهای شما (مانند npm, pip, docker) را با کندی و اختلال مواجه می‌کند.
راه‌حل هوشمند و ۱۰۰٪ خودکار Antigravity Cleaner:
شما هیچ نیازی به تایپ دستورات طولانی، دانستن شماره پورت‌ها، یا دستکاری تنظیمات ویندوز و لینوکس ندارید! ابزار متن‌باز Antigravity Cleaner خودش به صورت خودکار پورت فعال فیلترشکن شما را شناسایی می‌کند، فایل‌های ادیتور را پچ می‌کند، پکت‌های ضربان قلب برای حفظ استریم چت تزریق می‌کند و برنامه را با یک دابل‌کلیک اجرا می‌نماید.

۳. کلینیک جامع خطاها (رفع ۸ ارور آزاردهنده ادیتور)

در ادامه، تمامی خطاهایی که برنامه‌نویسان در ایران با آن روبرو می‌شوند به همراه علت و راه‌حل قطعی آن‌ها آورده شده است:

۱. ارور ۴۰۳ و تحریم حساب کاربری (Account Not Eligible) بحرانی / شایع‌ترین
HTTP 403 Forbidden: "Your current account is not eligible for Antigravity, because it is not currently available in your location."

علت: فعال بودن گیت‌کیپرهای سمت کلاینت در هسته ادیتور و ثبت آی‌پی یا DNS در زمان ورود به حساب کاربری گوگل.

راه‌حل: اجرای یک‌باره دستور antigravity-cleaner patch all در ترمینال یا انتخاب گزینه Patch All در نرم‌افزار.
۲. ارور ۴۰۰ عدم پشتیبانی لوکیشن (User location is not supported) شبکه و ریجن
HTTP 400 Bad Request: "User location is not supported."

علت: ارسال درخواست‌های اتصال اولیه هوش مصنوعی بدون پروکسی اختصاصی و شناسایی موقعیت مکانی ایران توسط لبه گوگل کلود.

راه‌حل: اجرای برنامه با لانچر هوشمند antigravity-cleaner launch که تمام ترافیک ادیتور را به پروکسی لوکال هدایت می‌کند.
۳. قطع شدن چت وسط کدنویسی (Agent terminated due to error و write EIO) آزاردهنده
Agent terminated due to error. You can prompt the model to try again or start a new conversation. (write EIO)

علت: سرریز بافر لاگ‌های بیهوده ادیتور روی کنسول لینوکس یا ویندوز، همراه با قطعی ارتباط استریم زنده توسط فایروال اینترنت ایران.

راه‌حل: پچ هسته با antigravity-cleaner patch all؛ شیلد ASAR لاگ‌های مخرب را مسدود کرده و ارسال خودکار پکت‌های KeepAlive مانع از بسته شدن استریم می‌شود.
۴. خطای نامشخص شبکه (Network issue connecting to the server) تایم‌اوت اینترنت
Error Unknown: There was a network issue connecting to the server, please try again. (Error ID: 95ea05dd-...)

علت: افت پکت‌ها و نشت استعلام‌های DNS در حین استریم gRPC یا استفاده از حالت سنگین TUN.

راه‌حل: بستن حالت TUN و اجرای مستقیم ادیتور با antigravity-cleaner launch.
۵. خطای اتمام سهمیه و لیمیت موقت (HTTP 429 Quota Exceeded) محدودیت سهمیه
HTTP 429: Resource has been exhausted (Too Many Requests). Please wait before retrying.

علت: خرابی فایل‌های کش سهمیه روی دیسک، یا استفاده از آی‌پی اشتراکی شلوغ در فیلترشکن.

راه‌حل: اجرای دستور antigravity-cleaner clean برای پاکسازی تخصصی باکت‌های کش ۴۲۹ بدون پاک شدن تاریخچه چت‌ها یا لاگین اکانت.
۶. خطای عدم اتصال به پورت لوکال (dial tcp 127.0.0.1:10808 connection refused) پروکسی لوکال
proxyconnect tcp: dial tcp 127.0.0.1:10808: connect: connection refused

علت: نرم‌افزار فیلترشکن (مثل v2rayN یا کلش) باز نیست یا روی پورت دیگری (مثلاً ۷۸۹۰ یا ۲۰۸۰) گوش می‌دهد.

راه‌حل: دستور antigravity-cleaner doctor پورت‌های فعال سیستم شما را فوراً شناسایی کرده و پورت صحیح را اعلام می‌کند.
۷. خطای راه‌اندازی اکانت (Failed to fetch / Setting up your account) سشن ورود
There was an unexpected issue setting up your account. Failed to fetch.

علت: وجود توکن‌های منقضی‌شده و رکوردهای خراب در حافظه DIPS ادیتور.

راه‌حل: اجرای antigravity-cleaner clean و لاگین مجدد به اکانت گوگل.
۸. باز نشدن ادیتور و خطای قفل بودن پروسه (SingletonLock) قفل پروسه
SingletonLock: Could not acquire lock. The process is already running.

علت: بسته شدن ناگهانی ادیتور در پس‌زمینه و جا ماندن فایل قفل روی سیستم.

راه‌حل: لانچر هوشمند antigravity-cleaner launch این قفل‌های مرده را به طور اتوماتیک پیش از بالا آمدن برنامه حذف می‌کند.

۴. راه‌اندازی خودکار در کمتر از ۱۰ ثانیه (ویندوز، لینوکس و مک)

هیچ پیش‌نیاز سختی وجود ندارد! فقط دستور نصب سیستم‌عامل خود را کپی کرده و اجرا کنید:

در ویندوز (Windows PowerShell):

نرم‌افزار PowerShell را در حالت Run as Administrator باز کنید و دستور زیر را پیست نمایید:

PowerShell irm https://raw.githubusercontent.com/dalroot/antigravity-cleaner/main/install.ps1 | iex

در لینوکس و مک (Linux / macOS Terminal):

ترمینال خود را باز کرده و دستور زیر را اجرا کنید:

Bash curl -sSL https://raw.githubusercontent.com/dalroot/antigravity-cleaner/main/install.sh | bash
بعد از نصب چه کنیم؟ فقط یک گام ساده:
۱. ابتدا فیلترشکن خود (v2rayN، کلش، نکوباکس، هیدیفای و...) را مثل همیشه متصل کنید.
۲. یک‌بار دستور antigravity-cleaner patch all را بزنید تا هسته ادیتور برای همیشه پچ شود.
۳. دستور antigravity-cleaner launch را بزنید تا برنامه با پروکسی اختصاصی باز شود.
(اختیاری) اگر می‌خواهید یک آیکون آماده روی دسکتاپ داشته باشید، دستور antigravity-cleaner create-launcher را بزنید تا با یک دابل‌کلیک ادیتور همیشه بدون دردسر باز شود.

۵. رابط کاربری گرافیکی (GUI)

در صورتی که مایل به استفاده از خط فرمان نیستید، Antigravity Cleaner دارای رابط کاربری گرافیکی مستقل (GUI) نیز هست. برای اجرای آن کافیست دستور زیر را بزنید یا روی فایل برنامه کلیک کنید:

Terminal antigravity-cleaner gui

در این پنجره، تمام ابزارها از جمله عیب‌یابی سلامت سیستم، پچ هسته، پاکسازی سهمیه و اجرای ادیتور با یک کلیک در اختیار شما قرار دارد.

۶. جدول جعبه‌ابزار دستورات Antigravity Cleaner

دستور کاربرد و عملکرد چه زمانی استفاده کنیم؟
antigravity-cleaner launch شناسایی خودکار پورت پروکسی، حذف قفل‌های مرده و اجرای ادیتور با اتصال ایزوله استفاده روزمره برای باز کردن مطمئن ادیتور
antigravity-cleaner patch all پچ دائمی فایل‌های هسته ادیتور و فعال‌سازی شیلد ضد قطعی استریم (KeepAlive) پس از نصب اولیه ادیتور یا بعد از آپدیت‌های جدید
antigravity-cleaner clean پاکسازی باکت‌های موقت سهمیه ۴۲۹ بدون دست زدن به لاگین و تاریخچه چت‌ها هنگام مواجهه با ارور ۴۲۹ یا پیام Quota Exceeded
antigravity-cleaner doctor اسکن خودکار پورت‌های فعال، بررسی سلامت فایل‌های ادیتور و پینگ گوگل هر زمان که در اتصال یا پورت‌ها شک داشتید
antigravity-cleaner create-launcher ساخت آیکون اجرای خودکار روی دسکتاپ با یک کلیک برای باز کردن برنامه بدون نیاز به باز کردن ترمینال
antigravity-cleaner restore بازگردانی تمام فایل‌های ادیتور به نسخه دست‌نخورده از روی فایل‌های بکاپ .agybak در صورت تمایل به بازگشت کامل به حالت اورجینال

۷. سوالات متداول برنامه‌نویسان (FAQ)

آیا اجرای دستورات Antigravity Cleaner لاگین یا چت‌های قبلی من را پاک می‌کند؟
خیر، به هیچ وجه. برخلاف دستورات خطرناک و خام مثل پاک کردن کل پوشه ~/.config/Antigravity، ابزار Antigravity Cleaner به صورت جراحی‌شده فقط ۱۶ فایل موقت کش را هدف قرار می‌دهد و تمامی توکن‌های ورود، اکانت گوگل و پروژه‌های شما ۱۰۰٪ دست‌نخورده باقی می‌مانند.

من از کلش (Clash Verge / Mihomo) یا نکوباکس استفاده می‌کنم؛ آیا تنظیمی لازم است؟
خیر. ابزار به صورت خودکار پورت‌های استاندارد (۱۰۸۰۸ مربوط به v2rayN، پورت ۷۸۹۰ مربوط به کلش، پورت ۲۰۸۰ مربوط به نکوباکس و ۱۰۸۰ مربوط به سایر پروتکل‌ها) را اسکن کرده و به پورت فعال متصل می‌شود.

آیا این ابزار متن‌باز و امن است؟
بله، ریپازیتوری پروژه به صورت ۱۰۰٪ متن‌باز تحت لایسنس Apache 2.0 در گیت‌هاب در دسترس عموم است. این ابزار کاملاً آفلاین کار می‌کند و هیچ‌گونه ارسال تلمتری، داده یا ارتباط با سرور خارجی ندارد.

از آزادی کدنویسی لذت ببرید!

اگر این آموزش و ابزار مشکل کار با Google Antigravity را برای شما برطرف کرد، با دادن یک ستاره (Star) به ریپازیتوری در گیت‌هاب، از زحمات تیم توسعه حمایت کنید.

ستاره در گیت‌هاب