راست‌چین هوشمند نور
Noor RTL — VS Code, Copilot & AI Chat
نمایش خواناتر فارسی و عربی در گفتگوهای هوش مصنوعی، ورودی‌ها، پیش‌نمایش Markdown و کامنت‌های کد؛ با امکان فعال یا غیرفعال‌کردن هر بخش به‌صورت مستقل.
چه امکاناتی دارد؟
- گفتگو و متن: جهت‌دهی متن در بخش‌های پشتیبانی‌شدهٔ Copilot و AI Chat و نمایش فارسی در پیش‌نمایش داخلی Markdown.
- ورودی‌های خودکار: تشخیص جهت فارسی و انگلیسی در پرامپت، جستجو، Find/Replace، تنظیمات و Command Palette. ورودی خالی به‌اجبار راست‌چین نمی‌شود.
- کامنت فارسی: راست‌چین‌کردن خودکار خطوط مستقل کامنت فارسی، بدون تغییر جهت کد و رشته‌ها.
- کنترل دلخواه: روشن یا خاموش‌کردن قابلیت‌ها از Settings یا فرمان «فعال/غیرفعال‌کردن بخش‌های RTL».
نصب و شروع کار
روش اول: نصب از مارکت Visual Studio
افزونه را می‌توانید مستقیماً از صفحهٔ مارکت نصب کنید:
🔗 Noor RTL — VS Code, Copilot & AI Chat
در VS Code، بخش Extensions را باز کنید و عبارت Noor RTL یا Noor-CRCIS.rtl-copilot را جستجو کرده و روی Install کلیک کنید.
روش دوم: نصب دستی از فایل VSIX
- نصب افزونه: فایل نسخهٔ انتشار را دریافت کنید و از فرمان
Extensions: Install from VSIX... در VS Code نصب کنید. نام بستهٔ این نسخه rtl-copilot-2.9.21.vsix است.
- اعمال تغییرات رابط: در Command Palette، فرمان «نصب مجدد پچ» از گروه «راست‌چین هوشمند نور» را اجرا کنید.
- راه‌اندازی دوباره: تمام پنجره‌های VS Code را کامل ببندید و برنامه را دوباره باز کنید.
- استفاده در Remote SSH: رابط کاربری روی رایانهٔ محلی نمایش داده می‌شود؛ نصب و اعمال پچ باید روی همان VS Code محلی انجام شود، نه فقط سرور.
اگر نصب VS Code در پوشه‌ای محافظت‌شده باشد، افزونه یک‌بار UAC ویندوز یا احراز هویت pkexec لینوکس را درخواست می‌کند؛ همان مجوز همهٔ فایل‌های پچ و پشتیبانِ تراکنش را پوشش می‌دهد. مسیر فایل‌ها در Output Log ثبت می‌شود. در ویندوز، جایگزینی فایل موجود با مسیر پشتیبان معتبر انجام می‌شود تا با نسخه‌های مختلف .NET در PowerShell سازگار باشد. اگر درخواست را رد کنید، افزونه تغییرات موقتِ پیش از درخواست را بازمی‌گرداند؛ افزونه رمز عبور را دریافت یا ذخیره نمی‌کند.
پیش‌نمایش داخلی Markdown مسیر مستقلی دارد و برای خودش به پچ Workbench نیاز ندارد.
بیلد و ساخت فایل VSIX
برای ساخت بسته به Node.js 22 و npm نیاز دارید. دستورها را در ریشهٔ پروژه اجرا کنید:
npm ci
npm test
npm run package
پس از موفقیت آزمون‌ها، فایل rtl-copilot-2.9.21.vsix در همین پوشه ساخته می‌شود. برای نصب بسته در VS Code:
code --install-extension rtl-copilot-2.9.21.vsix
همچنین می‌توانید در VS Code فرمان Extensions: Install from VSIX... را اجرا و فایل ساخته‌شده را انتخاب کنید. راهنمای کامل انتشار در راهنمای توسعه و انتشار آمده است.
تنظیم‌های اصلی
در Settings عبارت rtlCopilot را جستجو کنید. پس از تغییر تنظیم‌های پچ، «نصب مجدد پچ» و خروج کامل از VS Code لازم است.
- همهٔ کادرهای ورودی — پیش‌فرض روشن: تنظیم
rtlCopilot.autoInputDirection جهت خودکار پرامپت، جستجو، Find/Replace، تنظیمات، Command Palette و سایر ورودی‌های پشتیبانی‌شده را کنترل می‌کند. جهت هر ورودی با نخستین حرف فارسی یا لاتین قفل می‌شود و با ادامهٔ تایپ تغییر نمی‌کند؛ پس از پاک‌کردن کامل کادر، جهت متن بعدی دوباره تشخیص داده می‌شود. در textareaهای چندخطی، جهت هر پاراگراف نیز جداگانه نمایش داده می‌شود.
- کامنت‌های مستقل فارسی — پیش‌فرض روشن: با
rtlCopilot.areas.editorComments خاموش یا روشن می‌شوند.
- جهت خودکار کل ادیتور — پیش‌فرض خاموش: تنظیم
rtlCopilot.autoEditorDirection مستقل از کامنت‌هاست. برای کنترل دستی فایل‌ها، rtlCopilot.areas.editorsCode را روشن کنید.
- میان‌بر دستی تغییر جهت:
Ctrl + Shift + Right خط جاری را راست‌به‌چپ (RTL) و Ctrl + Shift + Left آن را چپ‌به‌راست (LTR) می‌کند. Shift به‌تنهایی جهت را تغییر نمی‌دهد؛ انتخاب دستی بر تشخیص خودکار مقدم است.
- تنظیم هر ناحیه: همهٔ ناحیه‌های پشتیبانی‌شده کلید جداگانه زیر
rtlCopilot.areas.* دارند. برای ورودی‌ها نیز گروه‌های promptInputs، searchInputs، settingsInputs، quickPickInputs و otherInputs مستقل‌اند و از کلید اصلی inputs پیروی می‌کنند.
نکته: برای اعمال تغییرات تنظیمات پچ، «نصب مجدد پچ» و خروج کامل از VS Code لازم است.
پیش از فعال‌سازی بدانید
- تغییر فایل‌های VS Code: برخی قابلیت‌ها با پچ فایل‌های داخلی برنامه کار می‌کنند و ممکن است هشدار یکپارچگی نصب ایجاد کنند. افزونه پشتیبان تهیه می‌کند. اگر دسترسی نوشتن کافی نباشد، یک‌بار UAC ویندوز یا احراز هویت
pkexec لینوکس را درخواست می‌کند؛ همان مجوز برای همهٔ فایل‌های تراکنش و پشتیبان‌های همان نصب استفاده می‌شود. رد مجوز سیستم‌عامل، عملیات را بدون تغییر ادامه می‌دهد.
- نصب فقط‌خواندنی: نسخه‌هایی مانند Snap یا نصب بدون مجوز نوشتن قابل پچ نیستند. از نصب قابل‌نوشتن و رسمی VS Code استفاده کنید.
- پس از به‌روزرسانی VS Code: ممکن است پچ به نصب مجدد نیاز داشته باشد. برای بازگشت از فرمان «غیرفعال‌سازی پچ RTL» استفاده کنید؛ اگر هشدار یکپارچگی باقی ماند، نصب رسمی VS Code را Repair/Reinstall کنید.
- محدودهٔ پشتیبانی: کامنت بعد از کد در همان خط، Docstringهایی که زبان رشته تشخیص می‌دهد، فیلد رمز، Webview افزونه‌های دیگر و پنجره‌های بومی سیستم‌عامل مشمول راست‌چینی عمومی نیستند. کامنت‌ها فقط با توکن معتبر زبان تشخیص داده می‌شوند. نمایش متن ترکیبی به رندرکنندهٔ VS Code نیز وابسته است.
پشتیبانی و اطلاعات پروژه
برای گزارش مشکل، نسخهٔ VS Code و افزونه، سیستم‌عامل، ناحیهٔ درگیر و مراحل بازتولید را در صفحهٔ Issues بنویسید. اطلاعات محرمانه، توکن یا متن خصوصی ارسال نکنید.
کد منبع · تغییرات نسخه‌ها · راهنمای توسعه و انتشار · مجوز
محصول مرکز تحقیقات کامپیوتری علوم اسلامی نور — وب‌سایت نور
این افزونه ابزار مستقل است و محصول رسمی Microsoft یا GitHub نیست.
محصولات و خدمات مرکز نور
🔻🔻🔻🔻🔻🔻
👈 تا حالا با چت بات اسلامی گفتگو کردی؟!!!
▪️▫️▪️▫️▪️
مرکز تحقیقات کامپیوتری علوم اسلامی (نور): پیشگام در داده‌پردازی هوشمند علوم اسلامی و انسانی — noorsoft.org
