lark-vc
installsforks
How to install lark-vc?
larksuite/cli/lark-vc
$npx -y skills add larksuite/cli --skill lark-vc飞书视频会议：搜索历史会议记录、查询会议纪要（总结/待办/章节/逐字稿）、查询参会人快照。当用户查询已结束的会议、获取会议产物（纪要/妙记）、查看参会人时使用；查询未来日程走 lark-calendar。不负责：Agent 真实入会/离会、会中实时事件（走 lark-vc-agent）。
SKILL.md
| 1 | # vc (v1) |
| 2 | |
| 3 | **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理** |
| 4 | |
| 5 | **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`references/vc-domain-boundaries.md`](references/vc-domain-boundaries.md)**，不读将导致命令使用、会议产物决策、领域边界职责判断错误： |
| 6 | > 1. 了解日历 & VC、会议产物 & 文档的关联关系和职责划分 |
| 7 | > 2. 了解会议产物（妙记和纪要）之间的关联关系，例如：**妙记和纪要产生条件相互独立** |
| 8 | > 3. 了解不同会议产物的组成部分，以便根据需求决策使用哪种产物的数据 |
| 9 | > 4. 了解会议总结、分析和信息提取的标准流程 |
| 10 | |
| 11 | ## 身份 |
| 12 | |
| 13 | 所有 vc 命令默认使用 `--as user`。`+search` 和 `meeting get` 也支持 `--as bot`。 |
| 14 | |
| 15 | ```bash |
| 16 | # BAD — 查昨天的会议用 calendar，会漏掉即时会议 |
| 17 | lark-cli calendar +search-event --query "站会" --start <start_time> --end <end_time> |
| 18 | |
| 19 | # GOOD — 查已结束的会议用 vc +search |
| 20 | lark-cli vc +search --query "站会" --start <start_time> --end <end_time> |
| 21 | ``` |
| 22 | |
| 23 | ## Shortcuts （推荐优先使用） |
| 24 | |
| 25 | | Shortcut | 说明 | |
| 26 | |----------|------| |
| 27 | | [`+search`](references/lark-vc-search.md) | 搜索历史会议记录（需至关键词、时间范围、组织者、参与者、会议室少一个筛选条件） | |
| 28 | | [`+detail`](references/lark-vc-detail.md) | 通过 meeting-ids 获取会议详情，包括 note_id 和 minute_token | |
| 29 | | [`+recording`](references/lark-vc-recording.md) | 通过 meeting-ids 或 calendar-event-ids 查询 minute_token | |
| 30 | |
| 31 | - 使用任何 Shortcut 前，必须先读其对应 reference 文档。 |
| 32 | |
| 33 | ## 意图路由 |
| 34 | |
| 35 | | 用户意图 | 路由到 | |
| 36 | |----------|--------| |
| 37 | | 查"昨天的会议""上周的会""已结束的会议" | 本 skill（`+search`，含即时会议） | |
| 38 | | 查日历/日程或未来时间的会议 | [lark-calendar](../lark-calendar/SKILL.md) | |
| 39 | | 查"今天有哪些会议" | `vc +search`（已结束）+ lark-calendar（未开始），合并展示 | |
| 40 | | 只按自然语言标题查"xx 纪要的逐字稿 / 原始记录 / 谁说了什么" | 先到 [lark-drive](../lark-drive/SKILL.md) / [lark-doc](../lark-doc/SKILL.md)；仅在已拿到 `note_id` / `vc-node-id` 后再到 [lark-note](../lark-note/SKILL.md) | |
| 41 | | Agent 真实入会/离会、会中实时事件 | [lark-vc-agent](../lark-vc-agent/SKILL.md) | |
| 42 | | 妙记信息/时长/封面/链接 | 先走 `vc +detail` 或 `vc +recording` 获取 `minute_token`，再用 [lark-minutes](../lark-minutes/SKILL.md) 的 `minutes get` | |
| 43 | | 本地音视频文件转纪要/逐字稿 | 先走 [lark-minutes](../lark-minutes/SKILL.md) 上传，再用 `minutes +detail --minute-tokens` | |
| 44 | |
| 45 | ## 核心概念 |
| 46 | |
| 47 | - **视频会议（Meeting）**：飞书视频会议实例，通过 meeting_id 标识。已结束的会议支持通过关键词、时间段、参会人、组织者、会议室等条件搜索（见 `+search`）。 |
| 48 | - **会议纪要（Note）**：视频会议结束后生成的结构化文档，通过 `note_id` 标识，包含纪要文档（总结、待办）和逐字稿文档。`note_display_type` 区分**普通纪要（`normal`）**和 **unified 纪要**；已知 `note_id` 的直查与 unified 原始记录请用 [lark-note](../lark-note/SKILL.md)。 |
| 49 | - **妙记（Minutes）**：来源于飞书视频会议的录制产物或用户上传的音视频文件，支持视频/音频的转写，包含总结、待办、章节和文字记录，通过 minute_token 标识。妙记带有**原始会议录制视频**，会后**不会自动授权给参会人**，需管理员授权或参会人主动申请；而智能纪要及其逐字稿会后自动授权给参会人。 |
| 50 | - **纪要文档（MainDoc）**：AI 智能纪要的主文档，包含 AI 生成的总结和待办，对应 `note_doc_token`。 |
| 51 | - **用户会议纪要（MeetingNotes）**：用户主动绑定到日程的纪要文档，对应 `meeting_note`。需先通过 [`calendar +meeting`](../lark-calendar/references/lark-calendar-meeting.md) 由 `event_id` 获取。 |
| 52 | - **逐字稿（VerbatimDoc）**：会议的逐句文字记录，包含说话人和时间戳。 |
| 53 | |
| 54 | ## 产物选择决策 |
| 55 | |
| 56 | | 用户意图 | 必须读取的产物 | 禁止 | |
| 57 | |---------|-------------|------| |
| 58 | | 提炼/总结/重新总结/整理会议内容/回顾会议 | 为降低 token 消耗，非必须不得获取 AI 纪要。必须使用原始对话记录（按下方逐字稿路由取得），基于原始对话独立分析。两类产物都存在且用户未指定时，默认用智能纪要的逐字稿；用户明确要妙记时才用妙记文字记录（Transcript） | 禁止直接搬运 AI 纪要（`note_doc_token`）的总结作为最终输出 | |
| 59 | | 查看待办/章节 | 默认 AI 纪要（`note_doc_token`）；仅存在妙记或用户明确要妙记时用妙记产物 — AI 待办更友好（含提出人和负责人），章节按话题划分更结构化 | — | |
| 60 | | 查看纪要链接/文档地址 | 仅返回文档链接，无需读取内容 | — | |
| 61 | | 直接看 AI 总结结果 | AI 纪要（`note_doc_token`） | — | |
| 62 | | 谁说了什么/完整发言记录 | 原始对话记录（按下方逐字稿路由取得） | — | |
| 63 | |
| 64 | > **智能纪要 vs 妙记的选择规则**（总结/待办/逐字稿等重复产物通用）：只存在一类 → 用存在的那类；两类都存在且用户明确指定（如"看妙记逐字稿"）→ **语义指向哪个走哪个，不要改道**；两类都存在但用户未指定 → **默认智能纪要及其逐字稿**（会后自动授权给参会人，访问门槛低于含原始录制视频、需申请授权的妙记）。完整说明见 [`references/vc-domain-boundaries.md`](references/vc-domain-boundaries.md) 的「产物选择决策」。 |
| 65 | |
| 66 | |
| 67 | > **逐字稿路由**：先用 `vc +detail` 拿到 `note_id`，再 [`note +detail`](../lark-note/SKILL.md) 看 `note_display_type`，**不要只看 `verbatim_doc_token` 是否为空**。具体路由以 [lark-note](../lark-note/SKILL.md) 的 `note_display_type` 规则为准。 |
| 68 | > |
| 69 | > **为什么"提炼/总结"必须从原始对话记录出发？** AI 纪要是模型对会议的二次压缩，可能遗漏讨论细节、争论过程和隐含决策。用户要求"提炼"或"重新总结"时，期望的是基于原始对话的独立分析，而非对 AI 产物的重新排版。 |
| 70 | |
| 71 | ## 核心场景 |
| 72 | |
| 73 | ### 1. 搜索会议记录 |
| 74 | 1. 仅支持搜索已结束的会议，对于还未开始的未来会议，需要使用 lark-calendar 技能。 |
| 75 | 2. 仅支持使用关键词、时间段、参会人、组织者、会议室等筛选条件搜索会议记录，对于不支持的筛选条件，需要提示用户。 |
| 76 | 3. 搜索结果存在多条数据时，务必注意分页数据获取，不要遗漏任何会议记录。 |
| 77 | 4. 只有自然语言纪要标题、没有会议线索时，不要把标题当会议关键词；按上方意图路由切到文档搜索。 |
| 78 | |
| 79 | ### 2. 整理会议纪要 |
| 80 | |
| 81 | > 在选择读取哪个产物前，先确认你理解 AI 总结链路 vs 录制链路的区别。如不确定，先读 [`references/vc-domain-boundaries.md`](references/vc-domain-boundaries.md)。 |
| 82 | |
| 83 | 1. 整理纪要文档时默认给出纪要文档、逐字稿、妙记链接即可，无需读取纪要文档或逐字稿内容。 |
| 84 | 2. 用户明确需要获取总结、待办、章节产物时，再读取文档获取具体内容。 |
| 85 | 3. 读取智能纪要（`note_doc_token`）内容时，纪要文档的**第一个 `<whiteboard>`** 标签是封面图（AI 生成的总结可视化），应同时下载展示给用户： |
| 86 | |
| 87 | ```bash |
| 88 | # 1. 读取纪要内容 |
| 89 | lark-cli docs +fetch --doc <note_doc_token> --doc-format markdown |
| 90 | # 2. 从返回的 markdown 中提取第一个 <whiteboard token="xxx"/> 的 token |
| 91 | # 3. 下载封面图到聚合目录（和逐字稿、录像同目录，保持产物归拢） |
| 92 | # 并非所有纪要都有封面画板，没有 <whiteboard> 标签时跳过即可 |
| 93 | lark-cli docs +media-download --type whiteboard --token <whiteboard_token> --output ./minutes/<minute_token>/cover |
| 94 | ``` |
| 95 | > **产物目录规范**：同一会议的所有下载产物（录像、逐字稿、封面图等）统一放到 `./minutes/{minute_token}/` 目录下。这与 `minutes +download` 和 `minutes +detail --minute-tokens` 的默认落点保持一致，便于 Agent 聚合。显式路径（如封面图）需手动对齐到同一目录。 |
| 96 | |
| 97 | > **纪要相关文档 — 根据用户意图选择：** |
| 98 | > - `note_doc_token` → **AI 智能纪要**（A |
People who liked this also viewed
6 picksType
- azure-resource-lookupList, find, and show Azure resources across subscriptions or resource groups. Handles prompts like \"list the websites in my subscription\", \"list my web apps\", \"show my app services\", \"list virtSkillsJul 2026
- azure-messagingTroubleshoot and resolve issues with Azure Messaging SDKs for Event Hubs and Service Bus. Covers connection failures, authentication errors, message processing issues, and SDK configuration problems. SkillsJul 2026
- lark-doc飞书云文档（Docx / Wiki 文档）：读取和编辑飞书文档内容。当用户给出文档 URL 或 token，或需要查看、创建、编辑文档、插入或下载文档图片附件时使用。文档中嵌入的电子表格、多维表格、画板，先用本 skill 提取 token 再切到对应 skill。当用户给出 doubao.com 的 /docx/ 或 /wiki/ URL/token 时，也应直接使用本 skill；路由依据是 SkillsJul 2026
- lark-im飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件（支持大文件分片下载）、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片（Interactive Card）、监听卡片按钮回调（card.action.trigger）。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 FeedSkillsJul 2026
- lark-wiki飞书知识库：管理知识空间、空间成员和文档节点。创建和查询知识空间、查看和管理空间成员、管理节点层级结构、在知识库中组织文档和快捷方式。当用户需要在知识库中查找或创建文档、浏览知识空间结构、查看或管理空间成员、移动或复制节点时使用。当用户给出 doubao.com 的 /wiki/ URL/token 时，也应直接使用本 skill，不要因为域名不是飞书而回退到 WebFetch；路由依据是 URLSkillsJul 2026
- lark-mail飞书邮箱：Use when user mentions 起草邮件、写邮件、草稿、发送/回复/转发邮件、查阅邮件、看邮件、搜索邮件、邮件文件夹、邮件标签、邮件联系人、监听新邮件、邮件收信规则等；use for mail/email intent only. Do not use for docs/sheets/calendar/auth setup/pure contact lookup/IM chSkillsJul 2026
