دليل الأوامر

شرح لكل أمر في SMART.

استخدم هذا المرجع لفهم ما يغيّره كل أمر، ثم انسخ الصيغة الدقيقة التي تحتاج إليها.

مرجع الأوامر

تستخدم أمثلة التوليد --dry-run لإنشاء خطة قابلة للمراجعة من دون كتابة ملفات. استبدله بـ --yes فقط بعد مراجعة الملفات المخططة.

فحص البيئة

يتحقق من كتالوج التوليد المضمّن وكل قالب مسجّل قبل إنشاء أي مشروع.

smart doctor
كتالوج التوليد

يسرد وصفات التوليد المعتمدة على البيانات ومعرّفاتها.

smart catalog list

يعرض غرض وصفة واحدة وأدوارها المطلوبة ومعاملاتها وإصدارها.

smart catalog describe service/edocument
المشاريع

يخطط لمشروع SOKit rc8 جديد بهوية وحزمة وتخطيط مستودع محددة بوضوح.

smart project init ./platform --id platform --name Platform --group com.example --base-package com.example.platform --topology monorepo --dry-run

يفحص مستودعًا موجودًا ويخطط لإعدادات SMART من دون استبدال ملفات التطبيق.

smart project adopt . --dry-run

يقرأ التخطيط والإعدادات والمكونات والأدلة المكتشفة من دون تغيير المشروع.

smart project inspect .

يفحص إعدادات المشروع وملفاته المكتشفة ثم يعرض مشكلات تحقق قابلة للمعالجة.

smart project validate .
تطبيقات الواجهة

يخطط لتطبيق SOKit UI 1.1.4 داخل المشروع والموقع المحددين.

smart app add ui portal --project . --dry-run
الخدمات

يخطط لخدمة مستندات إلكترونية rc8 بحدود وحدات البيانات والمستندات.

smart service add edocument documents --project . --dry-run

يخطط لخدمة المراجع rc8 الوحيدة في المشروع ووحدات التخزين التابعة لها.

smart service add reference references --project . --dry-run

يخطط لخدمة التخزين rc8 الوحيدة في المشروع مع برنامج التشغيل المحدد.

smart service add bucket files --project . --dry-run

يخطط لخدمة الإشعارات rc8 الوحيدة في المشروع وبرامج التسليم الاختيارية.

smart service add notifier notifications --project . --dry-run
نطاقات التخزين

يخطط لنطاق صالح في خدمة تخزين موجودة، بما يشمل التخزين والحدود وأنواع الوسائط والأدوار.

smart bucket scope add attachments --storage primary --project . --dry-run
المصادقة

يفتح تسجيل الدخول الآمن في المتصفح ويحفظ بيانات اعتماد SMART الناتجة لهذا الملف الشخصي.

smart auth login

يعرض رمز QR محليًا ورابط تحقق ورمزًا قصيرًا، ثم ينتظر إكمال تسجيل الدخول من أي متصفح.

smart auth login --device

يحدّث جلسة SMART الحالية ويحمّل أدوارها الفعلية فورًا.

smart auth refresh

يعرض ما إذا كان الملف الشخصي الحالي مسجّل الدخول والهوية التي يستخدمها.

smart auth status

يسجّل الخروج من SMART ويحذف بيانات الاعتماد المحفوظة محليًا للملف الشخصي الحالي.

smart auth logout

تسجيل الدخول عبر الجهاز، من الطرفية إلى SMART

لقطات محلية حقيقية لتدفق تفويض جهاز مكتمل باستخدام واجهة SMART الأصلية المترجمة لسطر الأوامر. يُعرض نموذجا الرمز وبيانات الاعتماد كخطوتين منفصلتين، لكن يُغفل الإدخال؛ ولا تظهر أي كلمة مرور أو رمز وصول أو بيانات اعتماد قابلة لإعادة الاستخدام.

قراءة النص الكامل
  1. شغّل smart auth login --device؛ يعرض SMART في الطرفية رمز QR محليًا ورابط تحقق ورمزًا قصيرًا صالحًا لمرة واحدة.
  2. يوضح نموذج Device Login الحقيقي في Keycloak موضع إدخال الرمز الصالح لمرة واحدة؛ ويبقى الحقل فارغًا في التسجيل.
  3. بعد إرسال الرمز، يطلب Keycloak اسم المستخدم وكلمة المرور؛ ويُغفل إدخال بيانات الاعتماد عمدًا.
  4. يؤكد Keycloak نجاح Device Login في الجلسة المكتملة نفسها.
  5. تعرض جلسة واجهة SMART الأصلية نفسها لسطر الأوامر Signed in to SMART وتؤكد الدورين skills:sokit وtools:sokit.
خدمة SMART المحلية

يشغّل خدمة MCP المحلية لـ SMART للملف الشخصي المسجّل دخوله حاليًا.

smart mcp start

يعرض ما إذا كانت خدمة MCP المحلية لـ SMART تعمل وكيف يمكن للعملاء الوصول إليها.

smart mcp status

يوقف خدمة MCP المحلية لـ SMART من دون إزالة تكاملات الوكلاء.

smart mcp stop
تكاملات الوكلاء

يربط Codex بخدمة MCP المحلية لـ SMART مع الحفاظ على الإعدادات غير المرتبطة.

smart mcp integrate codex on

يزيل فقط إدخالات SMART المُدارة من تكامل Codex.

smart mcp integrate codex off

يربط Claude Code بخدمة MCP المحلية لـ SMART مع الحفاظ على الإعدادات غير المرتبطة.

smart mcp integrate claude on

يزيل فقط إدخالات SMART المُدارة من تكامل Claude Code.

smart mcp integrate claude off

يربط Cursor بخدمة MCP المحلية لـ SMART مع الحفاظ على الإعدادات غير المرتبطة.

smart mcp integrate cursor on

يزيل فقط إدخالات SMART المُدارة من تكامل Cursor.

smart mcp integrate cursor off

يربط Cline بخدمة MCP المحلية لـ SMART مع الحفاظ على الإعدادات غير المرتبطة.

smart mcp integrate cline on

يزيل فقط إدخالات SMART المُدارة من تكامل Cline.

smart mcp integrate cline off

يربط Gemini CLI بخدمة MCP المحلية لـ SMART مع الحفاظ على الإعدادات غير المرتبطة.

smart mcp integrate gemini-cli on

يزيل فقط إدخالات SMART المُدارة من تكامل Gemini CLI.

smart mcp integrate gemini-cli off

يربط GitHub Copilot CLI بخدمة MCP المحلية لـ SMART مع الحفاظ على الإعدادات غير المرتبطة.

smart mcp integrate github-copilot-cli on

يزيل فقط إدخالات SMART المُدارة من تكامل GitHub Copilot CLI.

smart mcp integrate github-copilot-cli off

يربط Windsurf بخدمة MCP المحلية لـ SMART مع الحفاظ على الإعدادات غير المرتبطة.

smart mcp integrate windsurf on

يزيل فقط إدخالات SMART المُدارة من تكامل Windsurf.

smart mcp integrate windsurf off

يربط Zed بخدمة MCP المحلية لـ SMART مع الحفاظ على الإعدادات غير المرتبطة.

smart mcp integrate zed on

يزيل فقط إدخالات SMART المُدارة من تكامل Zed.

smart mcp integrate zed off

يربط VS Code بخدمة MCP المحلية لـ SMART مع الحفاظ على الإعدادات غير المرتبطة.

smart mcp integrate vscode on

يزيل فقط إدخالات SMART المُدارة من تكامل VS Code.

smart mcp integrate vscode off

يربط JetBrains بخدمة MCP المحلية لـ SMART مع الحفاظ على الإعدادات غير المرتبطة.

smart mcp integrate jetbrains on

يزيل فقط إدخالات SMART المُدارة من تكامل JetBrains.

smart mcp integrate jetbrains off
الإكمال التلقائي في الصدفة

ينشئ تعريفات الإكمال التلقائي للأوامر في صدفة bash.

smart completion bash

ينشئ تعريفات الإكمال التلقائي للأوامر في صدفة zsh.

smart completion zsh

ينشئ تعريفات الإكمال التلقائي للأوامر في صدفة fish.

smart completion fish

ينشئ تعريفات الإكمال التلقائي للأوامر في صدفة pwsh.

smart completion pwsh

ينشئ تعريفات الإكمال التلقائي للأوامر في صدفة nu.

smart completion nu
الإزالة

يوقف SMART ويزيل تكاملات الوكلاء وملفات الخدمة التي يديرها.

smart mcp uninstall
مخرجات مقروءة آليًا

يعيد حالة المصادقة بتنسيق JSON لاستخدامها في البرامج النصية وأدوات التطوير.

smart auth status --json

يعيد حالة خدمة MCP المحلية لـ SMART بتنسيق JSON للبرامج النصية وفحوصات السلامة.

smart mcp status --json
المساعدة والإصدار

يسرد مجموعات أوامر SMART والخيارات المتاحة لكل مجموعة.

smart help

يعرض مساعدة المستوى الأعلى نفسها باستخدام صيغة الخيار القياسية.

smart --help

يطبع إصدار أداة SMART المثبّتة.

smart version

يطبع إصدار أداة SMART المثبّتة باستخدام صيغة الخيار القياسية.

smart --version