anl 1.7.1 → 1.7.2

package/README.ar.md

@@ -2,75 +2,99 @@
 
 [简体中文](./README.zh.md) | [English](./README.md) | [Español](./README.es.md) | العربية | [Français](./README.fr.md) | [Русский](./README.ru.md) | [日本語](./README.jp.md)
 
-## الوصف
+# نظرة عامة على الوظائف
 
-an-cli هو أداة سطر أوامر للواجهات الأمامية وتوفر الأوامر التالية:
-
-> `anl type`: أداة CLI تُولّد تلقائيًا تعريفات الأنواع TypeScript ودوال طلبات API اعتمادًا على ملف Swagger/OpenAPI JSON.
-
-> `anl lint`: تُنشئ إعدادات ESLint وStylelint وPrettier وCommitLint وVSCode لمشاريع React أو Vue.
-
-> `anl git`: تُنشئ إعدادات Git محلية تشمل فروع gitflow القياسية وموضوعات رسائل الالتزام وأوامر Git مخصصة.
+> an-cli هو أداة سطر أوامر للواجهة الأمامية، يتضمن الأوامر التالية:
+>
+> - أمر `anl type`: أداة سطر أوامر لتوليد تعريفات أنواع TypeScript ودوال طلبات API تلقائيًا بناءً على Swagger JSON.
+> - أمر `anl lint`: توليد تكوينات eslint و stylelint و prettier و commitLint و VSCode ذات الصلة لمشاريع react أو vue
+> - أمر `anl git`: توليد تكوين git المحلي، مع وظائف اختيارية: إنشاء فروع gitflow القياسية، موضوعات رسائل git commit، تكوين أوامر git المخصصة
 
-## الميزات
+# الميزات الرئيسية
 
 - `anl type`
-  - 🚀 تحليل تلقائي لملفات Swagger JSON
-  - 📦 توليد ملفات تعريف الأنواع TypeScript
-  - 🔄 توليد دوال طلبات API آمنة الأنواع
-  - 🎯 دعم معاملات المسار والاستعلام ومتن الطلب
-  - 📝 توليد تلقائي لتعريفات التعدادات
-  - 🎨 دعم تنسيق الشيفرة
-  - ⚡️ دعم رفع الملفات
-  - 🛠 خيارات توليد قابلة للتهيئة
+  - 🚀 تحليل مستندات Swagger JSON تلقائيًا
+  - 📦 توليد ملفات تعريف أنواع TypeScript
+  - 🔄 توليد دوال طلبات API آمنة من حيث الأنواع
+  - 🎯 دعم معاملات المسار ومعاملات الاستعلام وجسم الطلب
+  - 📝 توليد تعريفات أنواع التعداد تلقائيًا
+  - 🎨 دعم تنسيق الكود
+  - ⚡️ دعم تحميل الملفات
+  - 🛠 خيارات توليد كود قابلة للتكوين
 
 - `anl lint`
-  - 🔍 إعداد أدوات الفحص البرمجي بنقرة واحدة
-  - 🎨 تهيئة تلقائية لـ ESLint
-  - 🎯 إعدادات Prettier
-  - 🔄 معايير رسائل الالتزام عبر CommitLint
-  - 📦 إعدادات محرر VSCode
+  - 🔍 تكوين أدوات lint المختلفة بنقرة واحدة
+  - 🎨 أتمتة تكوين ESLint
+  - 🎯 تكوين تنسيق Prettier
+  - 🔄 معيار التزام CommitLint
+  - 📦 تكوين محرر VSCode
 
-## التثبيت
+- `anl git`
+  - 🔍 تثبيت اختياري لوظائف متعددة
+  - 🎨 إنشاء فروع git flow القياسية
+  - 🎯 تعيين موضوع تلقائي يتوافق مع معيار CommitLint
+  - 🔄 توفير تكوين أوامر git المخصصة ونقطة الدخول
+  - 📦 توليد تلقائي بدون تكوين
 
-> ملاحظة
->
-> يتطلب التثبيت عالميًا
+# التثبيت
+
+> [!NOTE]
+> يتطلب التثبيت العام
 
 ```bash
 $ npm install anl -g
+```
 
+```bash
 $ yarn global add anl
 ```
 
-## دليل الاستخدام
+```bash
+$ pnpm add -g anl
+```
+
+# تعليمات الاستخدام
 
-> تلميح
+> [!TIP]
 >
-> 1. إن كانت هذه أول مرة، نفّذ الأمر أولًا لمعاينة التغييرات على مشروعك، ثم عدّل الإعدادات بحسب التوثيق وأعد التوليد حتى تصل للشكل المطلوب.
-> 2. أو اتبع الخطوات أدناه واحدة تلو الأخرى.
+> 1. إذا كنت تستخدمه لأول مرة ولا تعرف ما هي النتائج، يُنصح بتنفيذ الأمر أولاً، ومراقبة التغييرات التي ستحدث في المشروع، ثم الجمع بين الوثائق، وتعديل التكوين بشكل أكبر، وإعادة التوليد، للوصول في النهاية إلى الشكل المثالي
+> 2. أو اتبع الخطوات أدناه خطوة بخطوة، وستحصل على نتائج جيدة
+> 3. يرجى تنفيذ أوامر `anl type` و `anl lint` و `anl git` في الدليل الجذر للمشروع
 
-# أمر anl type
+## تعليمات استخدام أمر `anl type`
 
-## طريقة الاستخدام
+- عند تنفيذ أمر `anl type` **للمرة الأولى**، سيتم _إنشاء تلقائي_ لملف تكوين باسم `an.config.json` في _الدليل الجذر للمشروع_ (يمكن أيضًا الإنشاء يدويًا) مع قالب تكوين أولي.
 
-1. تنفيذ الأمر
+- عند تنفيذ أمر `anl type`، سيتم البحث عن ملف تكوين `an.config.json` في الدليل الجذر لمشروع المستخدم، وقراءة معلومات التكوين الخاصة به، وتوليد تغليف axios المقابل، والتكوين، وقائمة الواجهات، وطلبات الواجهة وأنواع TS لمعاملات الطلب والاستجابة لكل واجهة
 
-```bash
-$ anl type
-```
+- عناصر التكوين في ملف التكوين قابلة للتعديل بحرية
+
+- حول ملف تكوين `an.config.json`
+  - يجب أن يكون ملف التكوين في الدليل الجذر للمشروع
+
+  - لا يمكن تغيير اسم ملف التكوين
+
+  - للحصول على وصف تفصيلي للمعاملات، يرجى الاطلاع على [شرح ملف التكوين بالتفصيل](#شرح-ملف-التكوين-بالتفصيل)
+
+- قم بتحديث ملف التكوين وفقًا لاحتياجاتك، ثم قم بتنفيذ أمر `anl type` مرة أخرى، وسيتم التوليد وفقًا لمعلومات التكوين المحددة في ملف التكوين، وتوليد معلومات النوع المقابلة
+
+- إذا كانت ملفات 'config.ts' و 'error-message.ts' و 'fetch.ts' و 'api-type.d.ts' موجودة، فلن يتم توليدها مرة أخرى
+
+-
+
+> [!NOTE]
+>
+> إذا لم تكن واضحًا بشأن هذه التكوينات، يمكنك أولاً تنفيذ أمر anl type لتوليد الأنواع أولاً، ثم فحص دليل المشروع، والجمع بين شرح عناصر التكوين، وتعديل عناصر التكوين، وإعادة التوليد، والتحقق تدريجيًا من وظيفة عناصر المشروع، وإكمال التكوين النهائي
 
-2. شرح ملف الإعداد
+### طريقة الاستخدام
 
-- عند أول تشغيل لـ `anl type` سيتم إنشاء ملف إعداد باسم `an.config.json` تلقائيًا في جذر المشروع (يمكن إنشاؤه يدويًا أيضًا).
-- عند التشغيل سيبحث عن `an.config.json` في جذر المشروع ويقرأه ليُولّد غلاف Axios والإعدادات وقائمة الواجهات وأنواع الطلب/الاستجابة.
-- جميع الحقول قابلة للتعديل بحرية.
+```bash
+$ anl lint
+```
 
-3. مثال لملف `an.config.json`
+### شرح ملف التكوين بالتفصيل
 
-- يجب أن يكون ملف الإعداد في جذر المشروع.
-- لا يمكن تغيير اسم الملف.
-- تفاصيل المعاملات في قسم «خيارات الإعداد».
+#### مثال على ملف التكوين
 
 ```json
 {
@@ -101,51 +125,46 @@ $ anl type
 }
 ```
 
-3. حدّث الإعداد حسب الحاجة ثم نفّذ `anl type` مرة أخرى لتوليد الشيفرة وفق الإعدادات.
+#### شرح عناصر التكوين
 
-```bash
-$ anl type
-```
+| عنصر التكوين             | النوع                                 | مطلوب | الوصف                                                                                                                                   |
+| ------------------------ | ------------------------------------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| saveTypeFolderPath       | string                                | نعم   | مسار حفظ ملفات تعريف الأنواع                                                                                                            |
+| saveApiListFolderPath    | string                                | نعم   | مسار حفظ ملفات دوال طلبات API                                                                                                           |
+| saveEnumFolderPath       | string                                | نعم   | مسار حفظ ملفات بيانات التعداد                                                                                                           |
+| importEnumPath           | string                                | نعم   | مسار استيراد التعداد (مسار ملف enum المُشار إليه في apps/types/models/\*.ts)                                                            |
+| swaggerJsonUrl           | string                                | نعم   | عنوان مستند Swagger JSON                                                                                                                |
+| requestMethodsImportPath | string                                | نعم   | مسار استيراد طرق الطلب                                                                                                                  |
+| dataLevel                | 'data' \| 'serve' \| 'axios'          | نعم   | مستوى بيانات استجابة الواجهة                                                                                                            |
+| formatting               | object                                | لا    | تكوين تنسيق الكود                                                                                                                       |
+| headers                  | object                                | لا    | تكوين رأس الطلب                                                                                                                         |
+| includeInterface         | Array<{path: string, method: string}> | لا    | الواجهات المضمنة: ملف قائمة الواجهات المحدد بـ `saveApiListFolderPath` سيتضمن فقط الواجهات في القائمة، متعارض مع حقل `excludeInterface` |
+| excludeInterface         | Array<{path: string, method: string}> | لا    | الواجهات المستبعدة: نص قائمة الواجهات المحدد بـ `saveApiListFolderPath` لن يتضمن الواجهات في هذه القائمة، متعارض مع `includeInterface`  |
+| publicPrefix             | string                                | لا    | البادئة العامة على مسار url، على سبيل المثال: api/users، api/users/{id}، api هي البادئة العامة                                          |
 
-> ملاحظة
->
-> إذا لم تكن متأكدًا من الخيارات، نفّذ `anl type` أولًا وعاين المخرجات ثم عدّل الخيارات وأعد التشغيل حتى تصل لما تريد.
+#### العلاقة بين عناصر التكوين والملفات المولدة
 
-## خيارات الإعداد
-
-| الخيار                   | النوع                                 | إلزامي | الوصف                         |
-| ------------------------ | ------------------------------------- | ------ | ----------------------------- |
-| saveTypeFolderPath       | string                                | نعم    | مسار حفظ ملفات تعريف الأنواع  |
-| saveApiListFolderPath    | string                                | نعم    | مسار حفظ ملفات دوال طلبات API |
-| saveEnumFolderPath       | string                                | نعم    | مسار حفظ ملفات التعدادات      |
-| importEnumPath           | string                                | نعم    | مسار الاستيراد للتعدادات      |
-| swaggerJsonUrl           | string                                | نعم    | رابط ملف Swagger JSON         |
-| requestMethodsImportPath | string                                | نعم    | مسار الاستيراد لطرائق الطلب   |
-| dataLevel                | 'data' \| 'serve' \| 'axios'          | نعم    | مستوى بيانات الاستجابة        |
-| formatting               | object                                | لا     | إعدادات تنسيق الشيفرة         |
-| headers                  | object                                | لا     | ترويسات الطلب                 |
-| includeInterface         | Array<{path: string, method: string}> | لا     | توليد الواجهات المذكورة فقط   |
-| excludeInterface         | Array<{path: string, method: string}> | لا     | استبعاد الواجهات المذكورة     |
-
-## بنية الملفات المولدة
-
-- يتم توليد البنية التالية اعتمادًا على ملف الإعداد.
+> يتم إنشاء هيكل الملف بناءً على ملف التكوين، والمُشار إليه بـ **غير مُتحكم به** يعني: يتم إنشاء هذا المجلد وملفاته تلقائيًا ولا تتحكم فيه عناصر التكوين
 
 ```
 project/
 ├── apps/
-│   ├── types/
-│   │   ├── models/          # جميع تعريفات الأنواع (عدا التعدادات)
-│   │   ├── connectors/      # تعريفات أنواع واجهات API (تعريفات الواجهات)
-│   │   └── enums/           # تعريفات التعدادات
-│   └── api/
-│       ├── fetch.ts         # تنفيذ طرائق الطلب
-│       └── index.ts         # دوال طلبات API
+│   ├── types/               		# محدد بواسطة عنصر التكوين saveTypeFolderPath
+│   │   ├── models/          				# جميع ملفات تعريف الأنواع (باستثناء أنواع التعداد) غير مُتحكم به
+│   │   ├── connectors/      				# تعريفات نوع API (ملفات تعريف الواجهة) غير مُتحكم به
+│   └── api/                 		# ملف الطلب: محدد بواسطة عنصر التكوين saveApiListFolderPath
+│   │    ├── fetch.ts        				# تنفيذ طريقة الطلب غير مُتحكم به
+│   │    └── index.ts        				# قائمة دوال طلبات API غير مُتحكم به
+│   │    └── api-type.d.ts      		# ملف تعريف نوع الطلب غير مُتحكم به
+│   │    └── config.ts       				# الطلب، اعتراض الاستجابة، تكوين الطلب غير مُتحكم به
+│   │    └── error-message.ts   		# رسائل خطأ على مستوى النظام غير مُتحكم به
+│   │    ├── fetch.ts        				# تغليف طلب axios، يمكن استبداله بـ fetch غير مُتحكم به
+│   └── enums/               		# تعريف نوع بيانات التعداد: محدد بواسطة عنصر التكوين saveEnumFolderPath
 ```
 
-## أمثلة على الشيفرة المولدة
+### أمثلة على الكود المولد
 
-### تعريفات الأنواع
+#### تعريف نوع الواجهة
 
 ```typescript
 declare namespace UserDetail_GET {
@@ -162,29 +181,29 @@ declare namespace UserDetail_GET {
 }
 ```
 
-### دالة طلب API
+#### دالة طلب API
 
 ```typescript
 import { GET } from './fetch';
 
 /**
- * جلب تفاصيل المستخدم
+ * الحصول على تفاصيل المستخدم
  */
 export const userDetailGet = (params: UserDetail_GET.Query) => GET<UserDetail_GET.Response>('/user/detail', params);
 ```
 
-## مزايا إضافية
+### شرح الميزات
 
-### تحليل الأنواع
+#### تحليل الأنواع
 
-- يدعم جميع أنواع بيانات OpenAPI 3.0
-- يتعامل تلقائيًا مع الأنواع المتداخلة المعقدة
-- يدعم المصفوفات والكائنات والتعدادات وغيرها
-- يُولّد تعليقات الواجهات تلقائيًا
+- يدعم جميع أنواع البيانات في مواصفات OpenAPI 3.0
+- معالجة تلقائية للأنواع المتداخلة المعقدة
+- يدعم أنواع المصفوفات والكائنات والتعدادات وغيرها
+- توليد تعليقات الواجهة تلقائيًا
 
-### رفع الملفات
+#### تحميل الملفات
 
-عند اكتشاف رفع ملفات، تُضاف الترويسات المناسبة تلقائيًا:
+عند اكتشاف نوع تحميل ملف، سيتم إضافة رأس الطلب المقابل تلقائيًا:
 
 ```typescript
 export const uploadFile = (params: UploadFile.Body) =>
@@ -193,29 +212,29 @@ export const uploadFile = (params: UploadFile.Body) =>
 	});
 ```
 
-### معالجة الأخطاء
+#### معالجة الأخطاء
 
-يوفر الأداة معالجة قوية للأخطاء:
+تحتوي الأداة على آلية معالجة أخطاء كاملة:
 
-- رسائل أخطاء التحليل
-- تحذيرات عند فشل توليد الأنواع
-- التعامل مع استثناءات كتابة الملفات
+- مطالبات أخطاء التحليل
+- تحذيرات فشل توليد الأنواع
+- معالجة استثناءات كتابة الملفات
 
-### ترشيح الواجهات
+#### تصفية الواجهات
 
-يمكن التحكم في الواجهات المولدة عبر الإعدادات:
+تدعم الأداة تصفية الواجهات التي تحتاج إلى التوليد من خلال التكوين:
 
 1. تضمين واجهات محددة
-   - استخدم `includeInterface` لتحديد الواجهات المراد توليدها
-   - سيتم توليد المدرجة فقط
-   - الصيغة: مصفوفة كائنات تحتوي `path` و`method`
+   - تحديد الواجهات التي تحتاج إلى التوليد من خلال عنصر التكوين `includeInterface`
+   - سيتم توليد الواجهات المحددة في التكوين فقط
+   - تنسيق التكوين هو مصفوفة كائنات تحتوي على `path` و `method`
 
 2. استبعاد واجهات محددة
-   - استخدم `excludeInterface` لتحديد الواجهات المستبعدة
-   - سيتم توليد بقية الواجهات
-   - الصيغة: مصفوفة كائنات تحتوي `path` و`method`
+   - تحديد الواجهات التي تحتاج إلى الاستبعاد من خلال عنصر التكوين `excludeInterface`
+   - سيتم توليد جميع الواجهات باستثناء تلك المحددة في التكوين
+   - تنسيق التكوين هو مصفوفة كائنات تحتوي على `path` و `method`
 
-مثال:
+مثال على التكوين: يتم تكوين هذا في `an.config.json`
 
 ```json
 {
@@ -234,120 +253,101 @@ export const uploadFile = (params: UploadFile.Body) =>
 }
 ```
 
-ملاحظة: لا يمكن استخدام `includeInterface` و`excludeInterface` معًا. عند وجودهما، تكون أولوية `includeInterface`.
+ملاحظة: لا يمكن استخدام `includeInterface` و `excludeInterface` في نفس الوقت، إذا تم تكوينهما معًا، سيتم إعطاء الأولوية لـ `includeInterface`.
 
-## التطوير
-
-```bash
-# تثبيت الاعتمادات
-npm install
-
-# وضع التطوير
-اضغط F5 لبدء التصحيح
-
-# البناء
-npm run build
-
-# ربط محلي للتصحيح
-npm run blink
-```
-
-## ملاحظات
-
-1. تأكد من إمكانية الوصول إلى رابط Swagger JSON
-2. المسارات في ملف الإعداد نسبية إلى جذر المشروع
-3. سيتم استبدال الملفات المولدة للملفات الموجودة بنفس الاسم
-4. يُنصح بإضافة الملفات المولدة إلى نظام التحكم بالإصدارات
-
-## الأسئلة الشائعة
+### ملاحظات
 
-1. فشل تنسيق ملفات الأنواع المولدة
-   - تحقق من تثبيت Prettier
-   - تأكد من وجود ملف إعداد Prettier في الجذر
+1. تأكد من إمكانية الوصول إلى عنوان مستند Swagger JSON
+2. يجب أن تكون المسارات في ملف التكوين نسبية إلى الدليل الجذر للمشروع
+3. ستستبدل الملفات المولدة الملفات الموجودة بنفس الاسم
+4. يُنصح بإضافة الملفات المولدة إلى التحكم في الإصدار
 
-2. مسار الاستيراد في دوال الطلب غير صحيح
-   - تحقق من صحة `requestMethodsImportPath`
-   - تأكد من وجود ملف طرائق الطلب
+### الأسئلة الشائعة
 
-# أمر anl lint
+1. فشل تنسيق ملف النوع المولد
+   - تحقق من تثبيت prettier
+   - تأكد من وجود ملف تكوين prettier في الدليل الجذر للمشروع
 
-### نظرة عامة
+2. خطأ في مسار استيراد دالة الطلب
+   - تحقق من صحة تكوين requestMethodsImportPath
+   - تأكد من وجود ملف طريقة الطلب
 
-إعداد سريع لأدوات الفحص البرمجي للواجهات الأمامية، بما في ذلك:
+# تعليمات استخدام أمر `anl lint`
 
-- ESLint لفحص الشيفرة
-- Prettier لتنسيق الشيفرة
-- CommitLint لمعايير رسائل الالتزام
-- إعدادات محرر VSCode
+> يوفر وظيفة تكوين أدوات lint المختلفة لمشروع الواجهة الأمامية بنقرة واحدة، بما في ذلك:
+>
+> - فحص كود ESLint
+> - تنسيق كود Prettier
+> - معيار معلومات الالتزام CommitLint
+> - تكوين محرر VSCode
 
-### الاستخدام
+### طريقة الاستخدام
 
 ```bash
 $ anl lint
 ```
 
-### تفاصيل الإعداد
+### تفاصيل التكوين
 
-#### 1. ESLint
+#### 1. تكوين ESLint
 
-- تثبيت الاعتمادات المطلوبة تلقائيًا
-- دعم React/Vue
-- توليد `.eslintrc.js` و `.eslintignore`
+- تثبيت التبعيات المطلوبة تلقائيًا
+- يدعم إطارات React/Vue
+- توليد `.eslintrc.js` و `.eslintignore` تلقائيًا
 - دمج دعم TypeScript
 
-#### 2. Prettier
+#### 2. تكوين Prettier
 
-- تثبيت اعتمادات Prettier تلقائيًا
-- توليد `.prettierrc.js`
-- الإعدادات الافتراضية:
+- تثبيت التبعيات ذات الصلة بـ prettier تلقائيًا
+- توليد ملف تكوين `.prettierrc.js`
+- التكوين الافتراضي يتضمن:
   - عرض السطر: 80
-  - استخدام Tab
-  - علامات اقتباس أحادية
-  - أقواس الدوال السهمية
-  - قواعد تنسيق أخرى
+  - مسافة بادئة Tab
+  - استخدام علامات اقتباس مفردة
+  - أقواس دالة السهم
+  - معايير نمط الكود الأخرى
 
-#### 3. CommitLint
+#### 3. تكوين CommitLint
 
-- تثبيت اعتمادات CommitLint
-- تهيئة git hooks عبر Husky
+- تثبيت التبعيات ذات الصلة بـ commitlint
+- تكوين husky git hooks
 - توليد `commitlint.config.js`
-- توحيد رسائل الالتزام
+- توحيد رسالة git commit
 
-#### 4. VSCode
+#### 4. تكوين VSCode
 
 - إنشاء `.vscode/settings.json`
-- تفعيل التنسيق التلقائي عند الحفظ
-- ضبط المُنسّق الافتراضي
-- دعم تحديث الإعدادات الموجودة
-
-# أمر anl git
+- تكوين التنسيق التلقائي للمحرر
+- تعيين أداة التنسيق الافتراضية
+- يدعم تحديث ملفات التكوين الموجودة
 
-### نظرة عامة
+# أمر `anl git`
 
-تطبيق قدرات Git التالية عبر اختيار متعدد تفاعلي:
+### نظرة عامة على الوظائف
 
-- إنشاء فروع gitflow القياسية
-  - نسخ `.gitscripts/` و`.gitconfig` و`.commit-type.cjs` إلى المشروع (إن لم تكن موجودة)
-  - إعطاء صلاحية التنفيذ لـ `.gitscripts/random-branch.sh`
-  - تنفيذ `git config --local include.path ../.gitconfig`
-- ضبط موضوع رسالة الالتزام تلقائيًا
-  - نسخ `.githooks/commit-msg` وضبطه كقابل للتنفيذ
-  - تنفيذ `git config core.hooksPath .githooks`
-- أوامر Git مخصصة
-  - إضافة `.gitattributes` إلى المشروع (إن لم يكن موجودًا)
+- من خلال الاختيار المتعدد التفاعلي، يمكن تطبيق إمكانيات Git التالية على المستودع الحالي:
+  - إنشاء فروع gitflow القياسية
+    - نسخ `.gitscripts/` و `.gitconfig` و `.commit-type.cjs` إلى المشروع (فقط عند الغياب)
+    - إضافة أذونات التنفيذ لـ `.gitscripts/random-branch.sh`
+    - تنفيذ `git config --local include.path ../.gitconfig`
+  - تعيين موضوع commit تلقائيًا
+    - نسخ `.githooks/commit-msg` وتعيينه كقابل للتنفيذ
+    - تنفيذ `git config core.hooksPath .githooks`
+  - أوامر git المخصصة
+    - إضافة `.gitattributes` إلى المشروع (فقط عند الغياب)
 
-### الاستخدام
+### طريقة الاستخدام
 
 ```bash
 $ anl git
 ```
 
-اختر وظيفة أو أكثر من القائمة. لن تُنشأ الملفات إلا عند عدم وجودها؛ وتحافظ الأداة على الملفات الموجودة.
+اختر وظيفة واحدة أو أكثر في المطالبة. يتم إنشاء الملفات فقط عند عدم وجودها؛ سيتم الاحتفاظ بالملفات الموجودة.
 
 ### ملاحظات
 
-- يُرجى التشغيل داخل مستودع Git.
-- إذا فشلت أوامر الضبط التلقائي، نفّذ يدويًا:
+- يرجى التشغيل داخل مستودع Git.
+- إذا فشل تنفيذ git config تلقائيًا، يرجى التنفيذ يدويًا:
 
 ```bash
 git config --local include.path ../.gitconfig
@@ -358,6 +358,6 @@ git config core.hooksPath .githooks
 
 ISC License
 
-# المساهمة
+# دليل المساهمة
 
-مرحبٌ بـ Issues و Pull Requests: https://github.com/bianliuzhu/an-cli
+نرحب بتقديم [القضايا](https://github.com/bianliuzhu/an-cli/issues) و [طلبات السحب](https://github.com/bianliuzhu/an-cli/pulls)!