عن المشروع

lark-cli هي واجهة سطر الأوامر الرسمية لتطبيق Lark/Feishu، وتتم صيانتها بواسطة فريق larksuite. صُممت الأداة للاستخدام البشري وللوكلاء الذكيين على حدٍّ سواء، وتغطي 18 مجالًا تجاريًا أساسيًا بما في ذلك Messenger وDocs وBase وSheets وSlides وCalendar وMail وTasks وMeetings وMarkdown وWiki وContact وAttendance وApproval وOKR وProject وApps، مع أكثر من 200 أمر مُنتقى و26 مهارة ذكاء اصطناعي. تتميز الأداة بتصميم أصيل للوكلاء الذكيين عبر مهارات منظمة متوافقة مع أدوات الذكاء الاصطناعي الشائعة، مما يسمح للوكلاء بالتعامل مع Lark دون أي إعدادات إضافية. كل أمر مُختبَر مع وكلاء حقيقيين، ويتميز بمعاملات موجزة وإعدادات افتراضية ذكية ومخرجات منظمة لتعظيم معدل نجاح استدعاءات الوكلاء. الأداة مفتوحة المصدر بموجب رخصة MIT ويمكن تثبيتها عبر npm في بضع خطوات فقط. يوفر نظام الأوامر ثلاثي المستويات مرونة بمستويات دقة مختلفة: الاختصارات (مسبوقة برمز +، مصممة للبشر وللذكاء الاصطناعي مع إعدادات افتراضية ذكية ومخرجات جدولية)، أوامر API (مولّدة تلقائيًا من بيانات Lark OAPI الوصفية، ومُنتقاة عبر تقييم ومعايير جودة، مع أكثر من 100 أمر بمراسلة فردية مع نقاط نهاية المنصة)، واستدعاءات API الخام (وصول مباشر إلى أي نقطة نهاية في منصة Lark المفتوحة، وتغطي أكثر من 2500 واجهة برمجة تطبيقات). يدعم المصادقة عبر تسجيل الدخول OAuth مع اختيار تفاعلي أو علامات CLI للنطاقات، والتبديل بين هوية المستخدم والروبوت، ووضع الوكيل مع عناوين تحقق غير حظرية. تتضمن الأداة تنسيقات مخرجات متعددة (JSON وpretty وtable وndjson وCSV)، ودعم الترقيم، ومعاينات تجريبية للأوامر ذات الآثار الجانبية، واستكشاف المخططات لفحص معاملات API وهياكل الاستجابة. تشمل ميزات الأمان حماية من حقن المدخلات، وتعقيم مخرجات الطرفية، وتخزين بيانات الاعتماد في سلسلة المفاتيح الأصلية لنظام التشغيل، وإشارات التحكم بالمخاطر المرسلة مع طلبات OpenAPI إلى نطاقات Feishu/Lark الرسمية عبر HTTPS. تحذر الأداة المستخدمين من المخاطر الكامنة عند أتمتة الوكلاء الذكيين للعمليات، بما في ذلك هلوسة النماذج، والتنفيذ غير المتوقع، وحقن التعليمات، وتوصي باستخدام الروبوت المدمج كمساعد محادثة خاص بدلًا من استخدامه في الدردشات الجماعية. للاستخدام المؤسسي، تدعم الأداة التضمين في وكلاء أو منصات مخصصة مع بيانات اعتماد مركزية، وسجلات تدقيق موحدة، وسطح أوامر مقيد عبر حزم التوسعة. المشروع مكتوب بلغة Go (الإصدار 1.23 أو أحدث) ويُوزَّع عبر npm، مع الترحيب بمساهمات المجتمع بموجب رخصة MIT.