Back to Details

lark-meeting

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

lark-meeting

lark-meeting

飞书视频会议业务的统一入口，支持查询会议记录、实时会议互动、管理妙记、阅读智能纪要等操作。本技能负责领域关系、任务路由和跨命令编排。
无需预读 
lark-shared
 或预跑 
auth status --verify
，仅遇到未认证、token / 身份或 scope 错误时读取该 Skill，修复后重试。认证、身份或 scope 管理请求则直接使用该 Skill。
Unified entry for Lark Video Conference business, supporting operations such as querying meeting records, real-time meeting interaction, managing Minutes, reading intelligent minutes, etc. This skill is responsible for domain relationships, task routing and cross-command orchestration.
No need to pre-read 
lark-shared
 or pre-run 
auth status --verify
; only read this Skill when encountering unauthenticated, token/identity or scope errors, then retry after fixing. Requests for authentication, identity or scope management directly use this Skill.

身份初始化与延续

Identity Initialization and Continuity

把 
source_identity
作为跨命令工作流的状态：
  1. 上下文已有来源身份：严格沿用。用户要求切换时先说明身份连续性和权限影响，不静默切换。
  2. 没有来源身份，用户明确指定身份：使用用户指定的 
    --as
    。
  3. 没有来源身份且用户未指定：操作语义明确要求应用机器人时使用 
    --as bot
    ，否则显式使用 
    --as user
    。
确定 
source_identity
后，再检查目标命令是否支持该身份：
  • 支持：显式传入并继续执行。
  • 不支持：说明限制并停止；不要为了让命令成功而替换身份。
  • 只有用户明确同意切换身份后，才以新身份重新开始一条工作流。
Use 
source_identity
as the state of cross-command workflows:
  1. Source identity already exists in context: Strictly follow it. When the user requests to switch, first explain the identity continuity and permission impact, do not switch silently.
  2. No source identity, user explicitly specifies identity: Use the 
    --as
    specified by the user.
  3. No source identity and user does not specify: Use 
    --as bot
    when the operation semantics explicitly require an application robot, otherwise explicitly use 
    --as user
    .
After determining 
source_identity
, check whether the target command supports this identity:
  • Supported: Explicitly pass it in and continue execution.
  • Not supported: Explain the restrictions and stop; do not replace the identity to make the command succeed.
  • Only restart a workflow with the new identity after the user explicitly agrees to switch identity.

领域模型与概念

Domain Model and Concepts

text
[会议来源]

Calendar 日程 (event_id) ──预约或关联──┐
即时会议（无 event_id）────────────────┴──► 会议 (meeting_id)

Calendar 日程 ──meeting_note────────────► Doc（用户纪要，独立于 AI 智能纪要）

[会议产物]

会议 (meeting_id)
├── AI 总结 ──► Note 智能纪要 (note_id)
│               ├── 智能纪要文档 ───────────► Doc (note_doc_token)
│               ├── 逐字稿
│               │   ├── normal  ──────────► Doc (verbatim_doc_token)
│               │   └── unified ──────────► note +transcript（非独立 Doc）
│               └── 共享文档 ──────────────► Doc (shared_doc_tokens)
│
└── 录制 ──► Minutes 妙记 (minute_token)
                 ├── AI 产物：Summary / Todo / Chapter / Keyword
                 ├── Transcript（文字记录）
                 └── 原始音视频

本地音视频 ─────────────────────────────► Minutes 妙记 (minute_token)
对象主标识概念与关系
Calendar 日程
event_id
日历上的日程，包含时间、参与人、会议室和 RSVP，可预约或关联 VC 会议；不是完整的会议记录。日程上的 
meeting_note
是用户手工绑定的 Doc，与 AI 智能纪要无关。
Meeting 会议
meeting_id
实际发生的视频会议，可以来自 Calendar，也可以是没有日程的即时会议。会议主题、时间、参会人快照和会中事件属于会议数据；Note 与 Minutes 是它可能关联的会后产物。
Note 智能纪要
note_id
开启 AI 总结后形成的逻辑产物集合。
note_display_type
决定获取逐字稿中文字记录的不同方式。
Minutes 妙记
minute_token
由会议录制或本地音视频上传生成，包含总结、待办、章节、关键词、文字记录和原始音视频；可以关联 VC 会议，也可以独立存在。
Doc 文档Doc token内容载体，不是会议标识。
note_doc_token
、
shared_doc_tokens
和部分 
verbatim_doc_token
指向 Doc；Doc token 不能当作 
note_id
或 
meeting_id
。
text
[Meeting Sources]

Calendar Schedule (event_id) ──Scheduled or Associated──┐
Instant Meeting (no event_id)────────────────┴──► Meeting (meeting_id)

Calendar Schedule ──meeting_note────────────► Doc (user-created minutes, independent of AI intelligent minutes)

[Meeting Artifacts]

Meeting (meeting_id)
├── AI Summary ──► Note (intelligent minutes) (note_id)
│               ├── Intelligent Minutes Document ───────────► Doc (note_doc_token)
│               ├── Verbatim Transcript
│               │   ├── normal  ──────────► Doc (verbatim_doc_token)
│               │   └── unified ──────────► note +transcript (non-independent Doc)
│               └── Shared Document ──────────────► Doc (shared_doc_tokens)
│
└── Recording ──► Minutes (minute_token)
                 ├── AI Products: Summary / Todo / Chapter / Keyword
                 ├── Transcript (text record)
                 └── Original Audio & Video

Local Audio & Video ─────────────────────────────► Minutes (minute_token)
ObjectPrimary IdentifierConcept and Relationship
Calendar Schedule
event_id
A schedule on the calendar, including time, participants, conference rooms and RSVP, which can be scheduled or associated with VC meetings; it is not a complete meeting record. The 
meeting_note
on the schedule is a Doc manually bound by the user, which has nothing to do with AI intelligent minutes.
Meeting
meeting_id
An actual video conference that can come from Calendar or be an instant meeting without a schedule. Meeting topic, time, participant snapshot and in-meeting events belong to meeting data; Note and Minutes are possible post-meeting artifacts associated with it.
Note (Intelligent Minutes)
note_id
A collection of logical artifacts formed after enabling AI summary. 
note_display_type
determines different ways to obtain text records in the verbatim transcript.
Minutes
minute_token
Generated by meeting recording or local audio & video upload, including summary, to-do items, chapters, keywords, text records and original audio & video; it can be associated with VC meetings or exist independently.
DocDoc tokenContent carrier, not a meeting identifier. 
note_doc_token
, 
shared_doc_tokens
and some 
verbatim_doc_token
point to Doc; Doc token cannot be used as 
note_id
or 
meeting_id
.

核心标识

Core Identifiers

  • meeting_id
    ：会议 ID。长数字字符串，不是 9 位会议号。
  • meeting_no
    ：会议号。9 位纯数字；CLI 参数名为 
    --meeting-number
    。
  • minute_token
    ：妙记 Token。小写字母数字串，通常取自妙记 URL 
    /minutes/<minute_token>
    。
以上标识均按字符串原样传递，不能相互替代。
  • meeting_id
    : Meeting ID. A long numeric string, not a 9-digit meeting number.
  • meeting_no
    : Meeting number. 9-digit pure number; CLI parameter name is 
    --meeting-number
    .
  • minute_token
    : Minutes Token. A lowercase alphanumeric string, usually obtained from the Minutes URL 
    /minutes/<minute_token>
    .
All the above identifiers are passed as strings as they are and cannot be substituted for each other.

领域不变量

Domain Invariants

  • Note 与 Minutes 分别来自 AI 总结和录制两条独立链路。一场会议可能同时有两类产物、只有其中一类，也可能都没有；不能根据 
    note_id
    推断必然存在 
    minute_token
    ，反之亦然。
  • Minutes 可以由本地音视频直接生成，因此不一定关联 
    meeting_id
    或 Calendar 
    event_id
    。
  • Calendar 
    meeting_note
    、Note 
    note_id
    、Minutes 
    minute_token
    和各类 Doc token 标识不同对象，不能互换、代入其他域的命令或从一者反推另一者。
  • Note and Minutes come from two independent links of AI summary and recording respectively. A meeting may have both types of artifacts, only one type, or none at all; it is impossible to infer that a 
    minute_token
    must exist based on 
    note_id
    , and vice versa.
  • Minutes can be directly generated from local audio & video, so it is not necessarily associated with 
    meeting_id
    or Calendar 
    event_id
    .
  • Calendar 
    meeting_note
    , Note 
    note_id
    , Minutes 
    minute_token
    and various Doc tokens identify different objects and cannot be interchanged, substituted into commands of other domains or inferred from one another.

快速行动

Quick Actions

查询进行中的会议内容

Query Ongoing Meeting Content

bash
undefined
bash
undefined

当前用户所在会议

Meetings the current user is in

lark-cli vc +meeting-list-active --as user
lark-cli vc +meeting-list-active --as user

应用机器人可见的目标用户会议

Target user's meetings visible to the application robot

lark-cli vc +meeting-list-active --as bot --user-id <open_id>
lark-cli vc +meeting-list-active --as bot --user-id <open_id>

确定唯一 meeting_id 后沿用来源身份

Use the source identity after confirming the unique meeting_id

lark-cli vc +meeting-events --as <source_identity> --meeting-id <meeting_id> --page-all --format pretty

同时有多场会议时，需要先选择要查询的会议；只有一场会议时，直接查询该场会议的会议事件。

应用身份只返回“目标用户正在参会、且应用机器人也在同一会议中”的会议；返回空不代表目标用户没有在开会。向用户说明结果时使用“用户身份”或“应用身份”，不要暴露 `user` / `bot` 这类内部缩写。
lark-cli vc +meeting-events --as <source_identity> --meeting-id <meeting_id> --page-all --format pretty

When there are multiple meetings, you need to select the meeting to query first; when there is only one meeting, directly query the meeting events of that meeting.

The application identity only returns meetings where "the target user is attending and the application robot is also in the same meeting"; an empty result does not mean the target user is not in a meeting. Use "user identity" or "application identity" when explaining results to users, do not expose internal abbreviations like `user` / `bot`.

场景手册

Scenario Manuals

当任务目标与场景匹配时，阅读对应的场景手册，按流程执行任务。
  • 查询会议及其产物：按主题、时间、参会人或 
    meeting_id
    / 
    meeting_no
    / 
    event_id
    定位历史会议；查询参会人、录像和会议关联的智能纪要或妙记；基于会议记录总结或复盘。
  • 查询妙记及其产物：已有妙记 URL / 
    minute_token
    ，或按标题、所有者、参与者搜索妙记；读取总结、待办、章节、关键词、逐字稿，下载原始音视频，或查询关联智能纪要。
  • 生成和修改妙记、管理妙记权限：将本地音视频生成妙记、逐字稿、总结、待办或章节；修改妙记标题、总结、待办、关键词或说话人；申请妙记权限，或查看、分配妙记协作者权限。
  • 查询智能纪要及关联产物：已有 
    note_id
    、智能纪要 Docx URL/token，或需要查询纪要正文、逐字稿、妙记和共享文档等关联产物。
  • 应用机器人参会与会中互动：完整编排应用机器人的活跃会议发现、真实入会、事件拉取、文本/表情互动和明确授权后的离会。
  • 会中事件与会中互动：在不触发新的入会/离会操作时，使用用户身份或已在会中的应用身份查询活跃会议、查看发言/聊天/共享内容，或发送文本和表情。
When the task target matches a scenario, read the corresponding scenario manual and execute the task according to the process.
  • Query Meeting and Artifacts: Locate historical meetings by topic, time, participants or 
    meeting_id
    / 
    meeting_no
    / 
    event_id
    ; query participants, recordings and intelligent minutes or Minutes associated with the meeting; summarize or review based on meeting records.
  • Query Minutes and Artifacts: Have Minutes URL / 
    minute_token
    , or search Minutes by title, owner, participants; read summary, to-do items, chapters, keywords, verbatim transcript, download original audio & video, or query associated intelligent minutes.
  • Generate and Modify Minutes, Manage Minutes Permissions: Generate Minutes, verbatim transcript, summary, to-do items or chapters from local audio & video; modify Minutes title, summary, to-do items, keywords or speakers; apply for Minutes permissions, or view and assign Minutes collaborator permissions.
  • Query Intelligent Minutes and Associated Artifacts: Have 
    note_id
    , intelligent minutes Docx URL/token, or need to query minutes content, verbatim transcript, Minutes and shared documents and other associated artifacts.
  • Application Robot Attendance and In-Meeting Interaction: Complete orchestration of application robot's active meeting discovery, real attendance, event pulling, text/emoji interaction and explicit authorized departure.
  • In-Meeting Events and In-Meeting Interaction: When no new join/leave operations are triggered, use user identity or application identity already in the meeting to query active meetings, view speeches/chat/shared content, or send text and emojis.

命令参考

Command Reference

命令用途参考方式
vc +search
搜索历史会议lark-vc-search
vc +detail
查询会议信息及关联的 Note、Minutes 标识lark-vc-detail
vc meeting get
查询会议基础信息和参会人快照
lark-cli vc meeting get --help
vc +recording
从会议定位录制及妙记lark-vc-recording
vc +meeting-list-active
发现当前可见的进行中会议lark-vc-meeting-list-active
vc +meeting-events
读取会中事件和共享内容lark-vc-meeting-events
vc +meeting-message-send
发送会中文本消息或表情lark-vc-meeting-message-send
vc +meeting-join
让应用机器人加入会议lark-vc-agent-meeting-join
vc +meeting-leave
让应用机器人离开会议lark-vc-agent-meeting-leave
minutes +search
搜索妙记lark-minutes-search
minutes minutes get
查询妙记基础信息
lark-cli minutes minutes get --help
minutes +detail
读取妙记信息和指定产物lark-minutes-detail
minutes +download
下载妙记原始音视频lark-minutes-download
minutes +upload
从云空间音视频生成妙记lark-minutes-upload
minutes +update
修改妙记标题lark-minutes-update
minutes +speaker-replace
替换妙记逐字稿说话人lark-minutes-speaker-replace
minutes +summary
替换妙记 AI 总结lark-minutes-summary
minutes +todo
增删改妙记 AI 待办lark-minutes-todo
minutes +apply-permission
申请妙记查看或编辑权限lark-minutes-apply-permission
drive +member-list
查看妙记协作者及其权限lark-drive-member-list
drive +member-add
给指定成员分配妙记查看或编辑权限lark-drive-member-add
minutes +word-replace
批量替换妙记逐字稿关键词
lark-cli minutes +word-replace --help
note +detail
查询智能纪要及关联文档标识lark-note-detail
note +transcript
获取 unified 智能纪要逐字稿lark-note-transcript
CommandPurposeReference Method
vc +search
Search historical meetingslark-vc-search
vc +detail
Query meeting information and associated Note, Minutes identifierslark-vc-detail
vc meeting get
Query basic meeting information and participant snapshot
lark-cli vc meeting get --help
vc +recording
Locate recordings and Minutes from meetingslark-vc-recording
vc +meeting-list-active
Discover currently visible ongoing meetingslark-vc-meeting-list-active
vc +meeting-events
Read in-meeting events and shared contentlark-vc-meeting-events
vc +meeting-message-send
Send in-meeting text messages or emojislark-vc-meeting-message-send
vc +meeting-join
Let application robot join the meetinglark-vc-agent-meeting-join
vc +meeting-leave
Let application robot leave the meetinglark-vc-agent-meeting-leave
minutes +search
Search Minuteslark-minutes-search
minutes minutes get
Query basic Minutes information
lark-cli minutes minutes get --help
minutes +detail
Read Minutes information and specified artifactslark-minutes-detail
minutes +download
Download original audio & video of Minuteslark-minutes-download
minutes +upload
Generate Minutes from cloud storage audio & videolark-minutes-upload
minutes +update
Modify Minutes titlelark-minutes-update
minutes +speaker-replace
Replace speakers in Minutes verbatim transcriptlark-minutes-speaker-replace
minutes +summary
Replace Minutes AI summarylark-minutes-summary
minutes +todo
Add/delete/modify Minutes AI to-do itemslark-minutes-todo
minutes +apply-permission
Apply for Minutes view or edit permissionlark-minutes-apply-permission
drive +member-list
View Minutes collaborators and their permissionslark-drive-member-list
drive +member-add
Assign Minutes view or edit permission to specified memberslark-drive-member-add
minutes +word-replace
Batch replace keywords in Minutes verbatim transcript
lark-cli minutes +word-replace --help
note +detail
Query intelligent minutes and associated document identifierslark-note-detail
note +transcript
Obtain unified intelligent minutes verbatim transcriptlark-note-transcript

渐进加载规则

Progressive Loading Rules

按“快速行动 → 场景手册 → 命令参考”渐进加载：
  1. 用户目标符合“快速行动”的进入条件时，直接执行对应 CLI；不要预读场景手册、命令参考、
    --help
    或 schema。
  2. 不符合快速行动条件，或缺少关键标识、需要消歧、涉及写操作时，读取与目标匹配的一个主场景手册；主场景明确转交到下游场景时，只继续读取被引用的场景或章节，并按其中流程执行 CLI。
  3. 仅当缺少具体参数、返回字段、特殊约束或异常处理方式时：有参考手册的命令读取对应文件；没有参考手册的命令运行表中列出的精确 
    lark-cli ... --help
    。场景或 reference 已给出精确命令时，不再调用 
    --help
    ；仅在参数缺失、命令不识别或文档与运行结果冲突时调用。
Load progressively in the order of "Quick Actions → Scenario Manuals → Command Reference":
  1. When the user's target meets the entry conditions of "Quick Actions", directly execute the corresponding CLI; do not pre-read scenario manuals, command references, 
    --help
    or schema.
  2. If it does not meet the quick action conditions, or lacks key identifiers, needs disambiguation, or involves write operations, read one main scenario manual matching the target; when the main scenario explicitly transfers to a downstream scenario, only continue to read the referenced scenario or chapter, and execute the CLI according to the process in it.
  3. Only when specific parameters, return fields, special constraints or exception handling methods are missing: For commands with reference manuals, read the corresponding file; for commands without reference manuals, run the exact 
    lark-cli ... --help
    listed in the table. When the scenario or reference has given an exact command, do not call 
    --help
    again; only call it when parameters are missing, commands are unrecognized, or documents conflict with running results.