دليل إعداد Cursor

الملخص: يُحمِّل ملف .cursorrules سياق Rediacc في ذاكرة Cursor الذكية، بينما تتيح له الطرفية تشغيل أوامر rdc على أجهزتك الفعلية.

الإعداد السريع

1. ثبّت أداة CLI: curl -fsSL https://www.rediacc.com/install.sh | bash
2. انسخ قالب AGENTS.md إلى جذر مشروعك كملف .cursorrules
3. افتح المشروع في Cursor

يقرأ Cursor ملف .cursorrules عند بدء التشغيل. المهم هنا أن حدود نافذة السياق تنطبق، لذا احرص على أن يكون الملف مركّزًا على أجهزتك ومستودعاتك الفعلية بدلًا من نصوص عامة.

تهيئة .cursorrules

أنشئ ملف .cursorrules في جذر مشروعك مع سياق بنية Rediacc التحتية. راجع قالب AGENTS.md الكامل للحصول على النسخة الكاملة.

الأقسام الرئيسية التي يجب تضمينها:

• اسم أداة CLI (rdc) والتثبيت
• الأوامر الشائعة مع علم --output json
• نظرة عامة على البنية (عزل المستودعات، Docker daemons)
• قواعد المصطلحات (محولات، وليس أوضاع)

تكامل الطرفية

يمكن لـ Cursor تنفيذ أوامر rdc من خلال طرفيته المدمجة. الأنماط الشائعة:

فحص الحالة

اسأل Cursor: “تحقق من حالة خادم الإنتاج”

يُنفّذ Cursor في الطرفية:

rdc machine status prod-1 -o json

نشر التغييرات

اسأل Cursor: “انشر تهيئة nextcloud المحدّثة”

يُنفّذ Cursor في الطرفية:

rdc repo up nextcloud@prod-1 --yes

عرض السجلات

اسأل Cursor: “أرني سجلات حاوية mail الأخيرة”

يُنفّذ Cursor في الطرفية:

rdc repo logs mail@prod-1 -c mail-postfix --lines 100

إعدادات مساحة العمل

للمشاريع الجماعية، أضف إعدادات Cursor الخاصة بـ Rediacc إلى .cursor/settings.json:

{
  "terminal.defaultProfile": "bash",
  "ai.customInstructions": "Use rdc CLI for all infrastructure operations. Always use --output json when parsing results."
}

نصائح

• وضع Composer في Cursor يعمل بشكل جيد للمهام التحتية متعددة الخطوات
• استخدم @terminal في محادثة Cursor للإشارة إلى مخرجات الطرفية الأخيرة
• يمنح أمر rdc --help-all لـ Cursor مرجعًا كاملاً للأوامر
• ادمج .cursorrules مع ملف CLAUDE.md لتحقيق أقصى توافق عبر أدوات الذكاء الاصطناعي