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

ما هو OpenHands؟ دليل وكيل البرمجة المستقل داخل بيئة Sandbox المعزولة

OpenHands منصة هندسة برمجيات مستقلة مفتوحة المصدر برخصة MIT تعمل دون تقييد بمزود نموذج أو سحابة محددة. تنشئ بيئات Sandbox معزولة عبر Docker أو Kubernetes لتعديل عدة ملفات، وتثبيت الاعتماديات، وتشغيل الاختبارات، وإصلاح الأعطال تكرارياً. يستعرض هذا الدليل بنية V1 SDK، وسجل EventStream، وسياسات التحقق الأمني، وMicroagents، ودعم MCP الأصيل.

ما هو OpenHands؟ دليل وكيل البرمجة المستقل داخل بيئة Sandbox المعزولة

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

ما هو OpenHands؟ منصة OpenHands (تطور مشروعي OpenDevin وAll-Hands-AI) هي منصة هندسة برمجيات مستقلة مفتوحة المصدر بترخيص MIT دون تبعية لأي مزود. تنشئ بيئات Sandbox معزولة عبر Docker أو Kubernetes لتعديل ملفات متعددة، وتثبيت الاعتماديات، وتشغيل الاختبارات، وإصلاح الأعطال تكرارياً حتى نجاح الفحوصات دون تعريض الجهاز المضيف للخطر.

هام

ملخص تنفيذي — الركائز المعمارية لمنصة OpenHands

  • رخصة MIT واستقلالية كاملة: المنصة الأساسية وحزمة Software Agent SDK وأداة CLI وبيئة التقييم مرخصة بـ MIT وتعمل مع واجهات تجارية أو نماذج مستضافة داخلياً.
  • عزل Sandbox لملفات متعددة واختبارات مستقلة: Docker Runtime افتراضياً وKubernetes Remote Runtime يعزلان تعديل الشيفرة وتثبيت الحزم والاختبارات في حاويات مؤقتة.
  • بنية V1 SDK وحوكمة أمنية: تضم سجل EventStream الحتمي، وسياسات الموافقة (AlwaysConfirm وConfirmRisky وNeverConfirm)، ومحلل --llm-approve، وMicroagents، ودعم MCP مع OAuth.

البنية المعيارية لإصدار OpenHands V1 وسجل EventStream

تطورت OpenHands نحو بنية V1 مفصولة بين المستودع الرسمي لـ OpenHands على GitHub وحزمة Software Agent SDK، ما يتيح تشغيل واجهة المتصفح ومسارات CI الصامتة على المحرك نفسه.

حزم V1 المفصولة

  • openhands.sdk: يضم LLM وAgent وConversation وEvent وسياسات الأمان، مع توجيه متوافق مع LiteLLM لتبديل مزود النماذج عبر متغيرات البيئة فقط.
  • openhands.tools: يوفر أدوات قياسية هي TerminalTool للأوامر، وFileEditorTool لتعديل عدة ملفات بدقة، وTaskTrackerTool لتخطيط المهام الفرعية.
  • openhands.workspace: يعزل حدود التنفيذ بين مجلد محلي أو حاوية Docker مؤقتة أو بيئة تشغيل بعيدة.
  • openhands.agent_server: يتيح حالة الجلسة عبر REST وWebSocket لعميل المتصفح Agent Canvas وأداة OpenHands CLI.

سجل EventStream الحتمي

بدلاً من حفظ محادثات نصية غير مهيكلة، تسجل OpenHands كل خطوة تخطيط وأمر طرفية ورقعة ملف ومخرج خطأ في سجل EventStream مرتب زمنياً ومهيكَل برمجياً. يبث خادم openhands.agent_server هذا التدفق لحظياً عبر WebSocket إلى واجهة Agent Canvas وعميل CLI، مما يسمح للمهندسين بمراقبة فروقات الملفات ومخرجات الاختبارات مباشرة دون الدخول اليدوي إلى الحاوية. ومع تفعيل LOG_ALL_EVENTS=true، تحصل فرق المنصات على تشخيص دقيق وقابل للتكرار عند تعثر المهام المستقلة، وأثر تدقيق موثوق للامتثال الأمني، وإمكانية استئناف الجلسات الطويلة بأمان بعد أي انقطاع في الشبكة أو الخادم.

تعديل ملفات متعددة داخل Sandbox ودورات الاختبار المستقلة

إصلاح الأعطال الفعلية أو بناء ميزة خلفية جديدة يمس عادة مخططات البيانات وطبقات الخدمات ونقاط API وملفات الاختبار معاً. تعالج OpenHands هذا التعقيد بالجمع بين التحرير المتزامن لعدة ملفات وحدود العزل الصارمة داخل حاوية قابلة للتدمير.

خيارات Docker Runtime وKubernetes Remote Runtime وLocal Runtime

يشغّل Docker Runtime افتراضياً حاوية مؤقتة نظيفة لكل جلسة، فيعزل تثبيت المكتبات وتشغيل أوامر البناء داخل نطاقات الحاوية ويظل النظام المضيف سليماً بالكامل بعد انتهاء الجلسة وحذفها. ولأحمال التكامل المستمر الواسعة والترحيلات الجماعية والتقييمات المتوازية، يوزع Remote Runtime الجلسات تلقائياً على وحدات Pod مستقلة داخل عنقود Kubernetes بحيث يعمل عشرات الوكلاء بالتوازي دون تضارب على الموارد أو تلويث بيئات البناء. كما يظل خيار Local Runtime متاحاً بوضوح للمهام المحلية الخفيفة التي لا تستدعي تشغيل حاوية.

دورة التحقق المغلقة حتى اجتياز الاختبارات

داخل Sandbox، يخطط الوكيل عبر TaskTrackerTool، ويعدل الملفات المترابطة عبر FileEditorTool، ويثبت الاعتماديات المطلوبة داخل الحاوية، ثم يشغل اختبارات الوحدة والتكامل عبر TerminalTool. عند فشل أي اختبار، يقرأ الوكيل تتبع الخطأ الكامل (Stack Trace) من سجل EventStream، ويحدد ما إذا كان العطل في الشيفرة المصدرية أو في إعداد الاختبار، ثم يطبق رقعة جديدة ويعيد التشغيل حتى تنجح كل الاختبارات. تستفيد فرق تطوير البرمجيات المخصصة من هذه الدورة المغلقة لتقليص ديون الاختبارات القديمة وتسريع ترقيات الأطر الكبرى بأدلة تحقق قابلة لإعادة الإنتاج.

التثبيت، وتشغيل CLI الصامت، وحاوية Docker، وحزمة Python SDK

تتوفر المراجع الكاملة في docs.openhands.dev وopenhands.dev عبر ثلاثة مسارات: CLI المحلي، أو Docker، أو Python V1 SDK.

تثبيت CLI والتشغيل Headless وإدارة MCP

ثبّت عبر uv مع Python 3.12 (أو pip install openhands-ai)، وشغّل Agent Canvas بـ --mount-cwd (وخيار --gpu)، ونفّذ مهام headless مع --llm-approve، وأضف خوادم MCP:

uv tool install openhands --python 3.12
openhands serve --mount-cwd
openhands --headless --llm-approve \
  --task "إصلاح حالة التسابق في تجديد رمز المصادقة واجتياز اختبارات pytest"
openhands mcp add internal-docs --url https://mcp.example.internal/sse
openhands mcp list

تشغيل بيئة Docker المعزولة

لتشغيل التطبيق مع صورة agent-server وتسجيل EventStream الكامل، استخدم الأمر الرسمي:

docker run -it --rm --pull=always \
  -e AGENT_SERVER_IMAGE_REPOSITORY=ghcr.io/openhands/agent-server \
  -e AGENT_SERVER_IMAGE_TAG=1.26.0-python \
  -e LOG_ALL_EVENTS=true \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v ~/.openhands:/.openhands \
  -v $(pwd):/workspace:rw \
  -p 3000:3000 \
  --add-host host.docker.internal:host-gateway \
  --name openhands-app \
  docker.openhands.dev/openhands/openhands:1.8
تحذير

حدود صلاحيات مقبس Docker: ربط /var/run/docker.sock يتيح إنشاء حاويات Sandbox شقيقة بصلاحية إدارة الحاويات على المضيف. تجنب تفعيل NeverConfirm على أجهزة تحمل مفاتيح إنتاجية أو SSH شخصية؛ واحصر المهام غير المراقبة في مشغلات CI محصنة أو Kubernetes Remote Runtime.

الأتمتة عبر حزمة Python V1 SDK

يدمج مهندسو المنصات دورات الإصلاح المستقل مباشرة باستخدام openhands.sdk:

import os
from openhands.sdk import LLM, Agent, Conversation, Tool
from openhands.sdk.security.confirmation_policy import ConfirmRisky
from openhands.tools.file_editor import FileEditorTool
from openhands.tools.task_tracker import TaskTrackerTool
from openhands.tools.terminal import TerminalTool
llm = LLM(
    model=os.getenv("LLM_MODEL", "anthropic/claude-sonnet-4-5-20250929"),
    api_key=os.getenv("LLM_API_KEY"),
    base_url=os.getenv("LLM_BASE_URL"),
)
agent = Agent(
    llm=llm,
    tools=[
        Tool(name=TerminalTool.name),
        Tool(name=FileEditorTool.name),
        Tool(name=TaskTrackerTool.name),
    ],
)
conversation = Conversation(agent=agent, workspace=os.getcwd())
conversation.set_confirmation_policy(ConfirmRisky())
conversation.send_message(
    "إصلاح تقريب الوحدات الصغرى في الفوترة والتحقق من جميع اختبارات الوحدة."
)
conversation.run()

سياسات الأمان وقواعد Microagents ودعم MCP

تحمي الحاوية النظام المضيف، بينما تضبط السياسات الأوامر المسموح بها والالتزام بقواعد المستودع.

سياسات التأكيد ومحلل الأمان LLM

  • AlwaysConfirm: يطلب موافقة صريحة قبل كل أمر طرفية أو تعديل ملف.
  • ConfirmRisky: الوضع المتوازن افتراضياً؛ ينفذ القراءة والاختبارات الآمنة تلقائياً ويتوقف عند الأوامر عالية الخطورة.
  • NeverConfirm: تشغيل مستمر دون توقف، مخصص فقط لحاويات CI المؤقتة بصلاحيات مقيدة.

عند تفعيل --llm-approve، يفحص محلل الأمان المعتمد على LLM دلالة كل أمر قبل تنفيذه لمنع الحذف المدمر أو تسريب الأسرار أو التنزيلات غير المصرح بها.

قواعد Microagents ودعم MCP مع OAuth

تُحفظ قواعد المستودع الهندسية وقيود الترحيل ومعايير المراجعة في ملفات Microagents بصيغة Markdown مع ترويسة YAML (name وtrigger_type وkeywords) داخل المسار ~/.openhands/microagents/ وبالتوافق الكامل مع بنية .agents/skills/ القياسية القابلة للنقل بين الأدوات. تُحقن هذه القواعد تلقائياً في سياق الوكيل عند لمس المسارات أو الكلمات المفتاحية المحددة دون الحاجة إلى تكرار التعليمات في كل جلسة. كما يربط دعم MCP الأصيل (openhands mcp add وopenhands mcp list) خوادم الأدوات المؤسسية المحمية بمصادقة OAuth مباشرة بجلسة التنفيذ. وفي تحليل البروتوكولات القديمة أو الملفات التنفيذية المغلقة، يمكن توصيل أدوات دليل بنية REA (Reverse Engineer Anything) عبر MCP مباشرة بجلسة OpenHands لتحويل نتائج الهندسة العكسية إلى شيفرة مختبرة داخل الحاوية المعزولة نفسها.

نصيحة

نصيحة تطبيق مرحلي: ابدأ مع كل مستودع جديد بسياسة ConfirmRisky و--llm-approve وحفظ Microagents داخل Git، ثم راجع EventStream بعد أول سبرينت لمعايرة العتبات ببيانات فعلية قبل أتمتة مهام CI الصامتة.

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

المعيارOpenHandsOpenCodeGooseوكلاء السحابة وIDE المغلقة
نموذج التنفيذدورة مستقلة (Agent Canvas وCLI وHeadless وPython V1 SDK)جلسة طرفية تفاعلية أصلية (TUI)تطبيق سطح مكتب وCLI وصفات APIإضافة IDE مغلقة أو سحابة مملوكة
عزل SandboxDocker Runtime مؤقت وKubernetes Remote (+ Local)مجلد المطور والطرفية المحلية مباشرةتشغيل محلي؛ الحاوية إعداد خارجيمتفاوت؛ سحابة مزود أو IDE محلي
اختبارات متعددة الملفاتاعتماديات واختبارات شاملة وإصلاح تكراري داخل الحاويةتحرير متعدد الملفات بإشراف طرفيسلاسل خطوات بالإضافات والوصفاتمتباين؛ البناء والاختبار غالباً مقيد
تقييد النموذجلا يوجد — رخصة MIT ونماذج تجارية أو محلية عبر LiteLLMلا يوجد — عدة مزودين ونقاط محليةلا يوجد — مفتوح المصدر متعدد النماذجمرتفع — مرتبط بنموذج أو اشتراك
MCP والتوسعةMCP أصيل (openhands mcp add وOAuth) وMicroagents وV1 SDKدعم واسع لخوادم MCP والأدواتإضافات MCP غنية وصفات YAMLمحصور في موصلات المتجر المغلق

لمحبي السرعة التفاعلية في الطرفية يبرز دليل OpenCode لوكيل البرمجة الطرفي مفتوح المصدر، بينما يخدم دليل Goose للوكيل البرمجي مفتوح المصدر الفرق التي تجمع سطح المكتب وCLI ووصفات API. أما عند الحاجة إلى عزل صارم بالحاويات ودورات اختبار مستقلة وتدقيق EventStream، فتتفرد OpenHands بوضوح.

حوكمة الإنتاج ومنهجية Kling Digital

يتطلب نقل OpenHands من التجربة الفردية إلى منصة هندسية مؤسسية تطبيق أربع ضوابط تشغيلية محددة:

  1. تقييد الشبكة الصادرة (Egress): حصر الاتصالات الصادرة من حاويات Sandbox في مرايا الحزم الداخلية وبوابة نماذج اللغة المعتمدة لدى المؤسسة فقط.
  2. عزل الأسرار والرموز قصيرة العمر: منع تخزين مفاتيح API أو رموز Git داخل المجلد المربوط، وإصدار رموز مؤقتة بأقل صلاحية مقيدة بالفرع النشط فقط.
  3. الأرشفة المركزية لسجل EventStream: إرسال مخرجات LOG_ALL_EVENTS=true إلى تخزين تدقيق غير قابل للتعديل للاحتفاظ بسلسلة أدلة كاملة لكل طلب دمج.
  4. المراجعة البشرية الإلزامية وفحوصات SAST: التعامل مع نجاح الاختبارات داخل Sandbox كدليل تحقق فني لا كإذن دمج مباشر، وتمرير كل تعديل عبر مراجعة الكود وفحوصات الأمان الثابت.

تصمم Kling Digital منصات برمجة مستقلة محايدة تقنياً، وعناقيد Kubernetes Remote Runtime، وتكاملات MCP بمصادقة OAuth لمستودعات المؤسسات. نسّق جلسة تقييم معماري لإصدار OpenHands V1 عبر التواصل مع Kling Digital.

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

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

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

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

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

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

اترك تعليقاً

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

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

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

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

مقارنة تقنية

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

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

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

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

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

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

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

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

عرض الكل