أفضل الممارسات لتجنّب mojibake مع Codex على Windows - prompting واضح قبل ضبط البيئة

حين تترك Codex يعمل على ملفّات نصّيّة يابانيّة على Windows، فإنّ أوّل ما يفيد عادةً ليس مواءمةً مثاليّةً للمحرّر أو الـ shell. بل هو إخبار Codex بدقّة كيف يقرأ، وكيف يكتب، ومتى يتوقّف.

حالات الفشل الشائعة مألوفة:

• وجود ملفّات UTF-8 وCP932 وUTF-16 معاً في الـ repository نفسه
• النصّ يبدو مقروءاً على الشاشة، لكنّ تفسير الـ bytes خاطئ أصلاً
• “تعديل صغير” يُعيد حفظ ملفّ موجود بصمت في encoding مختلف
• العطل الفعلي يقع في ملفّات CSV أو TXT أو السجلّات أو Markdown أو ملفّات التكوين، لا في الشيفرة المصدريّة
• مخرجات shell سريعة تُنسخ إلى ملفّ حقيقي ويصبح الضرر دائماً

يعمل Codex بشكل أفضل حين يُعامَل أقلّ كـ chatbot لمرّة واحدة وأكثر كزميل فريق يتّبع قواعد المشروع. إن كان الفريق يستخدم بالفعل AGENTS.md، فإنّ قواعد text encoding هي بالضبط من النوع الذي ينبغي تدوينه مرّة واحدة وإعادة استخدامه.

تنظّم هذه المقالة مجموعةً عمليّة من التعليمات لاستخدام Codex بأمان مع ملفّات نصّيّة يابانيّة على Windows.

1. الإجابة المختصرة

أكثر خطوة فعّالة هي تعريف سير عمل text encoding قبل بدء مهمّة التعديل.

القواعد التي تساعد عادةً أكثر من غيرها هي:

• قبل أن يقرأ Codex ملفّاً نصّيّاً يابانيّاً موجوداً، اجعله يفحص encoding المحتمل، ووجود BOM، ونمط الـ newlines
• إذا كان هناك اشتباه بـ mojibake، فلا تدعه يحفظ الملفّ بناءً على التخمين
• حافظ على الـ encoding الأصلي وعلى BOM ونمط الـ newlines للملفّات الموجودة
• اترك الملفّات الجديدة تتبع اتّفاقيّة الـ repository، عادةً مبنيّة على UTF-8
• استخدم فقط مسارات كتابة تمنح تحكّماً صريحاً بـ encoding
• بعد الكتابة، أعد فتح الملفّ وتحقّق من أسطر يابانيّة تمثيليّة

عمليّاً، النسخة المختصرة تبدو هكذا:

• افحص قبل القراءة
• امنع الحفظ التخمينيّ
• حافظ على الموجود، ووحّد المعيار للجديد فقط
• تجنّب مسارات الكتابة الغامضة
• تحقّق بعد الحفظ

التعليمات الخطرة هي أمور مثل:

• “أصلح الـ mojibake”
• “اجعل كلّ شيء UTF-8”
• “صدّر CSV”
• “وفّق بينها بأي طريقة”
• “احفظه ولنرَ”

المشكلة في تلك الـ prompts هي أنّها لا تخبر Codex أين يُفترض به أن يتوقّف.

2. لماذا يجعل Windows هذا أسهل في الكسر

المشكلة الجذريّة عادةً ليست أنّ Codex لا يستطيع التعامل مع اليابانيّة. بل أنّ مشاريع Windows غالباً ما تحتوي على encodings متعدّدة ومسارات كتابة متعدّدة في الوقت نفسه.

قد يتضمّن repository حقيقيّ:

• ملفّات مصدر أحدث وMarkdown بـ UTF-8
• ملفّات CSV وTXT وسجلّات وملفّات تكوين أقدم بـ CP932
• بعض المخرجات المولَّدة بـ UTF-16
• مسارات حفظ مختلفة عبر المحرّرات والـ shells وأدوات التصدير وسير العمل المعتمد على Office
• نهايات أسطر LF وCRLF معاً

في تلك الحال، يكفي تفسير واحد خاطئ لكي يتعامل Codex مع نصّ غير مقروء كأنّه قد فهمه بالفعل. حالما يُحفظ الملفّ في تلك الحال، تتوقّف المشكلة عن كونها مشكلة عرض وتصبح ضرراً فعليّاً للمحتوى.

لذلك فإنّ الوقاية من mojibake هي بشكل رئيسيّ مشكلة إجراءات I/O، لا مشكلة جودة لغة غامضة.

3. قواعد تستحقّ التثبيت مسبقاً

3.1 افحص encoding وBOM وnewlines قبل القراءة

ينبغي أن تكون القاعدة الأولى صريحةً:

قبل قراءة أو تعديل ملفّ نصّيّ موجود قد يحتوي على يابانيّة، حدّد أوّلاً encoding المحتمل، ووجود BOM، ونمط الـ newlines.

يُغيّر هذا سير العمل من “اقرأ النصّ أوّلاً” إلى “افهم شروط الملفّ أوّلاً”.

3.2 لا تسمح أبداً بالحفظ التخميني للملفّات المريبة

هذه أهمّ قاعدة أمان.

إذا كان هناك اشتباه بـ mojibake، أبقِ الملفّ للقراءة فقط حتّى يصبح التفسير موثوقاً.

إن لم يستطع الوكيل قراءة الملفّ بثقة، فلا ينبغي السماح له بحفظه.

3.3 حافظ على الملفّات الموجودة؛ ووحّد المعيار للملفّات الجديدة

تبدو “حوّل كلّ شيء إلى UTF-8” نظيفةً، لكنّها كثيراً ما تكون مدمّرةً جدّاً كجزء من مهمّة تعديل عاديّة.

قاعدة تشغيل أكثر استقراراً هي:

• حافظ على الـ encoding الأصلي للملفّات الموجودة
• اترك الملفّات الجديدة تتبع اتّفاقيّة الـ repository
• عامِل ترحيل الـ encoding كمهمّة صريحة بحدّ ذاتها

3.4 تجنّب مسارات الكتابة الغامضة

كثير من حوادث الـ encoding على Windows تأتي من مسارات إخراج عابرة:

• إعادة توجيه الـ shell
• أوامر مريحة سريعة
• مخرجات مولَّدة مؤقّتاً تُنسخ إلى ملفّ حقيقي

تلك المسارات كثيراً ما لا تُصرّح بسلوك الـ encoding، فهي افتراضيّات سيّئة لـ repositories ذات encodings مختلطة.

3.5 أعد الفتح وتحقّق بعد الكتابة

“الحفظ نجح” و”الملفّ سليم” ليسا الشيء نفسه.

بعد الكتابة، ينبغي على Codex أن يُعيد فتح الملفّ ويفحص أسطراً يابانيّة تمثيليّة بحثاً عن علامات مثل:

• replacement characters
• نموّ مريب في ?
• تغييرات BOM غير مقصودة
• diffs غير مقصودة على مستوى الـ newlines فقط
• نصّ عمل لم يتغيّر يُتلَف بصمت

3.6 أبلِغ عن الشذوذ قبل فرض إصلاح

في حوادث text encoding، التوقّف مبكّراً كثيراً ما يكون أفضل من فرض إصلاح.

إشارات إيقاف نموذجيّة:

• ازدياد U+FFFD
• ازدياد ?
• تغييرات BOM غير متوقّعة
• diffs ضخمة على مستوى الـ newlines فقط
• تغييرات كبيرة وغير طبيعيّة على الأسطر اليابانيّة وحدها

4. كتلة تعليمات قصيرة فعّالة

للمهامّ اليوميّة، شيء بهذا الطول كثيراً ما يكفي:

In this task, prioritize avoiding text-encoding accidents.

- Before reading an existing file that may contain Japanese, check likely encoding, BOM presence, and newline style.
- If mojibake is suspected, do not save based on guesswork.
- Preserve encoding, BOM, and newline style for existing files.
- Follow repository convention for new files.
- Use only write paths with explicit encoding control.
- After writing, reopen the file and verify representative Japanese lines.
- If replacement characters, suspicious `?`, unintended BOM changes, unintended newline conversion, or whole-file diffs appear, stop and report.

إذا كانت الملفّات المستهدفة معروفة، فإنّ إضافة سطر واحد إضافيّ يساعد أكثر:

Target files: <paths> / Representative strings: "<examples>"

تمنح الـ representative strings لـ Codex مجموعةً ملموسةً من النصّ يجب أن يبقى كما هو دون تغيير.

5. قالب عملي لـ AGENTS.md

إن اضطُرّ الفريق إلى تكرار التحذير نفسه كثيراً، فمكانه AGENTS.md. قالب عملي يبدو هكذا:

# Text Encoding Rules

## Scope
This repository may contain Japanese text and mixed legacy encodings.
Avoid mojibake and accidental re-encoding above all else.

## Mandatory Rules
- Before reading or editing an existing text file that may contain Japanese, first determine:
  - likely encoding
  - BOM presence
  - newline style
- If mojibake is suspected, do not save the file until the encoding interpretation is credible.
- Preserve the original encoding, BOM, and newline style for existing files.
- Treat "convert to UTF-8" as a separate, explicit task.
- New files should follow repository convention. If there is no clear rule, prefer UTF-8 and state whether BOM is used.
- Do not use ambiguous write paths by default, such as shell redirection or convenience commands without explicit encoding control.
- After writing, reopen the file and verify representative Japanese lines.
- If any of the following appears, stop and report:
  - replacement characters
  - unexpected `?`
  - unintended BOM change
  - unintended newline conversion
  - whole-file diffs without a business reason

## Reporting Format
For each changed text file, report:
- path
- detected or preserved encoding
- BOM presence
- newline style
- how verification was performed
- whether representative Japanese text remained intact

سطران قويّان بشكل خاصّ:

• If mojibake is suspected, do not save ...
• Treat "convert to UTF-8" as a separate, explicit task.

هذان السطران وحدهما يمنعان عدداً مفاجئاً من الحوادث.

6. prompts سيّئة وprompts أفضل

للصياغة أهمّيّة كبيرة في هذا النوع من المهامّ.

النمط ثابت: prompts الجيّدة تُحدّد كلّاً من الشروط المسبقة قبل التعديل والفحوصات بعد الحفظ.

7. قائمة مراجعة الـ review

بعد أن ينتهي Codex، يساعد أن يفحص المراجِع:

• ما إذا أُبلِغ عن معالجة encoding وBOM وnewlines لكلّ ملفّ
• ما إذا تغيّرت الأسطر اليابانيّة أكثر ممّا يتطلّبه التغيير العملي
• ما إذا كانت هناك diffs مريبة على مستوى الـ newlines فقط
• ما إذا ظهرت replacement characters أو ? غير عاديّة
• ما إذا انحرفت بنية CSV أو السجلّات أو ملفّات التكوين
• ما إذا تضمّنت الـ diff إعادة كتابة كاملة لملفّ غير ذي صلة

من أجل أمان الـ encoding، رصد diffs المريبة مبكّراً أفضل من دفع تعديل إضافي حتّى النهاية.

8. الخلاصة

على Windows، الخطوة الأولى نحو تعديل أكثر أماناً للنصّ الياباني مع Codex ليست عادةً كمال البيئة. بل جعل قواعد التعديل صريحة.

الأفكار الخمس التي تستحقّ التذكّر هي:

• افحص encoding وBOM وnewlines قبل القراءة
• لا تسمح بالحفظ التخمينيّ حين يُشتبَه بـ mojibake
• حافظ على الملفّات الموجودة ووحّد المعيار للملفّات الجديدة فقط
• تجنّب مسارات الكتابة الغامضة
• أعد الفتح وتحقّق من أسطر يابانيّة تمثيليّة بعد الحفظ

وإن اضطُرَّ المرء لقول ذلك مراراً، فليكتبه في AGENTS.md.

الوقاية من mojibake ليست في الحقيقة حول قول “من فضلك تعامل مع اليابانيّة بحذر”. بل حول تعريف الشروط التي يُسمح فيها بالحفظ، والشروط التي يجب أن يتوقّف فيها الوكيل.

9. مراجع

• OpenAI Codex docs, Best practices
• OpenAI Codex docs, Custom instructions with AGENTS.md
• OpenAI Codex docs, Windows

مقالات ذات صلة

أحدث المقالات التي تشترك في نفس الوسوم. عمّق فهمك بمواضيع مرتبطة.

أين يتصل هذا الموضوع

ترتبط هذه المقالة بشكل طبيعي بصفحات الخدمات التالية.

الملف الشخصي للمؤلف

صفحة الملف الشخصي لمؤلف المقالة.

غو كومورا

مؤسّس شركة كومورا سوفت ذ.م.م.

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