vc (v1)
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理
核心概念
- 视频会议（Meeting）：飞书视频会议实例，通过 meeting_id 标识。
- 会议记录（Meeting Record）：视频会议结束后生成的记录，支持通过关键词、时间段、参会人、组织者、会议室等筛选条件搜索会议室。
- 会议纪要（Note）：视频会议结束后生成的结构化文档，包含纪要文档（包含总结、待办、章节）和逐字稿文档。
- 妙记（Minutes）：来源于飞书视频会议的录制产物或用户上传的音视频文件，支持视频/音频的转写和会议纪要，通过 minute_token 标识。
- 纪要文档（MainDoc）：会议纪要的主文档，包含 AI 生成的总结和待办。
- 逐字稿（VerbatimDoc）：会议的逐句文字记录，包含说话人和时间戳。
核心场景
1. 搜索会议记录
- 仅支持搜索已结束的会议，对于还未开始的未来会议，需要使用 lark-calendar 技能。
- 仅支持使用关键词、时间段、参会人、组织者、会议室等筛选条件搜索会议记录，对于不支持的筛选条件，需要提示用户。
- 搜索结果存在多条数据时，务必注意分页数据获取，不要遗漏任何会议记录。
2. 整理会议纪要
- 整理纪要文档时默认给出纪要文档和逐字稿链接即可，无需读取纪要文档或逐字稿内容。
- 用户明确需要获取纪要文档中的总结、待办、章节产物时，再读取文档获取具体内容。
3. 纪要文档与逐字稿链接
- 纪要文档、逐字稿文档与关联的共享文档默认使用文档 Token 返回。
- 仅需要获取文档名称和 URL 等基本信息时，使用
lark-cli drive metas batch_query查询
bash# 学习命令使用方式 lark-cli schema drive.metas.batch_query # 批量获取文档基本信息: 一次最多查询 10 个文档 lark-cli drive metas batch_query --data '{"request_docs": [{"doc_type": "docx", "doc_token": "<doc_token>"}], "with_url": true}'
- 需要获取文档内容时，使用
lark-cli docs +fetch。
bash# 获取文档内容 lark-cli docs +fetch --doc <doc_token>
资源关系
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 技能查询今天还未开始的会议，统一整理后展示给用户。
Shortcuts（推荐优先使用）
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) |
API Resources
bashlark-cli schema vc.<resource>.<method> # 调用 API 前必须先查看参数结构 lark-cli vc <resource> <method> [flags] # 调用 API
重要：使用原生 API 时，必须先运行
schema查看--data/--params参数结构，不要猜测字段格式。
meeting
get— 获取会议详情（主题、时间、参会人、note_id）
bash# 获取会议基础信息：不包含参会人列表 lark-cli vc meeting get --params '{"meeting_id": "<meeting_id>"}' # 获取会议基础信息：包含参会人列表 lark-cli vc meeting get --params '{"meeting_id": "<meeting_id>", "with_participants": true}'
minutes（跨域，详见 lark-minutes）
get— 获取妙记基础信息（标题、时长、封面）；查询纪要内容请用+notes --minute-tokens <minute-token>
权限表
| 方法 | 所需 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 |
