minutes (v1) CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md ，其中包含认证、权限处理 核心概念 妙记（Minutes） ：来源于飞书视频会议的录制产物或用户上传的音视频文件，通过 minute_token 标识。 妙记 Token（minute_token） ：妙记的唯一标识符，可从妙记 URL 末尾提取（例如 https://*.feishu.cn/minutes/obcnq3b9jl72l83w4f14xxxx 中的 obcnq3b9jl72l83w4f14xxxx ）。如果 URL 中包含额外参数（如 ?xxx ），应截取路径最后一段。 核心场景 1. 搜索妙记 当用户描述的是"我的妙记""包含某个关键词的妙记""某段时间内的妙记"，优先使用 minutes +search 。 仅支持使用关键词、时间段、参与者、所有者等筛选条件搜索妙记记录，对于不支持的筛选条件，需要提示用户。 搜索结果存在多条数据时，务必注意分页数据获取，不要遗漏任何妙记记录。 如果是会议的妙记，应优先使用 vc +search 先定位会议，再按需通过 vc +recording 获取 minute_token 。 2. 查看妙记基础信息 当用户只需要确认某条妙记的标题、封面、时长、所有者、URL 等基础信息时，使用 minutes minutes get 。 如果用户给的是妙记 URL，应先从 URL 末尾提取 minute_token ，再调用 minutes minutes get 。 用户意图不明确时，默认先给基础元信息，帮助确认是否命中目标妙记。 使用 lark-cli schema minutes.minutes.get 可查看完整返回值结构。核心字段包含： title （标题）、 cover （封面 URL）、 duration （时长，毫秒）、 owner_id （所有者 ID）、 url （妙记链接）。 3. 下载妙记音视频文件 下载妙记音视频文件到本地，或获取有效期 1 天的下载链接。详见 minutes +download 。 minutes +download 只负责音视频媒体文件。 用户只想拿可分享的下载地址时，使用 --url-only ；用户要落地到本地文件时，直接下载。 注意 ： +download 只负责音视频媒体文件。如果用户需要的是逐字稿、总结、待办、章节等纪要内容，请使用 vc +notes --minute-tokens 。 4. 获取妙记的逐字稿、总结、待办、章节 当用户说"这个妙记的逐字稿""总结""待办""章节"时， 不属于本 skill 。 应使用 vc +notes --minute-tokens 获取对应的纪要产物。 如果当前上下文中已有 minute_token ，可直接传给 vc +notes ；如果只有妙记 URL，先提取 minute_token 。
通过 minute_token 获取纪要产物（逐字稿、总结、待办、章节）
lark-cli vc +notes --minute-tokens < minute_token
跨 skill 路由 ：逐字稿、AI 总结、待办、章节等纪要内容由 lark-vc 的 +notes 命令提供 资源关系 Minutes (妙记) ← minute_token 标识 ├── Metadata (标题、封面、时长、owner、url) → minutes minutes get └── MediaFile (音频/视频文件) → minutes +download 能力边界 ： minutes 负责 搜索妙记、查看基础元信息、下载音视频文件 。 路由规则 ： 用户说"妙记列表 / 搜索妙记 / 某个关键词的妙记" → minutes +search 用户只是想看"我的妙记 / 某段时间内的妙记 / 妙记列表"，不要先走 lark-vc ，而应直接使用本 skill 用户如果同时提到"会议 / 会 / 开会 / 某场会"，即使也提到了"妙记"，也应优先走 lark-vc 先定位会议，再通过 vc +recording 获取 minute_token 用户说"我的妙记 / 我拥有的妙记 / 我参与的妙记"时，可将相关过滤条件映射为 me ； me 表示当前用户 结果有多页时，使用 page_token 持续翻页，直到确认没有更多结果 minutes +search 单次最多返回 200 条；结果总数没有固定上限 用户说"这个妙记的标题 / 时长 / 封面 / 链接" → minutes minutes get 用户说"下载这个妙记的视频 / 音频 / 媒体文件" → minutes +download 用户说"这个妙记的逐字稿 / 总结 / 待办 / 章节" → 使用 vc +notes --minute-tokens Shortcuts（推荐优先使用） Shortcut 是对常用操作的高级封装（ lark-cli minutes +
[flags] ）。有 Shortcut 的操作优先使用。 Shortcut 说明 +search Search minutes by keyword, owners, participants, and time range +download Download audio/video media file of a minute 使用 +search 命令时，必须阅读 references/lark-minutes-search.md ，了解搜索参数和返回值结构。 使用 +download 命令时，必须阅读 references/lark-minutes-download.md ，了解下载参数和返回值结构。 API Resources lark-cli schema minutes. < resource . < method
调用 API 前必须先查看参数结构
lark-cli minutes < resource
< method
[ flags ]
调用 API
重要 ：使用原生 API 时，必须先运行 schema 查看 --data / --params 参数结构，不要猜测字段格式。 minutes get — 获取妙记信息 权限表 方法 所需 scope +search minutes:minutes.search:read minutes.get minutes:minutes:readonly +download minutes:minutes.media:export