تخطَّ إلى المحتوى

لمستخدمي Continue

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

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

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

كتلة 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/.

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

# .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 خريطة للكود.

سيرا عمل

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

// workflow 01

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

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

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

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

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

// workflow 02

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

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

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

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

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

الإعداد في Continue

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

  1. // step 01

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

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

  2. // step 02

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

    .continue/mcpServers/maguyva.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 }}
    
  3. // step 03

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

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