quickstart

تشغيل أول موجَّه: يتأكّد من وجود ملف شخصي، ويعاين عمليات الكتابة، ثم يثبّت.

الموجز

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

quickstart هو نقطة الدخول الموجَّهة الوحيدة لمشغّل جديد. في تدفّق خطّي واحد، فإنه: (1) يتأكّد من وجود ملف شخصي مشترك — مُنشئًا ملفًا شخصيًّا مبدئيًّا مع تنبيهٍ للتخصيص إن لم يُعثَر على أي ملف؛ (2) يعاين الملفات الملموسة التي ستكتبها المساعدات البرمجية المختارة، مُجمَّعةً حسب جذر المشروع مقابل دليلك المنزلي؛ (3) يطلب التأكيد؛ (4) يثبّت بمخرجات ملاحظات القدرات المُجمَّعة والمُنقّاة من الضجيج؛ و(5) يطبع الأوامر التالية المُوصى بها.

وهو يُركِّب اللبنات نفسها التي يستخدمها أمر install — ولا يعيد تنفيذها. يكون --harness افتراضيًّا all و--project الدليل الحالي.

السلوك

• الملف الشخصي — إذا لم يكن لمسار الملف الشخصي المُحَلّ ملفٌ، يعرض quickstart إنشاء ملف شخصي مبدئي (يُنشئه تلقائيًّا تحت --yes، أو صدفة غير تفاعلية، أو --format json) ويُسمّي حقول الهوية النائبة المراد تخصيصها.
• المعاينة + التأكيد — قبل أي كتابة، تُسرَد الأهداف تحت عنوانين (جذر المشروع مقابل دليلك المنزلي)؛ ويؤكّد تشغيلٌ تفاعلي قبل الكتابة خارج المشروع. يتابع كلٌّ من --yes، والصدفة غير التفاعلية، و--format json دون مطالبة. ويؤدّي الرفض إلى الإجهاض قبل أي كتابة.
• التثبيت — تُلخَّص القدرات التي لا يدعمها مساعد برمجي أصليًّا في ملاحظة مُجمَّعة واحدة لكل مساعد برمجي (مرّر --verbose للتفصيل لكل قدرة)؛ وتكون المجموعة الكاملة دائمًا في مصفوفة warnings الخاصّة بـ --format json.
• الخطوة التالية — تُسمّي مخرجات الطرفية الأوامر التالية (apothem verify …، apothem doctor).

الخيارات

مخرجات JSON

يُصدِر --format json مستندًا واحدًا يُلخّص كل خطوة موجَّهة:

{
  "status": "success",
  "command": "quickstart",
  "profile_path": "C:\\Users\\Example\\.config\\apothem\\profile.yaml",
  "steps": [
    {"step": "profile", "outcome": "created", "path": "…", "placeholder_identity": ["name", "email", "github"]},
    {"step": "install", "status": "success", "harness": "all", "files_written": ["…"], "warnings": [], "results": []},
    {"step": "recommend", "next": ["apothem verify --harness all --project .", "apothem doctor"]}
  ],
  "recommended_next": ["apothem verify --harness all --project .", "apothem doctor"]
}

أمثلة

apothem quickstart
apothem quickstart --harness all --project . --yes
apothem quickstart --harness claude-code
apothem quickstart --json

رموز الخروج

انظر أيضًا

• apothem install — تجسيد مساعد برمجي من الملف الشخصي المشترك
• apothem verify — تأكيد أن التثبيت فعّال
• apothem doctor — سلامة البيئة والتثبيت
• البدء — دليل التثبيت الكامل