الأدوات

تتيح الأدوات لـ LLM تنفيذ إجراءات داخل قاعدة الشفرة الخاصة بك. يأتي OpenCode مع مجموعة من الأدوات المدمجة، لكن يمكنك توسيعه عبر أدوات مخصصة أو خوادم MCP.

افتراضيا، تكون جميع الأدوات مفعلة ولا تحتاج إلى إذن للتشغيل. يمكنك التحكم في سلوك الأدوات عبر الأذونات.

---

التهيئة

استخدم الحقل permission للتحكم في سلوك الأدوات. يمكنك السماح أو الرفض أو طلب الموافقة لكل أداة.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "deny",
    "bash": "ask",
    "webfetch": "allow"
  }
}

يمكنك أيضا استخدام أحرف البدل للتحكم في عدة أدوات دفعة واحدة. على سبيل المثال، لطلب الموافقة على جميع الأدوات القادمة من خادم MCP:

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "mymcp_*": "ask"
  }
}

اعرف المزيد حول تهيئة الأذونات.

---

المدمجة

فيما يلي جميع الأدوات المدمجة المتاحة في OpenCode.

---

bash

نفذ أوامر shell في بيئة مشروعك.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "bash": "allow"
  }
}

تتيح هذه الأداة لـ LLM تشغيل أوامر terminal مثل npm install وgit status أو أي أمر shell آخر.

---

edit

عدّل الملفات الموجودة باستخدام استبدال نصي مطابق تماما.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "allow"
  }
}

تجري هذه الأداة تعديلات دقيقة على الملفات عبر استبدال مقاطع نصية متطابقة. وهي الطريقة الأساسية التي يعدّل بها LLM الشفرة.

---

write

أنشئ ملفات جديدة أو اكتب فوق الملفات الموجودة.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "allow"
  }
}

استخدم هذا للسماح لـ LLM بإنشاء ملفات جديدة. سيكتب فوق الملفات الموجودة إذا كانت موجودة بالفعل.

ملاحظة

تُدار أداة write عبر إذن edit، والذي يشمل جميع تعديلات الملفات (edit وwrite وpatch وmultiedit).

---

read

اقرأ محتويات الملفات من قاعدة الشفرة الخاصة بك.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "read": "allow"
  }
}

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

---

grep

ابحث في محتوى الملفات باستخدام التعابير النمطية (Regex).

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "grep": "allow"
  }
}

بحث سريع في المحتوى عبر قاعدة الشفرة الخاصة بك. يدعم صياغة Regex الكاملة وتصفية الملفات عبر أنماط المسارات.

---

glob

اعثر على الملفات عبر مطابقة الأنماط.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "glob": "allow"
  }
}

ابحث عن الملفات باستخدام أنماط glob مثل **/*.js أو src/**/*.ts. يعيد مسارات الملفات المطابقة مرتبة حسب وقت التعديل.

---

list

اعرض قائمة بالملفات والمجلدات في مسار محدد.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "list": "allow"
  }
}

تعرض هذه الأداة محتويات المجلد. وتقبل أنماط glob لتصفية النتائج.

---

lsp (experimental)

تفاعل مع خوادم LSP التي قمت بتهيئتها للحصول على ميزات ذكاء الشفرة مثل التعاريف والمراجع ومعلومات التحويم وتسلسل الاستدعاءات.

ملاحظة

هذه الأداة متاحة فقط عند ضبط OPENCODE_EXPERIMENTAL_LSP_TOOL=true (أو OPENCODE_EXPERIMENTAL=true).

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "lsp": "allow"
  }
}

تتضمن العمليات المدعومة: goToDefinition وfindReferences وhover وdocumentSymbol وworkspaceSymbol وgoToImplementation وprepareCallHierarchy وincomingCalls وoutgoingCalls.

لتهيئة خوادم LSP المتاحة لمشروعك، راجع خوادم LSP.

---

patch

طبّق الرقع (Patches) على الملفات.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "allow"
  }
}

تطبق هذه الأداة ملفات الرقع على قاعدة الشفرة الخاصة بك. وهي مفيدة لتطبيق الفروقات (Diffs) والرقع من مصادر متعددة.

ملاحظة

تُدار أداة patch عبر إذن edit، والذي يشمل جميع تعديلات الملفات (edit وwrite وpatch وmultiedit).

---

skill

حمّل مهارة (ملف SKILL.md) وأعد محتواها ضمن المحادثة.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "skill": "allow"
  }
}

---

todowrite

أدِر قوائم المهام أثناء جلسات البرمجة.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "todowrite": "allow"
  }
}

تنشئ هذه الأداة قوائم المهام وتحدّثها لتتبع التقدم أثناء العمليات المعقدة. يستخدمها LLM لتنظيم المهام متعددة الخطوات.

ملاحظة

هذه الأداة معطلة للوكلاء الفرعيين افتراضيا، لكن يمكنك تفعيلها يدويا. اعرف المزيد

---

todoread

اقرأ قوائم المهام الموجودة.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "todoread": "allow"
  }
}

تقرأ هذه الأداة الحالة الحالية لقائمة المهام. يستخدمها LLM لتتبع المهام المعلقة أو المكتملة.

ملاحظة

هذه الأداة معطلة للوكلاء الفرعيين افتراضيا، لكن يمكنك تفعيلها يدويا. اعرف المزيد

---

webfetch

اجلب محتوى الويب.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "webfetch": "allow"
  }
}

تتيح هذه الأداة لـ LLM جلب صفحات الويب وقراءتها. وهي مفيدة للبحث عن التوثيق أو لاستكشاف موارد عبر الإنترنت.

---

websearch

ابحث في الويب عن معلومات.

ملاحظة

هذه الأداة متاحة فقط عند استخدام مزود OpenCode أو عند ضبط متغير البيئة OPENCODE_ENABLE_EXA على أي قيمة منطقية صحيحة (مثل true أو 1).

للتفعيل عند تشغيل OpenCode:

OPENCODE_ENABLE_EXA=1 opencode

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "websearch": "allow"
  }
}

تجري عمليات بحث على الويب باستخدام Exa AI للعثور على معلومات ذات صلة عبر الإنترنت. وهي مفيدة للبحث في المواضيع، والعثور على أحداث جارية، أو جمع معلومات تتجاوز حد بيانات التدريب.

لا يلزم مفتاح API - إذ تتصل الأداة مباشرة بخدمة MCP المستضافة لدى Exa AI دون مصادقة.

نصيحة

استخدم websearch عندما تحتاج إلى العثور على معلومات (Discovery)، واستخدم webfetch عندما تحتاج إلى جلب محتوى من رابط محدد (Retrieval).

---

question

اطرح على المستخدم أسئلة أثناء التنفيذ.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "question": "allow"
  }
}

تتيح هذه الأداة لـ LLM طرح أسئلة على المستخدم أثناء المهمة. وهي مفيدة من أجل:

• جمع تفضيلات المستخدم أو متطلباته
• توضيح التعليمات غير الواضحة
• الحصول على قرارات حول خيارات التنفيذ
• تقديم خيارات حول الاتجاه الذي يجب اتباعه

يتضمن كل سؤال عنوانا ونص السؤال وقائمة بالخيارات. يمكن للمستخدمين الاختيار من الخيارات المتاحة أو كتابة إجابة مخصصة. وعند وجود عدة أسئلة، يمكن للمستخدمين التنقل بينها قبل إرسال جميع الإجابات.

---

أدوات مخصصة

تتيح لك الأدوات المخصصة تعريف دوالك الخاصة التي يمكن لـ LLM استدعاؤها. تُعرّف هذه الأدوات في ملف التهيئة ويمكنها تنفيذ شفرة عشوائية.

اعرف المزيد حول إنشاء أدوات مخصصة.

---

خوادم MCP

تتيح لك خوادم MCP (Model Context Protocol) دمج أدوات وخدمات خارجية. يشمل ذلك الوصول إلى قواعد البيانات وتكاملات API وخدمات الجهات الخارجية.

اعرف المزيد حول تهيئة خوادم MCP.

---

التفاصيل الداخلية

داخليا، تستخدم أدوات مثل grep وglob وlist أداة ripgrep في الخلفية. افتراضيا، يحترم ripgrep أنماط .gitignore، ما يعني أن الملفات والمجلدات المدرجة في .gitignore ستُستبعد من عمليات البحث وعرض القوائم.

---

Ignore patterns

لتضمين ملفات يتم تجاهلها عادة، أنشئ ملف .ignore في جذر المشروع. يمكن لهذا الملف السماح صراحة بمسارات محددة.

.ignore

!node_modules/
!dist/
!build/

على سبيل المثال، يسمح ملف .ignore هذا لـ ripgrep بالبحث داخل مجلدات node_modules/ وdist/ وbuild/ حتى لو كانت مدرجة في .gitignore.