ورقة غش Cursor (2026): Agent، Ask، قواعد، MCP، واختصارات

أوضاع، ملفات قواعد، إعدادات MCP، واختصارات لمحرّر Cursor. لوحة Agent هي سطح المحادثة: تبحث في الريبو، تحرّر الملفات، وتشغّل الطرفية. مقارنة مع اثنين من وكلاء الترميز الأخرى في Claude Code vs Copilot vs Cursor.

الأوضاع

افتح اللوحة مع Cmd+I (macOS) أو Ctrl+I (Windows و Linux). Shift+Tab يدور الأوضاع. Cmd+. أو Ctrl+. يفتح قائمة الوضع. تبديل يبدأ نافذة سياق نظيفة. وضع Copilot agent هو منتج مختلف.

Plan يحفظ الخطة في دليل بيتك. Save to workspace ينقلها إلى المشروع. انظر spec-driven development. بينما Agent يعمل، Enter يضع الملاحظة التالية في قائمة انتظار. على macOS، Cmd+Enter يرسلها الآن. Restore Checkpoint يرجع الملفات ويحافظ على النسخة.

Tab والاختصار المضمّن القديم

Tab ينهي من التحريرات الأخيرة، الكود القريب، وأخطاء linter، مُظهرة كنص رمادي. يمكن أن يتغيّر عدة أسطر، أضف استيراد، أو قفز إلى ملف آخر (بوابة تظهر في أسفل المحرّر). Tab مرة أخرى، بعد قبول، ينتقل إلى التحرير المتنبأ به التالي. القواعس لا تؤثر على Tab. غط أو عطّله من مؤشر Tab في أسفل اليمين.

صفحة مساعدة التحرير المضمّن القديم تصف الآن Agent. مع كود محدد، Cmd+K أو Ctrl+K يفتح Agent مع تلك الأسطر. Cmd+L و Ctrl+L تفعل الشيء نفسه. الوثائق تقول Cmd+K اعتادت فتح تحرير مضمّن وتم استبدال هذا. نفس المفاتيح أيضًا تبدّل اللوحة الجانبية عندما لا تكون مرتبطة بوضع. في نافذة Agents، Cmd+K أو Ctrl+K يفتح لوحة الأوامر للنسخ الماضية. Cmd+F أو Ctrl+F يبحث في المحادثة المفتوحة.

@ mentions

اكتب @ واستمر في الكتابة للتصفية. تخطّيه عندما لا تعرف الملف. Agent سيبحث. كرّر @ لإضافة أكثر من عنصر واحد. / يشغّل مهارة لرسالة واحدة. Option+Enter (macOS) أو Alt+Enter (Windows) يحافظ على تلك المهارة كـ Custom Mode.

Agent يمكنه البحث في الويب مع أداة Web الخاصة به. هذا ليس @ mention. وثائق mention الحالية لا تسرد @Docs أو @Web.

القواعس و AGENTS.md

القواعس تعليمات في بداية سياق الموديل. قواعس المشروع والمستخدم والفريق تطبّق في Agent، Ask، Plan، و Debug. لا تطبّق على Tab، و .cursor/rules ليس ما يقرأه Bugbot.

قواعس المشروع هي ملفات .mdc في .cursor/rules، بما فيها المجلدات الفرعية. ملف .md هناك يُتجاهل. التزم المجلد. أنشئ واحدًا مع New Cursor Rule في لوحة الأوامر (Cmd+Shift+P أو Ctrl+Shift+P)، من Customize، أو مع /create-rule.

افصل globs مع فواصل. احتفظ بقاعدة تحت 500 سطر. مسار مثل @service-template.ts يشير Agent إلى ملف. الملف لا يُضمّن، لذلك أي شيء يجب أن يكون موجودًا دائمًا يذهب إلى جسم القاعدة.

---
description: How this repo runs tests
alwaysApply: false
---

- Run tests with `npm test` from the repository root
- Do not edit anything under `dist/` or `build/`

AGENTS.md هو Markdown عادي، في الجذر أو في مجلد فرعي. الملفات المتداخلة تطبّق تحت هذا الدليل، تجمّع مع الآباء، والملف الأقرب يفوز. Cursor يقرأ CLAUDE.md نفس الطريقة ودائمًا يطبّقه، متجاهلاً alwaysApply. هذا يتداخل مع Claude Code.

قواعس المستخدم في Customize، Rules، تزامن مع حسابك. الملفات في ~/.cursor/rules (على Windows، %USERPROFILE%\.cursor\rules) تبقى على تلك الآلة. Team Rules تأتي من لوحة التحكم على خطط Team و Enterprise. على تضارب الترتيب هو Team، ثم Project، ثم User.

.cursorrules في جذر المشروع قديم وسيُستهلك. ألصقها إلى قاعدة Always Apply واحذف الملف القديم.

MCP

MCP يربط Agent بأدوات خارجية. إعدادات ليست Cursor-محددة في MCP servers explained. Cursor يدعم محلي stdio، SSE، و Streamable HTTP. Agent يستدعي أداة عندما تكون ذات صلة، بما فيها في Plan Mode، ويسأل أولاً إلا إذا كان Run Mode يسمح بالاستدعاء. بدّل الخوادم من Customize. السجلات تحت MCP Logs في لوحة Output (Cmd+Shift+U على macOS).

إدخال محلي يعيّن command، args، و env. إدخال بعيد يعيّن url و optional headers. فقط stdio يقبل envFile. القيم يمكن أن تستخدم ${env:NAME} و ${workspaceFolder}. CLI يقرأ نفس الملف. حلقات الأداة هي النمط في agentic AI.

{
  "mcpServers": {
    "repo-tools": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "${env:API_KEY}"
      }
    }
  }
}

Cloud Agents و Bugbot

Cloud Agents تُسمّى Background Agents. تعمل في VM معزولة وتستطيع فتح pull request. ابدأ من Cloud تحت مدخل الـ agent، من cursor.com/agents، أو مع @cursor في Slack، Linear، GitHub، أو Bitbucket. في CLI، أضف بادئة & للرسالة. اعتبارًا من أكتوبر 2026، الوثائق تتطلب Premium أو أعلى، Teams، Enterprise، أو خطة مدفوعة قديمة. Free و Plus لا يشملانها. Tab لا يعمل في السحابة.

Bugbot يعقّب على تفاصيل pull-request، على كل تحديث أو بعد cursor review أو bugbot run. حساب بوت أو GitHub App ينشرها يُتجاهل. .cursor/rules لا تطبّق. ضع ملاحظات المراجعة في .cursor/BUGBOT.md. ملف الجذر يُضمّن دائمًا. ملف متداخل يطبّق عندما مسارات متغيّرة تجلس تحته. إعدادات اختيارية تعيش في .cursor/config/bugbot.yaml على فرع الأساس.

/review و /review-bugbot، في Cursor 3.7+، على cursor.com/agents، وفي CLI، مراجع فرق diff ضد الأساس الافتراضي، بما فيها التحريرات غير الملتزمة.

CLI

الأمر الموثّق هو agent.

agent --version و agent update يتحقق ويرقّي CLI. على macOS، Linux، أو WSL، أضف ~/.local/bin إلى PATH إذا agent مفقود. /summarize يضغط السياق (/compress هي بديل). Ctrl+J يدرج سطر جديد. Ctrl+D يخرج على الضغط الثاني. CLI يحمل .cursor/rules بالإضافة إلى AGENTS.md و CLAUDE.md الجذر. Debug هو محرّر-فقط.

الموديلات و Privacy Mode

Cmd+/ أو Ctrl+/ يدور الموديلات. على macOS، Cmd+Option+/ يبدّل الموديل. الخيار عصا حتى تتغيّره. Auto يستخدم Cursor Router ويمكن تغيير الموديل بين الأدوار.

اعتبارًا من أكتوبر 2026، Free و Plus تشمل Grok 4.7، Grok 4.6، Grok 4.5، و Composer 2.5. Premium وأعلى، Teams، Enterprise، والأشياء القديمة Pro، Pro+، و Ultra فتح موديلات الجهات الخارجية.

Privacy Mode يبقي الكود خارج التدريب بواسطة Cursor وبواسطة مزوّدي الموديل. فعّله تحت General في الإعدادات (Cmd+Shift+J أو Ctrl+Shift+J). فرق Enterprise لديها تفعيل افتراضي، وإداري يمكنه قفله. مفاتيح API الخاصة بك تتابع سياسة الموفّر. الموديلات التي تتطلب احتفاظ بيانات الموفّر تبقى متوقفة حتى يوافق إداري عليها.

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

افتح الخريطة الكاملة مع Cmd+R ثم Cmd+S، أو Ctrl+R ثم Ctrl+S. أوتار Windows أدناه فقط تلك التي تطبع صفحة مساعدة.

أنماط ستعيد استخدامها

Shift+Tab to Ask when the answer must not touch files
Shift+Tab to Plan, edit the plan, then build
Select the failing test, press Ctrl+L, and name the fix
Tab accepts, Escape skips, Ctrl+Right takes one word
Put repeated instructions in .cursor/rules/*.mdc and tokens in ${env:API_KEY}
agent --mode=ask -p "list failing tests and their files"
Prefix & when the run should continue after the laptop closes

سمّ الملف وما يعني “تم”. نفس العادة في ChatGPT prompting cheat sheet. اختبار فاشل قبل التحرير هو الحلقة في AI-assisted TDD.

الأسئلة الشائعة

هل Chat وضع منفصل عن Agent في Cursor؟

الوثائق الحالية تصف لوحة Agent واحدة، تُسمى أيضًا Agent Chat، وأربعة أوضاع داخلها: Agent، Ask، Plan، و Debug. لا يوجد وضع Chat منفصل في تلك القائمة. افتح اللوحة مع Cmd+I أو Ctrl+I، ثم بدّل مع Shift+Tab أو picker الوضع. تبديل الأوضاع يبدأ نافذة سياق نظيفة.

أين تعيش قواعد مشروع Cursor، وماذا يجب أن أفعل مع .cursorrules؟

قواعد المشروع هي ملفات .mdc في .cursor/rules. ملف .md عادي في هذا المجلد يُتجاهل. قواعس المستخدم تعيش في Customize، Rules، وتزامن مع حسابك؛ الملفات تحت ~/.cursor/rules تبقى على تلك الآلة. .cursorrules في جذر الريبو قديم. انسخها إلى قاعدة Always Apply، ثم احذف الملف القديم.

ماذا تفعل Cmd+K أو Ctrl+K في Cursor الآن؟

مع كود محدد، Cmd+K أو Ctrl+K يفتح Agent مع تلك الأسطر في المدخل. Cmd+L و Ctrl+L تفعل الشيء نفسه. وثائق المساعدة تقول Cmd+K اعتادت فتح تحرير مضمّن وتم استبدال هذا السير. نفس المفاتيح أيضًا تبدّل اللوحة الجانبية عندما لا تكون مرتبطة بوضع.

كيف أضيف خادم MCP في Cursor؟

ضع خادم ريبو في .cursor/mcp.json أو خادم شخصي في ~/.cursor/mcp.json. خادم محلي يعيّن command، args، و env. خادم بعيد يعيّن url و optional headers. CLI يقرأ نفس mcp.json. بدّل الخوادم من Customize.

كيف أشغّل Cursor Agent من الطرفية؟

ثبّت السكريبت الرسمي، ثم شغّل agent. Shift+Tab يدور Agent، Plan، و Ask. /plan و /ask يبدّلان الأوضاع، و agent -p يشغّل موجّه واحد ويخرج. أضف بادئة & للرسالة لتسليم تلك المهمة إلى Cloud Agent واختره على cursor.com/agents.