~/.config/opencode/
ملفات opencode.json و AGENTS.md و commands/ و skills/ و plugins/ العامة. تعطل تطبيق سطح المكتب غالباً بسبب إضافة. أفرغ مفتاح الإضافة وأعد التشغيل. راجع استكشاف أخطاء سطح المكتب.
قائمة الميزات من المنتج
ما يفعله OpenCode فعلاً
كل عنوان أدناه قدرة مسمّاة من الصفحة الرئيسية لـ OpenCode أو المقدمة أو TUI أو الوكلاء أو وثائق الأذونات. إن كنت هنا للتثبيت، انتقل إلى صفحة التنزيل.
ثلاث واجهات، وكيل واحد
تسمي الصفحة الرئيسية هذا «أي محرر»: واجهة طرفية، وتطبيق سطح مكتب، وإضافة بيئة تطوير. سطح المكتب هو الجزء الذي اكتسب تبويبات للجلسات النشطة. ما زالت صفحة التنزيل الرسمية تدرج الطرفية أولاً، ثم سطح المكتب، ثم الإضافات.
إعداد TUI موجود في tui.json (السمة، اختصارات المفاتيح، المؤشر، أصوات التنبيه). إعداد وقت التشغيل موجود في opencode.json. ليسا الملف نفسه.
النافذة المكتبية الفارغة على Windows تكون عادة بسبب WebView2. ذلك المسار موجود في الأدلة.
النماذج وتسجيل الدخول و Zen
«أي نموذج» في الصفحة الرئيسية يعني أكثر من 75 مزود LLM عبر Models.dev، بما في ذلك النماذج المحلية. يضيف /connect مزوداً. تُشار إلى النماذج بصيغة provider/model، مثلاً openai/gpt-4.1 أو opencode/kimi-k2.
| المسار | ما هو |
|---|---|
| /connect | أضف مزوداً والصق مفتاح API، أو سجّل الدخول إلى Copilot أو ChatGPT أو Claude أو Zen. |
| /models | افتح المنتقي. شغّل opencode models في صدفة لسرد ما يمكنك استدعاؤه فعلاً. |
| OpenCode Zen | نماذج منتقاة اختبرها المشروع لوكلاء الترميز، حتى لا تكون جودة المزود ضرباً من الحظ. |
| GitHub Copilot | سجّل الدخول عبر GitHub. يطلب v1.18.31 تفكيراً تكيفياً ملخصاً لنماذج Copilot. |
| ChatGPT Plus/Pro | سجّل الدخول عبر OpenAI. أصلح v1.18.29 ظهور gpt-6-astra لمشتركي OpenAI. |
| نماذج محلية | تقول الصفحة الرئيسية والأسئلة الشائعة إنك تستطيع ربط نماذج محلية عبر قائمة المزودين نفسها. |
حلقة الوكيل
- Tab · Plan / Build
- Build هو الوكيل الأساسي الافتراضي مع تفعيل الأدوات. Plan مقيّد: يكون edit و bash افتراضياً ask أو deny حتى يقترح النموذج عملاً دون لمس الشجرة.
- /init · AGENTS.md
- إعداد موجّه يكتب قواعد المشروع. أودع الملف. يمكن أن تعيش القواعد العامة أيضاً في ~/.config/opencode/AGENTS.md.
- /undo · /redo
- تراجع عن دورة المستخدم الأخيرة وتغييرات ملفاتها أو أعدها. Git مطلوب. يمكنك التراجع أكثر من مرة.
- /share · /unshare
- انشر جلسة للمراجعة أو التصحيح. لا تُشارك المحادثات حتى تشغّل الأمر.
الأذونات هي حاجز الأمان
منذ v1.1.1 دُمج منطقي tools القديم في permission. كل قاعدة هي allow أو ask أو deny. يوافق opencode --auto على طلبات ask غير المرفوضة.
- read / edit / bash / grep / glob
- أدوات الملفات والصدفة. يمكن للأنماط أن تسمح بـ
git *وترفضrm *. - external_directory
- يُطلق عندما تغادر أداة دليل العمل. الافتراضي هو ask. توسيع المجلد الرئيسي بـ ~ لا يتجاوز هذا الحارس.
- doom_loop
- يُطلق عندما تتكرر استدعاء الأداة نفسه ثلاث مرات بالمدخل نفسه. الافتراضي هو ask.
- .env files
- read هو allow، لكن
*.envو*.env.*يكونان deny افتراضياً. يبقى*.env.exampleعلى allow.
MCP والوكلاء وملفات المشروع
الإعداد يعيش في مجلدات معروفة. هذه المسارات هي التي يسمّيها الملخص فعلاً.
.opencode/ في المستودع
إعداد وأوامر ومهارات وإضافات لكل مشروع. يمكن لMarkdown الوكيل أن يضبط mode: subagent ويرفض edit حتى لا يكتب المراجع ملفات.
/mcp
يسرد خوادم MCP المضبوطة وحالة اتصالها. يمكن لمفاتيح الأذونات أن تستهدف خادماً بأنماط مثل mymcp_*.
تبويبات سطح المكتب
عنوان صفحة التنزيل: نظّم العمل والجلسات النشطة بالتبويبات على macOS و Windows و Linux.