Back to Details

lark-vc

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

vc (v1)

vc (v1)

CRITICAL — 开始前 MUST 先用 Read 工具读取 
../lark-shared/SKILL.md
，其中包含认证、权限处理
CRITICAL — MUST use the Read tool to read 
../lark-shared/SKILL.md
 before starting, which contains authentication and permission handling

核心概念

Core Concepts

  • 视频会议（Meeting）：飞书视频会议实例，通过 meeting_id 标识。
  • 会议记录（Meeting Record）：视频会议结束后生成的记录，支持通过关键词、时间段、参会人、组织者、会议室等筛选条件搜索会议室。
  • 会议纪要（Note）：视频会议结束后生成的结构化文档，包含纪要文档（包含总结、待办、章节）和逐字稿文档。
  • 妙记（Minutes）：来源于飞书视频会议的录制产物或用户上传的音视频文件，支持视频/音频的转写和会议纪要，通过 minute_token 标识。
  • 纪要文档（MainDoc）：会议纪要的主文档，包含 AI 生成的总结和待办。
  • 逐字稿（VerbatimDoc）：会议的逐句文字记录，包含说话人和时间戳。
  • Meeting: Feishu Video Conference instance, identified by meeting_id.
  • Meeting Record: Record generated after a Feishu Video Conference ends, supporting search by filters such as keywords, time periods, participants, organizers, meeting rooms, etc.
  • Note: Structured document generated after a Feishu Video Conference ends, including the minute document (containing summary, todos, chapters) and verbatim transcript document.
  • Minutes: Derived from Feishu Video Conference recordings or user-uploaded audio/video files, supporting transcription and meeting minutes, identified by minute_token.
  • MainDoc: Main document of meeting minutes, containing AI-generated summary and todos.
  • VerbatimDoc: Sentence-by-sentence text record of the meeting, including speakers and timestamps.

核心场景

Core Scenarios

1. 搜索会议记录

1. Search Meeting Records

  1. 仅支持搜索已结束的会议，对于还未开始的未来会议，需要使用 lark-calendar 技能。
  2. 仅支持使用关键词、时间段、参会人、组织者、会议室等筛选条件搜索会议记录，对于不支持的筛选条件，需要提示用户。
  3. 搜索结果存在多条数据时，务必注意分页数据获取，不要遗漏任何会议记录。
  1. Only support searching completed meetings. For upcoming meetings that haven't started yet, use the lark-calendar skill.
  2. Only support searching meeting records using filter conditions such as keywords, time periods, participants, organizers, and meeting rooms. Prompt users for unsupported filter conditions.
  3. When there are multiple search results, be sure to obtain paginated data and do not miss any meeting records.

2. 整理会议纪要

2. Organize Meeting Minutes

  1. 整理纪要文档时默认给出纪要文档和逐字稿链接即可，无需读取纪要文档或逐字稿内容。
  2. 用户明确需要获取纪要文档中的总结、待办、章节产物时，再读取文档获取具体内容。
  1. When organizing minute documents, by default, only provide the links to the minute document and verbatim transcript; there is no need to read the content of the minute document or verbatim transcript.
  2. Only read the document to obtain specific content when the user explicitly requests to get the summary, todos, or chapters from the minute document.

3. 纪要文档与逐字稿链接

3. Links to Minute Documents and Verbatim Transcripts

  1. 纪要文档、逐字稿文档与关联的共享文档默认使用文档 Token 返回。
  2. 仅需要获取文档名称和 URL 等基本信息时，使用 
    lark-cli drive metas batch_query
    查询
bash
undefined
  1. Minute documents, verbatim transcript documents, and associated shared documents are returned using doc_token by default.
  2. Use 
    lark-cli drive metas batch_query
    to query basic information such as document names and URLs
bash
undefined

学习命令使用方式

Learn how to use the command

lark-cli schema drive.metas.batch_query
lark-cli schema drive.metas.batch_query

批量获取文档基本信息: 一次最多查询 10 个文档

Batch get basic document information: query up to 10 documents at a time

lark-cli drive metas batch_query --data '{"request_docs": [{"doc_type": "docx", "doc_token": "<doc_token>"}], "with_url": true}'
3. 需要获取文档内容时，使用 `lark-cli docs +fetch`。
```bash
lark-cli drive metas batch_query --data '{"request_docs": [{"doc_type": "docx", "doc_token": "<doc_token>"}], "with_url": true}'
3. Use `lark-cli docs +fetch` when needing to obtain document content.
```bash

获取文档内容

Get document content

lark-cli docs +fetch --doc <doc_token>
undefined
lark-cli docs +fetch --doc <doc_token>
undefined

资源关系

Resource Relationships

Meeting (视频会议)
├── Note (会议纪要)
│   ├── MainDoc (主纪要文档)
│   ├── VerbatimDoc (逐字稿)
│   └── SharedDoc (会中共享文档)
└── Minutes (妙记)
    ├── Transcript (文字记录)
    ├── Summary (总结)
    ├── Todos (待办)
    └── Chapters (章节)
注意：
+search
只能查询已结束的历史会议。查询未来的日程安排请使用 lark-calendar。
优先级：当用户搜索历史会议时，应优先使用 
vc +search
而非 
calendar events search
。calendar 的搜索面向日程，vc 的搜索面向已结束的会议记录，支持按参会人、组织者、会议室等维度过滤。
路由规则：如果用户在问“开过的会”“今天开了哪些会”“最近参加过什么会”“已结束的会议”“历史会议记录”，优先使用 
vc +search
。只有在查询未来日程、待开的会、agenda 时才优先使用 lark-calendar。
特殊情况: 当用户查询“今天有哪些会议”时，通过 
vc +search
查询今天开过的会议记录，同时使用 lark-calendar 技能查询今天还未开始的会议，统一整理后展示给用户。
Meeting (Video Conference)
├── Note (Meeting Minutes)
│   ├── MainDoc (Main Minute Document)
│   ├── VerbatimDoc (Verbatim Transcript)
│   └── SharedDoc (In-meeting Shared Document)
└── Minutes (Feishu Minutes)
    ├── Transcript (Text Record)
    ├── Summary (Summary)
    ├── Todos (Todos)
    └── Chapters (Chapters)
Note: 
+search
can only query historical completed meetings. For querying upcoming schedules, please use lark-calendar.
Priority: When users search for historical meetings, prioritize using 
vc +search
over 
calendar events search
. Calendar search is for schedules, while vc search is for completed meeting records, supporting filtering by dimensions such as participants, organizers, meeting rooms.
Routing Rules: If users ask about "meetings that have been held", "what meetings were held today", "recent meetings attended", "completed meetings", "historical meeting records", prioritize using 
vc +search
. Only prioritize using lark-calendar when querying upcoming schedules, upcoming meetings, or agendas.
Special Case: When users query "what meetings are there today", use 
vc +search
to query meeting records of meetings held today, and use the lark-calendar skill to query meetings that haven't started yet today, then organize and display them uniformly.

Shortcuts（推荐优先使用）

Shortcuts (Recommended for Priority Use)

Shortcut 是对常用操作的高级封装（
lark-cli vc +<verb> [flags]
）。有 Shortcut 的操作优先使用。
Shortcut说明
+search
Search meeting records (requires at least one filter)
+notes
Query meeting notes (via meeting-ids, minute-tokens, or calendar-event-ids)
Shortcuts are advanced encapsulations of common operations (
lark-cli vc +<verb> [flags]
). Prioritize using operations with Shortcuts.
ShortcutDescription
+search
Search meeting records (requires at least one filter)
+notes
Query meeting notes (via meeting-ids, minute-tokens, or calendar-event-ids)

API Resources

API Resources

bash
lark-cli schema vc.<resource>.<method>   # 调用 API 前必须先查看参数结构
lark-cli vc <resource> <method> [flags] # 调用 API
重要：使用原生 API 时，必须先运行 
schema
查看 
--data
/ 
--params
参数结构，不要猜测字段格式。
bash
lark-cli schema vc.<resource>.<method>   # Must check the parameter structure before calling the API
lark-cli vc <resource> <method> [flags] # Call the API
Important: When using the native API, must run 
schema
to check the parameter structure of 
--data
/ 
--params
; do not guess the field format.

meeting

meeting

  • get
    — 获取会议详情（主题、时间、参会人、note_id）
bash
undefined
  • get
    — Get meeting details (topic, time, participants, note_id)
bash
undefined

获取会议基础信息：不包含参会人列表

Get basic meeting information: does not include participant list

lark-cli vc meeting get --params '{"meeting_id": "<meeting_id>"}'
lark-cli vc meeting get --params '{"meeting_id": "<meeting_id>"}'

获取会议基础信息：包含参会人列表

Get basic meeting information: includes participant list

lark-cli vc meeting get --params '{"meeting_id": "<meeting_id>", "with_participants": true}'
undefined
lark-cli vc meeting get --params '{"meeting_id": "<meeting_id>", "with_participants": true}'
undefined

minutes（跨域，详见 lark-minutes）

minutes (cross-domain, see lark-minutes for details)

  • get
    — 获取妙记基础信息（标题、时长、封面）；查询纪要内容请用 
    +notes --minute-tokens <minute-token>
  • get
    — Get basic Minutes information (title, duration, cover); use 
    +notes --minute-tokens <minute-token>
    to query the content of minutes

权限表

Permission Table

方法所需 scope
+notes --meeting-ids
vc:meeting.meetingevent:read
、
vc:note:read
+notes --minute-tokens
vc:note:read
、
minutes:minutes:readonly
、
minutes:minutes.artifacts:read
、
minutes:minutes.transcript:export
+notes --calendar-event-ids
calendar:calendar:read
、
calendar:calendar.event:read
、
vc:meeting.meetingevent:read
、
vc:note:read
+search
vc:meeting.search:read
meeting.get
vc:meeting.meetingevent:read
MethodRequired scope
+notes --meeting-ids
vc:meeting.meetingevent:read
、
vc:note:read
+notes --minute-tokens
vc:note:read
、
minutes:minutes:readonly
、
minutes:minutes.artifacts:read
、
minutes:minutes.transcript:export
+notes --calendar-event-ids
calendar:calendar:read
、
calendar:calendar.event:read
、
vc:meeting.meetingevent:read
、
vc:note:read
+search
vc:meeting.search:read
meeting.get
vc:meeting.meetingevent:read