RTL Cursor, VS Code & Antigravity
افزونهٔ راستچین هوشمند برای VS Code، Cursor و Antigravity IDE — محیط چت، پنجرهٔ مستقل Agents در VS Code، دستیار هوش مصنوعی (Agent)، کامپوزر، فایلهای Plan، Canvas و پیشنمایش Markdown، با حفظ فونتها و تنظیمات خود ادیتور.
متنهای RTL (فارسی و عربی) راستچین میشوند؛ بلوکهای کد و واژههای انگلیسی چپچین و خوانا باقی میمانند.
این افزونه با ایجاد فایل بکاپ معتبر، یک لودر اختصاصی به فایل هستهٔ ادیتور (main.js) اضافه میکند. بعد از Enable / Disable یا پایان آپدیت، با تنظیم پیشفرض rtlCursor.autoRelaunch ادیتور با خروج عادی دوباره باز میشود؛ حتی اگر فقط در مود Agent باشید و IDE را باز نکنید. افزونه برنامهٔ در حال اجرا را اجباری نمیبندد.
امکانات و ویژگیها
- تشخیص خودکار و هوشمند جهت متن (Smart BiDi): پاراگرافهای فارسی به طور خودکار راستچین و پاراگرافهای انگلیسی چپچین میشوند.
- تراز بینقص متنهای ترکیبی (فارسی + انگلیسی): جلوگیری از پریدن نقطه، علامت تعجب و عبارات انگلیسی داخل پرانتز.
- حفظ تنظیمات فونت کاربر: افزونه هیچ فونتی، از جمله وزیرمتن، را انتخاب یا تحمیل نمیکند. فونت رابط، چت، ویرایشگر، ترمینال، Canvas و پیشنمایش Markdown را خود ادیتور و تنظیمات کاربر تعیین میکنند.
- فونت داخلی اختیاری: فایلهای معمولی و ضخیم وزیرمتن همراه افزونه هستند. بارگذاری آنها پیشفرض خاموش است و روشنکردن آن هم تنظیمات فونت کاربر را تغییر نمیدهد.
- ایزولهسازی دقیق کدها: کدهای چندخطی، کلمات تکخطی (
code) و ترمینال ادیتور با حفظ فونت تنظیمشدهٔ خودشان و جهت LTR کاملاً تفکیک شده میمانند.
- پشتیبانی Canvas: پیشنمایش Canvas داخل چت و تب ویرایشگر Canvas هم RTL هوشمند میگیرند (تزریق به iframeهای محلی
127.0.0.1).
- پشتیبانی VS Code: چت بومی و پنجرهٔ مستقل Agents، از جمله نشستهای Codex؛ پیامها، پاسخهای در حال دریافت، کارتهای سؤال و گزینهها، فهرست کارها و عنوان نشستها. در نسخههای پشتیبانیشدهٔ VS Code، فارسینویسی کادر Monaco از موتور داخلی RTL استفاده میکند تا جهت متن، مکاننما و کلیک هماهنگ باشند.
- پشتیبانی سه محیط: پشتیبانی VS Code، Cursor IDE و Antigravity IDE، با وضعیت فعالسازی و تنظیم بارگذاری فونت مستقل برای VS Code.
نصب و راهاندازی
شناسه افزونه: fusoft.rtl-cursor
نصب آفلاین از طریق فایل VSIX:
- فایل
releases/rtl-cursor-1.0.22.vsix را دانلود کنید (یا از Releases گیتهاب).
- در ادیتور (VS Code، Cursor یا Antigravity IDE) کلیدهای
Ctrl + Shift + P را فشار دهید.
- دستور
Extensions: Install from VSIX... را جستجو و فایل VSIX را انتخاب کنید.
- روی دکمهٔ نوار وضعیت پایین صفحه کلیک کرده یا دستور
RTL Cursor: Enable را اجرا نمایید.
- ادیتور چند ثانیه بعد خودکار بسته و دوباره باز میشود تا RTL اعمال شود.
اگر از نسخهٔ قدیمی ارتقا میدهید و RTL از قبل فعال است، ادیتور را یکبار کامل ببندید و دوباره باز کنید تا لودر جدید و حذف اجبار فونت اعمال شوند.
راهاندازی در محیط Agents در VS Code
افزونه را در همان VS Code نصب کنید. اگر RTL از قبل فعال نیست، دستور RTL Cursor: Enable را اجرا کنید. پس از نصب یا ارتقا، همهٔ پنجرههای VS Code، از جمله پنجرهٔ Agents، را کامل ببندید و دوباره باز کنید؛ بارگذاری مجدد یک پنجره برای بهروزرسانی لودر اصلی کافی نیست. پس از آن، پنجرهٔ مستقل Agents و چت داخل IDE هر دو پوشش داده میشوند. این پشتیبانی برای رابط بومی چت VS Code است؛ صفحههای وب مستقل افزونههای دیگر پوشش عمومی ندارند.
وضعیت و تنظیم بارگذاری فونت VS Code در پوشهٔ .rtl-cursor-vscode نگهداری میشود و فعالسازی یا غیرفعالسازی آن مراقب Cursor را تغییر نمیدهد. مراقب مستقل پسزمینهٔ ویندوز و ابزار ارتقای آن همچنان مخصوص Cursor هستند. بعد از آپدیت VS Code، اگر پچ حذف شده باشد، یک پنجرهٔ IDE باز کنید تا افزونه با تنظیم autoReapply آن را دوباره اعمال کند؛ سپس برنامه باید کامل راهاندازی مجدد شود.
برای فارسینویسی در کادر پیام، این نسخه مسیر داخلی RTL موتور Monaco را فقط روی مدل ورودی چت فعال میکند. این بخش علاوه بر لودر اصلی، دو بستهٔ JavaScript مربوط به IDE و Agents را با بکاپ و checksum هماهنگ بهروزرسانی میکند. دستور Disable تغییرات ورودی را هم حذف میکند. اگر ساختار موتور نسخهٔ VS Code شناخته نشود، فایلها دستنخورده میمانند و این قابلیت فعال نمیشود؛ پوشش متن پاسخها مستقل است. این سازوکار به نصب Cursor یا Antigravity اعمال نمیشود.
ارتقا از نسخهٔ قدیمی در مود Agent، بدون بازکردن IDE
اگر RTL از قبل فعال است و فقط در مود Agent کار میکنید، بعد از نصب VSIX جدید، فایل update-agent-watcher.ps1 را از همان ریلیز دانلود و یکبار با PowerShell اجرا کنید:
powershell.exe -NoProfile -File .\update-agent-watcher.ps1
این ابزار مراقب پسزمینهٔ نسخهٔ قدیمی را با بررسی هویت فرایند تعویض میکند و تنظیمها را نگه میدارد. خود ابزار Cursor را نمیبندد. بعد از این ارتقای یکباره، آپدیتهای بعدی Cursor در همان مود Agent بهصورت خودکار پوشش داده میشوند. اگر IDE را باز کنید، افزونه همین ارتقا را خودش انجام میدهد و نیازی به اجرای ابزار نیست.
استفادهٔ اختیاری از وزیرمتن داخلی
گزینهٔ rtlCursor.loadBundledVazirmatn پیشفرض خاموش است. با روشنکردن آن و اجرای Developer: Reload Window، فونت وزیرمتن در پنجرهٔ ادیتور و Canvas در دسترس قرار میگیرد؛ هیچ فونتی خودکار جایگزین نمیشود. برای استفاده، نام Vazirmatn را در تنظیمات فونت بخش دلخواه ادیتور انتخاب کنید؛ برای نمونه در editor.fontFamily. اثر هر تنظیم روی بخشهای مختلف را خود ادیتور تعیین میکند. فونت پیشنمایش داخلی Markdown هم تابع تنظیمات خود ادیتور است.
برای خاموشکردن بارگذاری فونت داخلی، گزینه را خاموش کنید و پنجره را دوباره بارگذاری کنید. نصب یا حذف فونت در سیستمعامل انجام نمیشود.
دستورات افزونه در Command Palette
| دستور |
عملکرد |
RTL Cursor: Toggle |
سوئیچ سریع (روشن / خاموش) |
RTL Cursor: Enable |
فعالسازی پچ RTL |
RTL Cursor: Disable |
غیرفعالسازی و بازیابی فایل نسخه اصلی |
RTL Cursor: Check Status |
بررسی وضعیت فعال بودن پچ |
نکات مهم و عیبیابی
- ریاستارت خودکار: با
rtlCursor.autoRelaunch (پیشفرض روشن) بعد از Enable / Disable یا تعمیر پچ پس از پایان آپدیت، Cursor با خروج عادی بسته و دوباره باز میشود. بازکردن دوباره منتظر خروج کامل برنامه میماند؛ اگر ذخیرهسازی یا خروج را لغو کنید، برنامه اجباری بسته نمیشود.
- ریاستارت دستی: اگر
rtlCursor.autoRelaunch را خاموش کنید، مثل قبل باید از File → Exit استفاده کنید.
- اعمال RTL بعد از آپدیت، بدون رفتن به IDE: لودر RTL در پروسهٔ اصلی Electron (
main.js) اجرا میشود. با rtlCursor.autoReapply پچ پس از پایان آپدیت دوباره اعمال میشود و با rtlCursor.autoRelaunch مراقب پسزمینه Cursor را با خروج عادی دوباره باز میکند تا پچ فعال شود. مود Agent از نشست قبلی بازیابی میشود؛ نیازی به بازکردن IDE یا ریاستارت دستی نیست. اگر autoRelaunch را خاموش کنید یا خروج بهخاطر پنجرهٔ باز یا ذخیرهسازی کامل نشود، پچ با راهاندازی بعدی فعال خواهد شد.
- Watch پسزمینه (ویندوز): بعد از Enable یک اسکریپت مخفی در
%USERPROFILE%\.rtl-cursor\ نصب میشود. مراقب پسزمینه تا پایان آپدیت و ثابتماندن فایلها صبر میکند، پچ را بهصورت اتمی اعمال میکند و در صورت روشنبودن autoRelaunch راهاندازی مجدد عادی انجام میدهد. تنظیمهای autoReapply و autoRelaunch برای این مراقب هم رعایت میشوند. لانچر wscript میزبان بدونکنسول rtl-cursor-watch-host.exe را راه میاندازد تا خود هلپر پنجره نسازد. هنگام ارتقای افزونه، مراقب قدیمی با بررسی هویت فرایند جایگزین میشود.
- کنسول خالی هنگام بستن کرسر: اگر فقط با ضربدر پنجره میآید و با End Task نمیآید، معمولاً از پردازهٔ Agent خود کرسر است نه از این افزونه.
- خطای عدم دسترسی (Permission denied): ادیتور را یکبار با گزینهٔ Run as administrator باز کرده و دستور Enable را اجرا کنید.
- بررسی لاگها: گزارش لودر در
%USERPROFILE%\rtl-cursor.log و گزارش مراقب پسزمینه در %USERPROFILE%\rtl-cursor-watch.log ذخیره میشود.
تغییرات نسخه ۱.۰.۲۲
- مراقب پسزمینه روی میزبان بدونکنسول
rtl-cursor-watch-host.exe اجرا میشود، نه روی powershell.exe؛ خود هلپر پنجرهٔ کنسول ندارد.
- لانچر
wscript همان میزبان را جدا از جاب کرسر راه میاندازد. اگر فایل میزبان نباشد، مسیر قبلی PowerShell میماند.
- بعد از نصب یا ارتقا، یکبار بستن کامل کرسر کافی است تا مراقب جدید جایگزین شود.
تغییرات نسخه ۱.۰.۲۱
- اگر مراقب پسزمینه از قبل روشن باشد، حتی بدون فایل قفل، دوباره اجرا نمیشود و پنجرهٔ کنسول نمیآید.
- شروع مراقب با
conhost --headless است تا ویندوز ترمینال هم پنجره نسازد.
- بعد از نصب یا ارتقا، یکبار بستن کامل کرسر کافی است؛ باز شدنهای بعدی نباید کنسول داشته باشند.
تغییرات نسخه ۱.۰.۲۰
- هنگام باز یا بسته شدن کرسر دیگر پنجرهٔ سیاه کنسول ظاهر نمیشود. اگر مراقب پسزمینه روشن باشد، دوباره اجرا نمیشود.
- اگر مراقب خاموش باشد یا فایلش عوض شده باشد، همان راهاندازی بیپنجرهٔ قبلی انجام میشود.
تغییرات نسخه ۱.۰.۱۹
- صفحهٔ افزونه فقط راهنمای نصب و استفاده را نشان میدهد. دستورهای ساخت و انتشار از این متن برداشته شده است.
- رفتار راستبهچپ همان نسخهٔ ۱.۰.۱۸ است.
تغییرات نسخه ۱.۰.۱۸
- باکس پیام خود کاربر در چت Agent با متن فارسی دیگر به چپ نمیرود. پوستهٔ چیدمان باکس چپبهراست میماند و فقط نوشتهٔ داخل آن راستبهچپ میشود.
- لینک و متن انگلیسی همان سمت راست میمانند. فهرست کار داخل همان پوسته همچنان جهت متن خودش را میگیرد.
- بررسی با ساختار واقعی پیام کرسر در کروم: باکس فارسی و انگلیسی هر دو به لبهٔ راست میچسبند.
تغییرات نسخه ۱.۰.۱۷
- رفع نامرئیشدن متن فارسی در کادر نوشتن چت جدیدِ Agents، پیش از ارسال اولین پیام؛ کادر شروع نشست هم از قوانین عمومی جهت کد و حالت RTL ویرایشگر خارج شده است.
- پوشش هر دو ساختار ورودی چت با Monaco واقعی، تنظیمات شکستن خط و کادر ورودی Agents و CSS نصبشدهٔ آن؛ بررسی فارسی و متن ترکیبی، سه فونت، مکاننما، کلیدهای جهت، کلیک و جایگزینی انتخاب.
- بررسی تغییر متن، بازترسیم و انتقال کادر به گفتوگو بدون دستکاری جهت یا سبک خطوط ورودی توسط افزونه.
- انتخاب کد اجرایی از فهرست نصب ادیتور بهجای بالاترین شمارهٔ پوشه؛ فایلهای باقیماندهٔ نسخههای قدیمی یا آزمایشی دیگر جای نسخهٔ نصبشده اجرا نمیشوند.
- نادیدهگرفتن نسخههای علامتخورده برای حذف و جلوگیری از اجرای دوبارهٔ افزونهٔ حذفشده از روی پوشههای باقیمانده.
- بررسی انتخاب نسخهٔ فعال در نصب عادی، مسیر سفارشی و حالت Portable، همراه با تستهای بومی ورودی و نمایش چت.
این فایل نسخهٔ نهایی ۱.۰.۱۷ است. اگر بستهٔ آزمایشی قبلی با همین شماره یا شمارهای بالاتر را نصب کردهاید، VSIX نهایی را دوباره نصب کنید. سپس همهٔ پنجرههای VS Code و Agents را کامل ببندید و دوباره باز کنید؛ در گزارش rtl-cursor.log، مسیر انتخابشده باید به پوشهٔ نسخهٔ ۱.۰.۱۷ اشاره کند.
تغییرات نسخه ۱.۰.۱۶
- بهروزرسانی شمارهٔ بسته و لودر به ۱.۰.۱۶ با حفظ پیادهسازی نهایی تأییدشدهٔ RTL برای Cursor، VS Code و Antigravity.
تغییرات نسخه ۱.۰.۱۵
- افزودن پشتیبانی چت بومی و پنجرهٔ مستقل Agents در VS Code، از جمله نشستهای Codex.
- نمایش پایدار فارسی و متن ترکیبی در پیامها، پاسخهای در حال دریافت، فهرستها، جدولها، کارتهای سؤال و عنوان نشستها؛ جهت هر پاراگراف را رفتار بومی مرورگر تعیین میکند.
- فارسینویسی کادر پیام با موتور داخلی RTL در Monaco، با هماهنگی مکاننما، کلیدهای جهت، کلیک و جایگزینی متن انتخابشده؛ بدون دستکاری خطوط ورودی یا متن کاربر.
- نمایش صحیح جملههای کاملاً فارسی با خارجکردن ورودی چت از قوانین عمومی LTR کدها؛ حروف داخل محدودهٔ کادر میمانند.
- حفظ جهت چپبهراست کدها و رفتار Cursor و Antigravity، فونتهای ادیتور و تنظیمات کاربر؛ بارگذاری وزیرمتن داخلی همچنان اختیاری و پیشفرض خاموش است.
- جداسازی وضعیت VS Code از Cursor و انتخاب runtime از افزونهٔ نصبشده در خود VS Code، با پشتیبانی مسیر سفارشی و حالت Portable.
- تشخیص قابلیت موتور بومی پیش از تغییر، بکاپ و checksum هماهنگ، غیرفعالسازی برگشتپذیر و پاکسازی مسیر بومی پس از حذف افزونه.
- تستهای واقعی با CSS محیط IDE و Agents، Monaco، متن کاملاً فارسی و ترکیبی، محدودهٔ حروف با سه فونت، مکاننما، کلیک، استریم پاسخ و سازگاری محیطهای قبلی.
این نسخه همان پیادهسازی نهایی تأییدشده است. ریلیزهای آزمایشی بعد از ۱.۰.۱۴ جمعآوری شدهاند و نسخهٔ صحیح با شمارهٔ ۱.۰.۱۵ منتشر شد. اگر نسخهٔ آزمایشی یا فایل قدیمی با همین شماره را نصب کردهاید، VSIX جدید را دوباره نصب کنید و همهٔ پنجرههای ادیتور را کامل ببندید و باز کنید.
تغییرات نسخه ۱.۰.۱۴
- حذف کامل انتخاب خودکار وزیرمتن، تشخیص فونت نصبشده و قوانین اجباری فونت.
- حفظ فونتهای خود ادیتور و تنظیمات کاربر در رابط، چت، کد، ترمینال، Canvas و پیشنمایش Markdown.
- تغییرات فونت کاربر مستقیماً توسط ادیتور اعمال میشوند؛ افزونه فقط جهت و تراز متن را تنظیم میکند.
- افزودن فایلهای وزیرمتن معمولی و ضخیم با مجوز اصلی و بارگذاری اختیاری از طریق
rtlCursor.loadBundledVazirmatn، خاموش بهصورت پیشفرض.
تغییرات نسخه ۱.۰.۱۳
- اصلاح دستور بازکردن دوبارهٔ ادیتور در ویندوز (
Start-Process -FilePath).
- حذف بستن اجباری Cursor از مراقب پسزمینه و جلوگیری از تداخل ریاستارت با آپدیت.
- اعمال خودکار RTL بعد از آپدیت در مود Agent، بدون بازکردن IDE یا ریاستارت دستی.
- صبر برای پایان آپدیت و ثابتماندن فایلها، حفظ importهای اصلی و اعمال اتمی پچ با بکاپ.
- رعایت
autoReapply در مراقب پسزمینه و جایگزینی مراقب قدیمی هنگام ارتقای افزونه.
- تستهای مستقل برای آپدیت، تعمیر پچ، لغو خروج و راهاندازی مجدد.
تغییرات نسخه ۱.۰.۱۲
- فونت انتخابی کاربر (
editor.fontFamily) روی اپل دیگر نادیده گرفته نمیشود؛ Vazirmatn روی فونت سفارشی سوار نمیشود.
- Watch ویندوز با
wscript مخفی اجرا میشود تا ترمینال خالی موقع روشن شدن سیستم نیاید.
تغییرات نسخه ۱.۰.۱۱
- فونت دیگر اجباری نیست: Vazirmatn فقط اگر روی سیستم نصب باشد اعمال میشود.
- اگر کاربر فونت Cursor را عوض کرده باشد، همان فونت کاربر استفاده میشود.
- حذف مسیر ثابت
file:// وزیرمتن که روی سیستمهای دیگر فونت کاربر را خراب میکرد.
تغییرات نسخه ۱.۰.۱۰
- Watch پسزمینه روی ویندوز: بعد از آپدیت Cursor بدون باز کردن IDE (مثلاً فقط Agent Window) پچ RTL دوباره اعمال میشود.
- فعالسازی زودتر افزونه (
activationEvents: *).
تغییرات نسخه ۱.۰.۹
- ریاستارت خودکار روی ویندوز بدون پنجرهٔ
cmd / ping (PowerShell مخفی).
تغییرات نسخه ۱.۰.۸
- پشتیبانی Cursor Canvas (پیشنمایش داخل چت و تب Canvas) با تزریق RTL به فریمهای محلی.
- ارتقای لودر:
web-contents-created + did-frame-finish-load + اسکن framesInSubtree.
- فونت وزیرمتن و تشخیص جهت هوشمند روی متنهای Canvas.
- اطمینان از حضور کامل منطق To-do کارت Plan از نسخه ۱.۰.۷ در runtime.
تغییرات نسخه ۱.۰.۷
- افزودن راستچین هوشمند برای فهرست To-do کارت Plan (
ui-todo-* / plan-todo__row).
- ریاستارت خودکار بعد از Enable / Disable و بعد از آپدیت ادیتور (
rtlCursor.autoRelaunch).
- دیگر برای اعمال پچ نیازی به Exit دستی نیست؛ ادیتور خودش باز میشود.
تغییرات نسخه ۱.۰.۶
- اضافه شدن پشتیبانی کامل از Antigravity IDE و پنجرهٔ چت و دستیار هوشمند آن (
workbench-jetski-agent).
- افزودن فونت استاندارد وزیرمتن (Vazirmatn) برای متون فارسی چت و رابط کاربری.
- ارتقای موتور BiDi برای تشخیص روانتر پاراگرافهای دوزبانه و جلوگیری از بههمریختگی علائم نگارشی.
- بهبود لودر برای شناسایی خودکار مسیر افزونهها در پوشههای مختلف کاربری.
لایسنس
مجوز انتشار Apache-2.0 — جزئیات بیشتر در فایل LICENSE.txt.