@phaseo/cli وشغّل phaseo login لربط وكلاء البرمجة بـ Phaseo وإدارة المفاتيح ومساحات العمل والإعدادات المسبقة والإعدادات وحواجز الحماية من الطرفية. تقرأ CLI أيضًا النماذج والمزوّدين والأسعار والرصيد والنشاط والتحليلات وعمليات التوليد.
التثبيت
تعرض عمليات التشغيل التفاعلية أيضًا تلميحًا عند نشر إصدار أحدث.
تسجيل الدخول
تستخدم البيئات البعيدة وغير التفاعلية رمز الجهاز تلقائيًا. تحقق من الحساب الذي سجّلت الدخول به، مع نطاقاتك ومساحة العمل النشطة ومساحات العمل الأخرى:
إدارة مساحة العمل
--json عندما يقرأ وكيل أو برنامج نصي المخرجات. تغطي CLI المهام اليومية في الحساب؛ أما تغييرات حدود المفاتيح والميزانيات وBYOK وقواعد التوجيه والإعدادات المسبقة والهوية فتُجرى من لوحة التحكم أو باستخدام مفتاح إدارة. راجع إدارة Phaseo من وكيل لمعرفة المهام التي تغطيها CLI.
ربط وكيل برمجة
استخدم اسم الوكيل كأمر. تطلب CLI مفتاحًا مخصصًا توافق عليه في المتصفح، ثم تكتب إعداد الوكيل:--model أو --catalog all|default أو --dry-run حسب الحاجة. يعمل أيضًا phaseo setup <agent> وphaseo integrations setup <agent>.
الموافقة على المفتاح في المتصفح
عند إعداد وكيل لأول مرة، تفتح CLI صفحة في لوحة تحكم Phaseo وتعرض رابطها. تعرض الصفحة مساحة العمل واسم المفتاح وحد الإنفاق الشهري البالغ $100 وانتهاء الصلاحية بعد 90 يومًا، وأن Phaseo CLI هي التي طلبته. اختر الموافقة وإنشاء المفتاح لتستلم CLI المفتاح مرة واحدة وتُكمل الإعداد. إذا اخترت رفض، أو تركت الطلب حتى تنتهي صلاحيته بعد 10 دقائق، فلن يُنشأ أي شيء. وافق وأنت مسجّل الدخول إلى لوحة التحكم بالحساب الذي استخدمته في CLI، بصفتك مالكًا لمساحة العمل أو مسؤولًا عنها، ومع عامل التحقق الثاني إذا كنت قد أعددته. عبر SSH أو في CI، افتح الرابط المعروض على أي جهاز سجّلت الدخول عليه. لاستخدام مفتاح أنشأته في لوحة التحكم بدلًا من ذلك، مرّره باستخدام--key <key>، أو باستخدام --key-stdin لإبقائه خارج سجل الصدفة. تتحقق CLI من المفتاح وتحفظه، ولا تلغيه عند إزالة الوكيل.
لتشغيل Cline أو Kilo Code أو oh-my-pi أو Muse Code أو MiniMax Code بإعدادات مؤقتة تُحذف عند خروجه، استخدم مشغّل الجلسات. توضع خيارات Phaseo قبل --، وخيارات الوكيل الخاصة بعده:
phaseo run <cline|kilo|omp|muse|minimax> هو الصيغة الطويلة. أضف --catalog all لسرد كل نماذج النص النشطة في Phaseo، أو --dry-run --json للمعاينة دون إنشاء مفتاح. تعرض المشغّلات تثبيت الوكيل المفقود في الطرفية التفاعلية (يستخدم MiniMax Code مثبّت PowerShell الرسمي على Windows؛ ويجب تثبيت Muse Code يدويًا على Windows). استخدم --skip-install عندما تدير الوكيل بنفسك.
تسرد صفحة وكلاء البرمجة كل وكيل، وما يفعله أمره، ودليله.
كتابة البرامج النصية باستخدام CLI
تطبع الأوامر مع--json مخرجات منظمة عادية دون ألوان أو مؤشرات دوّارة. في غير ذلك، تذهب المؤشرات الدوّارة إلى stderr وتمسح سطرها عند الانتهاء.
كيف تحافظ CLI على أمان بيانات الاعتماد
- تُحفظ الجلسات في مخزن بيانات الاعتماد في نظام التشغيل. اضبط
PHASEO_SESSION_BACKEND=fileفقط إذا لم يتوفر مخزن لبيانات الاعتماد؛ فهو يحفظ رموز التحديث في ملف نصي صريح مقيّد الأذونات. - يلغي
phaseo logoutرمز التحديث المحفوظ قبل مسح الحالة المحلية. - تحتاج مفاتيح الإدارة إلى صلاحيات صريحة. تُقيَّد مفاتيح الاستدلال بحواجز الحماية وسياسات التوجيه وإعدادات مساحة العمل بدلًا من النطاقات.
تطبيقات OAuth
يستخدم Phaseo خادم تفويض OAuth واحدًا لـ CLI والتطبيقات التي ينشئها المستخدمون وعملاء MCP المسجّلين ديناميكيًا. تستخدم CLI تسجيل الدخول عبر المتصفح أو الجهاز مع رموز تحديث متناوبة. تستخدم العملاء الخارجية رمز التفويض مع PKCE، ونطاقات صريحة وموافقة على مساحة العمل، وربطًا اختياريًا بالمورد المحمي. تحصل على رمز وصول قابل للإلغاء يدوم 7 أيام ورمز تحديث متناوب يدوم 90 يومًا من آخر استخدام له؛ راجع إنشاء Workbench لـ OAuth باستخدام Next.js لمعرفة كيفية عمل التحديث. الموافقة على التطبيق نفسه مرة أخرى تجدد مفتاحه بدلًا من إضافة مفتاح ثانٍ. تفعّل واجهة Phaseo API المستضافة OAuth للجهات الخارجية. تُبقيه عمليات نشر API المستضافة ذاتيًا ونشر المعاينة معطّلًا ما لم تكن قيمةPHASEO_THIRD_PARTY_OAUTH_ENABLED صحيحة: 1 أو true أو yes أو on، دون تمييز حالة الأحرف، مع تجاهل المسافات المحيطة.
.env