Kling Digital
ar
اتصل بنا
2026-11-19
9 دقائق قراءة
دليل مميز

ما هو OpenCode؟ دليل البنية المعمارية والتثبيت لوكيل البرمجة الطرفي مفتوح المصدر

يُعد OpenCode وكيل برمجة طرفياً مفتوح المصدر برخصة MIT يعمل محلياً على جهازك دون الارتباط بأي مزود ذكاء اصطناعي واحد. يتجاوز المشروع 228 ألف نجمة على GitHub، ويجمع بين نواة عميل-خادم مبنية بـ Bun وOpenTUI، وربط LSP التلقائي، وأكثر من 75 مزود نماذج، ودعم MCP.

ما هو OpenCode؟ دليل البنية المعمارية والتثبيت لوكيل البرمجة الطرفي مفتوح المصدر

يواجه مهندسو البرمجيات في البيئات الإنتاجية احتكاكاً مستمراً عندما تتغير حدود الاستخدام أو سياسات حفظ الشيفرة البرمجية لدى مزودي أدوات البرمجة المغلقة. فقد تتطلب مهمة واحدة نموذج استدلال متقدم لمراجعة ترحيل قاعدة بيانات، وتحتاج المهمة التالية إلى نموذج سريع منخفض التكلفة لإصلاح الاختبارات الوحدية، بينما يفرض مستودع حساس لعميل تشغيل نموذج محلي بالكامل دون اتصال خارجي. وضمن مشاريع حلول الذكاء الاصطناعي التي تنفذها Kling Digital، أصبح التخلص من الاحتكار أحادي المزود داخل سير عمل المطورين متطلباً معمارياً أساسياً.

OpenCode هو وكيل برمجة طرفي خفيف الوزن ومفتوح المصدر برخصة MIT يُطوّر في مستودع anomalyco/opencode، ويعمل مباشرة على جهازك دون الارتباط بأي شركة محددة. يجمع المشروع، الذي تجاوز 228 ألف نجمة على GitHub، بين بنية عميل-خادم منفصلة، وتحليل شيفرة تلقائي عبر بروتوكول LSP، ودعم أكثر من 75 مزود نماذج لغوية، وتكامل أصيل مع بروتوكول MCP.

هام
  • استقلالية تامة عن المزودين: تنقّل فورياً بين أكثر من 75 مزود نماذج عبر سجل Models.dev، بما في ذلك Anthropic وOpenAI وGoogle وAWS Bedrock وOpenRouter والاشتراكات الحالية والنماذج المحلية عبر Ollama وLM Studio.
  • سياق هيكلي تلقائي عبر LSP: بدلاً من حشو الملفات عشوائياً في نافذة السياق، يستعلم OpenCode مباشرة من خوادم اللغة (LSP) النشطة لاستخراج تعريفات الرموز وتواقيع الأنواع وتشخيصات المصرّف.
  • نواة عميل-خادم ومصفوفة صلاحيات V2: يشغّل المحرك نفسه المبني بـ TypeScript وBun واجهة الطرفية وتطبيق سطح المكتب والخادم البعيد opencode serve مع قواعد صلاحيات مرتبة (allow / ask / deny).

البنية المعمارية المنفصلة (عميل-خادم)، بيئة Bun وواجهة OpenTUI

اعتمدت الأجيال الأولى من مساعدي البرمجة الطرفيين على عملية واحدة متشابكة تتولى تدفق النموذج وتنفيذ الأدوات ورسم واجهة الطرفية معاً. وعند توسّع الجلسات متعددة الملفات أو انقطاع اتصال SSH، كانت الواجهة تتجمد وتضيع حالة العمل بالكامل. يعالج OpenCode هذا القصور عبر مستودع أحادي منظم بلغة TypeScript (@opencode/cli و@opencode/protocol و@opencode/client) يعتمد على Bun كبيئة تشغيل ومدير حزم عالي السرعة.

يرتكز النظام على محرك خلفي بدون واجهة (Headless Core) يحفظ سجل الجلسات واستدعاءات الأدوات وتتبع تعديلات الملفات محلياً في قاعدة بيانات SQLite. وتعمل طبقات العرض منفصلة تماماً عن هذا المحرك:

  • واجهة طرفية تفاعلية (OpenTUI + SolidJS): بُنيت باستخدام SolidJS مع حزم @opentui/core و@opentui/solid لتقديم تقسيم نوافذ وجلسات متوازية واختصارات تحرير شبيهة بـ Vim داخل محاكيات الطرفية الحديثة مثل WezTerm وAlacritty وGhostty وKitty.
  • تطبيق سطح المكتب وملحقات المحررات: يتصل تطبيق سطح المكتب (macOS وWindows وLinux) وملحقات IDE بالمحرك الخلفي نفسه وخوادم MCP نفسها دون تكرار حالة الجلسة.
  • الاتصال عن بُعد (serve وattach): يمكنك تشغيل المحرك على خادم بناء داخلي قوي عبر opencode serve أو opencode web ثم الاتصال به من جهاز محمول خفيف عبر opencode attach ، فتبقى الشيفرة المصدرية على الخادم بينما يعرض جهازك الجلسة بسلاسة.

الربط التلقائي مع LSP مقابل حشو السياق العشوائي

تعود معظم أخطاء وكلاء البرمجة في المستودعات الحقيقية إلى نقص السياق الهيكلي وليس إلى ضعف النموذج ذاته. فالاعتماد على عمليات البحث النصي grep وقراءة ملفات كاملة يستهلك عشرات الآلاف من الرموز (Tokens) دون داعٍ، ومع ذلك قد يفوّت تعريفات الأنواع المتعدية أو تواقيع المكتبات الخارجية.

يكتشف OpenCode خوادم Language Server Protocol (LSP) المثبتة في مساحة العمل (مثل TypeScript وPython وGo وRust) ويشغّلها تلقائياً في الخلفية. وقبل كتابة أي تعديل وبعده، يطلب بيانات هندسية دقيقة مباشرة من خادم اللغة:

  1. تحديد الرموز والمراجع بدقة: الوصول الفوري إلى التعريف المرجعي وجميع مواضع الاستدعاء عبر المشروع دون مسح خطي للمجلدات.
  2. تواقيع الأنواع الفعلية: فحص الواجهات الحقيقية للمكتبات المثبتة لمنع استدعاء دوال غير موجودة أو مهملة.
  3. تشخيصات المصرّف الفورية: فور تعديل أي ملف، تُعاد أخطاء الأنواع أو الاستيرادات الناقصة من LSP مباشرة إلى حلقة الوكيل ليصححها قبل إعادة التحكم إلى المطور.

وإذا احتاج فريقك أيضاً إلى تحليل واجهات برمجية غير موثّقة أو ملفات تنفيذية قبل كتابة شيفرة عميل مضبوطة الأنواع محلياً، فإن الجمع بين دقة LSP في OpenCode وأدوات الهندسة العكسية المشروحة في دليل بنية وإعداد REA (Reverse Engineer Anything) MCP يوفّر مسار عمل متكاملاً داخل الجلسة نفسها.

التوجيه بين أكثر من 75 مزود نماذج ووضعا Plan وBuild

يرتبط انتشار OpenCode وتجاوزه 228 ألف نجمة على GitHub بتعامله مع النماذج اللغوية كبنية قابلة للتبديل الحر. فبفضل سجل Models.dev المدمج، يربط الوكيل بأكثر من 75 مزود LLM، تشمل Anthropic Claude وOpenAI GPT وGoogle Gemini وAWS Bedrock وGroq وOpenRouter، إلى جانب خوادم محلية معزولة مثل Ollama وLM Studio. وتُدار بيانات المصادقة محلياً عبر أمر opencode auth login (في ~/.local/share/opencode/auth.json) أو عبر متغيرات .env، مع إمكانية ربط اشتراكات التطوير القائمة مثل GitHub Copilot أو حسابات ChatGPT.

الفصل المنضبط بين التخطيط والتنفيذ عبر plan وbuild

يبدأ عدد كبير من المشكلات الهندسية حين يشرع الوكيل بتعديل الملفات قبل تثبيت حدود التصميم. لذلك يوفّر OpenCode وكيلين أساسيين يمكن التبديل بينهما فورياً بمفتاح Tab داخل الواجهة الطرفية أو عبر الراية --agent plan:

  • وكيل plan: مخصص لقراءة المستودع، ورسم خرائط الاعتماديات، وتحليل أثر تعديلات قواعد البيانات، وصياغة خطة تنفيذ مرحلية دون المساس بالملفات.
  • وكيل build: يعمل بدرجة حرارة منخفضة لتطبيق التعديلات المعتمدة بدقة حتمية، ومتابعة تشخيصات LSP، وتشغيل الاختبارات المحلية حتى استقرار البناء.

التثبيت، خوادم MCP ومصفوفة الصلاحيات المرتبة V2

يتميز OpenCode بتثبيت سريع وخفيف على macOS وLinux وبيئات Node دون الحاجة لتنزيل صور حاويات ضخمة لبدء العمل المحلي:

# سكريبت التثبيت السريع (macOS / Linux)
curl -fsSL https://opencode.ai/v2/install | bash
# بديل عبر Homebrew (macOS / Linux)
brew install anomalyco/tap/opencode-v2
# بديل متعدد المنصات عبر npm
npm i -g @opencode/cli@latest
# مصادقة المزودين وتشغيل الخادم الخلفي
opencode auth login
opencode serve --port 4096
# الاتصال بالجلسة الجارية من طرفية أخرى
opencode attach http://127.0.0.1:4096

يتيح حفظ ملف opencode.jsonc (أو opencode.json) في جذر المستودع توحيد الوكيل الافتراضي وخوادم Model Context Protocol (MCP) وقواعد الأمان عبر الفريق بأكمله. وفي مخطط V2 من OpenCode يجب تعريف الخوادم ضمن mcp.servers (وليس mcpServers) وتعريف القواعد الأمنية داخل مصفوفة جذرية مرتبة باسم permissions تسود فيها القاعدة المطابقة الأخيرة:

{
  "$schema": "https://opencode.ai/config.json",
  "default_agent": "plan",
  "model": "anthropic/claude-sonnet-4-5",
  "agent": {
    "plan": {
      "temperature": 0.4,
      "description": "وكيل تحليل معماري وتقسيم مهام للقراءة فقط."
    },
    "build": {
      "temperature": 0.15,
      "description": "وكيل تنفيذ حتمي لكتابة الشيفرة وتطبيق التعديلات المعتمدة."
    }
  },
  "mcp": {
    "servers": {
      "filesystem": {
        "type": "local",
        "command": ["npx", "-y", "@modelcontextprotocol/server-filesystem", "./src"],
        "enabled": true
      },
      "internal-docs": {
        "type": "remote",
        "url": "https://mcp.internal.example/sse",
        "headers": {
          "Authorization": "Bearer ${INTERNAL_MCP_TOKEN}"
        },
        "enabled": true
      }
    }
  },
  "permissions": [
    { "action": "shell", "resource": "*", "effect": "ask" },
    { "action": "shell", "resource": "git status *", "effect": "allow" },
    { "action": "shell", "resource": "git diff *", "effect": "allow" },
    { "action": "shell", "resource": "npm test *", "effect": "allow" },
    { "action": "shell", "resource": "git push *", "effect": "deny" }
  ]
}
تحذير

يعمل OpenCode افتراضياً داخل صدفة نظام التشغيل المحلي مباشرة ولا ينشئ حاوية عزل (Sandbox) تلقائياً. ونظراً لأن مصفوفة permissions في الإصدار V2 تتبع مبدأ «آخر قاعدة مطابقة تسود» (last-match wins)، ضع دائماً قاعدة شاملة "" بإجراء "ask" في البداية، ثم اسمح فقط بأوامر القراءة والاختبار الآمنة، وأنهِ المصفوفة بقواعد "deny" صريحة لأوامر git push والسكريبتات الحساسة.

مقارنة هندسية: OpenCode مقابل OpenHands وGoose والوكلاء المغلقة

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

معيار المقارنةOpenCodeOpenHandsGooseالوكلاء التجاريون المغلقون
نموذج التشغيلواجهة طرفية TUI خفيفة، تطبيق سطح مكتب وserve/attachواجهة ويب، CLI وSDK معياري بـ Python وTypeScriptتطبيق سطح مكتب بـ Rust وCLI وخادم API (goosed) وGDKأداة CLI أو إضافة IDE مرتبطة بمزود واحد
مستوى العزلتشغيل محلي مباشر محكوم بمصفوفة صلاحيات V2 المرتبةحاويات عزل مؤقتة Docker أو Kubernetes افتراضياًتشغيل محلي وخادم محمي بـ TLS ومفتاح سريبيئة سحابية للمزود أو نوافذ تأكيد محلية
السياق والأدواتاكتشاف تلقائي لخوادم LSP (أنواع وتشخيصات) + MCPتدفق أحداث EventStream، تعديل متعدد الملفات واختبار تلقائيأكثر من 70 إضافة MCP وصفات YAML قابلة للنقلفهرسة مغلقة وموصلات خاصة بالمزود
مرونة النماذج75+ مزود عبر Models.dev، Ollama محلي واشتراكات قائمةمستقل عن النماذج (سحابي ومحلي) مع وكلاء مصغرين15+ مزود (Anthropic وOpenAI وGoogle وBedrock وOllama)غالباً محصور بعائلة نماذج واحدة
الرخصة والحوكمةرخصة MIT (anomalyco/opencode)رخصة MIT (OpenHands/OpenHands)رخصة Apache-2.0 (مؤسسة لينكس AAIF — aaif-goose/goose)رخصة تجارية مغلقة المصدر
أفضل سيناريو استخدامالبرمجة الطرفية اليومية السريعة ودقة الأنواع عبر LSPتفويض مهام متعددة الملفات مع تشغيل اختبارات داخل Sandboxدمج سطح المكتب وCLI وواجهات API المدمجة مع وصفات الفريقتراخيص مؤسسية موحدة لدى مزود واحد

يتفوق OpenCode عندما يقود المطور جلسة البرمجة لحظياً من لوحة المفاتيح مع استجابة طرفية فورية وتحقق مستمر من الأنواع عبر LSP. أما عند الحاجة لتفويض تذكرة كاملة لتثبيت حزم وتعديل عشرات الملفات وتشغيل حزم الاختبار تلقائياً داخل حاوية معزولة، فراجع دليل وكيل البرمجة المستقل داخل Sandbox OpenHands. وإذا احتاجت مؤسستك إلى محرك مكتوب بلغة Rust برخصة Apache-2.0 يجمع بين تطبيق سطح مكتب وCLI وصفات YAML وخادم HTTP/SSE قابل للتضمين، فستجد التفاصيل الكاملة في دليل Goose لسطح المكتب وCLI وAPI.

قائمة تحقق لتبني OpenCode في الفرق الهندسية

لتحويل OpenCode من أداة فردية إلى معيار هندسي آمن داخل المؤسسة، يُنصح بتطبيق الضوابط الخمسة التالية:

  1. تثبيت ملف opencode.jsonc في Git: اجعل "default_agent": "plan" هو الإعداد الافتراضي مع حظر صريح لأوامر الدفع والترحيل الإنتاجي.
  2. بوابة نماذج مركزية للبيانات الحساسة: وجّه المستودعات الخاضعة للامتثال إلى بوابة LLM داخلية أو عنقود Ollama خاص بدلاً من توزيع مفاتيح فردية.
  3. تثبيت إصدارات خوادم MCP: قيّد إصدارات حزم MCP المحلية بدقة وامنح رموز قراءة فقط للاتصالات الموجهة لقواعد البيانات الإنتاجية.
  4. تضمين خوادم LSP في بيئات التطوير (DevContainers): تأكد من تثبيت خوادم TypeScript وGo وPython مسبقاً لضمان دقة التحليل منذ اللحظة الأولى.
  5. قياس مؤشرات هندسية حقيقية: راقب زمن مراجعة طلبات الدمج ومعدل نجاح البناء التلقائي بدلاً من عدد الأسطر المولّدة.
نصيحة

لتسريع تأهيل المهندسين الجدد في المستودعات الأحادية الضخمة، شغّل نسخة داخلية من opencode serve مقيدة بوضع plan فقط. يمكن للأعضاء الجدد الاتصال عبر opencode attach وطرح أسئلة معمارية مدعومة بـ LSP دون أي مخاطرة بتعديل الفروع المحلية.

إذا كنت تخطط لبناء مسارات تطوير البرمجيات المعتمدة على وكلاء برمجة مفتوحي المصدر وخوادم MCP مخصصة وسياسات أمان صارمة، يمكنك التواصل مباشرة مع معماريي Kling Digital عبر صفحة الاتصال.

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

الأسئلة الأكثر شيوعاً حول هذا الدليل والتكامل.

العودة إلى الأخبار
مشاركة

التعليقات (0)

شارك أفكارك وتجاربك مع المجتمع.

لا توجد تعليقات بعد. كن أول من يشارك برأيه!

اترك تعليقاً

سيتم نشر تعليقك بعد مراجعة المسؤول واعتماده.

الموثوقية التخصصية ومركز الموارد التقنية

مقارنات معمارية، أدلة استراتيجية وأدوات رقمية تفاعلية

مصفوفات مقارنة تقنية، وأدلة هندسية معمقة، وأدوات حساب تفاعلية لدعم قراراتك الاستثمارية والتقنية.

مقارنة تقنية

مقارنة Next.js مقابل WordPress

سرعة تحميل أقل من ثانية، وحماية تامة دون ثغرات الإضافات، ومقارنة التكلفة الإجمالية لـ 3 سنوات.

عرض تحليل المقارنة الشامل
مقارنة معمارية

مقارنة معمارية Framer مقابل Next.js

الفروق الجوهرية بين أدوات التصميم المرئي والبرمجيات المؤسسية الشاملة.

عرض تحليل المقارنة الشامل

أحدث المقالات

أحدث أدلتنا في التكنولوجيا والتصميم والبرمجيات.

عرض الكل