الانتقال إلى المحتوى الرئيسي
يقرأ CometAPI CLI الإعدادات من ملف إعداد بصيغة TOML، ومن متغيرات البيئة، ومن علامات سطر الأوامر. عند توفر الإعداد نفسه من عدة مصادر، يكون ترتيب الأولوية كما يلي: علامات CLI > ملف الإعداد > متغيرات البيئة > القيم الافتراضية

​
ملف الإعداد

الموقع: ~/.config/cometapi/config.toml شغّل معالج الإعداد لإنشاء ملف الإعداد بشكل تفاعلي: 
cometapi init
أو أدِر الإعدادات الفردية باستخدام الأمر الفرعي config: 
# View current configuration
cometapi config show

# Set a value
cometapi config set api_key sk-...

# Remove a value
cometapi config unset api_key

# Show the config file path
cometapi config path

​
الإعدادات المتاحة

مفتاح الإعدادمتغير البيئةالوصف
api_keyCOMETAPI_KEYAPI key (مطلوب لجميع الأوامر)
access_tokenCOMETAPI_ACCESS_TOKENAccess token لأوامر مستوى الحساب
base_urlCOMETAPI_BASE_URLعنوان URL الأساسي للـ API (الافتراضي: https://api.cometapi.com/v1)
default_modelCOMETAPI_DEFAULT_MODELالنموذج الافتراضي لأمر chat (الاحتياطي: gpt-5.4)
output_format—تنسيق الإخراج الافتراضي: table أو json أو yaml أو csv أو markdown

​
بيانات الاعتماد

يستخدم CLI نوعين من بيانات الاعتماد:

​
API key

مطلوب لجميع الأوامر. يقوم API key بالمصادقة على الطلبات المرسلة إلى نقاط نهاية نماذج CometAPI. أنشئ API key من CometAPI Console → API Keys. قم بتعيينه بإحدى الطرق التالية: 
export COMETAPI_KEY="<COMETAPI_KEY>"

​
Access token

اختياري. يكون Access token مطلوبًا لأوامر مستوى الحساب: account وstats وtokens وlogs وtasks. أنشئ Access token من CometAPI Console → Personal Settings. قم بتعيينه بإحدى الطرق التالية: 
export COMETAPI_ACCESS_TOKEN="your-access-token"

​
الأمان

يطبق CLI ممارسات الأمان التالية:
  • لا يتم أبدًا تسجيل API keys وAccess tokens أو عرضها بالكامل. يتم إظهار آخر 4 أحرف فقط في مخرجات التشخيص.
  • يتم إنشاء ملف الإعداد بصلاحيات مقيّدة (0600) — بحيث يكون قابلاً للقراءة فقط من قِبل مالك الملف.
  • يجب عدم تضمين بيانات الاعتماد مطلقًا في نظام التحكم في الإصدارات. أضف مسار ملف الإعداد إلى ملف .gitignore إذا كان ذلك مناسبًا.
أنت مسؤول عن جميع الاستخدامات والرسوم الناتجة عن API keys الخاصة بك. حافظ على أمان مفاتيحك وقم بتدويرها إذا اشتبهت في وجود وصول غير مصرح به.

​
استكشاف الأخطاء وإصلاحها

الخطأالحل
API key not configuredشغّل cometapi init أو اضبط متغير البيئة COMETAPI_KEY
Connection failedشغّل cometapi doctor لتشخيص الاتصال
Access token not configuredمطلوب فقط للأوامر account وstats وtokens وlogs وtasks. شغّل cometapi init لإضافة واحد