المعجم

agent

مساعد ذكاء اصطناعي يستطيع قراءة الملفات وكتابة الشيفرة وتشغيل الأوامر وأداء المهام نيابة عنك. الوكلاء المدمجون في OpenCode يشملون "build" (لإجراء التغييرات) و"plan" (للتفكير في المشكلات دون إجراء تغييرات). يمكنك أيضاً إنشاء وكلاء مخصصين لمهام متخصصة.

AGENTS.md

ملف نصي عادي يحتوي تعليمات مخصصة يقرأها OpenCode في بداية كل جلسة. اعتبره مجموعة أوامر دائمة للذكاء الاصطناعي. يمكن أن يوجد عالمياً (~/.config/opencode/AGENTS.md) أو لكل مشروع (في جذر المشروع). الملف العالمي شخصي لك؛ ملف المشروع يُرفع عادة إلى Git ويُشارك مع الفريق.

CLI

Command-Line Interface. طريقة للتفاعل مع البرمجيات بكتابة أوامر نصية. لدى OpenCode واجهة CLI لتشغيل مهام لمرة واحدة، مثل opencode run "explain this function". بخلاف TUI، تشغّل CLI أمراً واحداً ثم تخرج.

command

إجراء مسبوق بشرطة مائلة تشغّله داخل OpenCode، مثل /models لتبديل نماذج الذكاء الاصطناعي، أو /share لمشاركة محادثة، أو /undo للتراجع عن آخر تغيير. يمكنك أيضاً إنشاء أوامر مخصصة للمهام المتكررة.

config

اختصار configuration. ملف (عادة opencode.json) تعرّف فيه تفضيلاتك لسلوك OpenCode — أي نموذج يُستخدم، وما هي الصلاحيات الممنوحة، وأي خوادم MCP تُربط، والمزيد. ملفات الإعداد يمكن أن تكون عالمية (تطبَّق على كل الجلسات) أو لكل مشروع.

context window

كمية النص التي يستطيع النموذج «رؤيتها» دفعة واحدة أثناء المحادثة. تُقاس بالرموز (tokens، تقريباً ¾ الكلمة). نموذج بنافذة سياق 128K يستطيع العمل مع نحو 128,000 رمز من المدخلات والمخرجات مجتمعة — بما في ذلك رسائلك ومحتوى الملفات ونتائج الأدوات وردود النموذج نفسه. نوافذ السياق الأكبر تتيح للنموذج التعامل مع قواعد شيفرة أكبر ومحادثات أطول دون فقدان التفاصيل السابقة.

GUI

Graphical User Interface. واجهة مرئية بنوافذ وأزرار وقوائم تتفاعل معها بالفأرة ولوحة المفاتيح. OpenCode Desktop واجهة GUI. قارن مع TUI وCLI.

Homebrew

مدير حزم لـ macOS (وLinux) يتيح تثبيت البرمجيات من سطر الأوامر. شغّل brew install <package> لتثبيت شيء، وbrew update لتحديث Homebrew نفسه، وbrew upgrade لتحديث الحزم المثبّتة. يمكن تثبيت OpenCode Desktop بـ brew install --cask opencode-desktop. انظر brew.sh.

LLM

Large Language Model. نوع من الذكاء الاصطناعي يعمل كنسخة متقدمة من الإكمال التلقائي — يأخذ نصاً موجوداً ويخمّن الكلمات التالية المحتملة. أطعمه بداية جملة فيتنبأ بكيفية إكمالها. أطعمه سؤالاً فيتنبأ بشكل الإجابة. أطعمه شيفرة فيها خطأ فيتنبأ بشكل الإصلاح.

تُدرَّب نماذج LLM على كميات هائلة من النصوص والشيفرة من الإنترنت، وهكذا «تتعلّم» أنماط اللغة والاستدلال والبرمجة. وهي التي تشغّل أدوات مثل OpenCode — عندما تكتب موجّهاً، فإن LLM هو من يقرأه ويولّد الرد. أمثلة: Claude (من Anthropic)، وGPT (من OpenAI)، وGemini (من Google).

لفهم أعمق لكيفية عمل نماذج LLM، شاهد Intro to Large Language Models لأندريه كارباثي — شرح واضح وغير تقني يغطي كيف تُبنى هذه النماذج وكيف تفكّر فيها وكيف تستفيد منها أقصى استفادة.

LM Studio

تطبيق سطح مكتب لتنزيل وتشغيل نماذج LLM محلياً على جهازك. يوفّر GUI لتصفح النماذج وإدارة التنزيلات وتشغيل خادم API محلي يستطيع OpenCode الاتصال به كـ مزوّد. انظر lmstudio.ai.

Markdown

صيغة نص عادي يفضّلها المطوّرون لكتابة المحتوى. بخلاف الصيغ المرتبطة ببرامج معيّنة (مثل .docx لـ Microsoft Word أو .pages لـ Apple Pages)، Markdown خفيفة وغير مرتبطة بأي برنامج أو شركة أو تقنية معيّنة. تنتهي الملفات بـ .md وتستخدم رموزاً بسيطة للتنسيق: # للعناوين، و** للخط العريض، و- للقوائم، و[نص](url) للروابط.

Markdown أيضاً صيغة النص المفضّلة لدى نماذج LLM — للقراءة والتوليد. كثير من الملفات التي ستعمل عليها في OpenCode هي Markdown، بما في ذلك AGENTS.md وملفات الدروس في هذه الدورة.

لتعلّم صيغة Markdown تفاعلياً، جرّب Markdown Live Preview.

MCP

Model Context Protocol. معيار مفتوح يتيح لـ OpenCode الاتصال بأدوات وخدمات خارجية. مثلاً، يمكنك إضافة خادم MCP يمنح OpenCode وصولاً إلى قضايا GitHub أو سجلات أخطاء Sentry أو البحث في التوثيق. خوادم MCP يمكن أن تكون محلية (على جهازك) أو بعيدة (مستضافة على الإنترنت).

mode

لدى OpenCode أوضاع تشغيل مختلفة. Build mode يتيح للوكيل إجراء تغييرات على ملفاتك. Plan mode يقيّده بالقراءة والاقتراح فقط — مفيد للتفكير في مشكلة قبل الالتزام بالتغييرات. بدّل بينهما بمفتاح Tab في TUI، أو عبر محدّد الوضع في Desktop.

model

عقل الذكاء الاصطناعي الذي يشغّل OpenCode. تُنشئ النماذج شركات مثل Anthropic (Claude) وOpenAI (GPT) وGoogle (Gemini). للنماذج نقاط قوة وسرعات وتكاليف مختلفة. أنت تختار النموذج، ويمكنك التبديل بينها في أي وقت.

Ollama

أداة CLI لتنزيل وتشغيل نماذج LLM محلياً على جهازك. تعمل كمدير حزم لنماذج الذكاء الاصطناعي — شغّل ollama pull llama3 لتنزيل نموذج وollama run llama3 لبدء الدردشة معه. يستطيع OpenCode الاتصال بـ Ollama كـ مزوّد محلي. انظر ollama.com.

permissions

قواعد تتحكّم بما يُسمح لـ OpenCode بفعله على جهازك. كل إجراء يمكن ضبطه على allow (تشغيل دون سؤال)، أو ask (طلب الموافقة)، أو deny (حظر كامل). مثلاً، قد تسمح بقراءة الملفات لكن تطلب الموافقة قبل حذفها.

prompt

الرسالة أو التعليمات التي تكتبها في OpenCode. الموجّه الجيد يعطي الذكاء الاصطناعي سياقاً كافياً ليفعل ما تريد. مثلاً: "أضف مفتاح الوضع الداكن إلى صفحة الإعدادات" أو "اشرح كيف تعمل المصادقة في هذا المشروع."

provider

شركة أو خدمة تستضيف نماذج الذكاء الاصطناعي. Anthropic وOpenAI وGoogle مزوّدون. يدعم OpenCode أكثر من 75 مزوّداً، بما في ذلك خيارات الاستضافة الذاتية مثل Ollama لتشغيل النماذج محلياً.

session

محادثة واحدة مع OpenCode. لكل جلسة سياقها وتاريخها. يمكنك تشغيل عدة جلسات بالتوازي، ومشاركة الجلسات مع الآخرين باستخدام الأمر /share.

skill

مجموعة تعليمات قابلة لإعادة الاستخدام تُحزَّم كملف SKILL.md. يحمّل OpenCode المهارات عند الحاجة عندما تكون ذات صلة بالمهمة الحالية. اعتبرها حزم معرفة متخصصة — مثلاً مهارة تعرف كيف تصوغ ملاحظات الإصدار أو تُعد مكوّن React جديداً.

text editor

برنامج لكتابة وتحرير ملفات النص العادي. ستحتاج واحداً لعرض وتحرير ملفات إعداد OpenCode، رغم أن OpenCode نفسه يتولى معظم إنشاء الملفات وتحريرها.

بعض المحررات الشائعة متعددة المنصات (كلها مجانية): VS Code وCursor وZed وWindsurf. إن لم ترد تثبيت شيء إضافي، نظام تشغيلك يتضمن واحداً: TextEdit على macOS (اضبطه على وضع النص العادي في الإعدادات)، أو Notepad على Windows، أو gedit/Kate/nano على Linux.

tool

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

branch

نسخة موازية من مشروعك. تتيح لك الفروع تجربة تغييرات دون التأثير على الشيفرة الرئيسية. عندما ترضى عن فرع، يمكنك دمجه في الفرع الرئيسي. الأمر git checkout -b <name> ينشئ فرعاً جديداً.

commit

لقطة محفوظة لمشروعك في لحظة زمنية. لكل commit رسالة تصف ما تغيّر ولماذا. اعتبره نقطة تحقق يمكنك العودة إليها. استخدم git add لتجهيز التغييرات، ثم git commit -m "message" لحفظها.

fork

نسخة من مستودع شخص آخر تعيش في حسابك على GitHub. الـ fork يتيح لك تجربة تغييرات على مشروع دون التأثير على الأصل. عندما تكون جاهزاً، يمكنك فتح pull request لاقتراح تغييراتك.

repository

Repo. مجلد يتتبعه Git — يحتوي ملفات مشروعك وتاريخها الكامل. المستودعات يمكن أن تكون محلية (على جهازك) أو بعيدة (على GitHub). استخدم git init لبدء تتبع مجلد، أو git clone لنسخ مستودع بعيد محلياً.

TUI

Terminal User Interface. واجهة نصية تعمل داخل الطرفية. تبدو TUI الخاصة بـ OpenCode كتطبيق دردشة لكنها تعمل بالكامل في الطرفية — دون حاجة إلى فأرة. وهي الطريقة الأصلية لاستخدام OpenCode، وشائعة بين المطوّرين المرتاحين في الطرفية. قارن مع GUI وCLI.