ربط جهاز.

المضيف

المضيف هو البرنامج الذي يمنح منضدة العمل ملفات هذا الكمبيوتر والأجهزة الموصولة به. يوجد مضيف واحد بالضبط لكل كمبيوتر. تطبيق سطح المكتب مضيف؛ وكذلك الخدمة الخلفية التي تُشغَّل بـ commandagi daemon start. عند بدء تطبيق سطح المكتب، يحل محل خدمة تعمل.

يستمع المضيف على 127.0.0.1 فقط (المنفذ 4173 افتراضياً، أو أي منفذ حر)، ويحفظ حالته في ~/.commandagi:

الأمر commandagi

commandagi daemon start [--port N] [--project DIR] [--name X] [--no-platform]
commandagi daemon status | stop | logs
commandagi daemon run   [same flags, in the foreground]
commandagi mcp [--credential-file F]
commandagi grant add | list | revoke …
commandagi threed install | status
commandagi code eval <path> [--input name=value]…

• يشغّل daemon start المضيف في الخلفية ويكتب سجله في ~/.commandagi/daemon.log. يستضيف --no-platform محلياً دون ربط بحساب.
• يرفض daemon stop العمل ما دام تطبيق سطح المكتب هو المضيف — أغلقه من التطبيق نفسه.
• mcp هو موصِّل stdio للوكلاء (راجع SDK وMCP). وgrant ينشئ التفويضات الدائمة ويلغيها (راجع الوكلاء والتفويضات الدائمة).
• threed يثبّت خدمة التصميم ثلاثي الأبعاد المحلية؛ وcode eval يقيّم جزء كود بلا واجهة ويطبع رسم عملياته كـ JSON.

اربط المضيف بحسابك

يمكن الوصول إلى المضيف المرتبط بحساب من منضدة عمل ذلك الحساب من أي مكان، ويتصرف بوصفه ذلك الحساب. الربط هو تسجيل الدخول:

• في تطبيق سطح المكتب، سجّل الدخول عندما يطلب ذلك؛
• في صفحة منضدة العمل التي يقدمها المضيف، سجّل الدخول من الشريط الأيسر — يتحقق المضيف من المفتاح ويحتفظ به؛
• من الصدفة، اضبط COMMANDAGI_API_KEY على مفتاح API قبل تشغيل الخدمة.

يُحفظ مفتاح الحساب في host.json، وهو ملف عادي للمالك وحده، فتبقى نسخة من ~/.commandagi المنسوخة مسجلة الدخول. يؤدي تسجيل الخروج إلى حذفه.

اقترن المضيفين ببعضهم

يستطيع المضيفون على حواسيب مختلفة أن يقترنوا، في الاتجاهين، بفعل واحد: يعرض أحدهم الاقتران ويقبله الآخر. الاقتران قرار يتخذه شخص دائماً. بعد الاقتران، يستطيع الوكلاء عرض المضيفين الآخرين واستدعاءهم — ضمن التفويضات الموجودة هناك.

مشغّلات الصفحة: USB والبلوتوث من المتصفح

تعمل بعض المشغّلات داخل صفحة منضدة العمل نفسها، باستخدام WebSerial وWeb Bluetooth. لا يفتح المتصفح منفذاً إلا عندما تختاره أنت، لذا لا يستخدم الوكيل أبداً اتصالاً إلا إذا أنشأه شخص، ولا يفتح واحداً من تلقاء نفسه. تُدار الأجهزة الشبكية (واجهة HTTP للطابعة، وFluidNC على TCP) بواسطة المضيف.

المشغّلات التي تستمع لأجهزة تتصل عبر الشبكة المحلية تحتاج إلى الإعداد "devices.lanListener": true.

كتالوج المشغّلات

يذكر كل مشغّل ما تم التحقق منه باستخدامه: none (لا شيء)، أو loopback (مقابل محاكاة برمجية أمينة للبروتوكول)، أو bench (على منضدة الاختبار)، أو hardware (على العتاد). لا يدّعي المشغّل أكثر مما أُنجز. لم يُعتمد أي جهاز على العتاد بعد.

تستخدم عوالم المحاكاة مُحاكيَين بدلاً من ذلك: gcode-sim لقنوات G-code، وservo-sim لناقلات المحركات السيرفو.

التالي

امنح وكيلاً صلاحية على جهاز: الوكلاء والتفويضات الدائمة.