لا تزال CometAPI CLI في المرحلة التجريبية. توقّع تغييرات طفيفة في الأوامر وتجربة الاستخدام بينما تستقر واجهة CLI.
الميزات
- دردشة متعددة النماذج مع Streaming وREPL تفاعلي
- البحث عن النماذج وعرضها
- رصيد الحساب وإحصاءات الاستخدام
- تصفح سجلات الاستخدام مع عوامل التصفية وتصدير CSV
- سجلات المهام غير المتزامنة (Suno وMidjourney وKling وغيرها)
- إخراج متعدد التنسيقات: table وJSON وYAML وCSV وMarkdown
- إعدادات مبنية على TOML مع معالج إعداد
- إكمال الأوامر لـ Bash وZsh وFish
- تصميم ملائم للوكلاء مع إخراج JSON منظم ورموز خروج حتمية
المتطلبات الأساسية
- Python 3.10 أو أحدث
- مفتاح CometAPI API
التثبيت
استخدم صفحة الحزمة على PyPI كمرجع التثبيت الأساسي، ثم اختر إحدى الطرق التالية لتثبيت CLI:البدء السريع
تشغيل معالج الإعداد
يخزن المعالج التفاعلي مفتاح API ورمز الوصول الاختياري في ملف إعداد محلي:يطلب المعالج ما يلي:
- مفتاح API — مطلوب لجميع الأوامر. أنشئ واحدًا من CometAPI Console → API Keys.
- رمز الوصول — اختياري، ومطلوب لأوامر
accountوstatsوtokensوlogsوtasks. أنشئ واحدًا من Console → Personal Settings.
جلسة دردشة تفاعلية
شغّلcometapi chat بدون معاملات للدخول إلى REPL للدردشة متعددة الأدوار:
| الأمر | الوصف |
|---|---|
/model | تبديل النموذج النشط |
/system | تعيين system prompt أو تغييره |
/clear | مسح سجل المحادثة |
/history | عرض سجل المحادثة |
/save | حفظ المحادثة في ملف |
/tokens | عرض استخدام Token للجلسة |
/help | عرض جميع أوامر REPL |
/exit | الخروج من REPL |
تكامل الوكيل
تم تصميم CLI للاستخدام من قِبل وكلاء AI البرمجيين ونصوص الأتمتة:- تدعم جميع أوامر البيانات الخيار
--jsonللحصول على مخرجات منظَّمة وقابلة للقراءة آليًا - رموز خروج حتمية:
0(نجاح)،64(إعدادات مفقودة)،77(خطأ مصادقة)،69(الخدمة غير متاحة) - تذهب الأخطاء إلى stderr، وتذهب البيانات إلى stdout
- راجع مرجع الأوامر الكامل للاطلاع على الخيارات الخاصة بكل أمر