larksuite/lark-meeting

Was macht lark-meeting?

Der zentrale Einstiegspunkt für das Lark-Videokonferenzgeschäft, der das Abfragen von Meeting-Aufzeichnungen, die Live-Interaktion in Meetings, die Verwaltung von Minuten, das Lesen von KI-Protokollen und andere Vorgänge unterstützt. Diese Skill ist verantwortlich für das Domainen-Routing, die Aufgabenkoordination und die befehlsübergreifende Orchestrierung.

Es ist nicht erforderlich, lark-shared vorab zu lesen oder auth status --verify auszuführen. Lesen Sie diesen Skill nur, wenn Sie auf einen nicht authentifizierten Zustand, Token-/Identitäts- oder Scope-Fehler stoßen, und wiederholen Sie den Vorgang nach der Behebung. Für Authentifizierungs-, Identitäts- oder Scope-Verwaltungsanfragen verwenden Sie direkt diesen Skill.

Identitätsinitialisierung und -fortführung

Behandeln Sie source_identity als statusübergreifenden Zustand des Arbeitsablaufs:

1. Kontext enthält bereits eine Quellidentität: Diese strikt beibehalten. Wenn der Benutzer einen Wechsel wünscht, zuerst die Identitätskontinuität und die Auswirkungen auf die Berechtigungen erläutern, nicht stillschweigend wechseln.
2. Keine Quellidentität vorhanden, Benutzer gibt explizit eine Identität an: Die vom Benutzer angegebene --as-Identität verwenden.
3. Keine Quellidentität vorhanden und Benutzer hat keine angegeben: Wenn die Operationssemantik explizit die Verwendung eines Anwendungs-Bots erfordert, --as bot verwenden; andernfalls explizit --as user verwenden.

Nachdem source_identity festgelegt wurde, prüfen, ob der Zielbefehl diese Identität unterstützt:

• Unterstützt: Explizit übergeben und mit der Ausführung fortfahren.
• Nicht unterstützt: Die Einschränkung erläutern und anhalten; die Identität nicht ersetzen, nur um den Befehl erfolgreich auszuführen.
• Erst nach expliziter Zustimmung des Benutzers zum Identitätswechsel einen neuen Arbeitsablauf mit der neuen Identität beginnen.

Domainenmodell und Konzepte

[Meeting-Quellen]

Calendar-Termin (event_id) ──gebucht oder verknüpft─┐
Ad-hoc-Meeting (kein event_id)─────────────────────┴──► Meeting (meeting_id)

Calendar-Termin ──meeting_note───────────────────────► Doc (Benutzerprotokoll, unabhängig von KI-Protokoll)

[Meeting-Artefakte]

Meeting (meeting_id)
├── KI-Zusammenfassung ──► Note KI-Protokoll (note_id)
│                           ├── KI-Protokoll-Dokument ───────────► Doc (note_doc_token)
│                           ├── Transkript
│                           │   ├── normal  ────────────────────► Doc (verbatim_doc_token)
│                           │   └── unified ────────────────────► note + transcript (kein separates Doc)
│                           └── Geteilte Dokumente ──────────────► Doc (shared_doc_tokens)
│
└── Aufzeichnung ──► Minutes (minute_token)
                     ├── KI-Artefakte: Zusammenfassung / Aufgaben / Kapitel / Schlüsselwörter
                     ├── Transcript (Textaufzeichnung, auch „Transkript“, „Wortprotokoll“, „Textprotokoll“)
                     └── Original-Audio/Video

Lokale Audio/Video ──────────────────────────────────► Minutes (minute_token)

Objekt	Primäre Kennung	Konzept und Beziehung
Calendar-Termin	event_id	Termin im Kalender, der Zeit, Teilnehmer, Besprechungsraum und RSVP enthält. Kann eine VC-Konferenz buchen oder damit verknüpft sein. Ist keine vollständige Meeting-Aufzeichnung. Das meeting_note im Termin ist ein manuell verknüpftes Doc und hat nichts mit dem KI-Protokoll zu tun.
Meeting	meeting_id	Die tatsächlich stattgefundene Videokonferenz, die aus einem Kalendertermin stammen oder ein Ad-hoc-Meeting ohne Termin sein kann. Meeting-Thema, -Zeit, Teilnehmer-Snapshot und Ereignisse während des Meetings sind Meeting-Daten; Note und Minutes sind mögliche nachgelagerte Artefakte.
Note (KI-Protokoll)	note_id	Eine logische Sammlung von Artefakten, die nach Aktivierung der KI-Zusammenfassung entsteht. note_display_type bestimmt die Methode zum Abrufen des Textprotokolls.
Minutes	minute_token	Wird durch Meeting-Aufzeichnung oder das Hochladen lokaler Audio-/Videodateien generiert. Enthält Zusammenfassung, Aufgaben, Kapitel, Schlüsselwörter, Textprotokoll (auch „Transkript“, „Wortprotokoll“, „Textprotokoll“) und Original-Audio/Video. Kann mit einem VC-Meeting verknüpft sein oder unabhängig existieren.
Doc	Doc-Token	Inhaltscontainer, kein Meeting-Identifikator. note_doc_token, shared_doc_tokens und einige verbatim_doc_token verweisen auf Docs; ein Doc-Token kann nicht als note_id oder meeting_id verwendet werden.

Kernkennungen

• meeting_id: Meeting-ID. Langer numerischer String, nicht die 9-stellige Meeting-Nummer.
• meeting_no: Meeting-Nummer. 9-stellige Zahl; CLI-Parametername ist --meeting-number.
• minute_token: Minuten-Token. Aus Kleinbuchstaben und Ziffern, normalerweise aus der Minuten-URL /minutes/<minute_token>.

Alle diese Kennungen werden als String im Originalformat übergeben und sind nicht austauschbar.

Domaineninvarianten

• Note und Minutes stammen aus zwei getrennten Pfaden: KI-Zusammenfassung bzw. Aufzeichnung. Ein Meeting kann beide Arten von Artefakten, nur eine oder keine haben; aus dem Vorhandensein einer note_id kann nicht auf das Vorhandensein eines minute_token geschlossen werden und umgekehrt.
• Minutes können direkt aus lokalen Audio-/Videodateien generiert werden, daher sind sie nicht unbedingt mit einer meeting_id oder einem Calendar event_id verknüpft.
• Calendar meeting_note, Note note_id, Minutes minute_token und verschiedene Doc-Token identifizieren unterschiedliche Objekte und können nicht gegeneinander ausgetauscht, in Befehlen anderer Domänen verwendet oder von einem auf das andere zurückgeschlossen werden.

Schnellaktionen

Inhalt eines laufenden Meetings abfragen

# Meeting, an dem der aktuelle Benutzer teilnimmt
lark-cli vc +meeting-list-active --as user

# Meeting des Zielbenutzers, das für den Anwendungs-Bot sichtbar ist
lark-cli vc +meeting-list-active --as bot --user-id <open_id>

# Nach Bestimmung der eindeutigen meeting_id die Quellidentität verwenden
lark-cli vc +meeting-events --as <source_identity> --meeting-id <meeting_id> --page-all --format pretty

Wenn mehrere Meetings gleichzeitig stattfinden, muss zuerst das abzufragende Meeting ausgewählt werden. Bei nur einem Meeting direkt die Ereignisse dieses Meetings abfragen.

Bei Verwendung der Anwendungsidentität werden nur Meetings zurückgegeben, an denen der Zielbenutzer und der Anwendungs-Bot gleichzeitig teilnehmen. Ein leeres Ergebnis bedeutet nicht, dass der Zielbenutzer nicht in einem Meeting ist. Verwenden Sie bei der Erklärung der Ergebnisse gegenüber dem Benutzer die Begriffe „Benutzeridentität“ oder „Anwendungsidentität“; vermeiden Sie interne Abkürzungen wie user/bot.

Szenario-Handbücher

Wenn das Aufgabenproblem mit einem Szenario übereinstimmt, lesen Sie das entsprechende Szenario-Handbuch und führen Sie die Aufgaben gemäß dem Ablauf darin aus.

• Meeting und seine Artefakte abfragen: Suchen Sie historische Meetings nach Thema, Zeit, Teilnehmer oder meeting_id / meeting_no / event_id; fragen Sie Teilnehmer, Aufzeichnungen und zugehörige KI-Protokolle oder Minuten ab; führen Sie Zusammenfassungen oder Retrospektiven basierend auf den Meeting-Aufzeichnungen durch.
• Minuten und ihre Artefakte abfragen: Sie haben bereits eine Minuten-URL / minute_token oder suchen Minuten nach Titel, Besitzer oder Teilnehmer; lesen Sie Zusammenfassungen, Aufgaben, Kapitel, Schlüsselwörter, Transkripte, laden Sie Original-Audio/Video herunter oder fragen Sie zugehörige KI-Protokolle ab.
• Minuten erstellen und bearbeiten, Minuten-Berechtigungen verwalten: Generieren Sie aus lokalen Audio-/Videodateien Minuten, Transkripte, Zusammenfassungen, Aufgaben oder Kapitel; ändern Sie den Minuten-Titel, die Zusammenfassung, Aufgaben, Schlüsselwörter oder Sprecher; beantragen Sie Minuten-Berechtigungen oder zeigen Sie Berechtigungen von Minuten-Mitarbeitern an und weisen Sie diese zu.
• KI-Protokoll und zugehörige Artefakte abfragen: Sie haben bereits eine note_id, eine KI-Protokoll-Docx-URL/einen Token oder müssen den Haupttext des Protokolls, das Transkript, Minuten und gemeinsame Dokumente sowie andere zugehörige Artefakte abfragen.
• Anwendungs-Bot nimmt an Meeting teil und interagiert: Vollständige Orchestrierung der Erkennung aktiver Meetings, des Beitritts oder des Starts, der Einladung, des Abrufs von Ereignissen, des Meeting-Screenshots, der Text-/Emoji-/Countdown-Interaktion, der Beendigung des Meetings und des Verlassens des Meetings nach expliziter Autorisierung durch den Anwendungs-Bot.
• Ereignisse und Interaktion während des Meetings: Fragen Sie ohne Auslösen eines neuen Beitritts-/Verlassens-Vorgangs mit der Benutzeridentität oder der bereits im Meeting befindlichen Anwendungsidentität aktive Meetings ab, sehen Sie sich Redebeiträge/Chats/Shared-Content an, lesen Sie bei Bedarf das aktuelle Meeting-Bild aus oder senden Sie Text/Emojis und steuern Sie den Countdown.

Befehlsreferenz

Befehl	Zweck	Referenzmethode
vc +search	Historische Meetings suchen	lark-vc-search
vc +detail	Meeting-Informationen und zugehörige Note/ Minutes-Kennungen abfragen	lark-vc-detail
vc meeting get	Basisinformationen zum Meeting und Teilnehmer-Snapshot abfragen	lark-cli vc meeting get --help
vc +recording	Aufzeichnung und Minuten aus einem Meeting lokalisieren	lark-vc-recording
vc +meeting-list-active	Aktuell sichtbare laufende Meetings erkennen	lark-vc-meeting-list-active
vc +meeting-events	Ereignisse und geteilte Inhalte während des Meetings lesen	lark-vc-meeting-events
vc +meeting-message-send	Textnachrichten oder Emojis während des Meetings senden	lark-vc-meeting-message-send
vc +meeting-screenshot	Screenshot der Videokonferenz erstellen	lark-vc-meeting-screenshot
vc +meeting-countdown	Countdown während des Meetings festlegen, verlängern, vorzeitig beenden oder ausschalten	lark-vc-meeting-countdown
vc +meeting-join	Anwendungs-Bot dem Meeting beitreten lassen	lark-vc-agent-meeting-join
vc +meeting-invite	Anwendungs-Bot lädt bestimmte Benutzer oder alle qualifizierten Terminteilnehmer ein	lark-vc-agent-meeting-invite
vc +meeting-end	Aktuellen Host-Anwendungs-Bot das Meeting beenden lassen	lark-vc-agent-meeting-end
vc +meeting-leave	Anwendungs-Bot das Meeting verlassen lassen	lark-vc-agent-meeting-leave
minutes +search	Minuten suchen	lark-minutes-search
minutes minutes get	Basisinformationen zu Minuten abfragen	lark-cli minutes minutes get --help
minutes +detail	Minuten-Informationen und bestimmte Artefakte lesen	lark-minutes-detail
minutes +download	Original-Audio/Video von Minuten herunterladen	lark-minutes-download
minutes +upload	Minuten aus Cloud-Space-Audio/Video generieren	lark-minutes-upload
minutes +update	Minuten-Titel ändern	lark-minutes-update
minutes +speaker-replace	Sprecher im Minuten-Transkript ersetzen	lark-minutes-speaker-replace
minutes +summary	KI-Zusammenfassung der Minuten ersetzen	lark-minutes-summary
minutes +todo	KI-Aufgaben in Minuten hinzufügen/löschen/ändern	lark-minutes-todo
minutes +apply-permission	Lese- oder Bearbeitungsberechtigung für Minuten beantragen	lark-minutes-apply-permission
drive +member-list	Minuten-Mitarbeiter und ihre Berechtigungen anzeigen	lark-drive-member-list
drive +member-add	Bestimmten Mitgliedern Lese- oder Bearbeitungsberechtigung für Minuten zuweisen	lark-drive-member-add
minutes +word-replace	Schlüsselwörter im Minuten-Transkript stapelweise ersetzen	lark-cli minutes +word-replace --help
note +detail	KI-Protokoll und zugehörige Dokumentkennungen abfragen	lark-note-detail
note +transcript	Unified KI-Protokoll-Transkript abrufen	lark-note-transcript

Progressive Laderegeln

Laden Sie schrittweise nach dem Schema „Schnellaktion → Szenario-Handbuch → Befehlsreferenz“:

1. Wenn das Benutzerziel die Eintrittsbedingungen einer „Schnellaktion“ erfüllt, führen Sie die entsprechende CLI direkt aus; lesen Sie nicht vorab das Szenario-Handbuch, die Befehlsreferenz, --help oder das Schema.
2. Wenn das Benutzerziel die Bedingungen für Schnellaktionen nicht erfüllt, oder wenn wichtige Kennungen fehlen, eine Disambiguierung erforderlich ist oder Schreibvorgänge betroffen sind, lesen Sie ein Hauptszenario-Handbuch, das zum Ziel passt. Wenn das Hauptszenario explizit an ein nachgelagertes Szenario verweist, lesen Sie nur das referenzierte Szenario oder den referenzierten Abschnitt weiter und führen Sie die CLI gemäß dessen Ablauf aus.
3. Nur wenn spezifische Parameter, Rückgabefelder, besondere Einschränkungen oder die Behandlung von Ausnahmen fehlen: Lesen Sie für Befehle mit Referenzhandbuch die entsprechende Datei; führen Sie für Befehle ohne Referenzhandbuch das in der Tabelle aufgeführte genaue lark-cli ... --help aus. Wenn das Szenario oder die Referenz bereits einen genauen Befehl angibt, rufen Sie nicht --help auf; rufen Sie es nur auf, wenn Parameter fehlen, der Befehl nicht erkannt wird oder die Dokumentation im Widerspruch zum Ausführungsergebnis steht.