@intlayer/docs 5.5.12 → 5.7.0

package/docs/ar/intlayer_cli.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-06-29
-title: واجهة سطر الأوامر (CLI)
-description: اكتشف كيفية استخدام واجهة سطر أوامر Intlayer لإدارة موقعك متعدد اللغات. اتبع الخطوات في هذا التوثيق عبر الإنترنت لإعداد مشروعك في دقائق معدودة.
+updatedAt: 2025-07-11
+title: CLI
+description: اكتشف كيفية استخدام واجهة الأوامر الخاصة بـ Intlayer لإدارة موقعك متعدد اللغات. اتبع الخطوات في هذه الوثائق عبر الإنترنت لإعداد مشروعك في دقائق قليلة.
 keywords:
   - CLI
   - واجهة سطر الأوامر
@@ -10,7 +10,7 @@ keywords:
   - التوثيق
   - Intlayer
   - Next.js
-  - جافاسكريبت
+  - جافا سكريبت
   - React
 slugs:
   - doc
@@ -18,7 +18,7 @@ slugs:
   - cli
 ---
 
-# واجهة سطر أوامر Intlayer
+# واجهة الأوامر Intlayer CLI
 
 ## تثبيت الحزمة
 
@@ -36,7 +36,7 @@ yarn add intlayer-cli -g
 pnpm add intlayer-cli -g
 ```
 
-> إذا كانت حزمة `intlayer` مثبتة بالفعل، يتم تثبيت واجهة سطر الأوامر تلقائيًا. يمكنك تخطي هذه الخطوة.
+> إذا كانت حزمة `intlayer` مثبتة بالفعل، يتم تثبيت واجهة الأوامر تلقائيًا. يمكنك تخطي هذه الخطوة.
 
 ## حزمة intlayer-cli
 
@@ -44,11 +44,11 @@ pnpm add intlayer-cli -g
 
 ستقوم هذه الحزمة بتحويل جميع ملفات intlayer، مثل `src/**/*.content.{ts|js|mjs|cjs|json}`. [انظر كيفية إعلان ملفات تصريحات Intlayer الخاصة بك](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
 
-لتفسير قواميس intlayer يمكنك استخدام مفسرات، مثل [react-intlayer](https://www.npmjs.com/package/react-intlayer)، أو [next-intlayer](https://www.npmjs.com/package/next-intlayer)
+لتفسير قواميس intlayer يمكنك استخدام المفسرات، مثل [react-intlayer](https://www.npmjs.com/package/react-intlayer)، أو [next-intlayer](https://www.npmjs.com/package/next-intlayer).
 
-## دعم ملف التكوين
+## دعم ملفات التهيئة
 
-يقبل Intlayer عدة صيغ لملفات التكوين:
+تدعم Intlayer عدة صيغ لملفات التهيئة:
 
 - `intlayer.config.ts`
 - `intlayer.config.js`
@@ -57,55 +57,13 @@ pnpm add intlayer-cli -g
 - `intlayer.config.mjs`
 - `.intlayerrc`
 
-لمعرفة كيفية تكوين اللغات المتاحة أو معلمات أخرى، راجع [توثيق التكوين هنا](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md).
-
-## SDK سطر الأوامر (CLI)
-
-SDK سطر الأوامر هو مكتبة تتيح لك استخدام CLI الخاص بـ Intlayer في كودك الخاص.
-
-```bash packageManager="npm"
-npm install @intlayer/cli -D
-```
-
-```bash packageManager="yarn"
-yarn add @intlayer/cli -D
-```
-
-```bash packageManager="pnpm"
-pnpm add @intlayer/cli -D
-```
-
-مثال على الاستخدام:
-
-```ts
-import {
-  push,
-  pull,
-  fill,
-  build,
-  docTranslate,
-  docReview,
-} from "@intlayer/cli";
-
-push();
-// ...
-pull();
-// ...
-fill();
-// ...
-build();
-// ...
-docTranslate();
-// ...
-docReview();
-// ...
-```
+لمعرفة كيفية تكوين اللغات المتاحة، أو معلمات أخرى، يرجى الرجوع إلى [توثيق التهيئة هنا](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/configuration.md).
 
 ## تشغيل أوامر intlayer
 
 ### بناء القواميس
 
-لبناء القواميس الخاصة بك، يمكنك تشغيل الأوامر التالية:
+لبناء قواميسك، يمكنك تشغيل الأوامر التالية:
 
 ```bash
 npx intlayer build
@@ -117,7 +75,7 @@ npx intlayer build
 npx intlayer build --watch
 ```
 
-سيقوم هذا الأمر بالبحث عن ملفات محتوى التصريحات الخاصة بك بشكل افتراضي في `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}`. وبناء القواميس في مجلد `.intlayer`.
+سيقوم هذا الأمر بالعثور على ملفات محتوى التصريحات الخاصة بك بشكل افتراضي في `./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}`. وبناء القواميس في مجلد `.intlayer`.
 
 ##### الأسماء المستعارة:
 
@@ -128,10 +86,11 @@ npx intlayer build --watch
 ### دفع القواميس
 
 ```bash
+bash
 npx intlayer dictionary push
 ```
 
-إذا تم تثبيت [intlayer editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md)، يمكنك أيضًا دفع القواميس إلى المحرر. سيسمح هذا الأمر بجعل القواميس متاحة لـ [المحرر](https://intlayer.org/dashboard). بهذه الطريقة، يمكنك مشاركة القواميس مع فريقك وتحرير المحتوى الخاص بك دون الحاجة إلى تعديل كود التطبيق الخاص بك.
+إذا تم تثبيت [محرر intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md)، يمكنك أيضًا دفع القواميس إلى المحرر. سيسمح هذا الأمر بجعل القواميس متاحة لـ [المحرر](https://intlayer.org/dashboard). بهذه الطريقة، يمكنك مشاركة قواميسك مع فريقك وتحرير المحتوى الخاص بك دون الحاجة إلى تعديل كود التطبيق.
 
 ##### الأسماء المستعارة:
 
@@ -141,23 +100,57 @@ npx intlayer dictionary push
 
 ##### الوسائط:
 
-- `-d`, `--dictionaries`: معرفات القواميس التي سيتم دفعها. إذا لم يتم تحديدها، فسيتم دفع جميع القواميس.
+**خيارات القاموس:**
+
+- **`-d`، `--dictionaries`**: معرفات القواميس التي سيتم دفعها. إذا لم يتم تحديدها، سيتم دفع جميع القواميس.
+
   > مثال: `npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id`
-- `-r`, `--deleteLocaleDictionary`: تخطي السؤال الذي يطلب حذف مجلدات اللغات بمجرد دفع القواميس، وحذفها. بشكل افتراضي، إذا تم تعريف القاموس محليًا، فسيتم الكتابة فوق محتوى القواميس البعيدة.
+
+**خيارات التكوين:**
+
+- **`--base-dir`**: تحديد الدليل الأساسي للمشروع. لاسترجاع تكوين intlayer، سيبحث الأمر عن ملف `intlayer.config.{ts,js,json,cjs,mjs}` في الدليل الأساسي.
+
+  > مثال: `npx intlayer dictionary push --env-file .env.production.local`
+
+**خيارات متغيرات البيئة:**
+
+- **`--env`**: تحديد البيئة (مثل `development`، `production`). مفيد في حالة استخدام متغيرات البيئة في ملف تكوين intlayer الخاص بك.
+- **`--env-file`**: توفير ملف بيئة مخصص لتحميل المتغيرات منه. مفيد في حالة استخدام متغيرات البيئة في ملف تكوين intlayer الخاص بك.
+
+  > مثال: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > مثال: `npx intlayer dictionary push --env production`
+
+**خيارات الإخراج:**
+
+- **`-r`، `--delete-locale-dictionary`**: تخطي السؤال الذي يطلب حذف مجلدات اللغات بمجرد دفع القواميس، وحذفها. بشكل افتراضي، إذا تم تعريف القاموس محليًا، فسوف يستبدل محتوى القواميس البعيدة.
+
   > مثال: `npx intlayer dictionary push -r`
-- `-k`, `--keepLocaleDictionary`: تخطي السؤال الذي يطلب حذف مجلدات اللغات بمجرد دفع القواميس، والاحتفاظ بها. بشكل افتراضي، إذا تم تعريف القاموس محليًا، فسيتم الكتابة فوق محتوى القواميس البعيدة.
+
+  > مثال: `npx intlayer dictionary push --delete-locale-dictionary`
+
+- **`-k`، `--keep-locale-dictionary`**: تخطي السؤال الذي يطلب حذف مجلدات اللغات بمجرد دفع القواميس، والاحتفاظ بها. بشكل افتراضي، إذا تم تعريف القاموس محليًا، فسوف يستبدل محتوى القواميس البعيدة.
+
   > مثال: `npx intlayer dictionary push -k`
-- `--env`: تحديد البيئة (مثل `development`، `production`).
-- `--env-file`: توفير ملف بيئة مخصص لتحميل المتغيرات منه.
-- `--base-dir`: تحديد الدليل الأساسي للمشروع.
-
-- `--verbose`: تمكين تسجيل مفصل لأغراض التصحيح.
-- `--git-diff`: التشغيل فقط على القواميس التي تتضمن تغييرات من الأساس (الافتراضي `origin/main`) إلى الفرع الحالي (الافتراضي: `HEAD`).
-- `--git-diff-base`: تحديد المرجع الأساسي لمقارنة git diff (الافتراضي `origin/main`).
-- `--git-diff-current`: تحديد المرجع الحالي لمقارنة git diff (الافتراضي `HEAD`).
-- `--uncommitted`: تضمين التغييرات غير الملتزمة.
-- `--unpushed`: تضمين التغييرات غير المدفوعة.
-- `--untracked`: تضمين الملفات غير المتتبعة.
+
+  > مثال: `npx intlayer dictionary push --keep-locale-dictionary`
+
+**خيارات السجل:**
+
+- **`--verbose`**: تفعيل تسجيل مفصل لأغراض التصحيح.
+
+**خيارات Git:**
+
+- **`--git-diff`**: تشغيل فقط على القواميس التي تتضمن تغييرات من القاعدة (الافتراضية `origin/main`) إلى الفرع الحالي (الافتراضي: `HEAD`).
+- **`--git-diff-base`**: تحديد المرجع الأساسي لفارق git (الافتراضي `origin/main`).
+- **`--git-diff-current`**: تحديد المرجع الحالي لفارق git (الافتراضي `HEAD`).
+- **`--uncommitted`**: تضمين التغييرات غير الملتزم بها.
+- **`--unpushed`**: تضمين التغييرات غير المدفوعة.
+- **`--untracked`**: تضمين الملفات غير المتتبعة.
+
+  > مثال: `npx intlayer dictionary push --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > مثال: `npx intlayer dictionary push --uncommitted --unpushed --untracked`
 
 ### سحب القواميس البعيدة
 
@@ -165,7 +158,7 @@ npx intlayer dictionary push
 npx intlayer pull
 ```
 
-إذا تم تثبيت [محرر intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md)، يمكنك أيضًا سحب القواميس من المحرر. بهذه الطريقة، يمكنك استبدال محتوى قواميسك حسب حاجة تطبيقك.
+إذا كان [محرر intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ar/intlayer_visual_editor.md) مثبتًا، يمكنك أيضًا سحب القواميس من المحرر. بهذه الطريقة، يمكنك استبدال محتوى قواميسك حسب حاجة تطبيقك.
 
 ##### الأسماء المستعارة:
 
@@ -175,13 +168,35 @@ npx intlayer pull
 
 ##### الوسائط:
 
-- `-d, --dictionaries`: معرفات القواميس التي سيتم سحبها. إذا لم يتم تحديدها، سيتم سحب جميع القواميس.
+**خيارات القاموس:**
+
+- **`-d, --dictionaries`**: معرفات القواميس التي تريد سحبها. إذا لم يتم تحديدها، سيتم سحب جميع القواميس.
+
   > مثال: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
-- `--newDictionariesPath` : مسار الدليل حيث سيتم حفظ القواميس الجديدة. إذا لم يتم تحديده، سيتم حفظ القواميس الجديدة في دليل `./intlayer-dictionaries` الخاص بالمشروع. إذا تم تحديد حقل `filePath` في محتوى القاموس الخاص بك، فلن تأخذ القواميس هذا الوسيط في الاعتبار وسيتم حفظها في الدليل المحدد في `filePath`.
-- `--env`: تحديد البيئة (مثلًا، `development`، `production`).
-- `--env-file`: توفير ملف بيئة مخصص لتحميل المتغيرات منه.
-- `--base-dir`: تحديد الدليل الأساسي للمشروع.
-- `--verbose`: تفعيل تسجيل الدخول التفصيلي لأغراض التصحيح.
+
+**خيارات التكوين:**
+
+- **`--base-dir`**: تحديد الدليل الأساسي للمشروع. لاسترجاع تكوين intlayer، سيبحث الأمر عن ملف `intlayer.config.{ts,js,json,cjs,mjs}` في الدليل الأساسي.
+
+  > مثال: `npx intlayer dictionary push --env-file .env.production.local`
+
+**خيارات متغيرات البيئة:**
+
+- **`--env`**: تحديد البيئة (مثلًا، `development`، `production`).
+- **`--env-file`**: توفير ملف بيئة مخصص لتحميل المتغيرات منه.
+- **`--base-dir`**: تحديد الدليل الأساسي للمشروع. لاسترجاع تكوين intlayer، سيبحث الأمر عن ملف `intlayer.config.{ts,js,json,cjs,mjs}` في الدليل الأساسي.
+
+  > مثال: `npx intlayer dictionary push --env-file .env.production.local`
+
+  > مثال: `npx intlayer dictionary push --env production`
+
+**خيارات الإخراج:**
+
+- **`--new-dictionaries-path`**: المسار إلى الدليل حيث سيتم حفظ القواميس الجديدة. إذا لم يتم تحديده، سيتم حفظ القواميس الجديدة في دليل `./intlayer-dictionaries` الخاص بالمشروع. إذا تم تحديد حقل `filePath` في محتوى القاموس الخاص بك، فلن تأخذ القواميس هذا الوسيط في الاعتبار وسيتم حفظها في الدليل المحدد في `filePath`.
+
+**خيارات السجل:**
+
+- **`--verbose`**: تفعيل تسجيل مفصل لأغراض التصحيح.
 
 ##### مثال:
 
@@ -189,13 +204,13 @@ npx intlayer pull
 npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
 ```
 
-### تعبئة / تدقيق / ترجمة القواميس
+### ملء / تدقيق / ترجمة القواميس
 
 ```bash
 npx intlayer fill
 ```
 
-يقوم هذا الأمر بتحليل ملفات إعلان المحتوى الخاصة بك للبحث عن مشكلات محتملة مثل الترجمات المفقودة، أو التناقضات الهيكلية، أو عدم تطابق الأنواع. إذا وجد أي مشاكل، فإن **intlayer fill** سيقترح أو يطبق تحديثات للحفاظ على اتساق وكمال قواميسك.
+يقوم هذا الأمر بتحليل ملفات إعلان المحتوى الخاصة بك للبحث عن مشكلات محتملة مثل الترجمات المفقودة، التناقضات الهيكلية، أو عدم تطابق الأنواع. إذا وجد أي مشاكل، فإن **intlayer fill** سيقترح أو يطبق تحديثات للحفاظ على قوام وكمال القواميس الخاصة بك.
 
 ##### الأسماء المستعارة:
 
@@ -205,78 +220,73 @@ npx intlayer fill
 
 ##### الوسائط:
 
-- `-f, --file [files...]`
-  قائمة بملفات إعلان المحتوى المحددة التي سيتم تدقيقها. إذا لم يتم توفيرها، سيتم تدقيق جميع الملفات المكتشفة التي تطابق النمط `*.content.{ts,js,mjs,cjs,tsx,jsx,json}`.
+**خيارات قائمة الملفات:**
 
-- `--exclude [excludedGlobs...]`
-  نمط globs لاستبعاد ملفات من التدقيق (مثلاً `--exclude "src/test/**"`).
+- **`-f, --file [files...]`**: قائمة بملفات إعلان المحتوى المحددة التي سيتم تدقيقها. إذا لم يتم توفيرها، فسيتم تدقيق جميع الملفات المكتشفة التي تطابق النمط `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` بناءً على إعداد ملف التكوين الخاص بك.
 
-- `--source-locale [sourceLocale]`
+  > مثال: `npx intlayer dictionary fill -f src/home/app.content.ts`
 
-  لغة المصدر للترجمة منها. إذا لم يتم تحديدها، سيتم استخدام اللغة الافتراضية من تكوينك.
+- **`-k, --keys [keys...]`**: تصفية القواميس بناءً على المفاتيح. إذا لم يتم توفيرها، سيتم تدقيق جميع القواميس.
 
-- `--output-locales [outputLocales...]`
-  اللغات المستهدفة للترجمة إليها. إذا لم يتم تحديدها، سيتم استخدام جميع اللغات من تكوينك باستثناء لغة المصدر.
+  > مثال: `npx intlayer dictionary fill -k key1 key2`
 
-- `--mode [mode]`
-  وضع الترجمة: 'complete' (كامل)، 'review' (مراجعة)، أو 'missing-only' (الناقص فقط). الافتراضي هو 'missing-only'.
+- **`--excluded-keys [excludedKeys...]`**: استبعاد القواميس بناءً على المفاتيح. إذا لم يتم توفيرها، سيتم تدقيق جميع القواميس.
 
-- `--git-diff`
-  يقوم بتصفية القواميس التي تحتوي على تغييرات من الأساس (الافتراضي `origin/main`) إلى الفرع الحالي (الافتراضي: `HEAD`).
+  > مثال: `npx intlayer dictionary fill --excluded-keys key1 key2`
 
-- `--git-diff-base`
-  تحديد المرجع الأساسي لـ git diff (الافتراضي `origin/main`).
+- **`--path-filter [pathFilters...]`**: تصفية القواميس بناءً على نمط glob لمسارات الملفات.
 
-- `--git-diff-current`
-  تحديد المرجع الحالي لـ git diff (الافتراضي: `HEAD`).
+  > مثال: `npx intlayer dictionary fill --path-filter "src/home/**"`
 
-- `--uncommitted`
-  يقوم بتصفية القواميس التي تحتوي على تغييرات غير ملتزمة.
+**خيارات إخراج الإدخال:**
 
-- `--unpushed`
-- `--unpushed`
-  يقوم بتصفية القواميس التي تحتوي على تغييرات غير مدفوعة.
+- **`--source-locale [sourceLocale]`**: لغة المصدر للترجمة منها. إذا لم يتم تحديدها، سيتم استخدام اللغة الافتراضية من إعداداتك.
 
-- `--untracked`
-  يقوم بتصفية القواميس التي تحتوي على ملفات غير متتبعة.
+- **`--output-locales [outputLocales...]`**: اللغات المستهدفة للترجمة إليها. إذا لم يتم تحديدها، سيتم استخدام جميع اللغات من تكوينك باستثناء لغة المصدر.
 
-- `--keys [keys...]`
-  تصفية القواميس بناءً على المفاتيح المحددة.
+- **`--mode [mode]`**: وضع الترجمة: 'كامل'، 'مراجعة'، أو 'الناقص فقط'. الوضع الافتراضي هو 'الناقص فقط'.
 
-- `--excluded-keys [excludedKeys...]`
-  استبعاد القواميس بناءً على المفاتيح المحددة.
+**خيارات Git:**
 
-- `--path-filter [pathFilters...]`
-  تصفية القواميس بناءً على نمط glob لمسارات الملفات.
+- **`--git-diff`**: تشغيل فقط على القواميس التي تتضمن تغييرات من القاعدة (الافتراضية `origin/main`) إلى الفرع الحالي (الافتراضي: `HEAD`).
+- **`--git-diff-base`**: تحديد المرجع الأساسي لفارق git (الافتراضي `origin/main`).
+- **`--git-diff-current`**: تحديد المرجع الحالي لفارق git (الافتراضي: `HEAD`).
+- **`--uncommitted`**: تضمين التغييرات غير الملتزمة.
+- **`--unpushed`**: تضمين التغييرات غير المدفوعة.
+- **`--untracked`**: تضمين الملفات غير المتتبعة.
 
-- `--model [model]`
-  نموذج الذكاء الاصطناعي المستخدم للترجمة (مثل `gpt-3.5-turbo`).
+> مثال: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+> مثال: `npx intlayer doc translate --uncommitted --unpushed --untracked`
 
-- `--provider [provider]`
-  مزود الذكاء الاصطناعي المستخدم للترجمة.
+**خيارات الذكاء الاصطناعي:**
 
-- `--temperature [temperature]`
-  إعداد درجة الحرارة لنموذج الذكاء الاصطناعي.
+- **`--model [model]`**: نموذج الذكاء الاصطناعي المستخدم للترجمة (مثلًا، `gpt-3.5-turbo`).
+- **`--provider [provider]`**: مزود الذكاء الاصطناعي المستخدم للترجمة.
+- **`--temperature [temperature]`**: إعداد درجة الحرارة لنموذج الذكاء الاصطناعي.
+- **`--api-key [apiKey]`**: توفير مفتاح API خاص بك لخدمة الذكاء الاصطناعي.
+- **`--custom-prompt [prompt]`**: توفير موجه مخصص لتعليمات الترجمة الخاصة بك.
+- **`--application-context [applicationContext]`**: توفير سياق إضافي لترجمة الذكاء الاصطناعي.
+
+  > مثال: `npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "تطبيقي هو متجر للقطط"`
+
+**خيارات متغيرات البيئة:**
+
+- **`--env`**: تحديد البيئة (مثل: `development`، `production`).
+- **`--env-file [envFile]`**: توفير ملف بيئة مخصص لتحميل المتغيرات منه.
 
-- `--api-key [apiKey]`
-  تقديم مفتاح API خاص بك لخدمة الذكاء الاصطناعي.
+  > مثال: `npx intlayer fill --env-file .env.production.local`
 
-- `--custom-prompt [prompt]`
-  تقديم موجه مخصص لتعليمات الترجمة الخاصة بك.
-- `--application-context [applicationContext]`
-  تقديم سياق إضافي لترجمة الذكاء الاصطناعي.
+  > مثال: `npx intlayer fill --env production`
 
-- `--env`
-  تحديد البيئة (مثل `development`، `production`).
+**خيارات التكوين:**
 
-- `--env-file [envFile]`
-  تقديم ملف بيئة مخصص لتحميل المتغيرات منه.
+- **`--base-dir`**: تحديد الدليل الأساسي للمشروع.
+
+  > مثال: `npx intlayer fill --base-dir ./src`
 
-- `--base-dir`
-  تحديد الدليل الأساسي للمشروع.
+**خيارات السجل:**
 
-- `--verbose`
-  تفعيل تسجيل مفصل لأغراض التصحيح.
+- **`--verbose`**: تفعيل تسجيل مفصل لأغراض التصحيح.
 
 ##### مثال:
 
@@ -290,7 +300,7 @@ npx intlayer fill --file src/home/*.content.ts --source-locale en --output-local
 
 #### الحصول على التكوين
 
-يسترجع أمر `configuration get` التكوين الحالي لـ Intlayer، وخاصة إعدادات اللغة. هذا مفيد للتحقق من إعداداتك.
+يقوم أمر `configuration get` باسترجاع التكوين الحالي لـ Intlayer، وخاصة إعدادات اللغة. هذا مفيد للتحقق من إعداداتك.
 
 ```bash
 npx intlayer configuration get
@@ -306,14 +316,13 @@ npx intlayer configuration get
 - **`--env`**: تحديد البيئة (مثل `development`، `production`).
 - **`--env-file`**: توفير ملف بيئة مخصص لتحميل المتغيرات منه.
 - **`--base-dir`**: تحديد الدليل الأساسي للمشروع.
-- **`--verbose`**: تفعيل تسجيل مفصل لأغراض التصحيح.
+- **`--verbose`**: تمكين تسجيل الدخول التفصيلي لأغراض التصحيح.
 
 #### دفع التكوين
 
-يقوم أمر `configuration push` برفع التكوين الخاص بك إلى نظام إدارة المحتوى Intlayer والمحرر. هذه الخطوة ضرورية لتمكين استخدام القواميس البعيدة في محرر Intlayer المرئي.
+أمر `configuration push` يقوم بتحميل تكوينك إلى نظام إدارة المحتوى Intlayer والمحرر. هذه الخطوة ضرورية لتمكين استخدام القواميس البعيدة في محرر Intlayer المرئي.
 
 ```bash
-bash
 npx intlayer configuration push
 ```
 
@@ -327,9 +336,9 @@ npx intlayer configuration push
 - **`--env`**: تحديد البيئة (مثل `development`، `production`).
 - **`--env-file`**: توفير ملف بيئة مخصص لتحميل المتغيرات منه.
 - **`--base-dir`**: تحديد الدليل الأساسي للمشروع.
-- **`--verbose`**: تفعيل تسجيل مفصل للأخطاء لأغراض التصحيح.
+- **`--verbose`**: تمكين تسجيل الدخول التفصيلي لأغراض التصحيح.
 
-عن طريق دفع التكوين، يتم دمج مشروعك بالكامل مع نظام إدارة المحتوى Intlayer، مما يتيح إدارة القواميس بسلاسة عبر الفرق.
+من خلال دفع التكوين، يتم دمج مشروعك بالكامل مع نظام إدارة المحتوى Intlayer، مما يتيح إدارة القواميس بسلاسة عبر الفرق.
 
 ### إدارة الوثائق
 
@@ -337,7 +346,7 @@ npx intlayer configuration push
 
 #### ترجمة الوثائق
 
-يقوم أمر `doc translate` بترجمة ملفات التوثيق تلقائيًا من لغة أساسية إلى لغات مستهدفة باستخدام خدمات الترجمة بالذكاء الاصطناعي.
+يقوم الأمر `doc translate` بترجمة ملفات الوثائق تلقائيًا من لغة أساسية إلى لغات مستهدفة باستخدام خدمات الترجمة بالذكاء الاصطناعي.
 
 ```bash
 npx intlayer doc translate
@@ -345,71 +354,132 @@ npx intlayer doc translate
 
 ##### الوسائط:
 
-- **`--doc-pattern [docPattern...]`**: أنماط Glob لمطابقة ملفات التوثيق التي سيتم ترجمتها.
+**خيارات قائمة الملفات:**
+
+- **`--doc-pattern [docPattern...]`**: أنماط glob لمطابقة ملفات الوثائق التي سيتم ترجمتها.
+
   > مثال: `npx intlayer doc translate --doc-pattern "docs/**/*.md" "src/**/*.mdx"`
+
 - **`--excluded-glob-pattern [excludedGlobPattern...]`**: أنماط Glob لاستبعادها من الترجمة.
+
   > مثال: `npx intlayer doc translate --excluded-glob-pattern "docs/internal/**"`
-- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: عدد الملفات التي تتم معالجتها في نفس الوقت للترجمة.
-  > مثال: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
+
+- **`--skip-if-modified-before [skipIfModifiedBefore]`**: تخطى الملف إذا تم تعديله قبل الوقت المحدد.
+
+  - يمكن أن يكون وقتًا مطلقًا مثل "2025-12-05" (سلسلة نصية أو تاريخ)
+  - يمكن أن يكون وقتًا نسبيًا بالميلي ثانية `1 * 60 * 60 * 1000` (ساعة واحدة)
+  - هذا الخيار يتحقق من وقت تحديث الملف باستخدام طريقة `fs.stat`. لذلك قد يتأثر بأدوات مثل Git أو أدوات أخرى تعدل الملف.
+
+  > مثال: `npx intlayer doc translate --skip-if-modified-before "2025-12-05"`
+
+- **`--skip-if-modified-after [skipIfModifiedAfter]`**: تخطى الملف إذا تم تعديله خلال الوقت المحدد.
+
+  - يمكن أن يكون وقتًا مطلقًا مثل "2025-12-05" (نص أو تاريخ)
+  - يمكن أن يكون وقتًا نسبيًا بالميلي ثانية `1 * 60 * 60 * 1000` (ساعة واحدة)
+  - تقوم هذه الخيار بفحص وقت تحديث الملف باستخدام طريقة `fs.stat`. لذلك قد يتأثر بأدوات مثل Git أو أدوات أخرى تقوم بتعديل الملف.
+
+  > مثال: `npx intlayer doc translate --skip-if-modified-after "2025-12-05"`
+
+**خيارات إخراج الإدخال:**
+
 - **`--locales [locales...]`**: اللغات المستهدفة لترجمة الوثائق إليها.
+
   > مثال: `npx intlayer doc translate --locales fr es de`
-- **`--base-locale [baseLocale]`**: لغة المصدر التي سيتم الترجمة منها.
+
+- **`--base-locale [baseLocale]`**: لغة المصدر للترجمة منها.
+
   > مثال: `npx intlayer doc translate --base-locale en`
+
+**خيارات معالجة الملفات:**
+
+- **`--nb-simultaneous-file-processed [nbSimultaneousFileProcessed]`**: عدد الملفات التي سيتم معالجتها في وقت واحد للترجمة.
+
+  > مثال: `npx intlayer doc translate --nb-simultaneous-file-processed 5`
+
+**خيارات الذكاء الاصطناعي:**
+
 - **`--model [model]`**: نموذج الذكاء الاصطناعي المستخدم للترجمة (مثل `gpt-3.5-turbo`).
 - **`--provider [provider]`**: مزود خدمة الذكاء الاصطناعي المستخدم للترجمة.
 - **`--temperature [temperature]`**: إعداد درجة الحرارة لنموذج الذكاء الاصطناعي.
-- **`--api-key [apiKey]`**: توفير مفتاح API الخاص بك لخدمة الذكاء الاصطناعي.
-- **`--custom-prompt [prompt]`**: توفير موجه مخصص لتعليمات الترجمة.
+- **`--api-key [apiKey]`**: توفير مفتاح API خاص بك لخدمة الذكاء الاصطناعي.
 - **`--application-context [applicationContext]`**: توفير سياق إضافي لترجمة الذكاء الاصطناعي.
+- **`--custom-prompt [prompt]`**: تخصيص الموجه الأساسي المستخدم للترجمة. (ملاحظة: في معظم الحالات، يُنصح باستخدام خيار `--custom-instructions` بدلاً من ذلك لأنه يوفر تحكمًا أفضل في سلوك الترجمة.)
+
+  > مثال: `npx intlayer doc translate --model deepseek-chat --provider deepseek --temperature 0.5 --api-key sk-1234567890 --application-context "تطبيقي هو متجر للقطط"`
+
+**خيارات متغيرات البيئة:**
+
 - **`--env`**: تحديد البيئة (مثل `development`، `production`).
 - **`--env-file [envFile]`**: توفير ملف بيئة مخصص لتحميل المتغيرات منه.
 - **`--base-dir`**: تحديد الدليل الأساسي للمشروع.
-- **`--verbose`**: تفعيل تسجيل مفصل لأغراض التصحيح.
-- **`--custom-instructions [customInstructions]`**: تعليمات مخصصة تضاف إلى الموجه. مفيدة لتطبيق قواعد محددة بخصوص التنسيق، ترجمة الروابط، إلخ.
 
-##### مثال:
+  > مثال: `npx intlayer doc translate --base-dir ./docs --env-file .env.production.local`
 
-```bash
-npx intlayer doc translate
-  --doc-pattern "docs/en/**/*.md"
-  --base-locale en --locales fr es
-  --model chatgpt-4o-latest
-  --custom-instructions "$(cat ./instructions.md)"
-```
+**خيارات السجل:**
+
+- **`--verbose`**: تمكين تسجيل الدخول التفصيلي لأغراض التصحيح.
+
+  > مثال: `npx intlayer doc translate --verbose`
+
+**خيارات التعليمات المخصصة:**
+
+- **`--custom-instructions [customInstructions]`**: تعليمات مخصصة تضاف إلى الموجه. مفيدة لتطبيق قواعد محددة تتعلق بالتنسيق، ترجمة الروابط، إلخ.
+
+  - يمكن أن تكون وقتًا مطلقًا مثل "2025-12-05" (نص أو تاريخ)
+  - يمكن أن تكون وقتًا نسبيًا بالمللي ثانية `1 * 60 * 60 * 1000` (ساعة واحدة)
+  - تقوم هذه الخيار بفحص وقت تحديث الملف باستخدام طريقة `fs.stat`. لذلك قد يتأثر بأدوات مثل Git أو أدوات أخرى تعدل الملف.
+
+  > مثال: `npx intlayer doc translate --custom-instructions "تجنب ترجمة الروابط، واحتفظ بتنسيق الماركداون"`
+
+  > مثال: `npx intlayer doc translate --custom-instructions "$(cat ./instructions.md)"`
+
+**خيارات Git:**
+
+- **`--git-diff`**: تشغيل فقط على القواميس التي تتضمن تغييرات من القاعدة (الافتراضية `origin/main`) إلى الفرع الحالي (الافتراضي: `HEAD`).
+- **`--git-diff-base`**: تحديد المرجع الأساسي لمقارنة git diff (الافتراضي `origin/main`).
+- **`--git-diff-current`**: تحديد المرجع الحالي لمقارنة git diff (الافتراضي: `HEAD`).
+- **`--uncommitted`**: تضمين التغييرات غير الملتزمة.
+- **`--unpushed`**: تضمين التغييرات غير المدفوعة.
+- **`--untracked`**: تضمين الملفات غير المتتبعة.
+
+  > مثال: `npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD`
+
+  > مثال: `npx intlayer doc translate --uncommitted --unpushed --untracked`
 
 > لاحظ أن مسار ملف الإخراج سيتم تحديده عن طريق استبدال الأنماط التالية
 >
-> - `/{{baseLocale}}/` بـ `/{{locale}}/` (Unix)
-> - `\{{baseLocale}}\` بواسطة `\{{locale}}\` (ويندوز)
-> - `_{{baseLocale}}.` بواسطة `_{{locale}}.`
-> - `{{baseLocale}}_` بواسطة `{{locale}}_`
-> - `.{{baseLocaleName}}.` بواسطة `.{{localeName}}.`
+> - `/{{baseLocale}}/` إلى `/{{locale}}/` (يونكس)
+> - `\{{baseLocale}}\` إلى `\{{locale}}\` (ويندوز)
+> - `_{{baseLocale}}.` إلى `_{{locale}}.`
+> - `{{baseLocale}}_` إلى `{{locale}}_`
+> - `.{{baseLocaleName}}.` إلى `.{{localeName}}.`
 >
-> إذا لم يتم العثور على النمط، ستضيف ملف الإخراج `.{{locale}}` في امتدادات الملف. على سبيل المثال، `./my/file.md` سيتم ترجمته إلى `./my/file.fr.md` للغة الفرنسية.
+> إذا لم يتم العثور على النمط، فسيتم إضافة `.{{locale}}` إلى امتدادات الملف في ملف الإخراج. على سبيل المثال، `./my/file.md` سيتم ترجمته إلى `./my/file.fr.md` للغة الفرنسية.
 
 #### مراجعة الوثائق
 
-يقوم أمر `doc review` بتحليل ملفات الوثائق من حيث الجودة، والاتساق، والكمال عبر اللغات المختلفة.
+يقوم الأمر `doc review` بتحليل ملفات الوثائق من حيث الجودة، الاتساق، والكمال عبر اللغات المختلفة.
 
 ```bash
 npx intlayer doc review
 ```
 
-##### الوسائط:
+يمكن استخدامه لمراجعة الملفات التي تم ترجمتها بالفعل، وللتحقق مما إذا كانت الترجمة صحيحة.
 
-يقبل أمر `doc review` نفس الوسائط التي يقبلها `doc translate`، مما يتيح لك مراجعة ملفات الوثائق المحددة وتطبيق فحوصات الجودة.
+في معظم الحالات،
 
-##### مثال:
+- يُفضّل استخدام أمر `doc translate` عندما لا تتوفر نسخة مترجمة من هذا الملف.
+- يُفضّل استخدام أمر `doc review` عندما تكون النسخة المترجمة من هذا الملف موجودة بالفعل.
 
-```bash
-npx intlayer doc review
- --doc-pattern "docs/ar/**/*.md"
- --locales fr es de
- --model chatgpt-4o-latest
- --custom-instructions "$(cat ./instructions.md)"
-```
+> لاحظ أن عملية المراجعة تستهلك عددًا أكبر من رموز الإدخال مقارنة بعملية الترجمة لمراجعة الملف بالكامل. ومع ذلك، فإن عملية المراجعة ستقوم بتحسين الأجزاء التي يجب مراجعتها، وستتخطى الأجزاء التي لم تتغير.
+
+##### الوسائط:
+
+يقبل أمر `doc review` نفس الوسائط التي يقبلها أمر `doc translate`، مما يتيح لك مراجعة ملفات التوثيق المحددة وتطبيق فحوصات الجودة.
+
+إذا قمت بتفعيل أحد خيارات git، فإن الأمر سيقوم بمراجعة الجزء من الملفات الذي يتم تغييره فقط. سيقوم السكربت بمعالجة الملف بتقسيمه إلى أجزاء ومراجعة كل جزء على حدة. إذا لم يكن هناك تغييرات في الجزء، فسيتخطى السكربت هذا الجزء لتسريع عملية المراجعة وتقليل تكلفة استخدام واجهة برمجة التطبيقات لمزود الذكاء الاصطناعي.
 
-## استخدم أوامر intlayer في ملف `package.json` الخاص بك
+## استخدام أوامر intlayer في ملف `package.json` الخاص بك
 
 ```json fileName="package.json"
 "scripts": {
@@ -423,18 +493,60 @@ npx intlayer doc review
 }
 ```
 
+## SDK الخاص بواجهة الأوامر CLI
+
+SDK الخاص بواجهة الأوامر (CLI) هو مكتبة تتيح لك استخدام واجهة أوامر Intlayer في كودك الخاص.
+
+```bash packageManager="npm"
+npm install @intlayer/cli --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add @intlayer/cli --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add @intlayer/cli --save-dev
+```
+
+مثال على الاستخدام:
+
+```ts
+import {
+  push,
+  pull,
+  fill,
+  build,
+  docTranslate,
+  docReview,
+} from "@intlayer/cli";
+
+push();
+// ...
+pull();
+// ...
+fill();
+// ...
+build();
+// ...
+docTranslate();
+// ...
+docReview();
+// ...
+```
+
 ## تصحيح أمر intlayer
 
 ### 1. **تأكد من أنك تستخدم أحدث إصدار**
 
-شغل:
+شغّل:
 
 ```bash
-npx intlayer --version                  # إصدار intlayer الحالي للغة المحلية
-npx intlayer@latest --version           # أحدث إصدار متوفر من intlayer
+npx intlayer --version                  # إصدار intlayer المحلي الحالي
+npx intlayer@latest --version           # أحدث إصدار intlayer متوفر
 ```
 
-### 2. **التحقق مما إذا كان الأمر مسجلاً**
+### 2. **تحقق مما إذا كان الأمر مسجلاً**
 
 يمكنك التحقق باستخدام:
 
@@ -443,16 +555,19 @@ npx intlayer --help                     # يعرض قائمة الأوامر ا
 npx intlayer dictionary build --help    # يعرض قائمة الخيارات المتاحة لأمر معين
 ```
 
-### 3. **إعادة تشغيل الطرفية**
+### 3. **أعد تشغيل الطرفية**
 
-في بعض الأحيان، يلزم إعادة تشغيل الطرفية للتعرف على الأوامر الجديدة.
+في بعض الأحيان، يكون من الضروري إعادة تشغيل الطرفية للتعرف على الأوامر الجديدة.
 
-### 4. **مسح ذاكرة التخزين المؤقت لـ npx (إذا كنت عالقًا مع إصدار قديم)**
+### 4. **مسح ذاكرة التخزين المؤقت لـ npx (إذا كنت عالقًا مع إصدار أقدم)**
 
 ```bash
 npx clear-npx-cache
 ```
 
-## تاريخ الوثيقة
+## سجل التوثيق
 
-- 5.5.10 - 2025-06-29: بداية التاريخ
+| الإصدار | التاريخ    | التغييرات                    |
+| ------- | ---------- | ---------------------------- |
+| 5.5.11  | 2025-07-11 | تحديث توثيق معلمات أوامر CLI |
+| 5.5.10  | 2025-06-29 | بدء السجل                    |