يقرأ CometAPI CLI الإعدادات من ملف إعداد TOML، ومتغيرات البيئة، وأعلام سطر الأوامر. وعندما يكون الإعداد نفسه متاحًا من عدة مصادر، يكون ترتيب الأولوية كما يلي:
أعلام CLI > ملف الإعداد > متغيرات البيئة > القيم الافتراضية
ملف الإعداد
الموقع: ~/.config/cometapi/config.toml
شغّل معالج الإعداد لإنشاء ملف الإعداد بشكل تفاعلي:
أو أدر الإعدادات الفردية باستخدام الأمر الفرعي config:
الإعدادات المتاحة
بيانات الاعتماد
يستخدم CLI نوعين من بيانات الاعتماد:
API key
مطلوب لجميع الأوامر. يقوم API key بمصادقة الطلبات إلى نقاط نهاية نماذج CometAPI.
أنشئ API key من CometAPI Console → API Keys.
قم بتعيينه بإحدى هذه الطرق:
Access token
اختياري. Access token مطلوب لأوامر مستوى الحساب: account و stats و tokens و logs و tasks.
أنشئ Access token من CometAPI Console → Personal Settings.
قم بتعيينه بإحدى هذه الطرق:
الأمان
يطبق CLI ممارسات الأمان التالية:
- لا يتم أبدًا تسجيل API keys وAccess tokens أو عرضها كاملة. يتم إظهار آخر 4 أحرف فقط في مخرجات التشخيص.
- يتم إنشاء ملف الإعداد بأذونات مقيدة (
0600) — بحيث لا يمكن قراءته إلا من قبل مالك الملف.
- يجب عدم تضمين بيانات الاعتماد أبدًا في نظام التحكم بالإصدارات. أضف مسار ملف الإعداد إلى
.gitignore إذا كان ذلك منطبقًا.
أنت مسؤول عن جميع مرات الاستخدام والرسوم المترتبة على مفاتيح API الخاصة بك. حافظ على أمان مفاتيحك وقم بتدويرها إذا اشتبهت في وجود وصول غير مصرّح به.
استكشاف الأخطاء وإصلاحها
