الإعدادات
يقرأ CLI كل إعداد من الأعلام ومتغيرات البيئة وملف إعداداته والقيم الافتراضية المضمّنة، ويخزّن كل شيء تحت ~/.polylane. تسرد هذه الصفحة الترتيب والمتغيرات وكيفية التحكم في بيانات الاستخدام.
الأسبقية
يحلّ CLI كل إعداد بهذا الترتيب، والأعلى يفوز:
- أعلام CLI، على سبيل المثال
--workspaceو--api-keyو--outputو--timeout. - متغيرات البيئة: مجموعة
POLYLANE_*إضافة إلىNO_COLORوDO_NOT_TRACKالقياسيين. - لبيانات الاعتماد فقط، رموز OAuth في
~/.polylane/credentials.json. - ملف الإعدادات في
~/.polylane/config.json. - القيم الافتراضية المضمّنة: النطاق
api.polylane.com، والمهلة 300 ثانية، والمخرجاتtextفي الطرفية وjsonعند التوجيه عبر أنبوب.
يتغلب POLYLANE_API_KEY المصدَّر دائماً على ~/.polylane/credentials.json قديم، فلا يلتقط مشغّل CI الذي ضُبط فيه المتغير رموز OAuth المتبقية. تسرد المصادقة الترتيب نفسه لبيانات الاعتماد.
ملف الإعدادات
يقبل ~/.polylane/config.json ستة مفاتيح: domain وworkspace_id وapi_key وoutput وtimeout وtelemetry. أدره عبر CLI: يطبع config show الإعدادات المحلولة وطريقة المصادقة المستخدمة ومسار الملف، مع تقنيع مفاتيح API.
polylane config show
polylane config set --key output --value json
لضبط مساحة العمل الافتراضية بالـ slug بدلاً من المعرّف، شغّل polylane workspace use <slug>. تعيش بيانات اعتماد OAuth منفصلة في ~/.polylane/credentials.json وتتحدّث من تلقاء نفسها حين يقارب رمز الوصول انتهاء صلاحيته.
متغيرات البيئة
| المتغير | الوصف |
|---|---|
POLYLANE_API_KEY | المصادقة من دون تخزين مفتاح على القرص |
POLYLANE_WORKSPACE_ID | ضبط مساحة العمل لجلسة shell الحالية |
POLYLANE_API_DOMAIN | الإشارة إلى اسم مضيف API مختلف؛ اسم المضيف فقط، من دون بروتوكول |
POLYLANE_OUTPUT | إجبار مخرجات text أو json |
POLYLANE_TIMEOUT | مهلة الطلب بالثواني |
POLYLANE_VERBOSE | تمكين التسجيل المفصّل |
POLYLANE_TELEMETRY=0 | تعطيل بيانات الاستخدام لهذه البيئة |
DO_NOT_TRACK=1 | الانسحاب العام من بيانات الاستخدام؛ يتجاوز كل إعداد آخر لبيانات الاستخدام، بما في ذلك ملف الإعدادات |
NO_COLOR | تعطيل ألوان ANSI |
بيانات الاستخدام
بيانات الاستخدام المجهولة مفعّلة افتراضياً. تسجّل اسم الأمر، وأسماء الأعلام، وعدد الوسائط الموضعية، ورمز الخروج وفئة الخطأ، والمدد، وإصدارَي CLI وNode، وتفاصيل نظام التشغيل، ومعرّفاً مجهولاً لكل تثبيت، ومعرّف مساحة العمل. وتبقى قيم الأعلام والوسائط ومسارات الملفات ومخرجات الأوامر ورسائل الخطأ الكاملة خارجها، ويعرض polylane telemetry status بدقة ما يُرسل وإلى أين.
أوقفها نهائياً بـ polylane telemetry disable، الذي يكتب في ملف الإعدادات، أو لكل بيئة بـ POLYLANE_TELEMETRY=0 أو DO_NOT_TRACK=1. يتبع القرار DO_NOT_TRACK، ثم POLYLANE_TELEMETRY، ثم ملف الإعدادات، ثم الافتراضي المفعّل؛ ولا يوجد علم لكل استدعاء.
الملفات على القرص
كل ما يخزّنه CLI يعيش تحت ~/.polylane:
| الملف | الوصف |
|---|---|
config.json | الإعدادات المحفوظة: النطاق ومساحة العمل ومفتاح API والمخرجات والمهلة وبيانات الاستخدام |
credentials.json | رموز OAuth |
telemetry.json | معرّف التثبيت المجهول وعدّادات التشغيل |
update-state.json | حالة التحقق من التحديثات |
احذف المجلد لإعادة ضبط CLI بالكامل؛ ويُنشأ معرّف تثبيت جديد في التشغيل التالي.