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 الخاص بالمشروع، لذا تُكتَب كتلة
Apothem فيه بوصفها إرشادات على مستوى المشروع لا تُسمّي أداة واحدة بعينها
قارئًا لها.
الملفات المكتوبة:
GEMINI.md
.gemini/commands/*.toml
.gemini/agents/*.md
.gemini/skills/
.gemini/.apothem/support/تعيين الملف التعريفي إلى الإعداد الأصلي
يقرأ المحوّل حزم Apothem المشتركة ويوجّه كل واحدة منها عبر سطح متوافق مع
Gemini. تبقى قواعد Markdown والقوالب ومادّة الخطّافات تحت
.gemini/.apothem/support/ لأنها مادّة دعم، لا دليل قواعد أصلي لـ
Gemini.
تنتهي كتلة Apothem في GEMINI.md بقسم ملفات دعم
Apothem الذي يُسمّي، نسبةً إلى جذر المشروع، الدليل الواقع تحت
.gemini/.apothem/support/ الذي تُحَلّ نسبةً إليه كل إحالة بأسلوب المستودع
(rules/<name>.md، وtemplates/...، وhooks/...).
المسارات نسبية بحيث لا يحمل ملف GEMINI.md المُودَع في المستودع أي مسار
خاص بجهاز بعينه.
يحمل كل أمر مُحوَّل في .gemini/commands/ الحقلين description
وprompt. لا تحوي المطالبة سوى تعليمات الأمر؛ وتُستبعَد بيانات
Apothem الوصفية في أعلى ملف المصدر (النسخة، وقائمة الأدوات، والحقول
المشابهة)، بحيث لا يقرؤها النموذج أبدًا بوصفها تعليمات. لا يُشغِّل Gemini
أمرًا مخصّصًا إلا حين تكتبه.
تحتفظ تعريفات المساعِدات في .gemini/agents/ بحدود أدواتها وحدّ أدوارها:
تصبح منحة tools في المصدر، مطروحًا منها disallowedTools،
قائمة سماح tools في Gemini مؤلّفة من أسماء أدوات
Gemini، ويصبح maxTurns هو max_turns. لذا لا يحصل
المساعِد المقصور على القراءة على أداة write_file أو replace.
لا يُضبَط أي نموذج، لذا يرث كل مساعِد نموذج الجلسة.
والمساعِد الذي يسرده المفتاح agent_mcp_servers في الملف التعريفي يحصل أيضًا على
مُدخلة mcp_<server>_* واحدة لكل خادم مُسمّى في قائمة السماح tools
الخاصة به، بحيث يستطيع استدعاء أدوات ذلك الخادم دون أدوات أي خادم آخر؛ ومن دون
المفتاح يحتفظ كل مساعِد بقائمة السماح العادية (راجع
خوادم MCP). ولا يكتب
Apothem منحةً هنا إلا لاسم خادم مؤلَّف من حروف وأرقام و-، لأن
Gemini CLI لا يستطيع مخاطبة اسم فيه شرطة سفلية؛ وأي اسم آخر يُتخطّى ويُبلَّغ
عنه، وكذلك المنحة لمساعِد يصل بالفعل إلى كل خادم MCP.
ملاحظات التوافق
يبقى ~/.gemini/ منطقة على نطاق المستخدم للأدوات التي تستخدم ملفًا
تعريفيًا عامًّا لـ Gemini. لا يكتب محوّل Gemini CLI إلا في
المشروع المُمرَّر عبر --project.
التحقّق
apothem verify --harness gemini-cli --project /path/to/projectيؤكّد أمر التحقّق ما يلي:
- الإعداد الأصلي موجود في المسار المتوقَّع.
- كل هدف مُدار موجود؛ والملفات المُدارة غير فارغة، وتُحلَّل إعدادات JSON
أو YAML. أضِف
--profile PATHلتتحقّق كذلك من أن الملفات المثبّتة تطابق ذلك الملف التعريفي. - روتين التحقّق الخاص بالمحوّل يُبلِغ عن النجاح.
التحديث
apothem update --harness gemini-cli --project /path/to/projectيُحدِّث GEMINI.md، والأوامر المُحوَّلة، وتعريفات المساعِدات المحلّية،
والمهارات المُثبَّتة، وشجرة الدعم .gemini/.apothem/support/.
إلغاء التثبيت
apothem uninstall --harness gemini-cli --project /path/to/projectيُزيل كتلة Apothem من <project>/GEMINI.md ويُبقي أي نص آخر
فيه. ولا يُحذَف الملف إلا عندما لا يبقى فيه شيء آخر. ويُزيل كذلك ملفات
Apothem في <project>/.gemini/commands/،
و<project>/.gemini/skills/، و<project>/.gemini/agents/،
و<project>/.gemini/.apothem/support/؛ وتبقى الملفات الأخرى في تلك
المجلدات. قبل التغيير، تُحفَظ نسخة مختومة بالوقت من كل ملف تحت
~/.apothem/backups/؛ ولا يُترَك أي ملف نسخة احتياطية في المشروع. لا يتأثّر
ملف 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 | معاينة التثبيت دون كتابة ملفات. |
انظر أيضًا
- كل أُطُر العمل — الفهرس الكامل للأدوات المدعومة
- دليل التثبيت — ثبّت Apothem في إطار العمل هذا
- مرجع
apothem harnesses— اسرد المحوّلات وافحصها من واجهة سطر الأوامر