OpenCode: OpenCode Built-in Tools
آخر تحديث: 2026-08-31
--- title: أدوات OpenCode المدمجة description: تعرّف على نظام الأدوات المدمجة بما في ذلك عمليات الملفات وتنفيذ Shell والبحث order: 11 lang: ar
قوة OpenCode تأتي من نظام أدواته المدمجة — AI يستدعي الأدوات لتنفيذ عمليات محددة.
1. ما ستتعلمه
- نظرة عامة على الأدوات المدمجة
- أدوات عمليات الملفات
- أداة تنفيذ Shell
- أدوات البحث والتحليل
- تكوين الأدوات والصلاحيات
2. نظرة عامة على الأدوات المدمجة
| الأداة | الوظيفة | مستوى الصلاحية |
|---|---|---|
read |
قراءة محتوى الملف | قراءة فقط |
write |
كتابة/إنشاء ملفات | كتابة |
edit |
تحرير/ترقيع ملفات | كتابة |
bash |
تنفيذ أوامر Shell | تنفيذ |
grep |
البحث في محتوى الملفات | قراءة فقط |
glob |
البحث عن ملفات بنمط | قراءة فقط |
list |
عرض محتويات الدليل | قراءة فقط |
webfetch |
جلب محتوى الويب | شبكة |
task |
استدعاء وكيل فرعي | وكيل |
3. أدوات عمليات الملفات
- read: AI يقرأ ملفات المشروع تلقائياً للسياق
- write: إنشاء ملفات جديدة أو الكتابة فوقها
- edit: تعديل دقيق باستخدام بحث+استبدال
4. أداة تنفيذ Shell
TEXT
📖 للعرض فقط
شغّل npm test وحلل الاختبارات الفاشلة
AI ينفذ → يحلل الأخطاء → يحدد المشاكل → يقترح إصلاحات → يُعدّل الكود.
5. تكوين الأدوات
JSON
{
"tools": {
"write": true,
"edit": true,
"bash": true,
"webfetch": false
}
}
قيم الصلاحيات: allow (تلقائي)، ask (تأكيد)، deny (رفض)
❓ الأسئلة الشائعة
س كيف أمنع AI من تنفيذ عمليات خطيرة؟
ج عيّن bash كـ ask أو deny. استخدم أنماط Glob للتحكم الدقيق.
س AI أجرى تعديلات خاطئة؟
ج استخدم /undo فوراً. عيّن edit و write كـ ask.
📖 الخلاصة
- أدوات مدمجة: read، write، edit، bash، grep، glob، list، webfetch، task
- صلاحيات: allow، ask، deny
- قابل للتكوين على المستوى العام ومستوى الوكيل
- وسّع عبر MCP
📝 التمارين
-
أساسي: عيّن edit كـ ask في opencode.json.
-
متوسط: أنشئ وكيل قراءة فقط معطّل فيه أدوات الكتابة/التنفيذ.
-
متقدم: استخدم أنماط Glob للسماح بـ git ورفض rm.