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