mokxi هي أداة سطر أوامر صغيرة بلا أي اعتماديات أخرى. تحتاج Node.js 18 أو أحدث. شغّلها بـ npx @mokxi/cli، أو ثبّتها مرة واحدة بـ npm install -g @mokxi/cli.
دخول
npx @mokxi/cli login
It shows a short code and opens mokxi.com/device. وافق عليه هناك، فتحصل الأداة على رمز خاص بها. للصق رمز أنشأته تحت
Settings > Developer instead, run npx @mokxi/cli login --paste.
يُحفظ الرمز في مجلد الإعدادات الخاص بالمستخدم (~/.config/mokxi/config.json، أو تحت XDG_CONFIG_HOME)، ولا يمكن قراءته إلا من قبلك. الأمر npx @mokxi/cli logout يمحوه، ويمكنك إبطاله تحت الإعدادات > المطوّر عند الانتهاء منه.
الأوامر
| الأمر | ماذا تفعل |
|---|---|
mokxi list |
مشاريعك، مع معرّفاتها |
mokxi new <board> [dir] |
ينشئ مشروعًا للوحة، مثل mokxi new uno blink |
mokxi pull <id or link> [dir] |
يكتب المشروع كملفات (انظر أدناه) |
mokxi pull |
داخل مجلد مسحوب: يجلب أحدث نسخة |
mokxi push [dir] |
يرسل المجلد إلى Mokxi، وينشئ المشروع في المرة الأولى |
mokxi run [dir] [--timeout 10s] |
يترجمه ويشغّله على جهازك ويطبع المخرج التسلسلي أولًا بأول |
mokxi test [dir] |
يشغّل سيناريوهات ملف mokxi.test.yaml الخاص بالمجلد ويبلّغ عن كل واحد |
mokxi run --cloud [dir] |
يشغّله على خوادم Mokxi بدلًا من ذلك |
mokxi open [dir or id] |
يفتح المشروع في متصفحك |
mokxi upload [dir] --firmware FILE |
يخزّن بناءً (ملف arduino-cli بامتداد .elf) مع المشروع |
mokxi boards |
اللوحات التي يحاكيها Mokxi |
mokxi --help يسرد كل الخيارات.
الملفات
mokxi pull يكتب نفس التخطيط الذي تكتبه ميزة الحفظ في GitHub في المحرر: الكود كمجلد Arduino IDE (Blink/Blink.ino وتبويباته)، والمشروع كاملًا في diagram.mokxi.json، وملف README مع شارة «افتح في Mokxi»، وإعدادات ومهام .vscode/. انظر Mokxi و VS Code و GitHub لمعرفة وظيفة كل ملف.
لذا فالبداية المعتادة هي:
npx @mokxi/cli pull https://mokxi.com/p/abc123 blink
cd blink
git init && git add . && git commit -m "From Mokxi"
ثم عدّل، ونفّذ npx @mokxi/cli push، وأرسل التغييرات كما تفعل مع أي كود. يجد النسخ المستنسخ من المستودع مشروعه في .vscode/settings.json، لذا يعمل mokxi push هناك أيضًا.
مزامنة آمنة
.mokxi/project.json يتذكّر ما تمت مزامنته آخر مرة (وهو في .gitignore).
mokxi pushيرفض العمل إذا تغيّر المشروع على Mokxi منذ آخر سحب أو دفع منك، فلا يكتب فوق عمل أُنجز في المتصفح أبدًا. أما--forceفيكتب فوقه رغم ذلك.mokxi pullيرفض العمل إذا كنت قد غيّرت ملفات لم تدفعها بعد. أما--forceفيستبدلها.- التبويب المحذوف على Mokxi يُحذف من المجلد عند السحب التالي، إلا إذا كنت قد غيّرت ذلك الملف.
mokxi push --new ينشئ مشروعًا جديدًا من المجلد بدلًا من تحديث المشروع الذي أتى منه.
التشغيل
mokxi run يترجم الكود بنفس المترجم الذي يستخدمه المحرر ويشغّله على نفس المحاكي، على جهازك أنت. لا يحتاج حسابًا ولا يكلّف شيئًا: يُنزَّل المترجم مرة واحدة (نحو 80 MB) ويُحفظ في مجلد ذاكرة مؤقتة. يمكن للمجلد أن يكون مشروع Mokxi مسحوبًا، أو مشروع Wokwi مع ملفّي diagram.json و wokwi.toml، أو كود Arduino عاديًا.
npx @mokxi/cli run --timeout 10s --expect-serial "Ready" --fail-on "panic"
تنجح العملية بمجرد أن يطبع الكود Ready، وتفشل لحظة أن يطبع panic، وتخرج بالرمز 1 إذا مضت 10 ثوانٍ من وقت المحاكاة أولًا، وهذا ما تحتاجه مهمة CI. الأمر mokxi test يشغّل ملفات السيناريوهات التي تضغط الأزرار وتغيّر قيم الحساسات وتفحص الأطراف وLEDs. الدليل اختبارات المحاكاة في CI يشرح كل ذلك، مع GitHub Action.
mokxi run --cloud يشغّله على خوادم Mokxi بدلًا من ذلك، ويُحتسب على دقائق API ضمن باقتك. ما دام المجلد مطابقًا لآخر ما تمت مزامنته، يشغّل المشروع المحفوظ، بما في ذلك البناء الذي يحتفظ به المحرر بعد ضغط «تشغيل». ومع وجود تغييرات محلية يرسل ملفات المجلد، وخوادم Mokxi لا تترجم: ابنِ بـ arduino-cli ومرّر --firmware build/Blink/Blink.ino.elf، أو ادفع واضغط «تشغيل» في المحرر مرة واحدة. run --cloud يقبل نفس فحوص mokxi simulate.
حدود الباقة
دفع مشروع جديد يُحتسب على حد المشاريع في باقتك مثل أي مشروع آخر. وعند بلوغ الحد، يطبع mokxi push نفس الرسالة التي يعرضها المحرر، ويخرج بالرمز 3.
رموز الخروج
الرمز 0 عندما ينجح كل شيء، و1 عندما تفشل عملية تشغيل في فحص (أو تنتهي مهلتها، أو لم تتم الترجمة)، و2 لخطأ في الأمر، و3 عندما يرفض Mokxi (تسجيل خروج، أو حد باقة، أو تعارض) أو عند فشل تنزيل.