RastChin for VS Code

RastChin فقط برای زبان فارسی طراحی شده است و متن فارسی را در Markdown Preview و پنل‌های اصلی Claude Code و Codex خواناتر می‌کند. فایل‌های خود VS Code مانند workbench.html و product.json هیچ‌وقت تغییر نمی‌کنند.

پشتیبانی

• VS Code Markdown Preview، از طریق API رسمی Markdown
• Claude Code chat webview
• Claude Code Plan Preview (قابل غیرفعال‌سازی)
• Codex / ChatGPT for VS Code webview

امکانات

• تشخیص خودکار متن فارسی در هر message/paragraph/table cell
• حفظ LTR و فونت monospace برای کد، command، URL، email، path، terminal و diff
• راست‌چین کردن composer فارسی در Claude و Codex
• حفظ ترتیب LTR ستون‌های table و تعیین جهت مستقل هر cell
• فونت Vazirmatn داخل VSIX، بدون download یا network request
• میان‌بر Ctrl+RightShift برای RTL دستی و Ctrl+LeftShift برای LTR دستی

جریان امن فعال‌سازی Agentها

Markdown Preview بلافاصله بعد از نصب فعال است. برای Agentها:

1. پس از نصب، روی دکمه Apply RTL Patches در اعلان RastChin کلیک کنید. این اعلان حتی اگر patch قبلی هنوز current باشد، امکان verify/re-apply را ارائه می‌دهد.
2. plan را در Output بررسی و Apply Patches را تأیید کنید.
3. در صورت نمایش پیام، Reload Window را بزنید.

اگر اعلان بسته شده باشد، دکمه RastChin: Apply RTL در status bar تا زمان اعمال patch باقی می‌ماند. همچنین با راست‌کلیک روی RastChin در فهرست Extensions می‌توان دستور re-apply را اجرا کرد. تمام commandهای قبلی، از جمله RastChin for VS Code: Re-apply Patches، همچنان در Command Palette در دسترس‌اند.

دستور RastChin for VS Code: Inspect Agent Patch Plan فقط خواندنی است و نسخه، مسیر و compatibility layout فعال را نمایش می‌دهد.

RastChin هدف فعال را با API رسمی extension registry پیدا می‌کند، layout را قبل از هر write اعتبارسنجی می‌کند و target ناشناخته/ناقص را تغییر نمی‌دهد. هر target در یک transaction مستقل patch می‌شود: backup و metadata ساخته می‌شوند و اگر یکی از writeها شکست بخورد، همه تغییرات همان target rollback می‌شوند.

Update و بازیابی

Update شدن Claude یا Codex معمولاً فایل‌های patch‌شده را جایگزین می‌کند. RastChin این تغییر را تشخیص می‌دهد و فقط پیشنهاد بررسی plan می‌دهد؛ update را بدون تأیید دوباره patch نمی‌کند. برای حذف patchها دستور زیر را اجرا کنید:

RastChin for VS Code: Disable / Restore Patches

Restore از hash و metadata استفاده می‌کند تا نسخه جدید Agent با backup قدیمی downgrade نشود. هنگام uninstall نیز hook بازیابی اجرا می‌شود. با این حال این integration یک API رسمی styling نیست و update بزرگ Agent ممکن است تا اضافه شدن adapter سازگار، UNSUPPORTED گزارش شود.

Commandها

• RastChin for VS Code: Status
• RastChin for VS Code: Inspect Agent Patch Plan
• RastChin for VS Code: Re-apply Patches
• RastChin for VS Code: Disable / Restore Patches
• RastChin for VS Code: Clean Legacy Extension Patches

تنظیمات

• persianRtlClean.patchClaudeCode
• persianRtlClean.patchCodex
• persianRtlClean.patchClaudePlanPreview
• persianRtlClean.confirmBeforePatching
• persianRtlClean.patchOnStartup

نصب extension به‌صورت پیش‌فرض agent دیگری را patch نمی‌کند. گزینه patchOnStartup یک opt-in صریح برای re-apply خودکار در startup است؛ مقدار پیش‌فرض آن false است.

جزئیات مجوزها و attribution در THIRD_PARTY_NOTICES.md آمده است.