Lark Vc

vc (v1)

CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理

核心概念

• 视频会议（Meeting）：飞书视频会议实例，通过 meeting\_id 标识。
• 会议记录（Meeting Record）：视频会议结束后生成的记录，支持通过关键词、时间段、参会人、组织者、会议室等筛选条件搜索会议室。
• 会议纪要（Note）：视频会议结束后生成的结构化文档，包含纪要文档（包含总结、待办、章节）和逐字稿文档。
• 妙记（Minutes）：来源于飞书视频会议的录制产物或用户上传的音视频文件，支持视频/音频的转写和会议纪要，通过 minute\_token 标识。
• 纪要文档（MainDoc）：会议纪要的主文档，包含 AI 生成的总结和待办。
• 逐字稿（VerbatimDoc）：会议的逐句文字记录，包含说话人和时间戳。

核心场景

1. 搜索会议记录

1. 仅支持搜索已结束的会议，对于还未开始的未来会议，需要使用 lark-calendar 技能。 2. 仅支持使用关键词、时间段、参会人、组织者、会议室等筛选条件搜索会议记录，对于不支持的筛选条件，需要提示用户。 3. 搜索结果存在多条数据时，务必注意分页数据获取，不要遗漏任何会议记录。

2. 整理会议纪要

1. 整理纪要文档时默认给出纪要文档和逐字稿链接即可，无需读取纪要文档或逐字稿内容。 2. 用户明确需要获取纪要文档中的总结、待办、章节产物时，再读取文档获取具体内容。

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

1. 纪要文档、逐字稿文档与关联的共享文档默认使用文档 Token 返回。 2. 仅需要获取文档名称和 URL 等基本信息时，使用 lark-cli drive metas batch_query 查询

# 学习命令使用方式
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}'

3. 需要获取文档内容时，使用 lark-cli docs +fetch。

# 获取文档内容
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 的操作优先使用。

API Resources

lark-cli schema vc.<resource>.<method>   # 调用 API 前必须先查看参数结构
lark-cli vc <resource> <method> [flags] # 调用 API

重要：使用原生 API 时，必须先运行 schema 查看 --data / --params 参数结构，不要猜测字段格式。

meeting

• get — 获取会议详情（主题、时间、参会人、note_id）

# 获取会议基础信息：不包含参会人列表
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>

权限表

vc +notes

前置条件： 先阅读 `../lark-shared/SKILL.md` 了解认证、全局参数和安全规则。

查询会议纪要，支持通过会议 ID、妙记 Token 或日程事件 ID 获取纪要文档、逐字稿、AI 总结、待办和章节。只读操作。

本 skill 对应 shortcut：lark-cli vc +notes。

命令

# 通过会议 ID 查询（逗号分隔支持批量，最多 50 个）
lark-cli vc +notes --meeting-ids 69xxxxxxxxxxxxx28
lark-cli vc +notes --meeting-ids 69xxxxxxxxxxxxx28,69xxxxxxxxxxxxx29

# 通过妙记 Token 查询（从妙记 URL 中提取）
lark-cli vc +notes --minute-tokens obbxxxxxxxxxxxxxxxxxx
lark-cli vc +notes --minute-tokens obbxxxxxxxxxxxxxxxxxx,obbyyyyyyyyyyyyyyyyyy

# 指定逐字稿输出目录（仅 --minute-tokens 路径有效）
lark-cli vc +notes --minute-tokens obbxxxxxxxxxxxxxxxxxx --output-dir ./output
lark-cli vc +notes --minute-tokens obbxxxxxxxxxxxxxxxxxx --overwrite

# 通过日程事件 ID 查询（从 calendar +agenda 获取 event_id）
lark-cli vc +notes --calendar-event-ids xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_0

# 输出格式
lark-cli vc +notes --meeting-ids 69xxxxxxxxxxxxx28 --format json

# 预览 API 调用
lark-cli vc +notes --meeting-ids 69xxxxxxxxxxxxx28 --dry-run

参数

核心约束

1. 三种参数互斥

每次只能指定一种输入方式。同时传入多种会报错。

2. 仅支持 user 身份

该命令仅支持 user 身份，使用前需完成 lark-cli auth login。

3. 批量上限

每次最多传入 50 个 ID/Token。

4. 按路径检查权限

不同输入方式需要不同权限，命令会自动检查对应路径所需的 scope：

输出结果

有纪要文档时

返回 notes 数组，每条记录包含：

minute-tokens 路径的 AI 产物

通过 --minute-tokens 查询时，返回的 artifacts 字段包含 AI 内置产物：

如何获取输入参数

常见错误与排查

提示

• 默认使用 --format json 输出，你更佳擅长解析 JSON 数据。
• 排查参数与请求结构时优先使用 --dry-run。
• --meeting-ids 和 --calendar-event-ids 路径最终都走纪要详情 API，需要 vc:note:read 权限。
• --minute-tokens 路径无纪要权限时会自动降级，不会报错，而是下载内置产物到本地。

参考

• lark-vc — 视频会议全部命令
• lark-vc-search — 搜索历史会议（获取 meeting_id）
• lark-shared — 认证和全局参数

vc +search

前置条件： 先阅读 `../lark-shared/SKILL.md` 了解认证、全局参数和安全规则。

搜索已结束的历史会议记录，支持关键词、时间范围、组织者、参与者以及会议室等多条件过滤。只读操作，不修改任何会议数据。

本 skill 对应 shortcut：lark-cli vc +search（调用 POST /open-apis/vc/v1/meetings/search）。

典型触发表达

以下说法通常应优先使用 vc +search：

• 今天开过的会
• 今天开了哪些会
• 最近参加过哪些会
• 我这周开过的会
• 已结束的会议
• 历史会议记录

命令

# 关键词搜索
lark-cli vc +search --query "周会"

# 按时间范围搜索
lark-cli vc +search --start "2026-03-10T00:00+08:00" --end "2026-03-17T00:00+08:00"
lark-cli vc +search --start 2026-03-10 --end 2026-03-17

# 关键词 + 时间范围
lark-cli vc +search --query "周会" --start "2026-03-10T00:00+08:00" --end "2026-03-17T00:00+08:00"
lark-cli vc +search --query "周会" --start "2026-03-10T00:00+08:00"
lark-cli vc +search --query "周会" --end "2026-03-17T00:00+08:00"

# 按组织者过滤（open_id，逗号分隔）
lark-cli vc +search --organizer-ids "ou_a,ou_b"

# 按参与者过滤（open_id，逗号分隔）
lark-cli vc +search --participant-ids "ou_x,ou_y"

# 按会议室过滤
lark-cli vc +search --room-ids "123,456"

# 多条件组合查询
lark-cli vc +search --organizer-ids "ou_a" --room-ids "123" --start "2026-03-10T00:00+08:00"

# 分页查询
lark-cli vc +search --query "周会" --page-size 15
lark-cli vc +search --query "周会" --page-token "next_page_token"

# 输出为表格/可读格式
lark-cli vc +search --query "周会" --format json

参数

核心约束

1. 至少提供一个过滤条件

所有参数均可选，但必须至少提供一个过滤条件：--query、--start、--end、--organizer-ids、--participant-ids 或 --room-ids。

2. 仅搜索历史会议

vc +search 只能搜索已结束的历史会议记录，不用于查询未来日程。查询未来会议安排请使用 lark-calendar。

3. 仅支持 user 身份

该接口仅支持 user 身份，使用前需完成 lark-cli auth login 并具备 vc:meeting.search:read 权限。

4. 支持分页

当返回 has_more=true 时，使用响应中的 page_token 配合 --page-token 获取下一页结果。

时间格式

--start 和 --end 支持以下时间格式：

输出结果

• 默认输出 JSON，包含 items、total、has_more 和 page_token。

Pagination (has_more / page_token)

• 当结果中返回 has_more=true 时，说明还有更多页可继续获取。
• 继续翻页时，使用响应中的 page_token 搭配 --page-token 发起下一次查询。
• 不要假设调大 --page-size 就能拿全结果；分页遍历时应以 has_more 和 page_token 为准。
• total 数量小于 50 时，自动分页获取所有结果；total 数量大于 50 时，向用户确认是否获取全部结果。

# First page
lark-cli vc +search --query "周会" --page-size 15

# Next page
lark-cli vc +search --query "周会" --page-size 15 --page-token "<PAGE_TOKEN>"

搜索结果中的下一步

搜索结果中的 meeting_id 可直接用于继续查询会议纪要：

# 根据 meeting_id 获取会议纪要
lark-cli vc +notes --meeting-ids <MEETING_ID>

常见错误与排查

提示

• 必须使用 --format json 输出，你更佳擅长解析 JSON 数据。
• 排查参数与请求结构时优先使用 --dry-run。
• 搜索的时间范围最大为 1 个月，如果需要搜索更长时间范围的会议，需要拆分为多次时间范围为一个月查询。

参考

• lark-vc -- 视频会议全部命令
• lark-vc-notes -- 获取会议纪要
• lark-shared -- 认证和全局参数