لمستخدمي Cline

‏Cline يخطط قبل أن يتصرف. امنح الخطة خريطة.

يقرأ Cline الملفات ويشغّل الأوامر ويسأل قبل أن يغيّر أي شيء. تفهرس Maguyva المستودع كله وتعيده عبر MCP، فيبدأ وضع Plan من مواقع استدعاء حقيقية بدل قائمة مجلدات.

ابدأ مجانًا اقرأ دليل إعداد Cline

خطة Free: 3 مستودعات, حتى 50 ألف سطر مُفهرَس من المستودع، بلا بطاقة.

استخدم ‎.clinerules لطريقة العمل، وMaguyva لما يقوله الكود الآن.

ما يجب معرفته عن Cline

أربع حقائق خاصة بـCline.

‏// ملف الإعداد

cline_mcp_settings.json

افتحه من أيقونة MCP Servers في لوحة Cline: تبويب Configure، ثم Configure MCP Servers. توضع الخوادم تحت mcpServers.

‏// النقل

بعيد، عبر URL

يتصل Cline بنقطة نهاية Maguyva عبر Streamable HTTP. لا عملية محلية ولا Node.js.

‏// المفتاح

ترويسة حرفية

يوضع المفتاح مباشرة في ترويسة Authorization، كما في أمثلة Cline نفسه. يقع ملف الإعدادات في تخزين المستخدم الخاص بمحررك، لا في مستودعك.

‏// النوع

‏streamableHttp، لا SSE

أبقِ "type": "streamableHttp" في الإدخال: من دون نوع، يفترض Cline بروتوكول SSE القديم. اسرد الأدوات التي تثق بها في autoApprove لتخطي طلب الموافقة عليها.

قواعد Cline اتفاق عمل. استخدمها.

# .clinerules/testing.md
- شغّل مجموعة الاختبارات قبل أن تعلّم المهمة كمكتملة.
- اسأل قبل إضافة اعتمادية.

قواعد مساحة العمل ملفات Markdown في .clinerules/ أو .cline/rules/؛ ويقرأ Cline أيضًا AGENTS.md و.cursorrules و.windsurfrules. القواعد هي المكان الصحيح لـ:

الأوامر التي ينبغي أن يشغّلها Cline.
ضوابط محصورة في مسار واحد عبر glob في الـfrontmatter.
أعراف الفريق التي سئمت تكرارها.

القواعد تخبر Cline كيف يتصرف. لكنها لا تخبره أيّ الخدمات تقرأ الجدول الذي يوشك على نقله.

حين لا تكفي القواعد وقراءة الملفات

ثلاث فجوات يملؤها Cline بقراءة مزيد من الملفات، طلبًا بعد طلب.

‏// خطة مبنية على قائمة

يستدل وضع Plan مما قرأه Cline حتى الآن. في مستودع كبير، هذا يعني شجرة مجلدات وحفنة من الملفات، فترث الخطة تلك الفجوات.

‏// كل قراءة رحلة ذهاب وإياب

كل ملف يفتحه Cline ليتوجّه يكلّف رموزًا وطلبًا إلى النموذج. التوجّه في حزمة غير مألوفة قد يستهلك معظم نافذة السياق قبل التعديل الأول.

‏// البحث النصي يجد السلاسل لا المستدعين

“من غيره يستدعي هذا؟” سؤال رسم بياني. البحث النصي يجد السلسلة؛ لكنه لا يفصل المستدعين الحقيقيين عن تعليق، أو mock، أو دالة تحمل الاسم نفسه.

Maguyva كخادم MCP في Cline

إدخال واحد في mcpServers يمنح Cline:

11 أداة على مستودعك المفهرس بحث دلالي وهيكلي (AST) وبالرسم البياني ونصي، إضافة إلى البحث عن الرموز والعناصر المعتمدة واسترجاع الملفات.
إجابات مع مسارات الملفات وأرقام الأسطر عبر أكثر من 285 لغة، فتستشهد الخطة بملفات حقيقية.
أدوات للقراءة فقط تستعلم أدوات Maguyva من الفهرس. لا تعدّل أيٌّ منها ملفاتك.

قواعد Cline تخبر Cline كيف يعمل.
Maguyva تمنح Cline خريطة يخطط انطلاقًا منها.

سيرا عمل

خطّط وفق الخريطة، ثم نفّذ.

// workflow 01

خطّط للتغيير من مواقع الاستدعاء الحقيقية

cline plan> انقل تحديث الجلسة إلى حزمة auth

dependency_search("refreshSession", dependents)
  src/api/middleware.ts:58
  src/jobs/renew.ts:12
  src/web/hooks/useSession.ts:30

→ تسرد الخطة مواقع الاستدعاء الثلاثة قبل أن يبدأ وضع Act.
[exit 0]

تسمّي الخطة كل ملف ستلمسه، فتوافق على قائمة لا على حدس.

// workflow 02

اعثر على التنفيذ الحقيقي، لا على fixture الاختبار

cline> كيف نحسب الاحتساب التناسبي (proration)؟

semantic_search("proration calculation")
  src/billing/proration.ts:22   prorate()   ← التنفيذ
  test/billing/proration.spec.ts:7   ← fixture

→ يقرأ Cline ملفًا واحدًا بدل ستة.
[exit 0]

تضع النتائج المرتّبة التنفيذ فوق الـfixture الذي يحمل الاسم نفسه.

الإعداد في Cline

ثلاث خطوات. خطة Free: 3 مستودعات, حتى 50 ألف سطر مُفهرَس من المستودع، بلا بطاقة.

// step 01

افهرس مستودعًا على maguyva.ai

اختر واحدًا تعرفه جيدًا، لتتمكَّن من التحقق من الإجابات.

// step 02

أضف Maguyva إلى إعدادات MCP في Cline

cline_mcp_settings.json

{
  "mcpServers": {
    "maguyva": {
      "type": "streamableHttp",
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

// step 03

استبدل العنصر النائب واطرح سؤالًا واحدًا

استبدل mgv_xxxx بمفتاح API الخاص بك واحفظ الملف. اطرح سؤالًا واحدًا تعرف إجابته مسبقًا، ثم افتح الملف المُشار إليه.