المؤشر

المؤشر هو محرر تعليمات برمجية مدعوم بالذكاء الاصطناعي مبني على VS Code يدمج قدرات متقدمة للذكاء الاصطناعي للتوليد والتحرير وتصحيح الأخطاء في التعليمات البرمجية مع دعم نماذج الذكاء الاصطناعي المتعددة بما في ذلك GPT-4 و Claude.

التثبيت والإعداد

أمر	وصف
Download from cursor.sh	قم بتثبيت Cursor من الموقع الرسمي
cursor --version	تحقق من الإصدار المثبت
cursor .	افتح المجلد الحالي في Cursor
cursor file.py	افتح ملف محدد
cursor --help	عرض معلومات المساعدة
cursor --extensions-dir	إظهار دليل الامتدادات

الميزات الأساسية للذكاء الاصطناعي

اختصار	وصف
Ctrl+K / Cmd+K	لوحة أوامر Open AI
Ctrl+L / Cmd+L	لوحة محادثة Open AI
Ctrl+I / Cmd+I	التحرير بالذكاء الاصطناعي المضمّن
Tab	قبول اقتراح الذكاء الاصطناعي
Escape	رفض اقتراح الذكاء الاصطناعي
Alt+] / Option+]	الاقتراح التالي للذكاء الاصطناعي
Alt+[ / Option+[	الاقتراح السابق للذكاء الاصطناعي

أوامر الدردشة بالذكاء الاصطناعي

أمر	وصف
@workspace	الإشارة إلى مساحة العمل بالكامل
@file	إشارة إلى ملف محدد
@folder	محتويات مجلد المراجع
@code	المرجع المحدد للكود
@docs	توثيق المرجع
@web	ابحث في الويب للحصول على السياق
@git	مراجعة تاريخ git

توليد التعليمات البرمجية

التوليد المضمّن

اختصار	وصف
Ctrl+K then type prompt	قم بإنشاء الكود مضمّنًا
Ctrl+K then Ctrl+A	قم بإنشاء الملف بالكامل
Ctrl+K then Ctrl+D	إنشاء توثيق
Ctrl+K then Ctrl+T	قم بإنشاء اختبارات
Ctrl+K then Ctrl+R	إعادة هيكلة الكود
Ctrl+K then Ctrl+F	إصلاح مشاكل الكود

التوليد القائم على الدردشة

أمر	وصف
”Create a function that…”	إنشاء دالة محددة
”Add error handling to this code”	تحسين الكود الموجود
”Convert this to TypeScript”	تحويل اللغة
”Optimize this algorithm”	تحسين الأداء
”Add comments to explain this”	توليد الوثائق

تحرير التعليمات البرمجية

التحرير القائم على التحديد

اختصار	وصف
Select code + Ctrl+K	تحرير الكود المحدد
Select code + Ctrl+I	تحرير الاختيار مضمّن
Ctrl+Shift+K	التحرير مع السياق
Alt+K	تحرير سريع

التحرير متعدد المؤشرات

اختصار	وصف
Ctrl+Alt+Down / Cmd+Option+Down	أضف المؤشر أدناه
Ctrl+Alt+Up / Cmd+Option+Up	أضف المؤشر أعلى
Ctrl+D / Cmd+D	حدد التكرار التالي
Ctrl+Shift+L / Cmd+Shift+L	حدد كل التكرارات

تكوين نماذج الذكاء الاصطناعي

الإعداد	وصف
GPT-4	النموذج الافتراضي للمهام المعقدة
GPT-3.5-turbo	نموذج أسرع للمهام البسيطة
Claude-3	نموذج بديل للبرمجة
Codex	مخصص لتوليد التعليمات البرمجية
Custom models	قم بتكوين النماذج المحلية أو المخصصة

ميزات مساحة العمل

إدارة الملفات

اختصار	وصف
Ctrl+P / Cmd+P	فتح ملف سريع
Ctrl+Shift+P / Cmd+Shift+P	لوحة الأوامر
Ctrl+Shift+E / Cmd+Shift+E	لوحة المستكشف
Ctrl+Shift+F / Cmd+Shift+F	البحث عبر الملفات
Ctrl+Shift+G / Cmd+Shift+G	التحكم في المصدر

البحث المعزز بالذكاء الاصطناعي

أمر	وصف
@search "semantic query"	البحث الدلالي في الكود
@find "natural language"	البحث عن الملفات باللغة الطبيعية
@grep "pattern with AI"	grep محسّن بالذكاء الاصطناعي

تصحيح الأخطاء بالذكاء الاصطناعي

ميزة	وصف
AI Debug Assistant	شرح مخرجات التصحيح
Error Explanation	يشرح الذكاء الاصطناعي رسائل الخطأ
Fix Suggestions	يقترح الذكاء الاصطناعي إصلاحات للأخطاء
Breakpoint Analysis	يحلل الذكاء الاصطناعي سياق نقطة التوقف

أوامر التصحيح

اختصار	وصف
F5	ابدأ تصحيح الأخطاء
F9	تبديل نقطة التوقف
F10	تجاوز
F11	انتقل إلى
Shift+F11	اخرج
Ctrl+Shift+F5	إعادة تشغيل التصحيح

التكامل مع Git

أمر	وصف
@git diff	يشرح الذكاء الاصطناعي اختلافات Git
@git commit	إنشاء رسائل commit
@git branch	اقتراح أسماء الفروع
@git merge	المساعدة في حل تعارضات الدمج

اختصارات Git

اختصار	وصف
Ctrl+Shift+G / Cmd+Shift+G	لوحة التحكم في التحكم بالمصدر
Ctrl+Enter / Cmd+Enter	التزم بالتغييرات
Ctrl+Shift+P then “Git”`	أوامر Git

الامتدادات والتخصيص

الامتدادات الشائعة

امتداد	وصف
Cursor AI	الوظائف الأساسية للذكاء الاصطناعي
GitHub Copilot	مساعدة الذكاء الاصطناعي الإضافية
Prettier	تنسيق الكود
ESLint	JavaScript التنظيف
Python	دعم لغة Python
Live Share	التعاون في الوقت الفعلي

إعدادات التكوين

الإعداد	وصف
cursor.ai.model	النموذج الافتراضي للذكاء الاصطناعي
cursor.ai.temperature	مستوى الإبداع في الذكاء الاصطناعي
cursor.ai.maxTokens	الحد الأقصى لطول الاستجابة
cursor.ai.autoComplete	تفعيل الإكمال التلقائي
cursor.ai.inlineChat	تمكين الدردشة المضمنة

الميزات المتقدمة

وضع المؤلف

ميزة	وصف
Multi-file editing	تحرير عدة ملفات في وقت واحد
Project-wide changes	تطبيق التغييرات على المشروع بالكامل
Dependency tracking	تتبع التبعيات الملفية
Batch operations	قم بإجراء عمليات جماعية

وكلاء الذكاء الاصطناعي

وكيل	وصف
Code Agent	مخصص لمهام البرمجة
Debug Agent	مركز على تصحيح الأخطاء
Test Agent	يولد ويشغل الاختبارات
Docs Agent	يُنشئ توثيقًا
Refactor Agent	متخصص إعادة هيكلة الكود

الميزات الخاصة باللغات البرمجية

Python

أمر	وصف
@python "create class"	إنشاء فئات Python
@python "add type hints"	أضف تعليقات النوع
@python "create tests"	قم بإنشاء اختبارات pytest
@python "optimize"	تحسين الأداء

JavaScript/TypeScript

جافا سكريبت/تايب سكريبت

أمر	وصف
@js "create component"	إنشاء مكونات React
@ts "add types"	أضف أنواع TypeScript
@js "async/await"	تحويل إلى async/await
@js "error handling"	أضف معالجة الأخطاء

Other Languages

لغات أخرى

أمر	وصف
@rust "safe code"	إنشاء كود Rust آمن
@go "concurrent"	أنماط التزامن في Go
@java "spring boot"	تطبيقات Spring Boot
@cpp "modern cpp"	ميزات C++ الحديثة

Productivity Tips

نصائح الإنتاجية

قالب	وصف
@template api	قالب REST API
@template component	قالب مكون واجهة المستخدم
@template test	قالب ملف الاختبار
@template config	قالب التكوين

Code Templates

قوالب الكود

ميزة	وصف
Auto-save	الحفظ التلقائي للملفات
Format on save	تنسيق التعليمات البرمجية تلقائيًا
Lint on save	التحقق التلقائي من التنسيق (Auto-lint code)
AI suggestions	اقتراحات استباقية

Workflow Automation

أتمتة سير العمل

ميزة	وصف
Live Share	التعاون في الوقت الفعلي
AI Pair Programming	الذكاء الاصطناعي كشريك في البرمجة
Code Reviews	مراجعات مدعومة بالذكاء الاصطناعي
Team Settings	إعدادات AI المشتركة

Collaboration Features

ميزات التعاون

اختصار	وصف
Ctrl+Shift+P then “Live Share”`	ابدأ جلسة التعاون
Ctrl+Shift+P then “Share”`	مشاركة مساحة العمل

Sharing Commands

أوامر المشاركة

الإعداد	وصف
cursor.ai.cacheSize	حجم ذاكرة التخزين المؤقت للاستجابة الذكية
cursor.ai.requestTimeout	انتهى وقت الطلب
cursor.ai.batchSize	حجم طلب الدفعة
cursor.ai.throttle	تقييد الطلبات

Performance Optimization

تحسين الأداء

مشكلة	حل
AI not responding	تحقق من اتصال الإنترنت
Slow responses	تقليل حجم السياق
Wrong suggestions	قدم المزيد من السياق
Model errors	تبديل نموذج الذكاء الاصطناعي
Extension conflicts	تعطيل الامتدادات المتعارضة

Troubleshooting

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

أمر	وصف
Ctrl+Shift+P then “Developer: Reload Window”`	إعادة تحميل المؤشر
Ctrl+Shift+P then “Developer: Toggle Developer Tools”`	افتح أدوات المطورين
Help > Show All Commands	اعرض جميع الأوامر المتاحة

Debug Commands

أوامر التصحيح

{
  "cursor.ai.customModels": [
    {
      "name": "Local Model",
      "endpoint": "http://localhost:8000",
      "apiKey": "your-api-key"
    }
  ]
}

API Integration

تكامل واجهة برمجة التطبيقات (API)

{
  "cursor.ai.webhooks": {
    "onCodeGeneration": "https://your-webhook.com/code",
    "onError": "https://your-webhook.com/error"
  }
}

Custom Models

نماذج مخصصة

اختصار	إجراء
Ctrl+K	أمر الذكاء الاصطناعي
Ctrl+L	الدردشة بالذكاء الاصطناعي
Ctrl+I	التحرير المضمّن
Tab	قبول الاقتراح
Escape	رفض الاقتراح
Ctrl+/	تبديل التعليق
Ctrl+S	احفظ الملف
Ctrl+Z	التراجع
Ctrl+Y	أعد

Webhook Configuration

إعداد الويب هوك

اختصار	إجراء
Ctrl+P	فتح سريع
Ctrl+G	انتقل إلى السطر
Ctrl+F	اعثر
Ctrl+H	استبدال
F12	انتقل إلى التعريف
Alt+F12	تعريف Peek

Keyboard Shortcuts Summary

ملخص اختصارات لوحة المفاتيح

# GitHub Actions with Cursor
name: AI Code Review
on: [pull_request]
jobs:
  ai-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: AI Code Review
        run: cursor-cli review --pr ${{ github.event.number }}

Essential Shortcuts

الاختصارات الأساسية

#!/bin/bash
# Cursor automation script
cursor --ai-command "review and optimize" src/
cursor --ai-command "generate tests" src/
cursor --ai-command "update documentation" docs/

Navigation

التنقل