vc (v1)
CRITICAL — 开始前 MUST 先用 Read 工具读取
../lark-shared/SKILL.md
，其中包含认证、权限处理
核心概念
视频会议（Meeting）
：飞书视频会议实例，通过 meeting_id 标识。
会议记录（Meeting Record）
：视频会议结束后生成的记录，支持通过关键词、时间段、参会人、组织者、会议室等筛选条件搜索会议室。
会议纪要（Note）
：视频会议结束后生成的结构化文档，包含纪要文档（包含总结、待办、章节）和逐字稿文档。
妙记（Minutes）
：来源于飞书视频会议的录制产物或用户上传的音视频文件，支持视频/音频的转写和会议纪要，通过 minute_token 标识。
纪要文档（MainDoc）
：AI 智能纪要的主文档，包含 AI 生成的总结和待办，对应
note_doc_token
。
用户会议纪要（MeetingNotes）
：用户主动绑定到会议的纪要文档，对应
meeting_notes
。仅通过
--calendar-event-ids
路径返回。
逐字稿（VerbatimDoc）
：会议的逐句文字记录，包含说话人和时间戳。
核心场景
1. 搜索会议记录
仅支持搜索已结束的会议，对于还未开始的未来会议，需要使用 lark-calendar 技能。
仅支持使用关键词、时间段、参会人、组织者、会议室等筛选条件搜索会议记录，对于不支持的筛选条件，需要提示用户。
搜索结果存在多条数据时，务必注意分页数据获取，不要遗漏任何会议记录。
2. 整理会议纪要
整理纪要文档时默认给出纪要文档和逐字稿链接即可，无需读取纪要文档或逐字稿内容。
用户明确需要获取纪要文档中的总结、待办、章节产物时，再读取文档获取具体内容。
读取智能纪要（
note_doc_token
）内容时，纪要文档的
第一个
1. 读取纪要内容
lark-cli docs +fetch --doc < note_doc_token
2. 从返回的 markdown 中提取第一个
3. 下载封面图到 artifact 目录（和逐字稿同目录，保持产物归拢）
并非所有纪要都有封面画板，没有 标签时跳过即可
lark-cli docs +media-download --type whiteboard --token < whiteboard_token
--output ./artifact- < title
/cover 产物目录规范 ：同一会议的所有下载产物（封面图、逐字稿等）统一放到 artifact-<title>/ 目录下，不要散落在当前工作目录。 纪要相关文档 — 根据用户意图选择： note_doc_token → AI 智能纪要 （AI 总结 + 待办 + 章节） meeting_notes → 用户绑定的会议纪要 （用户主动关联到会议的文档，仅 --calendar-event-ids 路径返回） verbatim_doc_token → 逐字稿 （完整的逐句文字记录，含说话人和时间戳）— 用户说"逐字稿""完整记录""谁说了什么"时用这个 用户说"纪要""总结""纪要内容"时，应同时返回 note_doc_token 和 meeting_notes （如有） 用户意图不明确时，应展示所有文档链接让用户选择，而不是替用户决定 3. 纪要文档与逐字稿链接 纪要文档、逐字稿文档与关联的共享文档默认使用文档 Token 返回。 仅需要获取文档名称和 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": "
获取文档内容
- lark-cli docs +fetch
- --doc
- <
- doc_token
- >
- 资源关系
- Meeting (视频会议)
- ├── Note (会议纪要)
- │ ├── MainDoc (AI 智能纪要文档, note_doc_token)
- │ ├── MeetingNotes (用户绑定的会议纪要文档, meeting_notes)
- │ ├── VerbatimDoc (逐字稿, verbatim_doc_token)
- │ └── SharedDoc (会中共享文档)
- └── Minutes (妙记) ← minute_token 标识，+recording 从 meeting_id 获取
- ├── 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 +
[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) +recording Query minute_token from meeting-ids or calendar-event-ids 使用 +search 命令时，必须阅读 references/lark-vc-search.md ，了解搜索参数和返回值结构。 使用 +notes 命令时，必须阅读 references/lark-vc-notes.md ，了解查询参数、产物类型和返回值结构。 使用 +recording 命令时，必须阅读 references/lark-vc-recording.md ，了解查询参数和返回值结构。 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": "
获取会议基础信息：包含参会人列表
lark-cli vc meeting get
--params
'{"meeting_id": "