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

Canonical source: https://maguyva.ai/ar/for-cline

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

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

> استخدم ‎.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 اتفاق عمل. استخدمها.

```text
# .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 *خريطة يخطط انطلاقًا منها*.

## سيرا عمل

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

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

```text
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]
```

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

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

```text
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 ألف سطر مُفهرَس من المستودع، بلا بطاقة.

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

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

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

`cline_mcp_settings.json`

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

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

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

تشرح [وثائق MCP](https://docs.cline.bot/mcp/mcp-overview) الخاصة بـCline الخوادم البعيدة ومهل الانتظار والموافقة التلقائية.

## افهرس مستودعًا واحدًا تعرفه جيدًا.

اتصل بـCline عبر MCP، ثم اطرح سؤالًا واحدًا يمكنك التحقق منه.