CLI

المصادقة

سجّل الدخول إلى CLI عبر متصفحك أو رمز جهاز أو مفتاح API، وأعدّ بيانات الاعتماد للسكربتات وCI.

يسجّل CLI الدخول عبر متصفحك أو رمز جهاز أو مفتاح API، وفي السكربتات وCI يقرأ بيانات الاعتماد من علم أو متغير بيئة. شغّل polylane auth login لاختيار طريقة تفاعلياً، أو مرّر علماً لتجاوز المنتقي.

طرق تسجيل الدخول

الطريقة	الأمر	الوصف
المتصفح	`polylane auth login`	للاستخدام التفاعلي. يفتح CLI متصفحك، ويتلقى الرموز على رد نداء localhost، ويحدّثها عند انتهاء صلاحيتها.
رمز الجهاز	`polylane auth login --no-browser`	لـ SSH والأجهزة بلا واجهة. يطبع CLI عنوان URL ورمزاً؛ افتح العنوان على أي جهاز، وأدخل الرمز، ويستقصي CLI حتى توافق.
مفتاح API	`polylane auth login --api-key sk_xxxxx`	للسكربتات وCI والوكلاء. يتحقق CLI من المفتاح ويخزّنه مع مساحة عمل افتراضية.

بعد تسجيل الدخول يعرض CLI من أنت، وإن كنت تنتمي إلى أكثر من مساحة عمل، يطلب منك اختيار واحدة افتراضية، تُحفظ على شكل workspace_id في ~/.polylane/config.json. أجبر تحديث الرمز بـ polylane auth refresh.

مفاتيح API

أنشئ مفتاحاً تحت Settings > API Keys بـ Create an API key: سمّه، واختر نطاقاته، وانسخه، لأنه يُعرض مرة واحدة. تبدأ المفاتيح بـ sk_. في CI، اضبط POLYLANE_API_KEY في البيئة بدلاً من تشغيل خطوة تسجيل الدخول، أو مرّر العلم العام --api-key <key> في استدعاء واحد.

أسبقية بيانات الاعتماد

حين توجد عدة بيانات اعتماد، يحلّها CLI بهذا الترتيب:

العلم --api-key على الأمر الحالي
متغير البيئة POLYLANE_API_KEY
بيانات اعتماد OAuth في ~/.polylane/credentials.json
api_key في ~/.polylane/config.json

يتغلب POLYLANE_API_KEY المصدَّر دائماً على ~/.polylane/credentials.json قديم، فلا يلتقط مشغّل CI الذي ضُبط فيه المتغير رموز OAuth المتبقية. يعرض polylane auth status المصدر المستخدم.

التحقق والتبديل

Terminal

polylane auth status
polylane auth whoami
polylane auth logout

يعرض auth status الطريقة المستخدمة ورمزاً مقنّعاً والمستخدم ومساحة العمل؛ ويعرض auth whoami المستخدم الحالي. ويلغي auth logout رموز OAuth ويمسح بيانات الاعتماد المخزّنة بعد تأكيد يتجاوزه --yes؛ وللتبديل بين الحسابات، سجّل الخروج ثم سجّل الدخول ببيانات الاعتماد الأخرى.

متغيرات البيئة

المتغير	الوصف
`POLYLANE_API_KEY`	مفتاح API للمصادقة غير التفاعلية
`POLYLANE_WORKSPACE_ID`	مساحة العمل الافتراضية (معرّف `ws_`)
`POLYLANE_API_DOMAIN`	تجاوز اسم مضيف API