التحديث

تحديث مُلحَق Claude CodeCopy Anchor Link

حدّث إدراج السوق (marketplace)، ثم حدّث المُلحَق من قائمة /plugin داخل Claude Code:

/plugin marketplace update apothem

افتح /plugin، واختر apothem، ثم اختر إجراء التحديث عندما يُدرَج إصدار أحدث من المُلحَق.

يُشغّل npx الإصدار الحالي دائمًاCopy Anchor Link

يحلّ npx @ahmed-g-gad/apothem إلى الحزمة المنشورة الحالية في كل تشغيل، لذا لا يوجد شيء لتحديثه. عندما تقدّم ذاكرة npx المؤقتة القديمة نسخةً أقدم، ثبّت وسم التوزيع (dist-tag) صراحةً:

npx @ahmed-g-gad/apothem@latest --version

تحديث إعداد قائم على المُثبِّتCopy Anchor Link

أعِد تشغيل المُثبِّت — فهو متّسق (idempotent) ويسحب وسم الإصدار في الشجرة الموجودة — أو شغّل نص التحديث المخصّص:

bash scripts/installer/update.sh

pwsh -NoProfile -File scripts/installer/update.ps1

يعيد نص التحديث سحب شجرة المصدر في APOTHEM_HOME (الافتراضي ~/.apothem) إلى APOTHEM_REF؛ فإن لم يُضبَط يحلّ إلى أحدث وسم إصدار موقَّع بصيغة vMAJOR.MINOR.PATCH، وقيمة الوسم تثبّته، ويختار main الفرع المتحرّك فقط عندما يُضبط APOTHEM_ALLOW_UNVERIFIED=1 أيضًا. ومن دون هذا التجاوز، يسحب التحديث المرجع ثم يُجهِض قبل إعادة التجسيد، لأن الفرع ليس وسم إصدار موقَّعًا. ويتحقّق من توقيع الوسم بـ git verify-tag قبل إعادة التجسيد؛ فيُجهَض عند وسم غير موقَّع أو مُتلاعَب به، ما لم يُخفِّض APOTHEM_ALLOW_UNVERIFIED=1 الإجهاض إلى تحذير. والوسم الموقَّع الذي لا يوجد مفتاح ناشره العام في حلقة المفاتيح المحلية يُجهَض مع إرشادات لاستيراد المفتاح، تشير إلى البصمة المنشورة في SECURITY.md. ثم يُعيد تجسيد إطار العمل المُسمّى بـ APOTHEM_HARNESS بتشغيل apothem update من الشجرة المُحدَّثة (ويأخذ إطار العمل قيمته الافتراضية وفق جدول متغيّرات بيئة المُثبِّت). ويتطلّب تثبيتًا سابقًا: فعندما لا توجد شجرة في APOTHEM_HOME ولم يُضبَط APOTHEM_SOURCE، يخرج برسالة توجّهك إلى المُثبِّت أولًا.

إعادة تجسيد مُخرَج إطار العملCopy Anchor Link

بعد تحديث المحرّك أو تحرير ~/.config/apothem/profile.yaml، أعِد اشتقاق إعداد إطار العمل المُثبَّت. لا تحتاج المحوّلات ذات نطاق المستخدم إلى --project؛ بينما تحتاجها المحوّلات ذات نطاق المشروع.

apothem update --harness claude-code
apothem update --harness cursor --project /path/to/project
apothem update --harness all --project /path/to/project

شغّل الأمر نفسه مع --dry-run --json عندما تحتاج إلى معاينة قابلة للقراءة آليًا دون أي كتابة على نظام الملفات.

حدود الأمر الحاليةCopy Anchor Link

يحدّث apothem update مُخرَج إطار العمل فقط. ولا تنفّذ واجهة سطر الأوامر update --self أو update --check أو update --apply؛ حدّث المحرّك نفسه عبر القناة التي ثبّتت منها — مسار /plugin، أو تشغيل npx جديد، أو نصوص المُثبِّت/التحديث أعلاه.

التحقّق من إصدار المحرّكCopy Anchor Link

apothem --version
npx @ahmed-g-gad/apothem --version