update
مرجع واجهة سطر الأوامر لأمر apothem update.
يعيد تثبيت إعداد محوّل إطار عمل من الملف التعريفي المشترك الحالي.
الموجز
apothem update --harness NAME|all [--profile PATH] [--dry-run]
[--project PATH]
[--quiet|-q] [--verbose|-v]
[--format plain|json] [--json] [--no-color]يعيد update تجسيد مخرجات إطار العمل من الملف التعريفي المشترك الحالي.
ويستخدم التحقّق نفسه من الملف التعريفي، واختيار --harness all نفسه،
وفحص نطاق المشروع نفسه، وسلوك التشغيل التجريبي نفسه، وغلاف JSON نفسه التي
يستخدمها install.
بالنسبة إلى المحوّلات ذات نطاق المشروع التي تكتب المهارات إلى دليلك المنزلي (انظر
install)،
يُحدِّث update تلك المجلّدات أيضًا ويطبع ملاحظة Note: نفسها
التي تسمّيها. والمحوّل الذي ثُبِّت قبل أن يكتب المهارات يحصل عليها في
تحديثه التالي. ويُتخطّى مجلّد المهارة الذي لم يكتبه Apothem مع
تحذير، كما في install.
والتثبيت الذي كتب مجلّد المهارات المشترك من قبل يُعاد كتابته بالصيغة التي تتشاركها
كل التثبيتات في تحديثه التالي؛ ويُنسَخ كل مجلّد متغيّر احتياطيًا
أولًا.
يُحَلّ الاسم المستعار بصيغة الاستمرار apothem updating (ويُقبَل أيضًا
بالصيغة apothem Updating) إلى المعالج نفسه.
الخيارات
| الخيار | الوصف |
|---|---|
--harness NAME | محوّل إطار العمل المراد تحديثه، أو all للمجموعة الشاملة للسجلّ كله (مطلوب). مع all، تُتخطّى أُطُر العمل المُدرَجة في exclude_harnesses الخاصة بالملف التعريفي، لكن إطار العمل المُسمّى صراحةً يُحدَّث حتى لو كان مُدرَجًا فيها. |
--profile PATH | مسار ملف YAML للملف التعريفي المشترك. القيمة الافتراضية ~/.config/apothem/profile.yaml. |
--dry-run | يعاين التحديث دون كتابة ملفات. |
--project PATH | جذر المشروع لأُطُر العمل ذات نطاق المشروع. مطلوب عندما تتضمّن مجموعة أُطُر العمل المختارة محوّلات ذات نطاق المشروع. |
--quiet، -q | يُخمِد المخرجات المعلوماتية؛ لا تُصدَر إلا الأخطاء. |
--verbose، -v | يُصدِر مخرجات تشخيصية إضافية. |
--format plain|json | صيغة المخرجات (الافتراضي: plain). |
--json | اختصار لـ --format json. |
--no-color | يعطّل رموز ألوان ANSI في المخرجات. |
-h، --help | يعرض المساعدة ويخرج. |
مخرجات JSON
{
"schema_version": 1,
"status": "success",
"command": "update",
"action": "updated",
"harness": "claude-code",
"profile_path": "C:\\Users\\Example\\.config\\apothem\\profile.yaml",
"project": null,
"files_written": [],
"results": [],
"warnings": [],
"error": null,
"output_path": "C:\\Users\\Example\\.claude\\settings.json"
}يُرجِع --dry-run القيمتين status: "dry_run"
وfiles_written: [].
أمثلة
apothem update --harness claude-code
apothem update --harness claude-code --dry-run
apothem update --harness all --project . --dry-run --json
apothem Updating --harness claude-code # continuous-form alias
apothem updating --harness claude-code # lowercase variantرموز الخروج
| الرمز | المعنى |
|---|---|
| 0 | حُدِّث المحوّل بنجاح، أو خُطِّط التشغيل التجريبي دون أخطاء |
| 1 | خطأ متوقّع في التحقّق، أو الملف التعريفي، أو إطار العمل، أو المشروع، أو المحوّل |
| 2 | تجسيد جزئي للدفعة بعد عملية كتابة واحدة على الأقل |
| 64 | خطأ استخدام: خيار أو أمر غير معروف، أو قيمة خيار مفقودة أو غير صالحة. ومع --json يكون الخطأ غلاف JSON يحمل الرمز cli.usage. |
انظر أيضًا
apothem updating— اسم مستعار بصيغة الاستمرار لهذا الأمر (موثّق هنا؛ تقبل واجهة سطر الأوامر الصيغتين كلتيهما)- apothem install — التثبيت الأوّلي
- دليل التحديث — مسارات التحديث لكل مُثبِّت