Zed

المورّد: Zed Industries اسم التثبيت: zed الحالة: إصدار عام الإعداد الأصلي: <project>/.rules

التثبيتCopy Anchor Link

apothem install --harness zed --project /path/to/project

يكتب المحوّل ملف تعليمات واحدًا لـ Zed على نطاق المشروع انطلاقًا من القواعد المشتركة لـ Apothem وسطح الحوكمة. يقرأ Zed ملف تعليمات واحدًا للمشروع، هو أول تطابق في هذه القائمة:

.rules
.cursorrules
.windsurfrules
.clinerules
.github/copilot-instructions.md
AGENT.md
AGENTS.md
CLAUDE.md
GEMINI.md

لا يوجد دليل قواعد لكل أداة، لذا يستقرّ سطح Apothem بأكمله في الملف المسطّح .rules الذي يتصدّر تلك القائمة.

ويكتب أيضًا مهارات Apothem، والقواعد والقوالب التي تستشهد بها، في دليلك المنزلي، قبل أن يمسّ المشروع (راجع الملفات خارج المشروع).

الملفات المكتوبة:

• <project>/.rules، ملف التعليمات.
• ~/.agents/skills/<name>/SKILL.md لكل مهارة وأمر من Apothem، في دليلك المنزلي.
• ~/.config/apothem/rules/ و~/.config/apothem/templates/، في دليلك المنزلي.

الملفات خارج المشروعCopy Anchor Link

يكتب التثبيت أيضًا مهارات Apothem في دليلك المنزلي، قبل أن يغيّر أي شيء في المشروع:

هذه المجلّدات مشتركة، وليست خاصة بالمشروع:

• كل مشروع تثبّت فيه zed، وكل تثبيت آخر لـ Apothem يسمّي المجلّد، يستخدم النسخة نفسها ويكتب الملفات نفسها، لذا لا يهمّ الترتيب الذي تثبّت به. وتقرأ أدوات أخرى عديدة ~/.agents/skills/ أيضًا؛ ويسردها سجلّ أُطُر العمل.
• يختار --project ملف التعليمات الذي يُكتَب والمشروعَ الذي ينتمي إليه التثبيت. ولا يغيّر المكان الذي تذهب إليه المهارات.
• لا يضيف التثبيت أي ملف مهارة أو قاعدة إلى مستودعك. ويحصل المشروع على ملف التعليمات، إضافةً إلى مجلّد البيانات .apothem/ الذي يُنشئه كل تثبيت على مستوى المشروع.
• تُكتَب المجلّدات المنزلية أولًا. فإن فشل ذلك، مثلًا لأن مجلّدًا في المسار رابطٌ يخرج من دليلك المنزلي (أما الرابط الذي يبقى داخله فيُتَّبَع) أو لا يمكن الكتابة فيه، يتوقّف التثبيت مع الخطأ قبل أن يتغيّر أي شيء في المشروع.
• مجلّد المهارة الذي يحمل اسم مهارة من Apothem ولم يكتبه Apothem يُترَك كما هو، ويطبع التثبيت تحذيرًا يسمّيه. أعد تسميته أو انقله، ثم شغّل apothem update. ويفشل apothem verify ما دام ذلك الاسم محجوزًا.
• يبلغ مجموع الملفات بضعة ميغابايتات.

يطبع التثبيت ملاحظة تسمّي المجلّدات التي يكتبها خارج --project، ويسردها --dry-run.

تعيين الملف التعريفي إلى الإعداد الأصليCopy Anchor Link

يقرأ المحوّل الملف التعريفي المشترك لـ Apothem ويُجسِّد ملف .rules الخاص بالمشروع في كل تشغيل لـ apothem install أو apothem update. الملف التعريفي المشترك هو مصدر الحقيقة؛ ويُنسَخ أي ملف .rules موجود مسبقًا (أو التعديلات المحلّية للمشروع على الملف المُولَّد) احتياطيًا قبل أن تستبدل المزامنة التالية المحتوى الذي يديره Apothem.

ملاحظات التوافقCopy Anchor Link

يُسمّي Zed ملف AGENTS.md ملفَّ تعليماته الأساسي، ويُبقي ملف .rules الخاص بالمشروع ملفَّ توافق مدعومًا (تعليمات Zed). ولأن Zed لا يقرأ إلا التطابق الأول، فإن ملف .rules جديدًا يحجب ملف AGENTS.md أو ملف CLAUDE.md أو أي ملف آخر أدنى في القائمة يعتمد عليه المشروع بالفعل. لا يُحرِّر التثبيت تلك الملفات أبدًا. عندما لا يحتوي .rules إلا على كتلة Apothem ويحتوي ملف أدنى أولوية على نصّك، يطبع التثبيت والتحديث تحذيرًا يُسمّي الملف المحجوب؛ انسخ التعليمات التي تحتاجها إلى .rules خارج كتلة Apothem لتُبقيها في Zed.

ملف التعليمات العام ~/.config/zed/AGENTS.md وكتلة خوادم سياق MCP (.zed/settings.json context_servers) يملكهما المُشغِّل؛ ولا يكتبهما Apothem.

لا يُحمِّل Zed المهارات العامّة إلا من ~/.agents/skills/، بتخطيط مسطّح فيه مجلّد واحد لكل مهارة، وهو التخطيط الذي يكتبه التثبيت. ويشترط Zed لتحميل المهارات المحلّية للمشروع شجرةَ عمل موثوقة، ولا تربط وثائقه أي شرط كهذا بالمجلّد العام. وذكر أحد التقارير حدًّا لحجم فهرس المهارات الذي يرسله Zed إلى النموذج؛ ولم يؤكّده Apothem، ولا ما إذا كانت المهارة التي توقف استدعاء النموذج تُحتسَب ضمنه. ويبلغ مجموع أسماء مهارات Apothem وأوصافها نحو 20 كيلوبايت. ولم يؤكّد Apothem كذلك كيفية تعامل Zed مع مفتاح ترويسة في SKILL.md لا يسرده.

التحقّقCopy Anchor Link

apothem verify --harness zed --project /path/to/project

يؤكّد أمر التحقّق ما يلي:

1. الإعداد الأصلي موجود في المسار المتوقَّع.
2. كل هدف مُدار موجود؛ والملفات المُدارة غير فارغة، وتُحلَّل إعدادات JSON أو YAML. أضِف --profile PATH لتتحقّق كذلك من أن الملفات المثبّتة تطابق ذلك الملف التعريفي.
3. كل مجلّد مهارة من Apothem في مكانه ومعه SKILL.md، أيًّا كان التثبيت الذي كتبه، ولا يوجد مجلّد مهارة يحمل اسمًا من Apothem ويعود إلى شيء لم يكتبه Apothem. ويسمّي الفحص الفاشل المجلّدات المفقودة أو الدخيلة.
4. روتين التحقّق الخاص بالمحوّل يُبلِغ عن النجاح.

التحديثCopy Anchor Link

apothem update --harness zed --project /path/to/project

يُعيد اشتقاق ملف .rules الخاص بالمشروع من الحالة الراهنة للملف التعريفي المشترك.

ويُعيد التحديث أيضًا كتابة أي مجلّد مهارة تختلف ملفاته عن الملفات الحالية. وإن كنت قد ثبّتّ بإصدار سابق لم يكتب أي مهارات، فإن التحديث يضيفها.

إلغاء التثبيتCopy Anchor Link

apothem uninstall --harness zed --project /path/to/project

يُزيل الكتلة المُدارة الخاصة بـ Apothem من ملف الإعداد الأصلي .rules ويُبقي نصّك الخاص. ولا يُحذف الملف إلا إذا لم يبقَ فيه شيء آخر. وقبل التغيير تُحفَظ نسخة من الملف بطابع زمني تحت ~/.apothem/backups/؛ ولا تبقى أي نسخة احتياطية في المشروع. ولا يتأثّر ملف YAML الخاص بالملف التعريفي المشترك ولا محرّك Apothem.

ويُزيل إلغاء التثبيت أيضًا مجلّدات المهارات التي كتبها في ~/.agents/skills/ والقواعد والقوالب في ~/.config/apothem/، ولكن فقط حين لا يعود أي تثبيت آخر لـ Apothem يستخدمها. فقد يستخدمها مشروع آخر، أو أداة أخرى تشارك المجلّد. وفي تلك الحالة يُبقي إلغاء التثبيت المجلّدات، ويطبع التثبيت الذي يستخدمها، ويُزيلها آخر إلغاء تثبيت. وتبقى الملفات التي أضفتها إلى تلك المجلّدات، ويُزال المجلّد الذي يبقى فارغًا. ويُنسَخ كل مجلّد احتياطيًا تحت ~/.apothem/backups/ قبل إزالته.

بوابة المطابقةCopy Anchor Link

python -m apothem.conformity.gate --all .

استكشاف الأخطاء وإصلاحهاCopy Anchor Link

مفاتيح الضبطCopy Anchor Link

انظر أيضًاCopy Anchor Link

• كل أُطُر العمل — الفهرس الكامل للأدوات المدعومة
• دليل التثبيت — ثبّت Apothem في إطار العمل هذا
• مرجع apothem harnesses — اسرد المحوّلات وافحصها من واجهة سطر الأوامر