À propos du projet

lark-cli est l'interface en ligne de commande officielle pour Lark/Feishu, maintenue par l'équipe larksuite. Elle est conçue pour les utilisateurs humains et les agents IA, couvrant 18 domaines métier principaux, notamment Messenger, Docs, Base, Sheets, Slides, Calendar, Mail, Tasks, Meetings, Markdown, Wiki, Contact, Attendance, Approval, OKR, Project et Apps, avec plus de 200 commandes sélectionnées et 26 compétences d'agent IA. L'outil présente une conception native pour les agents avec des compétences structurées compatibles avec les outils IA populaires, permettant aux agents d'opérer Lark sans configuration supplémentaire. Chaque commande est testée avec de vrais agents, avec des paramètres concis, des valeurs par défaut intelligentes et une sortie structurée pour maximiser les taux de réussite des appels d'agents. Il est open source sous licence MIT et peut être installé via npm en quelques étapes. Le système de commandes à trois niveaux offre une flexibilité à différentes granularités : raccourcis (préfixés par +, conçus pour les humains et l'IA avec des valeurs par défaut intelligentes et une sortie tabulaire), commandes API (générées automatiquement à partir des métadonnées Lark OAPI, sélectionnées par évaluation et contrôles de qualité, avec plus de 100 commandes mappées 1:1 aux points de terminaison de la plateforme) et appels API bruts (accès direct à tout point de terminaison de la plateforme ouverte Lark, couvrant plus de 2500 API). L'authentification prend en charge la connexion OAuth avec sélection interactive ou indicateurs CLI pour les portées, le changement d'identité entre utilisateur et bot, et le mode agent avec URL de vérification non bloquantes. L'outil inclut plusieurs formats de sortie (JSON, joli, tableau, ndjson, CSV), la prise en charge de la pagination, des aperçus à sec pour les commandes à effets secondaires et l'introspection de schéma pour inspecter les paramètres API et les structures de réponse. Les fonctionnalités de sécurité incluent la protection contre l'injection d'entrées, l'assainissement de la sortie du terminal, le stockage des identifiants dans le trousseau natif du système d'exploitation et des signaux de contrôle des risques envoyés avec les requêtes OpenAPI aux domaines HTTPS officiels de Feishu/Lark. L'outil avertit les utilisateurs des risques inhérents lorsque les agents IA automatisent des opérations, notamment les hallucinations de modèles, l'exécution imprévisible et l'injection de prompts, et recommande d'utiliser le bot intégré comme assistant conversationnel privé plutôt que dans des discussions de groupe. Pour un usage en entreprise, l'outil prend en charge l'intégration dans des agents ou plateformes personnalisés avec des identifiants centralisés, une journalisation d'audit unifiée et une surface de commandes restreinte via des packages d'extension. Le projet est écrit en Go (v1.23+) et distribué via npm, avec des contributions communautaires bienvenues sous licence MIT.