تطبيق سطح المكتب وCLI

ماذا يفعل تطبيق سطح المكتب

بُني cockpit المتصفح للتحكم عن بُعد بالروبوتات الموجودة على المنصة. يغطي تطبيق سطح المكتب النصف الآخر من سير العمل: أنت، وذراع روبوت على مكتبك، ومجموعة بيانات تريد تسجيلها بنفسك. يتصل بالذراع عبر USB، يكتشف الكاميرات المتصلة، ويرشدك في تسجيل episode تلو الآخر.

الاكتشاف تلقائي. وصّل SO-100 ويجد التطبيق منفذ التسلسل (serial port) ويحصي servo؛ تظهر كاميرات الويب المتصلة في معاينة حتى تتحقق من الإطار قبل تسجيل أي شيء. لا ملف إعدادات لكتابته ولا driver للبحث عنه.

كل ما تسجله يُكتب على القرص المحلي أولاً. لا شيء يغادر جهازك حتى ترفعه صراحةً، وهذا مهم إن كانت episodes الخاصة بك تحتوي على أشياء لست مستعداً لمشاركتها بعد، أو إن كنت تسجل في مكان بلا اتصال موثوق.

التنزيل والتثبيت

التطبيق متاح لـ macOS وWindows وLinux على /download. ثبّته، سجّل الدخول بحساب منصتك، وصّل الذراع. إن كنت تقرن روبوتاً بالمنصة في الوقت نفسه، فهذا التطبيق هو أيضاً المكان الذي تستخدم فيه رمز الإقران من المعالج.

مسار التسجيل الموجَّه

تسجيل بيانات imitation learning جيدة هو في معظمه انضباط، والتطبيق يفرض هذا الانضباط نيابة عنك. تمرّ كل episode عبر المحطات الخمس نفسها.

1. 1
   صف المهمة

   جملة واضحة واحدة، تُصاغ بالطريقة نفسها في كل مرة لنفس المهمة. تنتبه نماذج language-conditioned لهذه السلسلة النصية، لذا "pick up the red cube and place it in the bowl" أفضل بكثير من "test 4".

2. 2
   أعد ضبط المشهد

   حرّك الذراع إلى وضعية البداية وضع الأجسام. معاينة الكاميرا موجودة لتؤكد الإطار قبل الالتزام، لا بعده.

3. 3
   سجّل

   شغّل الذراع عن بُعد خلال المهمة بحركات متأنية وسلسة. توقف حالما تكتمل المهمة بدلاً من البقاء خاملاً داخل الإطار.

4. 4
   راجع

   شغّل episode مرة أخرى قبل الاحتفاظ بها. تجاهل episode سيئة يكلّف ثوانٍ؛ التدريب عليها يكلّف ساعات.

5. 5
   ارفع

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

البيانات المحلية وتصدير LeRobot

تُخزَّن episodes وتُصدَّر بصيغة LeRobot، صيغة التبادل التي تقبلها معظم منظومة تعلّم الروبوتات مفتوحة المصدر. يمكن لمجموعة بيانات مُسجَّلة بتطبيق سطح المكتب أن تدخل مباشرة في تدريب ACT أو Diffusion Policy أو SmolVLA أو GR00T fine-tune.

CLI

يُثبَّت CLI بشكل مستقل، دون تطبيق سطح المكتب، ما يجعله الخيار الصحيح للأجهزة بلا واجهة رسومية وللبرامج النصية. على macOS وLinux:

curl -fsSL https://www.ay-robots.com/install.sh | sh

على Windows، في PowerShell:

irm https://www.ay-robots.com/install.ps1 | iex

يصادق CLI باستخدام مفتاح API. أنشئه من /dashboard/settings؛ يحمل المفتاح البادئة ayr_live_ ويجب معاملته مثل كلمة المرور، لذا احتفظ به في بيئة shell أو في مدير أسرار، لا في برامج نصية تُرسلها إلى commit.

MCP: محلي ومُستضاف

إن كنت تعمل مع مساعد أو محرر يدعم MCP، يمكن الوصول إلى المنصة عبر Model Context Protocol بطريقتين. يعمل الخادم المحلي على جهازك ويبدأ بأمر واحد:

ay-robots mcp

يقع الخادم المُستضاف على https://www.ay-robots.com/api/mcp ويتحدث Streamable HTTP. لا يحتاج تثبيتاً محلياً: وجّه عميل MCP لديك إلى هذا الرابط وصادق بمفتاح API بادئته ayr_live_ من /dashboard/settings للعمل مع بيانات حسابك.

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