install

يثبّت تهيئة مُحَوِّل مساعد برمجي من الملف الشخصي المشترك.

الموجز

apothem install --harness NAME|all [--profile PATH] [--dry-run]
                 [--project PATH]
                 [--quiet|-q] [--verbose|-v]
                 [--format plain|json] [--json] [--no-color]

يُحمِّل الملف الشخصي المشترك ويتحقّق منه، ويختار مُحَوِّلًا مُسمّى أو مجموعة all على نطاق السجلّ بأكمله، ويتحقّق من خطّة التجسيد، ويكتب التهيئة الأصلية للمساعد البرمجي إضافةً إلى أفواج الدعم. تتطلّب المُحَوِّلات بنطاق المشروع الخيار --project PATH.

يُحَلّ الاسم البديل بالصيغة المستمرّة apothem installing إلى المعالج نفسه.

معاينة نطاق التأثير

يتفرّع install --harness all إلى نطاقات مختلطة: تكتب المُحَوِّلات بنطاق المشروع تحت الجذر --project المُقدَّم، بينما تكتب المُحَوِّلات بنطاق المستخدم تحت دليلك المنزلي — خارج ذلك الجذر. قبل كتابة أي ملف، يطبع الأمر الأهداف الملموسة مُجمَّعةً تحت عنوانين: تلك الموجودة داخل جذر المشروع وتلك الموجودة تحت دليلك المنزلي.

عندما يكتب التحديد خارج جذر المشروع، يحرس تأكيدٌ تفاعلي عمليات الكتابة المتجذّرة في الدليل المنزلي. يتابع كلٌّ من --yes، والصدفة غير التفاعلية (بدون TTY)، و--dry-run، و--format json دون مطالبة؛ ولا يكتب --dry-run و--format json أي شيء. ويؤدّي رفض المطالبة إلى الإجهاض قبل كتابة أي ملف.

ملاحظات القدرات

يُسقِط كل مُحَوِّل القدرات التي يدعمها مساعده البرمجي أصليًّا فقط؛ أمّا القدرات التي لا سطح أصلي لها فيُبلَّغ عنها، ولا تُسقَط بصمت. وفي الوضع plain يكون ذلك ملاحظةً مُجمَّعة واحدة لكل مساعد برمجي (مثلًا Note: <harness> - 9 capabilities not projected; pass --verbose for detail)؛ وتحت --verbose تطبع كل قدرة سطر تبريرها الخاص. ويحمل غلاف --format json دائمًا مصفوفة warnings الكاملة بصرف النظر عن مستوى الإسهاب.

الخيارات

مخرجات JSON

عند تمرير --json (أو --format json)، يُكتَب مستند JSON واحد إلى stdout:

{
  "status": "success",
  "command": "install",
  "action": "installed",
  "harness": "claude-code",
  "profile_path": "C:\\Users\\Example\\.config\\apothem\\profile.yaml",
  "project": null,
  "files_written": ["C:\\Users\\Example\\.claude\\settings.json"],
  "results": [],
  "warnings": [],
  "error": null,
  "output_path": "C:\\Users\\Example\\.claude\\settings.json"
}

لـ --dry-run:

{
  "status": "dry_run",
  "command": "install",
  "action": "dry_run",
  "harness": "claude-code",
  "files_written": [],
  "results": [],
  "warnings": [],
  "error": null
}

تستخدم أخطاء التحقّق المتوقّعة الغلاف نفسه وتتضمّن كائن error:

{
  "status": "error",
  "command": "install",
  "harness": "all",
  "files_written": [],
  "error": {
    "code": "project.required",
    "field": "project",
    "reason": "project-scope harnesses require --project: cursor, gemini-cli, github-copilot, windsurf.",
    "fix": "Pass --project PATH or select only user-scope harnesses."
  }
}

أمثلة

apothem install --harness claude-code
apothem install --harness claude-code --dry-run
apothem install --harness cursor --project . --profile ~/profile.yaml --json
apothem install --harness all --project . --dry-run --json
apothem Installing --harness claude-code   # continuous-form alias
apothem installing --harness claude-code   # lowercase variant

رموز الخروج

انظر أيضًا

• apothem installing — اسم بديل بالصيغة المستمرّة لهذا الأمر (مُوثَّق هنا؛ تقبل واجهة سطر الأوامر كلتا الصيغتين)
• apothem update — إعادة تطبيق الملف الشخصي الحالي على مساعد برمجي
• apothem verify — تأكيد أن المُحَوِّل فعّال
• البدء — دليل التثبيت الكامل