شروع پروژه
معرفی پروژه
Persian Unicode Safety یک Skill برای Codex است که با هدف جلوگیری از خراب شدن متن فارسی و عربی در فرآیندهای توسعه نرمافزار طراحی شده است. این پروژه به Codex کمک میکند قبل از ویرایش فایلها، اجرای دستورات ترمینال یا تولید خروجی متنی، وضعیت encoding محیط را بررسی کند و از روشهای امن برای خواندن، نوشتن و اصلاح فایلها استفاده کند.
این Skill برای پروژههایی کاربرد دارد که شامل متن فارسی، متن راستبهچپ، نام فایلهای غیرانگلیسی، فایلهای JSON، Markdown، CSV، سورسکد، خروجی Git، PowerShell، Bash، WSL، Docker یا CI هستند. ساختار پروژه به شکلی طراحی شده که فایل اصلی Skill سبک و خلاصه بماند و راهنماهای جزئیتر فقط در زمان نیاز از پوشه references بارگذاری شوند.
در این پروژه برای سناریوهای مختلف مثل PowerShell ویندوز، شلهای لینوکسی، Python، Node.js، Git، VS Code و تشخیص/ترمیم mojibake راهنمای جداگانه در نظر گرفته شده است تا Codex بتواند بسته به نوع کار، مسیر امنتری را انتخاب کند.
مسئله اصلی
چالش پروژه
در پروژههایی که متن فارسی دارند، یکی از مشکلات رایج این است که فایلها یا خروجیها به دلیل تنظیمات اشتباه encoding خراب میشوند. این مشکل مخصوصاً در Windows PowerShell 5.1، redirect کردن خروجی ترمینال، خواندن و نوشتن فایلها بدون encoding مشخص، مسیرهای فارسی در Git و کار با فایلهای JSON یا Markdown بیشتر دیده میشود.
چالش اصلی این پروژه این بود که قبل از هر عملیات حساس روی متن فارسی، یک workflow مشخص وجود داشته باشد تا محیط، نوع فایل، مسیر خواندن/نوشتن و نمایش Git بررسی شود و از خراب شدن متن جلوگیری شود.
مسیر اجرا
راه حل اجرا
برای حل این مسئله، یک Skill مستندمحور طراحی شد که ابتدا سطح ریسک را تشخیص میدهد؛ یعنی مشخص میکند کار در چه محیطی انجام میشود، نوع فایل چیست و عملیات قرار است خواندن، نوشتن، append، diff، parse یا repair باشد.
سپس بر اساس شرایط، راهنمای مناسب از بخش references انتخاب میشود؛ مثلاً برای PowerShell، شلهای Unix، فایلخوانی Python/Node، Git و VS Code یا ترمیم متن خرابشده. در این Skill تأکید شده که برای کار با متن فارسی از UTF-8 صریح، APIهای امن، ترمینال درست تنظیمشده و بررسی round-trip قبل و بعد از تغییر استفاده شود.
دستاورد نهایی
خروجی و نتیجه
خروجی پروژه یک Skill کاربردی برای Codex است که ریسک خراب شدن متن فارسی و فایلهای UTF-8 را در فرآیند توسعه کاهش میدهد. این Skill بهخصوص برای پروژههایی که محتوای فارسی، مسیرهای فارسی، فایلهای Markdown/JSON/CSV یا دستورات PowerShell و Git دارند مفید است.
پروژه به صورت documentation-first طراحی شده و به جای اضافه کردن اپلیکیشن یا اسکریپت اجرایی، یک workflow قابل استفاده برای عاملهای Codex ارائه میدهد.
زیرساخت اجرا
فناوری های پروژه
این پروژه با مجموعهای از ابزارها و فناوریهایی پیادهسازی شده که برای سرعت توسعه، پایداری و مقیاس مناسب انتخاب شدهاند.
Codex Skills
Markdown
YAML
UTF-8
Unicode
PowerShell
Bash
WSL
Git
VS Code
Python
Node.js
JSON
CSV
گام بعدی
لینک های پروژه
برای بررسی اجرای نهایی یا مرور ساختار کد، از مسیرهای زیر وارد خود پروژه یا مخزن آن شوید.
وبسایت آموزشی / مدرسه
فروشگاه اینترنتی / تجارت الکترونیک
فروشگاه اینترنتی