التثبيت

يمكن تثبيت Apothem في أقل من دقيقتين، وهو يعمل جنبًا إلى جنب مع تهيئة إطار عملك القائمة. تشغّل كل القنوات المحرّك المكتفي ذاتيًا نفسه — تحمل شجرة الشفرة المصدرية اعتماديّاتها المُضمَّنة وتعمل من نسخة مسحوبة على Python 3.10 أو أحدث الخاص بالنظام (راجع زمن التشغيل المكتفي ذاتيًا).

متطلّبان مُسبقان تتشاركهما كل القنوات: وجود Python 3.10 أو أحدث على PATH الخاص بالنظام، مع إمكانية استيراد حزمتَي click وrich تحته. وتحتاج قناتا غلاف npm ومداخل الأدوات إضافةً إلى ذلك إلى Node.js 18 أو أحدث لتشغيل npx. ويكرّر قسم كل قناة أدناه متطلّباتها المُسبقة بالضبط، وأمرًا واحدًا جاهزًا للنسخ، وخطوة تحقّق.

اختر قناة

تتوفّر ثماني قنوات تثبيت. اختر بحسب طريقة عملك الحالية.

كل مسار عديم الأثر: إعادة التشغيل آمنة وتتقارب إلى الحالة نفسها.

1. إضافة Claude Code

المتطلّبات المُسبقة: Claude Code، وPython 3.10+ على PATH الخاص بالنظام.

يعمل مسار الإضافة بالكامل داخل Claude Code. فهو يحزم محرّك Apothem مع أوامر الشرطة المائلة الخاصة به، والعمّال المُفوَّضين، والمهارات، والقواعد، والخطّافات، وكلها قابلة للتشغيل من شجرة الإضافة المكتفية ذاتيًا:

/plugin marketplace add ahmed-g-gad/apothem
/plugin install apothem@apothem

بعد التثبيت، تصبح مجموعة أوامر Apothem (/plan-spec، و/code-review، و/security-audit، وغيرها)، والعمّال المُفوَّضون المرفقون، والمهارات، متاحةً في كل جلسة من جلسات Claude Code. للاطّلاع على الكتالوج الكامل للأوامر، راجع أوامر الشرطة المائلة.

التحقّق: شغِّل /plugin داخل Claude Code وتأكَّد من ظهور apothem بوصفه مُثبَّتًا، أو تحقَّق من تقرير الانحراف من الطرفية:

npx @ahmed-g-gad/apothem verify --harness claude-code

2. غلاف npm (npx)

المتطلّبات المُسبقة: Node.js 18+ (لأجل npx) وPython 3.10+ على PATH الخاص بالنظام. يحدّد الغلاف المُفسِّر ويوجّه كل أمر CLI إلى المحرّك المرفق — ولا يوضع شيء دائمًا على نظامك.

npx @ahmed-g-gad/apothem install --harness claude-code

كما يعمل مباشرةً من المستودع:

npx github:ahmed-g-gad/apothem install --harness claude-code

يعمل كل أمر في مرجع CLI بهذا الشكل؛ استبدل apothem بـ npx @ahmed-g-gad/apothem. وهذا أيضًا مسار التثبيت لـ OpenCode وكل أداة أخرى لا تكشف سجلًّا منفصلًا للإضافات أو الملحقات — يزامنها Apothem مباشرةً إلى دليل تهيئتها الأصلي (npx @ahmed-g-gad/apothem install --harness opencode).

التحقّق:

npx @ahmed-g-gad/apothem --version
npx @ahmed-g-gad/apothem verify --harness claude-code

3. المثبِّتات من خطوة واحدة

المتطلّبات المُسبقة: Python 3.10+ على PATH الخاص بالنظام (يعرض المثبِّت تثبيت متطلّبَي click / rich نيابةً عنك)؛ ولا يلزم git إلا للتثبيت الشبكي الذي يستنسخ الشفرة المصدرية.

تحلّ البرامج النصية للمثبِّت أحدث وسم إصدار موقَّع، وتتحقّق من توقيعه، وتضع شجرة الشفرة المصدرية لـ Apothem عند ذلك الوسم في ~/.apothem، وتنشئ ملف تعريف أوّليًا إن لم يكن موجودًا، ثم تحوِّل أول إطار عمل وتتحقّق من النتيجة. إعادة التشغيل عديمة الأثر: تُحدَّث الشجرة القائمة إلى الوسم المُحلّ من جديد، ويُعاد إطار العمل إلى التحويل. التثبيت المُتحقَّق منه والمُثبَّت على الوسم هو المسار الافتراضي والموصى به.

curl -fsSL https://apothem.ahmedgad.com/install.sh | bash

irm https://apothem.ahmedgad.com/install.ps1 | iex

تُشحَن البرامج النصية نفسها في النسخة المسحوبة تحت scripts/installer/ — بصيغ install وuninstall وupdate في أشكال .sh و.ps1 و.bat — فيمكنك تشغيلها مباشرةً بعد الاستنساخ:

APOTHEM_HARNESS=claude-code sh scripts/installer/install.sh                                 # POSIX
$env:APOTHEM_HARNESS = 'claude-code'; pwsh -NoProfile -File scripts/installer/install.ps1   # Windows

نموذج الثقة

إن لم تُعرِّف APOTHEM_REF، يحلّ المثبِّت أعلى وسم إصدار من نوع vMAJOR.MINOR.PATCH ويُنزِّل ذلك — لا فرع main المتغيّر باستمرار. وقبل تحويل أي تهيئة، يُتحقَّق من توقيع الوسم المُنزَّل بـ git verify-tag؛ أما الوسم غير الموقَّع، أو المُتلاعَب به، أو غير القابل للتحقّق، فيُجهِض التثبيت قبل كتابة أي شيء. ولتثبيت إصدار بعينه، استخدم APOTHEM_REF:

APOTHEM_REF=vMAJOR.MINOR.PATCH sh -c "$(curl -fsSL https://apothem.ahmedgad.com/install.sh)"

استبدل vMAJOR.MINOR.PATCH بوسم من صفحة الإصدارات.

يُرخي تجاوزان صريحان السلوك الافتراضي: APOTHEM_REF=main يُنزِّل الفرع المتغيّر (دون تحقّق)، وAPOTHEM_ALLOW_UNVERIFIED=1 يخفّض فشل التحقّق إلى تحذير ويتابع — لِلاستخدام دون اتصال، أو محليًا، أو مع إصدارات مُوقَّعة مسبقًا. أما الفحص المحلي عبر APOTHEM_SOURCE فلا يُنزِّل شيئًا ويتخطّى التحقّق.

يعمل المحرّك بعد ذلك مباشرةً من الشجرة المُوضوعة بوصفه زمن تشغيل مكتفيًا ذاتيًا — اعتماداته من الطرف الثالث مُضمَّنة داخل شجرة الشفرة المصدرية، فلا دخل لأي سجلّ حِزَم في الأمر:

PYTHONPATH="$HOME/.apothem/src" python -m apothem <command>

يقرأ كلا البرنامجين النصيين متغيرات بيئة التهيئة نفسها (APOTHEM_HOME، وAPOTHEM_REPO، وAPOTHEM_REF، وAPOTHEM_ALLOW_UNVERIFIED، وAPOTHEM_SOURCE، وAPOTHEM_HARNESS، وAPOTHEM_PROFILE، وAPOTHEM_SKIP_VERIFY، وAPOTHEM_AUTO_INSTALL_DEPS)؛ راجع متغيرات بيئة المثبِّت للجدول الكامل و زمن التشغيل المكتفي ذاتيًا لمعرفة كيفية عمل نموذج الاستدعاء python -m.

أمر apothem. بعد تثبيت ناجح، يكتب المثبِّت غلاف apothem يوجّه إلى المحرّك المرفق — على POSIX داخل $HOME/.local/bin، وعلى Windows داخل %LOCALAPPDATA%\Microsoft\WindowsApps (وهو دليل مستخدم موجود أصلًا على PATH الافتراضي لـ Windows). ولا يحرّر المثبِّت PATH الخاص بك أبدًا. وبمجرّد وجود الدليل على PATH تشغّل apothem <command> مباشرةً، دون PYTHONPATH يدوي.

التحقّق:

apothem verify --harness claude-code

# or, before the shim is on PATH, from the bundled source:
PYTHONPATH="$HOME/.apothem/src" python -m apothem verify --harness claude-code

4. ملحق عائلة VS Code

المتطلّبات المُسبقة: VS Code، وNode.js 18+، وPython 3.10+ على PATH الخاص بالنظام.

يُثبَّت ملحق Apothem من سوق Visual Studio — ملحق واحد يغطّي VS Code وسطح المساعد المرافق داخل المحرِّر. تشغّل أوامره في لوحة الأوامر (Apothem: Install، وVerify، وUpdate، وUninstall، وDoctor) المحرّكَ نفسه عبر المُشغِّل المُهيَّأ (npx @ahmed-g-gad/apothem افتراضيًا؛ وجّه الإعداد apothem.runner إلى نسخة مسحوبة محلّية للتشغيل من الشفرة المصدرية).

التحقّق: شغِّل أمر Apothem: Verify من لوحة أوامر المحرِّر، أو من الطرفية:

npx @ahmed-g-gad/apothem verify --harness claude-code

5. مدخل سطر الأوامر التمهيدي (مضيف الامتدادات)

المتطلّبات المُسبقة: أداته المضيفة على سطر الأوامر، وNode.js 18+، وPython 3.10+ على PATH الخاص بالنظام.

ثبِّت Apothem بوصفه امتدادًا مباشرةً من المستودع — يحمل الأمر المضيف الدقيق ومُعرِّف البيئة:

gemini extensions install https://github.com/ahmed-g-gad/apothem

هذا الامتداد مدخل تمهيدي، لا التثبيت الكامل بمفرده: فهو يحمّل ملف سياق Apothem ويضيف أمر /apothem يستدعي المحرّك خارجيًّا (npx @ahmed-g-gad/apothem). جسِّد إطار العمل الكامل بتشغيل التثبيت عبره:

npx @ahmed-g-gad/apothem install --harness gemini-cli --project .

التحقّق:

npx @ahmed-g-gad/apothem verify --harness gemini-cli --project .

6. مدخل سطر الأوامر التمهيدي (مضيف qwen-code)

المتطلّبات المُسبقة: أداته المضيفة على سطر الأوامر، وNode.js 18+، وPython 3.10+ على PATH الخاص بالنظام.

ثبِّت Apothem بوصفه امتداد --harness qwen-code مباشرةً من المستودع:

qwen extensions install ahmed-g-gad/apothem

مثل امتداد القناة 5، هذا مدخل تمهيدي: يحمّل ملف سياق Apothem ويستدعي المحرّك خارجيًّا. جسِّد إطار العمل الكامل بتشغيل التثبيت عبره:

npx @ahmed-g-gad/apothem install --harness qwen-code

التحقّق:

npx @ahmed-g-gad/apothem verify --harness qwen-code

7. مدخل سطر الأوامر التمهيدي (مضيف الإضافات)

المتطلّبات المُسبقة: أداته المضيفة على سطر الأوامر، وNode.js 18+، وPython 3.10+ على PATH الخاص بالنظام.

أضِف المستودع بوصفه سوق إضافات، ثم ثبِّت الإضافة — يحمل الأمر المضيف الدقيق ومُعرِّف البيئة:

codex plugin marketplace add ahmed-g-gad/apothem
codex plugin add apothem@apothem

مثل امتدادَي القناة 5 والقناة 6، هذا مدخل تمهيدي يستدعي المحرّك خارجيًّا. جسِّد إطار العمل الكامل بتشغيل التثبيت عبره:

npx @ahmed-g-gad/apothem install --harness codex

التحقّق:

npx @ahmed-g-gad/apothem verify --harness codex

8. المحرّك المباشر (python -m apothem)

المتطلّبات المُسبقة: Python 3.10+ مع إمكانية استيراد حزمتَي click وrich، إضافةً إلى نسخة مسحوبة من المستودع. لا يلزم Node.js.

شغِّل المحرّك المكتفي ذاتيًا مباشرةً من نسخة مستنسَخة — تحمل شجرة الشفرة المصدرية اعتماديّاتها المُضمَّنة، فيكون PYTHONPATH=src هو الإعداد كله:

git clone https://github.com/ahmed-g-gad/apothem
cd apothem
PYTHONPATH=src python -m apothem install --harness claude-code

التحقّق:

PYTHONPATH=src python -m apothem verify --harness claude-code

التحقّق من أي تثبيت

تُسمّي كل قناة أعلاه أمر التحقّق الخاص بها. والصيغتان العامّتان هما:

PYTHONPATH="$HOME/.apothem/src" python -m apothem verify --harness claude-code

npx @ahmed-g-gad/apothem verify --harness claude-code

استبدل اسم إطار العمل بالمحوِّل الذي ثبَّته؛ راجع قائمة أُطُر العمل لكل الأسماء المدعومة. وللتأكُّد من كل محوِّل مُسجَّل دفعةً واحدة، شغِّل apothem doctor (أو npx @ahmed-g-gad/apothem doctor) بالصيغة نفسها. في مسار الإضافة، شغِّل /plugin داخل Claude Code وتأكَّد من ظهور apothem بوصفه مُثبَّتًا.

المتطلّبات المُسبقة بلمحة

• Python 3.10 أو أحدث — يبحث عنه كل مسار يشغّل المحرّك (python3، وpython، والأسماء المُلحَقة بالإصدار، وpy -3 على Windows).
• إمكانية استيراد click وrich تحت ذلك المُفسِّر — وهما الاعتمادان الطرفيان اللذان لا يدمجهما المحرّك. يفحص المثبِّت كليهما، ويُسمّي أيّ اعتماد مفقود، ويعرض تثبيته نيابةً عنك — بتأكيدك، أو تلقائيًا عبر --yes (-Yes على PowerShell) أو APOTHEM_AUTO_INSTALL_DEPS=1.
• Node.js 18 أو أحدث — لمسارَي غلاف npm ومداخل الأدوات فقط.
• Git — لمسار المثبِّت فقط، وللصيغة الشبكية فحسب (يستنسخ البرنامج النصي الشفرة المصدرية؛ لا تحتاج النسخة المسحوبة المحلّية إلى استنساخ).
• Claude Code — لمسار الإضافة فقط. أما VS Code والأداة المضيفة لكل مدخل سطر أوامر تمهيدي فلا تلزم إلا لقناته الخاصة (4–7).

الأدلّة التالية