Zed
محوّل إطار عمل Apothem لـ Zed (GA).
المورّد: Zed Industries
اسم التثبيت: zed
الحالة: GA
الإعداد الأصلي: <project>/.rules
التثبيت
apothem install --harness zed --project /path/to/projectيكتب المحوّل ملفّ تعليمات Zed واحدًا بنطاق المشروع من سطح القواعد
والحوكمة المشترك لـApothem. يقرأ Zed ملفًّا مسطّحًا واحدًا
باسم .rules في جذر المشروع (إلى جانب عائلة AGENTS.md /
CLAUDE.md) بوصفه تعليمات؛ ولا يوجد دليل قواعد لكل أداة، لذا يحطّ سطح
Apothem بأكمله في هذا الملف الواحد.
الملفات المكتوبة: <project>/.rules
تعيين الملف التعريفي إلى الإعداد الأصلي
يقرأ المحوّل الملف التعريفي المشترك لـApothem ويصيّر ملفّ
.rules للمشروع في كل عملية apothem install أو
apothem update. الملف التعريفي المشترك هو مصدر الحقيقة؛ وتُحفَظ نسخة
احتياطية من أي ملفّ .rules موجود مسبقًا (أو التعديلات المحلية للمشروع
على الملف المُولَّد) قبل أن تستبدل المزامنة التالية المحتوى المُدار بواسطة
Apothem.
ملاحظات التوافق
سطح التعليمات الحالي لـZed هو ملفّ .rules المسطّح في جذر
المشروع. ملفّ التعليمات العام ~/.config/zed/AGENTS.md وكتلة خوادم سياق
MCP (context_servers في .zed/settings.json)
يملكهما المشغّل؛ ولا يكتبهما Apothem.
التحقّق
apothem verify --harness zed --project /path/to/projectيؤكّد أمر التحقّق ما يلي:
- وجود الإعداد الأصلي في المسار المتوقَّع.
- وجود جميع الحقول الإلزامية من الملف التعريفي المشترك.
- إبلاغ روتين التحقّق الخاص بالمحوّل عن النجاح.
التحديث
apothem update --harness zed --project /path/to/projectيعيد اشتقاق ملفّ .rules للمشروع من حالة الملف التعريفي المشترك الحالية.
إلغاء التثبيت
apothem uninstall --harness zed --project /path/to/projectيزيل ملفّ الإعداد الأصلي الذي كتبه المحوّل، مع إعادة تسميته أولًا إلى نسخة احتياطية ذات طابع زمني. لا يتأثّر YAML الملف التعريفي المشترك ولا محرّك Apothem.
بوّابة المطابقة
python -m apothem.conformity.gate --all .استكشاف الأخطاء وإصلاحها
| العَرَض | الإصلاح |
|---|---|
| ملف الإعداد غير موجود | أعد تشغيل apothem install --harness zed --project /path/to/project |
| فشل التحقّق | شغّل apothem update --harness zed --project /path/to/project، ثم تحقّق مجدّدًا |
| محتوى إعداد غير متوقَّع | تحقّق من ~/.config/apothem/profile.yaml أو --profile PATH، ثم أعد تشغيل apothem update --harness zed --project /path/to/project |
مفاتيح الضبط
| العَلَم | الافتراضي | الوصف |
|---|---|---|
--dry-run | false | معاينة التثبيت دون كتابة ملفات. |