RTL AI Reader

Publisher: 6arshid

نسخهٔ 0.3.5 — حاشیهٔ متن فارسی

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

بستهٔ نصب: rtl-ai-reader-win32-x64-0.3.5.vsix.

نسخهٔ 0.3.4 — اصلاح متن ترکیبی و نشانگر

متن فارسی و عربی حتی وقتی با انگلیسی شروع شود، با جهت پایهٔ راست‌به‌چپ و در سمت راست پنل نمایش داده می‌شود. کلمات و مسیرهای انگلیسی داخل متن، ترتیب چپ‌به‌راست خود را حفظ می‌کنند. جای نشانگر هنگام تایپ ترکیبی اصلاح شده و دریافت ورودی UTF-8 تکه‌تکه دیگر حروف فارسی را خراب نمی‌کند.

فایل rtl-ai-reader-win32-x64-0.3.4.vsix را با Extensions: Install from VSIX نصب کنید، سپس Developer: Reload Window را اجرا کنید و OpenCode یا Grok را در ترمینال جدید باز کنید.

سایت پشتیبانی / موقع الدعم / Support: 6arshid.com

الوصف بالعربية

إضافة RTL AI Reader لبرنامج VS Code تجعل مخرجات OpenCode وGrok بالعربية والفارسية أكثر وضوحًا، مع الحفاظ على اتجاه الأكواد والمسارات من اليسار إلى اليمين. توفر الإضافة طرفية تفاعلية تعالج اتصال الحروف وترتيب النص ثنائي الاتجاه، ولوحة قراءة مستقلة لعرض Markdown وقراءة النص المنسوخ من الحافظة.

تبقى الأعمدة واللوحة الجانبية في مواضعها أثناء إعادة ترتيب النص العربي والفارسي. يتطلب التشغيل التلقائي مساحة عمل موثوقة وNode.js بالإصدار 20 أو أحدث، مع تثبيت أداة OpenCode أو Grok وتسجيل الدخول إليها مسبقًا. حزمة VSIX الجاهزة مخصصة لنظام Windows x64.

التثبيت والاستخدام

1. ثبّت ملف VSIX باستخدام Extensions: Install from VSIX.
2. نفّذ Developer: Reload Window، ثم أغلق الطرفية القديمة وافتح طرفية جديدة.
3. شغّل opencode أو grok لاستخدام العرض التلقائي، أو نفّذ RTL AI: Start OpenCode RTL Terminal من لوحة الأوامر.
4. لقراءة نص منسوخ، استخدم RTL AI: Read Clipboard (OpenCode / Grok). لفتح لوحة القراءة، استخدم RTL AI: Open Reader.

النقر بالماوس داخل واجهة الطرفية وسجل التمرير الأصلي غير مدعومين. قد يحتوي النص المنسوخ من الطرفية على الأشكال العرضية للحروف؛ استخدم لوحة القراءة لنسخ النص بصيغته المنطقية.

للدعم والمساعدة: https://6arshid.com.

نسخهٔ 0.3.3 — توضیحات عربی و پشتیبانی

توضیحات و راهنمای نصب عربی اضافه شد و سایت 6arshid.com در معرفی افزونه و اطلاعات پشتیبانی ثبت شد. بستهٔ جدید: rtl-ai-reader-win32-x64-0.3.3.vsix.

نسخهٔ 0.3.2 — اصلاح چیدمان ترمینال

بازچینی فارسی و عربی اکنون داخل بخش‌های جداگانهٔ سطر انجام می‌شود؛ فاصلهٔ بین ستون‌ها و مرز پس‌زمینهٔ پنل‌ها ثابت می‌ماند تا متن پاسخ با ستون کناری OpenCode جابه‌جا نشود. بازنویسی کامل صفحه نیز بدون اسکرول ناخواسته در آخرین خانه انجام می‌شود.

برای به‌روزرسانی، فایل rtl-ai-reader-win32-x64-0.3.2.vsix را با Extensions: Install from VSIX نصب کنید، سپس Developer: Reload Window را اجرا کنید. از OpenCode خارج شوید، ترمینال قبلی را ببندید و در ترمینال جدید دوباره opencode را اجرا کنید.

نسخهٔ 0.3 — اجرای خودکار

بعد از نصب یا به‌روزرسانی، پنجرهٔ VS Code را Reload کنید و ترمینال قبلی را ببندید و ترمینال جدید باز کنید. سپس همان opencode یا grok را تایپ کنید؛ نیازی به Command Palette نیست. این رفتار به‌صورت پیش‌فرض با rtlAI.automaticTerminal فعال است و به workspace مورداعتماد و Node.js نسخهٔ 20 یا جدیدتر نیاز دارد. مسیر Node در rtlAI.nodeExecutable قابل تنظیم است؛ مقدار پیش‌فرض node است.

افزونه فقط PATH ترمینال‌های VS Code را با API خود VS Code تغییر می‌دهد و فرمان‌های واسط موقت اضافه می‌کند؛ فایل اجرایی اصلی، PATH سیستم و پروفایل شل تغییر نمی‌کنند. با غیرفعال‌کردن افزونه، تغییر محیط حذف می‌شود و واسط‌های ترمینال قبلی بدون RTL به دستور اصلی رجوع می‌کنند. نشست از قبل در حال اجرای OpenCode باید خارج و دوباره اجرا شود. برای ترمینالی که قبل از فعال‌شدن افزونه ساخته شده، یک ترمینال جدید باز کنید. Alias یا function هم‌نام و اجرای مسیر مطلق فایل اصلی، واسط PATH را دور می‌زنند.

حالت خودکار در ورودی/خروجی تعاملی، همان پنجرهٔ ترمینال را استفاده می‌کند و هنگام خروج، نمای شل را برمی‌گرداند. دستورهای دارای pipe یا خروجی فایل، بدون تبدیل عبور می‌کنند تا JSON و export تغییر نکند. آرگومان‌ها و پوشهٔ جاری حفظ می‌شوند. نسخهٔ آماده برای Windows x64 بسته‌بندی شده است. محدودیت‌های نمایشگر ترمینال نسخهٔ 0.2 همچنان اعمال می‌شوند.

نسخهٔ 0.2 — ترمینال RTL

از Command Palette دستور RTL AI: Start OpenCode RTL Terminal یا RTL AI: Start Grok RTL Terminal را اجرا کنید. دکمهٔ RTL AI در نوار پایین هم OpenCode RTL را باز می‌کند. در ترمینالی با نام OpenCode RTL یا Grok RTL کار کنید؛ ترمینال قبلی تغییر نمی‌کند.

این حالت تعاملی، خروجی ANSI را با یک ترمینال داخلی تجزیه می‌کند و حروف فارسی/عربی و ترتیب دوطرفهٔ هر سطر را قبل از ارسال به ترمینال VS Code اصلاح می‌کند. نسخهٔ بسته‌بندی‌شده برای Windows x64 است. اجرای کیبورد و تغییر اندازه پشتیبانی می‌شود؛ کلیک ماوس در رابط TUI و تاریخچهٔ اسکرول بومی پشتیبانی نمی‌شوند. متن کپی‌شده از این ترمینال ممکن است شامل فرم نمایشی حروف باشد؛ برای کپی متن منطقی از پنل Reader استفاده کنید. این حالت جدید هنوز نیاز به بررسی دستی رابط OpenCode/Grok دارد، خصوصاً سطرهای شکسته و متن دارای اعراب.

نمایش خوانای فارسی و عربی در یک پنل جداگانه VS Code، با کدهای چپ‌به‌راست.

نصب و استفاده

1. فایل VSIX را از دستور Extensions: Install from VSIX نصب کنید.
2. دستور RTL AI: Open Reader را اجرا کنید.
3. OpenCode را انتخاب کنید، پرامپت بنویسید و ارسال کنید. OpenCode باید قبلاً نصب و احراز هویت شده باشد. هر ارسال یک اجرای مستقل opencode run است؛ ادامهٔ جلسهٔ قبلی و تعامل TUI پشتیبانی نمی‌شود.
4. برای Grok یا خروجی قبلی OpenCode، متن را کپی کنید و دکمهٔ خواندن کلیپ‌بورد را بزنید. برای دریافت خروجی جدید، ترمینال Grok یا OpenCode را فعال کنید، دستور RTL AI: Follow Active Terminal Output را اجرا کنید و سپس دستور CLI را در همان ترمینال اجرا کنید. این روش به Shell Integration نیاز دارد و از دستور بعدی شروع می‌شود. خروجی برنامه‌های تمام‌صفحه با بازنویسی مکان‌نما ممکن است تکراری یا نامرتب باشد؛ برای آن‌ها از اجرای غیرتعاملی یا کپی متن استفاده کنید.
5. اجرای مستقیم Grok Build با grok --single <prompt> --output-format plain آماده است. برای CLI دیگر، rtlAI.grokExecutable و rtlAI.grokArguments را تنظیم کنید. {prompt} به یک آرگومان تبدیل می‌شود.

This extension provides an independent RTL webview. It does not modify VS Code's terminal renderer or other extensions' chat panels. It preserves logical Unicode text; it cannot reconstruct text already copied in reversed visual order. Grok clipboard reading works without a CLI; direct Grok execution requires Grok Build installed and authenticated. No API keys are collected by this extension. CLI tools use their own authentication and permissions; they may modify the workspace according to your prompts.

Markdown is rendered with raw HTML disabled. Persian paragraphs use browser bidirectional layout; fenced code and inline code are isolated left-to-right. Output is limited to the most recent two million characters. Interactive CLI input is not supported; use your terminal for authentication and interactive approval flows.

Development

npm install, npm test, npm run package.

Use VS Code's Extension Development Host to test the actual webview and your locally installed CLIs. Publishing requires ownership of the 6arshid Marketplace publisher; setting the manifest publisher does not create that account.