لمستخدمي Zed

‏Zed سريع. لكن الوكيل لا يزال مضطرًا إلى إيجاد الكود.

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

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

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

إدخال واحد في context_servers: رابط URL وترويسة Authorization.

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

أربع حقائق خاصة بـZed. لا شيء منها صعب.

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

settings.json

توضع الخوادم البعيدة تحت context_servers. افتح الملف بالأمر zed: open settings file، أو أضف خادمًا من Settings → AI → MCP Servers.

‏// النقل

بعيد، عبر URL

يتصل Zed بنقطة النهاية البعيدة لـMaguyva عبر HTTP. لا عملية محلية، ولا Node.js.

‏// المفتاح

ترويسة حرفية

يضع هذا الدليل المفتاح مباشرة في ترويسة Authorization، لأن توسيع متغيرات البيئة في ترويسات Zed لم يُتحقَّق منه هنا. احتفظ به في إعدادات المستخدم، لا في ملف تودعه في Git.

‏// الموافقات

أذونات الأدوات

يطلب Zed افتراضيًا الموافقة قبل كل استدعاء أداة. اسمح بأدوات Maguyva واحدة تلو الأخرى تحت agent.tool_permissions.tools، بمفاتيح مثل mcp:maguyva:find_symbol.

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

# .rules
- شغّل أمر اختبار المستودع قبل أن تعدّ التغيير منتهيًا.
- أبقِ التعديلات داخل الحزمة المطلوب تغييرها.

يحمّل Zed ملف تعليمات مشروع واحدًا: أول تطابق من قائمة ثابتة تبدأ بـ.rules وتشمل AGENTS.md وCLAUDE.md. أما التعليمات الشخصية فمكانها ~/.config/zed/AGENTS.md. استخدمه لـ:

أوامر البناء والاختبار والـlint.
الأعراف التي يخطئ فيها الوكيل مرة بعد مرة.
المجلدات التي يجب ألا يلمسها الوكيل.

ملف التعليمات يخبر الوكيل كيف يعمل. لكنه لا يستطيع أن يخبره أيّ ملفات من بين أربعة آلاف تستدعي الدالة التي يوشك على تغييرها.

حين لا يكفي المخزن المفتوح

ثلاثة أشياء لا يستطيع وكيل Zed تعلّمها من الملفات التي أمامه.

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

يرى الوكيل ما فتحته وما وجده بـgrep. دالة مساعدة بالاسم نفسه في حزمة أخرى تبدو مطابقة تمامًا إلى أن تُشحن النسخة الخاطئة.

‏// المستدعون ليسوا على الشاشة

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

‏// للسياق ميزانية

كل ملف يفتحه الوكيل ليتوجّه يستهلك رموزًا (tokens) لا يمكنه إنفاقها على التغيير. إجابة واحدة مرتّبة مع file:line أرخص من عشر قراءات استكشافية.

Maguyva كخادم سياق في Zed

إدخال واحد في context_servers يمنح وكيل Zed:

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

‏Zed يمنح الوكيل محررًا سريعًا.
Maguyva تمنح الوكيل خريطة للكود.

سيرا عمل

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

// workflow 01

اعثر على التنفيذ قبل أن يفتح الوكيل علامة تبويب

zed agent> أين سياسة إعادة المحاولة لخطافات الويب الصادرة؟

find_symbol("retryPolicy")
  src/webhooks/dispatch.ts:41   retryPolicy()   ← التنفيذ
  src/webhooks/__mocks__/dispatch.ts:9   ← mock

→ يفتح الوكيل dispatch.ts:41، لا الـmock.
[exit 0]

بحث مرتّب واحد يحل محل جولة من grep. تعود الإجابة مسارًا وسطرًا يستطيع الوكيل فتحهما مباشرة.

// workflow 02

افحص العناصر المعتمدة قبل تغيير التوقيع

zed agent> أضف وسيط timeout إلى fetchInvoice

dependency_search("fetchInvoice", dependents)
  7 مستدعين عبر 4 حزم

→ يحدّث الوكيل مواقع الاستدعاء السبعة في مرور واحد.
[exit 0]

يظهر نطاق التأثير قبل التعديل الأول، لا بعد فشل البناء.

الإعداد في Zed

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

// step 01

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

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

// step 02

أضف Maguyva إلى context_servers في إعدادات Zed

~/.config/zed/settings.json

{
  "context_servers": {
    "maguyva": {
      "url": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}

// step 03

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

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