إضافة بيئة
فعّل محوّل بيئة لكي تُجسَّد تهيئتها الأصلية من الملف التعريفي المشترك.
الهدف: فعّل إطار عمل إضافيًا لكي يُجسِّد Apothem تهيئته الأصلية من ملفك التعريفي المشترك.
المتطلّبات المسبقة
- ملف تعريفي مشترك في
~/.config/apothem/profile.yaml(أنشئ واحدًا عبرapothem profile initإن لم يكن موجودًا بعد). - واجهة
apothemعلىPATHلديك. إذا ثبّتّ شجرة المصدر القائمة بذاتها، فصدّر كل أمر بـPYTHONPATH="$HOME/.apothem/src"وشغّلpython -m apothemبدلًا منapothem— أو استخدمnpx @ahmed-g-gad/apothem.
الخطوات
-
اسرد أُطُر العمل المُسجَّلة وانظر أيّها مثبَّت بالفعل:
apothem harnesses listيطبع
apothem harnesses listكل مُعرّف مدعوم؛ والمجموعة ذاتها موجودة في قائمة أُطُر العمل وسجلّ أُطُر العمل المُولّد من المصدر. اختر مُعرّف أداتك بدلًا من تثبيت القائمة هنا — فهي تنمو مع إضافة المحوّلات. -
افحص إطار العمل المستهدف لتأكيد نطاقه ومسار مُخرَجه:
apothem harnesses show cursorسطر
Scope: projectيعني أن المحوّل يُجسِّد في شجرة مشروع ويتطلّب--project PATH؛ بينماScope: userيُجسِّد في دليل تهيئة بنطاق المستخدم ولا يحتاج إلى راية مشروع. -
عاين التثبيت دون كتابة ملفات:
apothem install --harness cursor --project /path/to/project --dry-run -
ثبّت إطار العمل. لإطار عمل بنطاق المستخدم:
apothem install --harness claude-codeلإطار عمل بنطاق المشروع، مرّر جذر المشروع:
apothem install --harness cursor --project /path/to/projectثبّت كل إطار عمل مدعوم دفعة واحدة عبر
--harness all(لا تزال أُطُر العمل بنطاق المشروع تحتاج إلى--project؛ وتُتخطّى المُعرّفات المدرجة فيexclude_harnessesفي الملف التعريفي).
التحقق
apothem verify --harness cursor --project /path/to/projectسطر ✓ <harness-id> is verified يؤكّد أن الأهداف المُدارة موجودة وقابلة للتحليل.
يقدّم apothem doctor رؤية النظام بأكمله عبر كل إطار عمل.
ذات صلة
- حرّر الملف التعريفي لتغيير ما
يُجسّده المحوّل، ثم أعد تشغيل
apothem update. - يغطّي التثبيت تثبيت أول تشغيل.