كيفية استخدام AI OpenHands: دليل عملي للإعداد والأوامر وسير العمل الواقعي
إذا تمنيت يومًا أن يكون لديك مطور ماهر يبرمج معك على مدار الساعة طوال أيام الأسبوع، فإن AI OpenHands يقترب بشكل ملحوظ. إنه "مهندس ذكاء اصطناعي" مفتوح المصدر يمكنه قراءة المستودع الخاص بك، وكتابة التعليمات البرمجية، وتشغيل المحطات الطرفية، وتصفح المستندات، والتكرار - تمامًا مثل مطور مبتدئ يتعلم بسرعة ويعمل بلا كلل. ولكن القوة لا تنطلق إلا بمجرد إعداده بشكل صحيح وتعلم كيفية توجيهه.
يرشدك هذا الدليل خطوة بخطوة حول كيفية استخدام AI OpenHands - من التثبيت إلى سير العمل المتقدم - حتى تتمكن من الشحن بشكل أسرع بثقة.
- خيارات التثبيت والبدء السريع
- تشغيل OpenHands محليًا أو مع النماذج السحابية
- أفضل الممارسات للأوامر والمستودعات والمهام
- سير العمل المثبت لعمل الميزات وتصحيح الأخطاء والاختبارات والوثائق
- الضمانات والخصوصية والتعاون
جدير بالذكر: يتم تطوير OpenHands بنشاط من قبل فريق All Hands والمجتمع. الوثائق الرسمية هي نجم الشمال الخاص بك للحصول على الإرشادات والنصائح الحالية. يمكنك أيضًا متابعة أدلة التثبيت العملية من الممارسين الذين وثقوا عمليات الإعداد المحلية و VM. لتشغيل النماذج المحلية، تتضمن المستندات إرشادات محددة أيضًا.
ما هو AI OpenHands - ولماذا نستخدمه؟
فكر في AI OpenHands كزميل في فريق الذكاء الاصطناعي مع لوحة مفاتيح. على عكس المساعدين الذين يعتمدون على الدردشة فقط، يمكن لـ OpenHands:
- استخدام محطة طرفية لتشغيل الأوامر والاختبارات والمدققين اللغويين
- تحرير التعليمات البرمجية عبر الملفات والدلائل
- اقتراح وتطبيق خطط خطوة بخطوة
هذا يجعله مثاليًا لمهام مثل تنفيذ الميزات وإصلاح الأخطاء وكتابة الاختبارات وإنشاء الوثائق وإعادة هيكلة وتحديث قواعد التعليمات البرمجية. بدلاً من التلاعب بالأوامر والنسخ / اللصق، فإنك تمنح OpenHands هدفًا وتدعه يكرر، مع الإشراف على تحركاته.
بداية سريعة: أسرع طريقة لاستخدام OpenHands
هناك عدة طرق للبدء. يعتمد اختيارك على ما إذا كنت تريد استخدام سحابة LLM أو تشغيل كل شيء محليًا.
الخيار أ: استخدم سحابة LLM (الأسهل)
- اتبع المستندات الرسمية "Start Building" و "Getting Started" لتثبيت التطبيق وتشغيله. عادة ما:
- تثبيت المتطلبات الأساسية (Docker، Node، Python، Git حسب المسار)
- توفير مفتاح API لنموذج سحابي مدعوم (على سبيل المثال، OpenAI أو Anthropic أو غيرها من المشاريع التي تدعمها في ذلك الوقت)
- تشغيل واجهة OpenHands وتوصيل المستودع الخاص بك
يضعك هذا المسار في إنتاجية بسرعة مع الحد الأدنى من النفقات العامة للحساب.
الخيار ب: تشغيل OpenHands باستخدام LLM محلي
- إذا كنت تفضل إبقاء التعليمات البرمجية والأوامر بعيدًا عن السحابة أو كنت ترغب في تجنب تكاليف API، فاستخدم دليل LLMs المحلي في الوثائق الرسمية.
- إعداد نموذج محلي متوافق (عبر Ollama أو غيرها من الواجهات الخلفية المدعومة في ذلك الوقت)
- تكوين نقاط نهاية النموذج وحدود السياق
- تأكد من أن جهازك لديه VRAM / CPU ومساحة القرص الكافية
الخيار ج: النشر إلى VM
- إذا كنت بحاجة إلى بيئة مخصصة، فقد وثق الممارسون كيفية تشغيل OpenHands على VM وإنشاء تطبيق في دقائق. هذا مفيد للفرق التي تريد مثيل مهندس AI مستقر ومشترك.
التشغيل الأول: إعداد المشروع وتأطير المهام
يتألق OpenHands عندما يمكنه رؤية التعليمات البرمجية الخاصة بك. ابدأ بـ:
- فتح المستودع الذي تريد أن يعمل عليه.
- تشغيل المشروع أو فهرسته حتى يتمكن OpenHands من تعيين الهيكل.
- إعطائها هدفًا واضحًا مع قيود.
مثال جيد لتأطير المهام:
- "أضف إعادة تعيين كلمة المرور للمستخدم إلى خدمة
auth باستخدام روابط البريد الإلكترونية. استخدم وحدة mailer الموجودة. أضف وحدات الوحدة لتوليد الرموز وانتهائه. لا تقم بتغيير مخطط بيانات المستخدم."
لماذا هذا يعمل:
- يسمي المكون والنطاق والتبعيات والحدود. كلما كنت أكثر وضوحًا، كان تخطيط OpenHands وتنفيذه أفضل.
كيفية كتابة أوامر فعالة لـ OpenHands
فكر في المطالبات على أنها تذاكر موجزة. أفضلهم:
- حدد النتيجة: "تنفيذ X مع قيود Y"
- ملفات المرجع أو الوحدات النمطية أو الاختبارات: "راجع
auth/routes.py و tests/test_auth.py"
- قيود الدولة: "لا توجد تغييرات في مخطط DB؛ الحفاظ على الواجهات الحالية"
- تضمين معايير القبول: "يجب أن تجتاز الاختبارات:
pytest -k password_reset"
نموذج يمكنك إعادة استخدامه:
الهدف: <ما تريد بناءه أو إصلاحه>
السياق: <الملفات ذات الصلة والقيود المعروفة والخدمات الخارجية>
القبول: <كيف يبدو النجاح: الاختبارات ونقاط النهاية والمقاييس>
الحدود: <ما لا يجب تغييره أو المناهج التي يجب تجنبها>
الأدوات: <الأوامر التي يمكن تشغيلها أو البرامج النصية أو مصادر البيانات>
سير العمل الأساسي: التخطيط → التنفيذ → التحقق → التحسين
عادةً ما يقترح OpenHands خطة متعددة الخطوات. إليك كيفية توجيهه:
- وافق أو عدل خطته مبكرًا. ادفعه لتشغيل الاختبارات أولاً لتحديد خط الأساس للإخفاقات.
- اطلب منه إنشاء أو تحديث اختبار لتحديد النجاح، ثم تنفيذ التعليمات البرمجية.
- اجعله يقوم بتشغيل مجموعة الاختبارات والمدققين اللغويين بشكل متكرر.
- إذا توقف، أضف المزيد من السياق: أسماء الملفات أو تتبعات المكدس أو السجلات.
نصيحة للمحترفين: شجع التغييرات الصغيرة بحجم PR بدلاً من التعديلات المتجانسة. هذا يساعد في قابلية المراجعة والتراجع.
نماذج لسير العمل يمكنك نسخها
1) تنفيذ الميزة
- الأمر: "أضف تصدير CSV إلى صفحة
orders. استخدم ترقيم الصفحات من جانب الخادم، وقم بتدفق النتائج عبر text/csv. أضف زر Export في OrdersTable.jsx ونقطة النهاية في routes/orders.ts. قم بتضمين اختبارات للترقيم والترويسات."
- يفحص المستودع؛ مسودات الخطة
- يضيف نقطة النهاية وزر العميل
- أنت تشرف، وتوافق على التغييرات، وتدمج بمجرد أن يصبح أخضر.
2) تصحيح خطأ في البناء
- الأمر: "CI تفشل في Node 20. أصلح أخطاء استيراد ESM / CJS في
build.mjs. حافظ على ملحقات rollup الحالية؛ قم بتحديث التكوين والتعليمات البرمجية لتمرير CI."
- توفير السجلات أو الارتباط بـ CI artifacts.
- اطلب من OpenHands تكرارها محليًا (
npm run build) واقتراح اختلافات قليلة.
3) تغطية الاختبار وتقوية
- الأمر: "قم بزيادة التغطية لـ
payments/service.py من 62٪ إلى 85٪ +. أضف وحدات اختبار لـ retry_charge و refund و webhook_signature. لا تقم بتعديل منطق الأعمال إلا إذا كشف الاختبار عن خطأ."
- اسمح لـ OpenHands بإنشاء الاختبارات وتشغيلها وتحسينها.
4) الوثائق وتجربة المطور
- الأمر: "أنشئ
CONTRIBUTING.md و DEVELOPMENT.md لهذا المستودع. قم بتضمين إعداد البيئة والبرامج النصية وأوامر الاختبار وإرشادات PR."
- اجعله يتحقق من الأوامر عن طريق تشغيلها بالفعل.
الضمانات: حافظ على OpenHands مفيدًا وآمنًا
- نطاق الدليل: وجهه إلى مستودع أو دليل معين لتجنب التعديلات العرضية في أماكن أخرى.
- حماية الملف: ضع علامة على ملفات التكوين أو البنية التحتية الهامة على أنها للقراءة فقط حيثما أمكن ذلك.
- تدقيق الأوامر: طلب الموافقة على الأوامر المدمرة (على سبيل المثال،
rm -rf ، إعادة تعيين قاعدة البيانات).
- نظافة الأسرار: لا تقم أبدًا بلصق مفاتيح API في الأوامر. استخدم متغيرات البيئة والسجلات المقنعة.
- الوصول إلى الشبكة: إذا تم تمكين التصفح، فضعه في وضع الحماية وقم بتسجيل المكالمات الصادرة.
النماذج المحلية مقابل السحابية: اختيار ما هو مناسب لك
- الإيجابيات: استدلال / ترميز قوي، الحد الأدنى من الإعداد، التكرار السريع
- السلبيات: التكلفة المستمرة، اعتبارات إدارة البيانات
- الإيجابيات: الخصوصية والتحكم والقدرة على التنبؤ بالتكلفة
- السلبيات: متطلبات الأجهزة، جودة النموذج تختلف، الحاجة إلى المزيد من الضبط
راجع إرشادات LLMs المحلية الرسمية لتكوين الواجهات الخلفية للنموذج وحدود الذاكرة.
اللعب الجماعي: استخدام OpenHands في تدفق تعاوني
- سير عمل الفرع أولاً: اطلب من OpenHands إنشاء فرع ميزة ودفع التغييرات لمراجعة PR.
- نظافة الالتزام: اطلب منه إنتاج عمليات التزام ذرية برسائل واضحة والإشارة إلى أرقام المشكلات.
- قوالب PR: قم بإنشاء وفرض قوالب PR حتى يعرف المراجعون ما الذي تغير ولماذا.
- مالكو التعليمات البرمجية: ادمج مع CODEOWNERS لتوجيه PRs التي تم إنشاؤها بواسطة الذكاء الاصطناعي إلى المراجعين المناسبين.
استكشاف الأخطاء وإصلاحها للمشكلات الشائعة
- إنه عالق أو يدور: قم بتضييق النطاق. اطلب منه شرح خطوته التالية. قدم اختبارًا فاشلاً.
- اختلافات فوضوية: اطلب خطة أصغر ومرحلية - الاختبارات أولاً، ثم الحد الأدنى من تغييرات التعليمات البرمجية.
- تحريرات ملفات خاطئة: حدد المسارات الدقيقة وذكره بالحدود.
- الاجتياز محليًا ولكن الفشل في CI: شارك تفاصيل بيئة CI والسجلات؛ اجعله يتكرر بحاوية.
نصائح الأداء والتحركات القوية
- سياق البداية الدافئة: اطلب منه قراءة الملفات الرئيسية أولاً (
README ، package.json ، ملفات الخدمة الرئيسية).
- امنحه البرامج النصية: قم بتوفير
make test أو npm run verify حتى يتمكن من التحقق بسرعة.
- علم المجال: قدم نظرة عامة معمارية موجزة؛ إنه يؤتي ثماره في عدد أقل من أخطاء المنطق.
- فرض النمط: أشر إلى
.eslintrc ، .prettierrc ، black/ruff تكوينات حتى يتم تنسيقها بشكل صحيح.
- استخدم نقاط التفتيش: بعد كل مرحلة، اطلب ملخصًا والخطوات التالية لإبقائه على المسار الصحيح.
سيناريو واقعي: من تقرير الخطأ إلى التصحيح في ساعة
- الوضع: خطأ في الإنتاج يسقط 500s غير معالجة على حمولات JSON المشوهة في
orders API.
- الأمر الخاص بك: "استنساخ 500 على JSON المشوه في
orders POST. أضف التحقق من المخطط وأرجع 400 مع تفاصيل الخطأ. قم بتحديث الاختبارات لتغطية الحمولات المشوهة."
- يقوم بتشغيل API محليًا، ويعيد إنتاج الخطأ
- يضيف طبقة تحقق ومعالج أخطاء
- يقوم بتحديث الاختبارات ويضمن اجتياز CI
- ينتج PR مضغوطًا مع إدخال سجل التغييرات
الوقت الذي تم توفيره: لقد ركزت على تحليل التأثير والنشر، بينما تعامل OpenHands مع السقالات.
عمليات التكامل التي تشحن OpenHands
- مشغلات الاختبار: pytest ، Jest ، Vitest ، JUnit
- أدوات البناء: Vite ، Webpack ، Rollup ، Babel
- مديرو الحزم: npm ، pnpm ، yarn ، pip / poetry
- المدققون اللغويون / المنسقون: ESLint ، Prettier ، black ، ruff
- الحاويات: Docker Compose للتكافؤ المحلي مع CI
من خلال توحيد هذه الأدوات، يمكن لـ OpenHands التفكير في مجموعتك بشكل أكثر موثوقية وأتمتة المزيد من حلقة التطوير.
بالمناسبة: استخدام Sider.AI جنبًا إلى جنب مع OpenHands
نتيجة الملاءمة: 8/10. إذا كنت تستخدم OpenHands كمهندس AI الخاص بك، فمن الجدير إقرانه ببحث ومسودة مساعد للمواصفات وأوصاف PR والوثائق. بالمناسبة، يمكن أن يساعدك Sider.AI في صياغة المواصفات الفنية بسرعة، أو تلخيص RFCs، أو تحويل سجلات تشغيل OpenHands إلى سجلات تغيير نظيفة وملاحظات إصدار. يقلل الجمع بينهما من تبديل السياق: يعالج OpenHands إجراءات التعليمات البرمجية بينما يحول Sider.AI النتائج إلى وثائق نظيفة ومرئية للمستخدم.
قائمة التحقق من الأمن والخصوصية والامتثال
- احتفظ بالأسرار في متغيرات البيئة؛ لا تقم أبدًا بتضمين المفاتيح في الأوامر
- راجع كل تغيير تم إنشاؤه بواسطة الذكاء الاصطناعي كما تفعل مع PR لمطور مبتدئ
- تسجيل الأوامر والإجراءات من أجل التدقيق
- تثبيت إصدارات سلسلة الأدوات؛ تجنب الترقيات العرضية في ملفات التأمين
- إذا كنت تستخدم LLMs السحابية، فقم بالمواءمة مع سياسات الاحتفاظ بالبيانات الخاصة بك
متى لا تستخدم OpenHands
- تصميم خوارزمية جديدة بدون اختبار قوي أو سقالات المواصفات
- قواعد التعليمات البرمجية المنظمة للغاية بدون عملية مراجعة قوية
- البرامج النصية العشوائية لمرة واحدة حيث يكون الترميز اليدوي أسرع
أول 60 دقيقة لك مع OpenHands: كتاب لعب مصغر
- الدقيقة 0-10: التثبيت والتشغيل باستخدام البداية السريعة الرسمية
- الدقيقة 10-20: قم بتوصيل المستودع الخاص بك؛ اطلب منه تعيين هيكل المشروع
- الدقيقة 20-35: حدد هدفًا صغيرًا وقابلاً للاختبار؛ الموافقة على خطتها
- الدقيقة 35-50: دعه ينفذ ويشغل الاختبارات؛ دفعة حسب الحاجة
- الدقيقة 50-60: مراجعة الاختلافات والتحسين والدمج في فرع ميزة
الروابط الرئيسية والخطوات التالية
- وثائق "Start Building" والاستخدام الرسمية لـ OpenHands: نصائح، وبداية سريعة، وأفضل الممارسات.
- دليل إعداد LLM المحلي: تكوين وتشغيل OpenHands بالكامل على جهازك.
- إرشادات التثبيت التي يقودها المجتمع على VM: خطوات تثبيت واقعية ومشروع تجريبي سريع.
الوجبات السريعة
- قم بتأطير المهام مثل التذاكر بمعايير قبول واضحة.
- حافظ على التكرارات صغيرة؛ اختبر مبكرًا وغالبًا.
- استخدم الضمانات وراجع التغييرات - تعامل معها كزميل مبتدئ.
- اختر السحابة للراحة، والنماذج المحلية للخصوصية.
- قم بالإقران مع أدوات التوثيق (على سبيل المثال، Sider.AI) لتسريع المواصفات وملاحظات الإصدار.
الأسئلة الشائعة
س 1: كيف أقوم بتثبيت وبدء استخدام AI OpenHands بسرعة؟
استخدم البداية السريعة الرسمية لتثبيت المتطلبات الأساسية، وقم بتوصيل LLM مدعوم (سحابي أو محلي)، وتشغيل واجهة المستخدم لتوصيل المستودع الخاص بك. توفر مستندات "Start Building" إرشادات خطوة بخطوة مع نصائح الإعداد.
س 2: هل يمكنني تشغيل OpenHands باستخدام LLM محلي بدلاً من نموذج سحابي؟
نعم. اتبع دليل LLMs المحلي لتكوين واجهة خلفية لنموذج محلي وضبط إعدادات السياق. هذا مثالي للمشاريع الحساسة للخصوصية أو تجنب تكاليف API.
س 3: ما هي أفضل طريقة لحث OpenHands على مهام الترميز؟
اكتب المطالبات مثل التذاكر الموجزة: حدد الهدف، وأشر إلى ملفات معينة، وقم بتعيين الحدود، وقم بتضمين معايير القبول. اطلب منه إنشاء أو تشغيل اختبارات للتحقق من التقدم.
س 4: هل AI OpenHands آمن للاستخدام في كود الإنتاج؟
تعامل معه كمطور مبتدئ: استخدم حماية الفروع ومراجعة التعليمات البرمجية و CI للتحقق من التغييرات. أضف ضمانات للأوامر واحتفظ بالأسرار خارج المطالبات.
س 5: كيف تقارن OpenHands بمساعد التعليمات البرمجية التقليدي؟
على عكس الأدوات التي تعتمد على الدردشة فقط، يمكن لـ OpenHands تشغيل الأوامر وتحرير الملفات والتكرار بشكل مستقل داخل المستودع الخاص بك. تم تصميمه لمهام شاملة مثل الميزات وتصحيح الأخطاء والاختبارات.
