OpenCode: OpenCode Configuration File

آخر تحديث: 2026-08-31

--- title: ملف تكوين OpenCode description: تعلّم بنية ملف تكوين OpenCode، بما في ذلك جميع عناصر opencode.json والإعدادات الشائعة order: 4 lang: ar

يدير OpenCode جميع الإعدادات عبر ملف opencode.json.

1. ما ستتعلمه

• موقع ملفات التكوين وأولوياتها
• بنية opencode.json الكاملة
• تفاصيل إعدادات شائعة
• تكوين المتغيرات البيئية

2. موقع ملف التكوين

3. بنية التكوين الكاملة

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {},
  "model": {},
  "agent": {},
  "tools": {},
  "permission": {},
  "theme": {},
  "tui": {}
}

• provider: مزودو النماذج المخصصة
• model: النموذج الافتراضي
• agent: وكلاء مخصصون (التفاصيل في الدرس 13)
• tools: مفاتيح الأدوات العامة
• permission: التحكم بالصلاحيات (allow/ask/deny)
• tui: إعدادات واجهة الطرفية

4. AGENTS.md (قواعد المشروع)

ملف Markdown في جذر المشروع يحدد قواعد سلوك AI.

إنشاء عبر TUI: /init أو يدوياً.

مثال:

# Project Rules

- Always use TypeScript for new files
- Follow ESLint configuration
- Write unit tests for all new functions
- Use conventional commits format

5. المتغيرات البيئية

❓ الأسئلة الشائعة

📖 الخلاصة

• التحميل حسب الأولوية: عام < مشروع < متغيرات بيئية
• opencode.json هو التكوين المركزي
• AGENTS.md يحدد قواعد المشروع بلغة طبيعية
• المتغيرات البيئية مناسبة لـ CI/CD

📝 التمارين

1. أساسي: أنشئ opencode.json عاماً مع مزود النموذج المفضل لديك.

2. متوسط: أنشئ .opencode/opencode.json للمشروع بصلاحيات أدوات محددة.

3. متقدم: اكتب AGENTS.md يحدد معايير الترميز واجعل OpenCode يتبعه.

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

من نحن