ابزارهای فارسی‌محور، local-first و RTL برای مرورگر، VS Code، برنامه‌های دسکتاپ هوش مصنوعی پشتیبانی‌شده
راست‌چین مجموعه‌ای متن‌باز برای خواناتر کردن متن فارسی و ترکیب‌های فارسی–انگلیسی است. پردازش متن در افزونه‌ها و برنامهٔ دسکتاپ روی دستگاه شما انجام می‌شود؛ راست‌چین محتوای صفحه، گفتگو یا سند را برای خودش ارسال نمی‌کند.
این پروژه جهت نوشتار، تایپوگرافی، نشانه‌گذاری متن ترکیبی و رفتار کادر نوشتن فارسی را بهتر می‌کند و در عین حال کد، فرمان، مسیر، URL، diff و سایر محتوای فنی را LTR نگه می‌دارد. این مونوریپو مرجع عمومی سه برنامهٔ راست‌چین است. زبان طبیعیِ تحت پشتیبانی فقط فارسی است و انگلیسی تنها در متن ترکیبی و اصطلاحات فنی حفظ می‌شود.
| برنامه | نسخه | مسئولیت | وضعیت |
|---|---|---|---|
| افزونهٔ مرورگر | 1.1.78 | رفتار RTL مبتنی بر Manifest V3 برای وب‌سایت‌های صریحاً پشتیبانی‌شده، popup و side panel | بسته‌های مستقل Chrome و Firefox |
| افزونهٔ VS Code | 0.3.15 | Markdown Preview و یکپارچه‌سازی برگشت‌پذیر Claude Code/Codex با رضایت کاربر | مسیر انتشار مستقل VSIX |
| برنامهٔ دسکتاپ | 0.3.7 | کشف محلی و یکپارچه‌سازی RTL در حافظه برای برنامه‌های رسمی دسکتاپ پشتیبانی‌شده | پایدار برای ChatGPT/Codex؛ Claude در نسخه‌های آینده |
هر برنامه نسخه و مسیر انتشار مستقل دارد. نسخهٔ ریشه، یعنی 0.1.0، زیرساخت مونوریپو را توصیف می‌کند و نسخهٔ هماهنگ همهٔ خروجی‌ها نیست.
خروجی‌های عمومی و checksum آن‌ها در GitHub Releases با tag مستقل هر برنامه منتشر می‌شوند. تغییر نسخهٔ یک برنامه پس از review و merge در main انتشار همان مسیر را خودکار آغاز می‌کند. نصب نسخه‌های Windows، macOS و Linux دستی است و برنامهٔ دسکتاپ در حال حاضر auto-update ندارد. بستهٔ macOS در حالت پیش‌فرض ad-hoc ممکن است هشدار Gatekeeper نشان دهد؛ حالت امضا و notarization اپل نیز برای انتشار مورداعتماد پشتیبانی می‌شود. انتشار فایل در GitHub به‌معنی انتشار خودکار در marketplaceها نیست.
- پردازش متن مرورگر، VS Code و دسکتاپ روی دستگاه کاربر می‌ماند.
- راست‌چین هیچ تحلیل‌گر یا تله‌متری اضافه نمی‌کند و حساب کاربری، پایگاه داده، object storage یا API بارگذاری محتوا ندارد.
- دسترسی مرورگر به میزبان‌ها و مجوزهای اعلام‌شده در manifest افزونه محدود است.
- تغییرات VS Code به قصد صریح کاربر، بررسی سازگاری، پشتیبان، نوشتن تراکنشی و بازیابی آگاه از هش نیاز دارند.
- برنامهٔ دسکتاپ فایل‌های امضاشدهٔ برنامهٔ فروشنده را تغییر نمی‌دهد و پورت اشکال‌زدایی شبکه باز نمی‌کند. این برنامه از پایپ محلی خصوصی استفاده می‌کند، مقادیر حساس محیط را حذف می‌کند و متن گفتگو را ثبت نمی‌کند.
- نسخه، چیدمان، فایل اجرایی، امضا یا هویت بستهٔ ناشناخته به‌صورت امن رد می‌شود.
- بازخورد، درخواست پشتیبانی و گزارش اشکال از طریق قالب‌های ایشوی GitHub انجام می‌شود؛ اطلاعات خصوصی یا محتوای کاربر نباید در ایشوی عمومی قرار گیرد.
برای قواعد کامل محصول، docs/product.md و برای مرزهای برنامه‌ها، docs/architecture.md را بخوانید.
نیازمندی‌ها:
- Node.js 24.18.1 یا جدیدتر در خط Node 24
- pnpm 11.14.0 از طریق Corepack
- Bash برای اسکریپت‌های بسته‌بندی مرورگر
- اختیاری: Chrome 114+، Firefox 142+، VS Code به‌همراه CLI با نام
codeو ابزارهای بسته‌بندی پلتفرم هدف دسکتاپ
در ریشهٔ مخزن اجرا کنید:
corepack enable
pnpm install --frozen-lockfile
pnpm check| فرمان | کاربرد |
|---|---|
pnpm dev:browser |
ساخت نسخهٔ unpacked برای Chrome در apps/browser-extension/unpacked/ |
pnpm dev:firefox |
ساخت نسخهٔ unpacked برای Firefox در apps/browser-extension/unpacked-firefox/ |
pnpm package:browser |
ساخت و بررسی هر دو ZIP انتشار Chrome و Firefox |
pnpm package:browser:chrome |
ساخت ZIP مخصوص Chrome Web Store |
pnpm package:browser:firefox |
ساخت ZIP مخصوص Firefox Add-ons |
pnpm dev:vscode |
باز کردن VS Code Extension Development Host؛ نیازمند code در PATH |
pnpm dev:desktop |
اجرای مدیر دسکتاپ در حالت توسعه از سورس |
pnpm lint |
اجرای همهٔ linterهای موجود |
pnpm typecheck |
اجرای همهٔ بررسی‌کننده‌های نوع |
pnpm test |
اجرای همهٔ آزمون‌های رگرسیون برنامه‌ها |
pnpm verify |
بررسی سیاست‌های بسته‌بندی/ایمنی برنامه‌ها و مرزهای مخزن عمومی |
pnpm check |
اجرای lint، بررسی نوع، آزمون‌ها و راستی‌آزمایی |
pnpm audit:prod |
رد آسیب‌پذیری شناخته‌شدهٔ شدید/بحرانی در وابستگی‌های تولید |
فرمان‌های توسعه و بسته‌بندی متمرکز در README هر برنامه قرار دارند. ساخت یک خروجی، آن را منتشر نمی‌کند.
apps/
├── browser-extension/ افزونهٔ Manifest V3 برای Chrome و Firefox
├── vscode-extension/ افزونهٔ VS Code
└── desktop-integrator/ مدیر Electron پایدار برای ChatGPT/Codex
packages/ ویژهٔ قراردادهای اثبات‌شدهٔ میان‌برنامه‌ای
docs/
├── product.md رفتار محصول و مرزهای انتشار
├── architecture.md نقشهٔ فشردهٔ معماری مونوریپو
├── migration/ منشأ سورس‌های واردشده
└── ai/ راهنمای پایدار مهندسی OmegaForge
scripts/ راستی‌آزمایی سراسری مخزن
.github/ CI، گردش‌کار بسته‌ها و قالب‌های مشارکت
فایل پیاده‌سازی را مستقیماً میان برنامه‌ها وارد نکنید. کد مشترک فقط زمانی در packages/ قرار می‌گیرد که دست‌کم دو برنامه از یک قرارداد پایدار یکسان استفاده کنند و قواعد ایمنی ویژهٔ میزبان آن‌ها حفظ شود.
مخزن‌های اولیه به‌صورت snapshotهای پاک وارد شدند و تاریخچه‌های نامرتبط Git با هم ترکیب نشدند. کامیت دقیق منابع در docs/migration/source-snapshots.md ثبت شده است.
از مشارکت در کد، آزمون، متن فارسی، مستندات فارسی، دسترس‌پذیری و adapterهای سازگاری استقبال می‌کنیم. از CONTRIBUTING.md شروع کنید و README و ماتریس آزمون بخش مالک را دنبال کنید. پیش از مشارکت آیین‌نامه رفتاری را بخوانید.
آسیب‌پذیری‌ها را از مسیر خصوصی SECURITY.md گزارش کنید. برای پرسش‌های نصب و استفاده به SUPPORT.md مراجعه کنید. نگه‌دارندگان باید از RELEASING.md پیروی کنند؛ تغییرات سراسری مخزن در CHANGELOG.md ثبت می‌شود.
سورس و مستندات دست‌اول تحت مجوز Apache 2.0 هستند. انتساب لازم در NOTICE آمده و کد، فونت و دارایی‌های اشخاص ثالث، شرایط درج‌شده در THIRD_PARTY_NOTICES.md و اعلان‌های هر برنامه را حفظ می‌کنند.
نام‌های RastChin و راست‌چین، لوگوی پلکانی و هویت‌های رسمی محصول متعلق به Omega Do IT Solutions هستند. Apache-2.0 حق استفاده از کد را می‌دهد، نه اجازهٔ معرفی یک توزیع تغییریافته به‌عنوان انتشار رسمی راست‌چین. TRADEMARK.md را ببینید.
OpenAI، ChatGPT، Codex، Anthropic، Claude، Meta، Meta AI، Linear، Google Chrome، Mozilla Firefox، Microsoft، Visual Studio Code، GitHub، Electron و سایر نام‌های اشاره‌شده متعلق به صاحبان خود هستند. راست‌چین یک پروژهٔ مستقل سازگاری است و از سوی این مالکان تأیید نشده است.