larksuite/lark-meeting

Que fait lark-meeting ?

Point d'entrée unifié pour les réunions vidéo Feishu (Lark). Prend en charge la consultation des enregistrements de réunions, l'interaction en temps réel, la gestion des Minutes (procès-verbaux), la lecture des résumés intelligents, etc. Cette compétence gère le routage des domaines, l'acheminement des tâches et l'orchestration des commandes.

Il n'est pas nécessaire de pré-lire lark-shared ni d'exécuter auth status --verify au préalable. Lisez cette compétence uniquement en cas d'erreurs d'authentification, de jeton (token) / d'identité ou de scope, puis réessayez après correction. Pour toute demande de gestion d'authentification, d'identité ou de scope, utilisez directement cette compétence.

Initialisation et continuité de l'identité

Considérez source_identity comme l'état du workflow inter-commandes :

1. Contexte avec identité source existante : respectez strictement l'identité existante. Si l'utilisateur demande un changement, expliquez d'abord la continuité de l'identité et l'impact sur les autorisations ; ne basculez pas silencieusement.
2. Pas d'identité source, mais l'utilisateur spécifie une identité : utilisez --as comme spécifié.
3. Ni identité source, ni spécification utilisateur : utilisez --as bot si la sémantique de l'opération requiert explicitement un robot applicatif, sinon utilisez --as user.

Après avoir déterminé source_identity, vérifiez si la commande cible prend en charge cette identité :

• Prise en charge : transmettez explicitement l'identité et poursuivez l'exécution.
• Non prise en charge : expliquez la limitation et arrêtez-vous ; ne remplacez pas l'identité pour forcer la réussite de la commande.
• Ce n'est qu'après l'accord explicite de l'utilisateur pour changer d'identité que vous pouvez recommencer un workflow avec la nouvelle identité.

Modèle de domaine et concepts

[Source de la réunion]

Événement de calendrier (event_id) ──réservation ou association──┐
Réunion instantanée (sans event_id) ───────────────────────────┴──► Réunion (meeting_id)

Événement de calendrier ──note_de_réunion (meeting_note)──────────► Doc (notes utilisateur, indépendantes du résumé IA)

[Produits de la réunion]

Réunion (meeting_id)
├── Résumé IA ──► Note (résumé intelligent, note_id)
│               ├── Document de résumé intelligent ───────────► Doc (note_doc_token)
│               ├── Transcription textuelle
│               │   ├── normale ──────────────────────────────► Doc (verbatim_doc_token)
│               │   └── unifiée ──────────────────────────────► note + transcription (pas un Doc indépendant)
│               └── Documents partagés ──────────────────────► Doc (shared_doc_tokens)
│
└── Enregistrement ──► Minutes (procès-verbal, minute_token)
                 ├── Produits IA : Résumé / Tâche / Chapitre / Mot-clé
                 ├── Transcription (alias : retranscription, texte littéral, enregistrement textuel)
                 └── Audio/Vidéo original

Audio/Vidéo local ───────────────────────────────────────────────► Minutes (minute_token)

Objet	Identifiant principal	Concept et relations
Événement de calendrier	event_id	Événement sur le calendrier, contenant l'heure, les participants, la salle de réunion et le RSVP. Peut être réservé ou associé à une réunion VC. Ne constitue pas un enregistrement complet de la réunion. La meeting_note de l'événement est un Doc lié manuellement par l'utilisateur, indépendant du résumé IA.
Réunion (Meeting)	meeting_id	Réunion vidéo qui a effectivement eu lieu. Peut provenir d'un événement de calendrier ou être une réunion instantanée sans programme. Le thème, l'heure, l'instantané des participants et les événements de la réunion constituent les données de la réunion ; les Notes et les Minutes sont des produits post-réunion éventuellement associés.
Note (résumé intelligent)	note_id	Ensemble logique de produits générés après l'activation du résumé IA. Le note_display_type détermine la manière d'obtenir les différentes parties de la transcription textuelle.
Minutes (procès-verbal)	minute_token	Généré par l'enregistrement de la réunion ou par le téléchargement d'audio/vidéo local. Contient le résumé, les tâches, les chapitres, les mots-clés, la transcription textuelle (alias : retranscription, texte littéral, enregistrement textuel) et l'audio/vidéo original. Peut être associé à une réunion VC ou exister indépendamment.
Doc (Document)	Jeton Doc	Conteneur de contenu, pas un identifiant de réunion. note_doc_token, shared_doc_tokens et certains verbatim_doc_token pointent vers un Doc ; le jeton Doc ne peut pas être utilisé comme note_id ou meeting_id.

Identifiants principaux

• meeting_id : ID de la réunion. Chaîne numérique longue, pas un numéro de réunion à 9 chiffres.
• meeting_no : Numéro de la réunion. 9 chiffres ; le paramètre CLI correspondant est --meeting-number.
• minute_token : Jeton Minutes. Chaîne alphanumérique en minuscules, généralement extraite de l'URL des Minutes : /minutes/<minute_token>.

Transmettez ces identifiants tels quels ; ils ne sont pas interchangeables.

Invariants du domaine

• Les Notes et les Minutes proviennent respectivement de deux voies indépendantes : le résumé IA et l'enregistrement. Une réunion peut avoir les deux types de produits, un seul, ou aucun. Ne déduisez pas l'existence d'un minute_token à partir d'un note_id, et inversement.
• Les Minutes peuvent être générées directement à partir d'audio/vidéo local ; elles ne sont donc pas nécessairement liées à un meeting_id ou à un event_id de calendrier.
• meeting_note du calendrier, note_id, minute_token et les différents jetons Doc identifient des objets différents ; ils ne peuvent pas être échangés, utilisés dans des commandes d'autres domaines, ou être déduits les uns des autres.

Action rapide

Consulter le contenu d'une réunion en cours

# Réunion à laquelle l'utilisateur actuel participe
lark-cli vc +meeting-list-active --as user

# Réunion de l'utilisateur cible visible par le robot applicatif
lark-cli vc +meeting-list-active --as bot --user-id <open_id>

# Une fois le meeting_id unique déterminé, utilisez l'identité source
lark-cli vc +meeting-events --as <source_identity> --meeting-id <meeting_id> --page-all --format pretty

S'il y a plusieurs réunions en même temps, sélectionnez d'abord celle à consulter. S'il n'y en a qu'une, consultez directement ses événements.

Avec une identité applicative, seules les réunions auxquelles « l'utilisateur cible participe ET le robot applicatif est également présent » sont retournées ; un résultat vide ne signifie pas que l'utilisateur cible n'est pas en réunion. Lorsque vous expliquez les résultats à l'utilisateur, utilisez les termes « identité utilisateur » ou « identité applicative », sans exposer les abréviations internes comme user / bot.

Manuel de scénarios

Lorsque l'objectif de la tâche correspond à un scénario, lisez le manuel correspondant et suivez son processus.

• Consulter une réunion et ses produits : Localiser des réunions passées par thème, heure, participant ou meeting_id / meeting_no / event_id ; consulter les participants, les enregistrements, les résumés intelligents ou les Minutes associés ; résumer ou faire un bilan à partir des enregistrements.
• Consulter les Minutes et leurs produits : Disposer d'une URL / d'un minute_token existant, ou rechercher des Minutes par titre, propriétaire, ou participant ; lire les résumés, tâches, chapitres, mots-clés, transcriptions, télécharger l'audio/vidéo original, ou consulter les résumés intelligents associés.
• Générer et modifier les Minutes, gérer les permissions : Générer des Minutes, transcriptions, résumés, tâches ou chapitres à partir d'audio/vidéo local ; modifier le titre, le résumé, les tâches, les mots-clés ou les intervenants ; demander l'accès aux Minutes, ou consulter / attribuer des permissions de collaboration.
• Consulter les Notes et leurs produits associés : Disposer d'un note_id, d'une URL / d'un jeton Docx de résumé intelligent, ou besoin de consulter le contenu du résumé, la transcription textuelle, les Minutes, les documents partagés, etc.
• Participation du robot applicatif et interaction en réunion : Orchestration complète pour que le robot applicatif découvre les réunions actives, les rejoigne ou les initie, invite des participants, récupère les événements, prenne des captures d'écran, interagisse via texte/émoticône/compte à rebours, mette fin à la réunion et quitte la réunion après autorisation explicite.
• Événements et interactions en réunion : Sans déclencher de nouvelle action de rejoindre/quitter la réunion, utiliser l'identité utilisateur ou l'identité applicative déjà présente pour consulter les réunions actives, voir les interventions/chat/contenu partagé, lire l'écran de la réunion actuelle si nécessaire, ou envoyer du texte/émoticône et manipuler le compte à rebours.

Référence des commandes

Commande	Utilisation	Méthode de référence
vc +search	Rechercher des réunions passées	lark-vc-search
vc +detail	Consulter les informations de la réunion et les identifiants des Notes et Minutes associées	lark-vc-detail
vc meeting get	Consulter les informations de base de la réunion et l'instantané des participants	lark-cli vc meeting get --help
vc +recording	Localiser l'enregistrement et les Minutes à partir de la réunion	lark-vc-recording
vc +meeting-list-active	Découvrir les réunions actives actuellement visibles	lark-vc-meeting-list-active
vc +meeting-events	Lire les événements et le contenu partagé en réunion	lark-vc-meeting-events
vc +meeting-message-send	Envoyer un message textuel ou une émoticône en réunion	lark-vc-meeting-message-send
vc +meeting-screenshot	Prendre une capture d'écran de la réunion vidéo	lark-vc-meeting-screenshot
vc +meeting-countdown	Définir, prolonger, terminer prématurément ou désactiver le compte à rebours en réunion	lark-vc-meeting-countdown
vc +meeting-join	Faire rejoindre la réunion par le robot applicatif	lark-vc-agent-meeting-join
vc +meeting-invite	Inviter un utilisateur spécifié ou tous les participants éligibles de l'événement via le robot applicatif	lark-vc-agent-meeting-invite
vc +meeting-end	Faire terminer la réunion par le robot applicatif Hôte actuel	lark-vc-agent-meeting-end
vc +meeting-leave	Faire quitter la réunion par le robot applicatif	lark-vc-agent-meeting-leave
minutes +search	Rechercher des Minutes	lark-minutes-search
minutes minutes get	Consulter les informations de base des Minutes	lark-cli minutes minutes get --help
minutes +detail	Lire les informations des Minutes et un produit spécifié	lark-minutes-detail
minutes +download	Télécharger l'audio/vidéo original des Minutes	lark-minutes-download
minutes +upload	Générer des Minutes à partir d'audio/vidéo dans Cloud Space	lark-minutes-upload
minutes +update	Modifier le titre des Minutes	lark-minutes-update
minutes +speaker-replace	Remplacer le locuteur de la transcription des Minutes	lark-minutes-speaker-replace
minutes +summary	Remplacer le résumé IA des Minutes	lark-minutes-summary
minutes +todo	Ajouter, supprimer ou modifier les tâches IA des Minutes	lark-minutes-todo
minutes +apply-permission	Demander l'accès en lecture ou en écriture aux Minutes	lark-minutes-apply-permission
drive +member-list	Voir les collaborateurs des Minutes et leurs permissions	lark-drive-member-list
drive +member-add	Attribuer à un membre spécifié l'accès en lecture ou en écriture aux Minutes	lark-drive-member-add
minutes +word-replace	Remplacer en masse des mots-clés dans la transcription des Minutes	lark-cli minutes +word-replace --help
note +detail	Consulter le résumé intelligent et les identifiants des documents associés	lark-note-detail
note +transcript	Obtenir la transcription textuelle unifiée du résumé intelligent	lark-note-transcript

Règle de chargement progressif

Suivez la progression « Action rapide → Manuel de scénarios → Référence des commandes » :

1. Lorsque l'objectif de l'utilisateur correspond aux conditions d'entrée de l'action rapide, exécutez directement la CLI correspondante ; ne pré-lisez pas le manuel de scénarios, la référence de commande, --help ou le schéma.
2. Si l'action rapide ne correspond pas, ou si vous manquez d'identifiants clés, avez besoin de désambiguïsation, ou si une opération d'écriture est impliquée, lisez un manuel de scénario principal qui correspond à l'objectif ; si le scénario principal renvoie explicitement à un scénario en aval, lisez uniquement le scénario ou la section référencé(e) et exécutez la CLI conformément à son processus.
3. Ce n'est que lorsque vous manquez de paramètres spécifiques, de champs de retour, de contraintes spéciales ou de méthodes de gestion des exceptions que : pour les commandes avec une référence, lisez le fichier correspondant ; pour les commandes sans référence, exécutez la commande exacte lark-cli ... --help indiquée dans le tableau. Lorsque le scénario ou la référence donne déjà une commande exacte, n'appelez pas --help ; appelez-le uniquement en cas de paramètre manquant, de commande non reconnue ou de conflit entre la documentation et le résultat de l'exécution.