تهيئة Intlayer

npx intlayer init

يثبّت الأمر init حزم Intlayer ويُعدّ إطار العمل لديك (ملف الإعداد، TypeScript، إضافة المُجمِّع، middleware/proxy، المزوّدات). وهو الطريقة الموصى بها للبدء مع Intlayer.

كل ما عدا ذلك (مسارات عمل CI، مهارات الذكاء الاصطناعي، خادم MCP، أدوات المحرر، قواعد lint، CMS، البنية التحتية) اختياري: اختره من قائمة --interactive، أو شغّل الأمر الفرعي المخصص له (انظر أدناه).

الأسماء المستعارة:

• npx intlayer init

الوسائط:

• --project-root [projectRoot] - اختياري. حدد الدليل الجذر للمشروع. إذا لم يتم توفيره ، فسيقوم الأمر بالبحث عن جذر المشروع بدءًا من دليل العمل الحالي.
• --no-gitignore - اختياري. يتخطى التحديث التلقائي لملف .gitignore. إذا تم تعيين هذا العلم ، فلن يتم إضافة .intlayer إلى .gitignore.
• --no-framework-setup - اختياري. يثبّت الحزم فقط، دون تعديل ملفات المشروع.
• --routing <routing> - اختياري. توجيه اللغات: prefix-no-default (افتراضي)، prefix-all، no-prefix، search-params أو none.
• -i, --interactive - اختياري. اختر خطوات الإعداد من قائمة (الحزم، CI، المهارات، MCP، VS Code، LSP، lint، CMS، البنية التحتية، …) بدلًا من المجموعة الافتراضية. يتطلب طرفية: بدونها (وكيل ذكاء اصطناعي، CI) يفشل الأمر ويعرض الأوامر الفرعية التي يجب تشغيلها بدلًا منه.
• --no-github-actions - اختياري. مع --interactive، لا يُنشئ أبدًا مسارات عمل GitHub Actions، حتى لو كانت محددة.

ماذا يفعل:

يقوم أمر init بمهام الإعداد التالية:

1. التحقق من صحة هيكل المشروع - يضمن أنك في دليل مشروع صالح مع ملف package.json.
2. يثبّت الحزم - يثبّت حزم Intlayer الناقصة لمكدّسك التقني (مثل react-intlayer وvite-intlayer) ويحدّث القديمة منها.
3. تحديث .gitignore - يضيف .intlayer إلى ملف .gitignore الخاص بك لاستبعاد الملفات التي تم إنشاؤها من التحكم في الإصدار (يمكن تخطيه باستخدام --no-gitignore).
4. تكوين TypeScript - يقوم بتحديث أي ملفات tsconfig.json لتشمل تعريفات أنواع Intlayer (.intlayer/**/*.ts).
5. إنشاء ملف التكوين - ينشئ intlayer.config.ts (لمشاريع TypeScript) أو intlayer.config.mjs (لمشاريع JavaScript) مع الإعدادات الافتراضية.
6. يحدّث إعداد المُجمِّع / إطار العمل - يضيف إضافة Intlayer إلى إعداد Vite أو Next.js أو Nuxt أو Astro أو غيرها، ويُنشئ middleware/proxy والمزوّدات عندما يدعم إطار العمل ذلك.

الإعداد خطوة بخطوة

لكل خطوة في قائمة --interactive أمر فرعي خاص بها. لا تطرح هذه الأوامر أي سؤال عند تمرير القيم كخيارات، لذا يمكن تشغيلها بأمان من وكيل ذكاء اصطناعي أو من مهمة CI.

من وكيل ذكاء اصطناعي أو مهمة CI

لا تملك صدفة وكيل الذكاء الاصطناعي طرفية، لذا لا يمكن الإجابة عن أي سؤال. استخدم الأمر الافتراضي، ثم الأوامر الفرعية التي تحتاجها:

npx intlayer init
npx intlayer init skills --platform Claude
npx intlayer init mcp --platform Claude --transport stdio

دون طرفية:

• يثبّت init skills المهارات المناسبة لمكدّسك ما لم يُحدَّد --skills (مثل --skills Usage Content React).
• يستخدم init skills وinit mcp منصة الذكاء الاصطناعي المكتشفة (Claude Code، Cursor، VS Code، Windsurf، …) ما لم يُحدَّد --platform، ويفشلان مع قائمة المنصات إذا لم تُكتشف أي منصة.
• يستخدم init mcp النقل stdio ما لم يُحدَّد --transport.
• يتطلب init infra الخيار --mode، ويكتفي init extension بطباعة روابط المتجر ما لم يُحدَّد --browser.

يُعَدّ خادم MCP دائمًا داخل المشروع (بالنسبة إلى Claude Code، في .mcp.json).

أمثلة:

التهيئة الأساسية:

npx intlayer init

يؤدي هذا إلى تهيئة Intlayer في الدليل الحالي ، مع اكتشاف جذر المشروع تلقائيًا.

التهيئة مع جذر مشروع مخصص:

npx intlayer init --project-root ./my-project

يؤدي هذا إلى تهيئة Intlayer في الدليل المحدد.

التهيئة دون تحديث .gitignore:

npx intlayer init --no-gitignore

سيؤدي هذا إلى إعداد جميع ملفات التكوين ولكنه لن يعدل ملف .gitignore الخاص بك.

إعداد البنية التحتية (تطبيق سطح المكتب أو الاستضافة الذاتية):

npx intlayer init infra

يقوم بتنزيل وتشغيل أداة التثبيت المستضافة (https://intlayer.org/install.sh، أو install.ps1 على Windows)، والتي تسألك عن كيفية تشغيل Intlayer:

• تطبيق سطح المكتب - يقوم بتثبيت لوحة التحكم الأصلية على جهازك، المتصلة بـ Intlayer Cloud.
• Docker الكل في واحد - لوحة التحكم + API + MongoDB + Redis + MinIO في حاوية واحدة.
• Docker Compose - حاوية واحدة لكل خدمة، للاستضافة الذاتية القابلة للتوسع.

تخطي القائمة باستخدام --mode:

npx intlayer init infra --mode compose

يتم تقديم نفس الخطوة بواسطة npx intlayer init --interactive. راجع مرجع init infra لمعرفة إعدادات أداة التثبيت، ودليل الاستضافة الذاتية لمعرفة ما يقوم كل وضع بإعداده.

مثال على المخرجات:

npx intlayer init
Checking Intlayer configuration...
✓ Added .intlayer to .gitignore
✓ Updated tsconfig.json to include intlayer types
✓ Created intlayer.config.ts
✓ Injected import into vite.config.ts
✓ Intlayer init setup complete.

ملاحظات:

• الأمر متكرر (idempotent) - يمكنك تشغيله بأمان عدة مرات. سيتم تخطي الخطوات المكونة بالفعل.
• إذا كان ملف التكوين موجودًا بالفعل ، فلن يتم استبداله.
• يتم تخطي تكوينات TypeScript بدون مصفوفة include (على سبيل المثال ، تكوينات نمط الحل مع المراجع).
• سيتوقف الأمر مع خطأ إذا لم يتم العثور على package.json في جذر المشروع.