Gemini CLI
محوّل أداة Apothem لـ Gemini CLI (إصدار عام).
المورّد: Google
اسم التثبيت: gemini-cli
الحالة: إصدار عام
الإعداد الأصلي: GEMINI.md و.gemini/ المحلّيان للمشروع
التثبيت
apothem install --harness gemini-cli --project /path/to/projectنطاق المحوّل هو المشروع. يثبّت ملفّ GEMINI.md الخاص بالمشروع، ويحوّل
أوامر Apothem إلى أوامر شرطة مائلة بصيغة TOML خاصّة
بـGemini، ويطبّع تعريفات المساعِدات المحلّية، ويضع مجموعات الدعم غير
الأصلية تحت .gemini/.apothem/support/.
الملفات المكتوبة:
GEMINI.md
.gemini/commands/*.toml
.gemini/agents/*.md
.gemini/skills/
.gemini/.apothem/support/تعيين الملف التعريفي إلى الإعداد الأصلي
يقرأ المحوّل مجموعات Apothem المشتركة ويوجّه كلّ واحدة منها عبر سطح
متوافق مع Gemini. تبقى قواعد Markdown والقوالب ومادّة الخطافات
تحت .gemini/.apothem/support/ لأنّها مادّة دعم، وليست دليل قواعد أصلي
لـGemini.
ملاحظات التوافق
يبقى ~/.gemini/ منطقةً على نطاق المستخدم للأدوات التي تستخدم ملفًا
تعريفيًا عامًّا لـGemini. لا يكتب محوّل Gemini CLI إلا في
المشروع المُمرَّر عبر --project.
التحقّق
apothem verify --harness gemini-cli --project /path/to/projectيؤكّد أمر التحقّق ما يلي:
- وجود الإعداد الأصلي في المسار المتوقَّع.
- وجود جميع الحقول الإلزامية من الملف التعريفي المشترك.
- إبلاغ روتين التحقّق الخاص بالمحوّل بالنجاح.
التحديث
apothem update --harness gemini-cli --project /path/to/projectيحدّث GEMINI.md، والأوامر المُحوَّلة، وتعريفات المساعِدات المحلّية،
والمهارات المثبّتة، وشجرة الدعم .gemini/.apothem/support/.
إلغاء التثبيت
apothem uninstall --harness gemini-cli --project /path/to/projectيزيل ملفات الإعداد الأصلي التي كتبها المحوّل. لا يتأثّر ملفّ YAML الخاص بالملف التعريفي المشترك ولا محرّك Apothem.
بوّابة المطابقة
python -m apothem.conformity.gate --all .استكشاف الأخطاء وإصلاحها
| العَرَض | الإصلاح |
|---|---|
| ملف الإعداد غير موجود | أعد تشغيل apothem install --harness gemini-cli --project /path/to/project |
| فشل التحقّق | شغّل apothem update --harness gemini-cli --project /path/to/project، ثم تحقّق مجدّدًا |
| محتوى إعداد غير متوقَّع | تحقّق من ~/.config/apothem/profile.yaml أو --profile PATH، ثم أعد تشغيل apothem update --harness gemini-cli --project /path/to/project |
مفاتيح الضبط
| العَلَم | الافتراضي | الوصف |
|---|---|---|
--dry-run | false | معاينة التثبيت دون كتابة ملفات. |