@phaseo/cli. وهي تربط بيئات البرمجة بـ Phaseo وتوفّر سير عمل رسميًا من الطرفية لإدارة مستوى التحكم في Phaseo.
استخدمها عندما تريد:
- تسجيل الدخول كمستخدم Phaseo من shell محلية أو بعيدة أو من بيئة وكيل
- إنشاء مفاتيح API أو مفاتيح الإدارة وتدويرها
- إدارة مساحات العمل والإعدادات المسبقة والضوابط والإعدادات
- استخدام OAuth الرسمي في CLI بينما تظل تطبيقات OAuth التي ينشئها المستخدمون قيد الاختبار الخاص
- استعراض النماذج والمزوّدين والأسعار والأرصدة والنشاط والتحليلات وعمليات الإنشاء
التثبيت
التحقق من الإصدار المثبّت
- يعرض
phaseo --versionالإصدار المثبّت. - يعرض
phaseo versionالإصدار وأمر التحديث الموصى به لمدير الحزم الحالي. - تعرض عمليات التشغيل التفاعلية أيضًا تلميحًا بالتحديث عند توفر إصدار أحدث منشور.
phaseo متاحًا كاسم مستعار للتوافق.
تسجيل الدخول
ابدأ باستخدام:- تسجيل الدخول باستخدام Phaseo: OAuth عبر المتصفح باستخدام رمز التفويض وPKCE
- تسجيل الدخول برمز الجهاز: الأنسب لـ SSH وCI وبيئات shell غير التفاعلية والوكلاء
مخرجات الطرفية
تعرض الطرفيات التفاعلية ألوان Phaseo وتسلسله المرئي ومؤشرات إعداد مؤقتة. تستخدم المؤشراتstderr وتمسح سطرها عند اكتمال العمل. يعطّل stderr غير التفاعلي وTERM=dumb الحركة، بينما يعطّل NO_COLOR الألوان. تعيد الأوامر التي تستخدم --json دائمًا مخرجات منظّمة بلا زخرفة للوكلاء والأتمتة. استخدم FORCE_COLOR=1 فقط عندما يدعم غلاف الطرفية الألوان لكنه لا يعرّف نفسه كـ TTY.
تأكيد هويتك
إنشاء المفاتيح
--json عندما يحتاج وكيل أو إجراء آلي إلى المفتاح المُنشأ بصيغته الخام لمرة واحدة.
إدارة مساحات العمل والضوابط
تشغيل بيئات البرمجة المدعومة
تستخدم التكاملات الدائمة اسم المنتج مباشرةً:--model أو --catalog all|default أو --dry-run حسب الحاجة. يبقى الشكل القديم phaseo integrations setup <integration> متاحًا للتوافق، لكنه غير مطلوب.
تستطيع CLI تشغيل Cline وKilo Code وoh-my-pi وMuse Code وMiniMax Code بإعداد مزوّد مؤقت ومفتاح Phaseo مخصص. لكل بيئة دليل تكامل للإعداد وحل المشاكل: Cline وKilo Code وoh-my-pi وMuse Code وMiniMax Code.
phaseo run <cline|kilo|omp|muse|minimax> للصيغة الصريحة. تأتي خيارات Phaseo قبل -- وخيارات البيئة بعدها. استخدم --catalog all لمزامنة كل نماذج النص والدردشة النشطة في Phaseo، أو عاين دون إنشاء بيانات اعتماد باستخدام:
--skip-install عند إدارة أي من البيئتين بشكل منفصل. لا تستبدل المشغّلات إعدادات Cline أوKilo أوoh-my-pi أوMuse Code أوMiniMax Code الموجودة.
تطبيقات OAuth
يستخدم Phaseo خادم تفويض OAuth واحدًا لواجهة CLI الرسمية والتطبيقات التي ينشئها المستخدمون وعملاء MCP المسجّلين ديناميكيًا. تستخدم CLI تسجيل الدخول عبر المتصفح أو رمز الجهاز مع تدوير رموز التحديث. وتستخدم العملاء الخارجية رمز التفويض مع PKCE ونطاقات صريحة وموافقة مساحة العمل ورموز وصول مفوّضة قابلة للإلغاء وربطًا اختياريًا بمورد محمي. تفعّل واجهة Phaseo API المستضافة OAuth للجهات الخارجية. وتبقيه عمليات النشر ذاتية الاستضافة أو التجريبية معطّلًا ما لم تُضبطPHASEO_THIRD_PARTY_OAUTH_ENABLED على قيمة صحيحة. القيم المقبولة هي 1 وtrue وyes وon، مع تجاهل حالة الأحرف بعد حذف المسافات. يؤدي التفعيل إلى إتاحة إدارة تطبيقات OAuth التي ينشئها المستخدمون والتسجيل الديناميكي للعملاء، لذا راجع إعدادات URI لإعادة التوجيه والموافقة وأسرار العملاء وحدود المعدل وتفويض مساحة العمل.
.env
Docker
Kubernetes
نموذج الأمان
تتطلب جلسات CLI افتراضيًا تخزينًا آمنًا يوفره نظام التشغيل. اضبطPHASEO_SESSION_BACKEND=file صراحةً فقط عند عدم توفر مخزن بيانات اعتماد للنظام؛ إذ يحفظ رموز التحديث في ملف نصي عادي بصلاحيات مقيّدة.
- يُبطل
phaseo logoutرمز التحديث المخزّن قبل مسح الحالة المحلية. - تتطلب مفاتيح الإدارة إمكانات محددة صراحةً.
- تعتمد مفاتيح الاستدلال العادية على الضوابط وسياسات التوجيه وإعدادات مساحة العمل بدلًا من نموذج نطاقات منفصل.