StoryBehindThisProject

لماذا لدينا هذا

تمت مناقشته في KCD 2025 بكين، Community Over Code 2025 الصين، وقررنا أخيرًا إنشاء وكيل (agent) للتعامل مع أعمال i18n (التدويل) للمجتمع. بالنسبة لي، لا يمكنني التوازي في https://github.com/sustainable-computing-io/kepler-doc/issues/175 وجلسة Community Over Code 2025.

في النطاق وليس في النطاق، وكيف يعمل

لا نريد إعادة اختراع العجلة.

المشغل (Trigger) ليس في النطاق
اتركه يدويًا للتحديث الكامل أو إجراء الفرق (diff action)
واجهة برمجة التطبيقات للنموذج (model api) ونقطة نهاية النموذج (model endpoint)

يمكن للأشخاص اختيار أي خدمة LLM مع واجهة برمجة التطبيقات OpenAI؟
نقطة دخول التكوين (config entry point)

نحتاج إلى معرفة اللغة الافتراضية وما هي اللغات المستهدفة، موجود في ملف التكوين.

--- النطاق ---

المرحلة الأولى: من ملف التكوين

سام في يوليو 2025: لا أريد أن يفحص LLM المشروع، بسبب تكلفة الرموز (token cost) أو قد يخطئ. فقط اطلب من مسؤول المستند تقديم ملف تكوين i18n، سيكون الإشارة اليدوية إلى ملف التكوين صحيحة بنسبة 100% لتكوين i18n.

نطاق اللغة، كيف نحصل على نطاق اللغة؟
= استهلاك ملفات التكوين للحصول على قائمة اللغات.
= اللغة الافتراضية - اللغة الموجودة (فرق ملف)
حفظ النتيجة في ملف محدد

سام في يوليو 2025: بعد أن يكون لدينا نطاق الترجمة، نحتاج أيضًا إلى قواعد تسمية من ملفات التكوين. (أو ربما نطلب من LLM ملاحظة ذلك)

-- نهاية هنا: الحصول على قائمة لملف المصدر، هدف الترجمة، اللغة.

سام في يوليو 2025: كنتيجة لهذه المرحلة، نحتاج إلى نطاق واضح لجميع المهام.

-- المرحلة الثانية، حلقة تكرار (A for loop) هنا للترجمة

الترجمة اطلب مساعدة LLM
كيف نحصل على مسرد (glossary) لتعيين المحتوى؟
الفجوات؟ (أو مجرد تحديث الكل)

سام في يوليو 2025: لتكون محددة.

--- ليس في النطاق ---

إنشاء طلب سحب (PR) اتركه لإجراء PR

لا نريد إعادة اختراع العجلة. حيث توجد إجراءات PR بالفعل لفتح طلب سحب للتغيير.