# يعمل Continue بالإعدادات. أضف كتلة تعرف مستودعك.

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

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).

يعمل وكيل Continue انطلاقًا من السياق الذي تعطيه إياه والأدوات التي تسمح بها إعداداته. تفهرس Maguyva المستودع كله وتقدّمه عبر MCP، فيسأل وضع الوكيل أين يقع الكود قبل أن يقرأ ملفًا بعد آخر.

> كتلة YAML واحدة: رابط URL وترويسة وسرّ (secret) من ملف ‎.env لديك.

## ما يجب معرفته عن Continue

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

### كتلة YAML

احفظ الكتلة باسم `.continue/mcpServers/maguyva.yaml` في مساحة عملك، أو أضف إدخال `mcpServers` الخاص بها إلى `~/.continue/config.yaml`. أما `config.json` فمتقادم.

### streamable-http

يتصل Continue بنقطة نهاية Maguyva عبر Streamable HTTP، والترويسة توضع تحت `requestOptions`. لا عملية محلية ولا Node.js.

### مرجع إلى سرّ

يُحلّ `${{ secrets.MAGUYVA_API_KEY }}` من `~/.continue/.env`، ثم من `.continue/.env` و`.env` في مساحة العمل، ثم من بيئة العملية. الكتلة نفسها لا تحمل أيّ مفتاح.

### وضع الوكيل فقط

يتيح Continue أدوات MCP في وضع الوكيل لا في الدردشة. تعمل أيضًا إعدادات JSON من عملاء آخرين: ضعها في `.continue/mcpServers/`.

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

```text
# .continue/rules/testing.md
---
globs: "src/**/*.ts"
---
شغّل اختبارات الحزمة قبل أن تعدّ التغيير مكتملًا.
```

يحمّل Continue قواعد Markdown من `.continue/rules/`. يمكن أن تنطبق القاعدة دائمًا، أو فقط حين تكون ملفات مطابقة في السياق (`globs`)، أو حين يقرر الوكيل أن `description` الخاص بها مناسب. استخدم القواعد من أجل:

- أوامر البناء والاختبار والفحص (lint).
- الأعراف حسب اللغة أو المجلد.
- المجلدات التي يجب ألا يمسّها الوكيل.

تخبر القاعدة الوكيل كيف يعمل. لكنها لا تستطيع أن تخبره بما يقوله الكود بعد دمج هذا الصباح.

## حين لا يكفي السياق المنتقى يدويًا

ثلاث فجوات يسدّها وضع الوكيل بقراءة الملفات.

### ‏// السياق هو ما تختاره

تضيف الملفات التي تظن أنها مهمة. والتنفيذ الذي يحتاجه الوكيل كثيرًا ما يكون في الملف الذي لم يخطر لك.

### ‏// المستدعون ليسوا في الملف

“ما الذي سينكسر إن غيّرت هذا؟” سؤال رسم بياني. من دون فهرس، يقرأ الوكيل الملفات واحدًا تلو الآخر ليجيب عنه.

### ‏// للنماذج المحلية نوافذ صغيرة

يمكن لـContinue تشغيل نماذج محلية بحدود سياق ضيقة. إجابة واحدة مرتّبة مع file:line تتسع حيث لا تتسع عشر قراءات استكشافية.

## Maguyva ككتلة MCP في Continue

كتلة mcpServers واحدة تمنح وضع الوكيل:

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

> تخبر القواعد Continue *كيف يعمل*.
> تمنح Maguyva Continue *خريطة للكود*.

## سيرا عمل

اسأل الخريطة أولًا، ثم عدّل.

### 01. اعثر على الملف الصحيح دون إضافة عشرة ملفات إلى السياق

```text
continue agent> أين نتحقق من تواقيع webhook؟

semantic_search("verify webhook signature")
  src/webhooks/verify.ts:17   verifySignature()
  docs/webhooks.md:40   ← نص

→ يقرأ الوكيل verify.ts ولا شيء غيره.
[exit 0]
```

البحث بالمعنى يجد التنفيذ حتى حين لا يطابق اسمه كلماتك.

### 02. اسرد المستوردين قبل إيقاف عميل

```text
continue agent> ما الذي لا يزال يستورد عميل الفوترة القديم؟

dependency_search("LegacyBillingClient", dependents)
  4 مستوردين في 3 حزم

→ ينقل الوكيل الأربعة كلها، ثم يزيل العميل.
[exit 0]
```

تكتمل قائمة المستوردين قبل الحذف، بدل أن يكتشفها البناء لاحقًا.

## الإعداد في Continue

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

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

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

### 02. احفظ الكتلة باسم ‎.continue/mcpServers/maguyva.yaml

`.continue/mcpServers/maguyva.yaml`

```yaml
name: Maguyva
version: 0.0.1
schema: v1
mcpServers:
  - name: maguyva
    type: streamable-http
    url: https://maguyva.tools/mcp
    requestOptions:
      headers:
        Authorization: Bearer ${{ secrets.MAGUYVA_API_KEY }}

```

### 03. أضف مفتاحك وانتقل إلى وضع الوكيل

اكتب `MAGUYVA_API_KEY=` متبوعًا بمفتاحك في `~/.continue/.env`. انتقل إلى وضع الوكيل واطرح سؤالًا واحدًا تعرف إجابته مسبقًا.

تشرح [وثائق MCP](https://docs.continue.dev/customize/deep-dives/mcp) الخاصة بـContinue وسائل النقل والأسرار وإعدادات JSON من عملاء آخرين.

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

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