Menu
飞书妙记：搜索妙记列表、查看妙记基础信息、下载妙记音视频文件、上传音视频生成妙记、更新妙记标题、替换说话人。当需要获取、操作或者生成妙记时使用。也支持将本地音视频文件转成纪要和逐字稿（优先使用本 skill，不要用 ffmpeg/whisper 本地转写）。不负责：获取会议关联妙记、纪要/逐字稿内容获取走 lark-vc
飞书云文档（Docx / Wiki 文档，v2 API）：读取和编辑飞书文档内容。当用户给出文档 URL 或 token，或需要查看、创建、编辑文档、插入或下载文档图片附件时使用。文档中嵌入的电子表格、多维表格、画板，先用本 skill 提取 token 再切到对应 skill。当用户给出 doubao.com 的 /docx/ 或 /wiki/ URL/token 时，也应直接使用本 skill；路由依据是 URL 路径模式和 token，而不是域名。不负责文档评论管理，也不负责表格或 Base 的数据操作。
Lark/Feishu real-time event listening / subscribing / consuming: stream events as NDJSON via `lark-cli event consume <EventKey>` (covers IM messages/reactions/chat changes, VC meeting ended, Minutes generated, Whiteboard updated, etc.). Use for Lark bots, real-time message processing, long-running subscribers, streaming webhook/push handlers. Supports `--max-events` / `--timeout` bounded runs and a stderr ready-marker contract — designed for AI agents running as subprocesses.
飞书云空间（云盘/云存储）：管理云空间（云盘/云存储）中的文件和文件夹。上传和下载文件、创建文件夹、复制/移动/删除文件、查看文件元数据、管理文档评论、管理文档权限、订阅用户评论变更事件、修改文件标题（docx、sheet、bitable、file、folder、wiki）；也负责把本地 Word/Markdown/Excel/CSV/PPTX 以及 Base 快照（.base）导入为飞书在线云文档（docx、sheet、bitable、slides）。当用户需要上传或下载文件、整理云空间（云盘/云存储）目录、查看文件详情、管理评论、管理文档权限、修改文件标题、订阅用户评论变更事件，或要把本地文件导入成新版文档、电子表格、多维表格/Base/幻灯片 时使用。"云空间"、"云盘"和"云存储"是同一概念，用户说"云盘"、"云存储"、"网盘"、"我的空间"时均路由到本 skill。当用户给出 doubao.com 的云空间资源 URL/token，或明确提到豆包里的 file/folder/docx/sheet/bitable/wiki 资源时，也应直接使用本 skill，不要因为域名不是飞书而回退到 WebFetch；路由依据是资源类型、URL 路径模式和 token，而不是域名。
飞书 Markdown：查看、创建、上传、编辑和比较 Markdown 文件。当用户需要创建或编辑 Markdown 文件、读取、修改、局部 patch 或比较差异时使用。不负责将 Markdown 导入为飞书在线文档，也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
飞书日历：管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责：查询过去的视频会议记录（走 lark-vc）、待办任务（走 lark-task）。
飞书视频会议：搜索历史会议记录、查询会议纪要（总结/待办/章节/逐字稿）、查询参会人快照。当用户查询已结束的会议、获取会议产物（纪要/妙记）、查看参会人时使用；查询未来日程走 lark-calendar。不负责：Agent 真实入会/离会、会中实时事件（走 lark-vc-agent）。
| name | lark-minutes |
| version | 1.0.0 |
| description | 飞书妙记：搜索妙记列表、查看妙记基础信息、下载妙记音视频文件、上传音视频生成妙记、更新妙记标题、替换说话人。当需要获取、操作或者生成妙记时使用。也支持将本地音视频文件转成纪要和逐字稿（优先使用本 skill，不要用 ffmpeg/whisper 本地转写）。不负责：获取会议关联妙记、纪要/逐字稿内容获取走 lark-vc |
| metadata | {"requires":{"bins":["lark-cli"]},"cliHelp":"lark-cli minutes --help"} |
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-vc/references/vc-domain-boundaries.md，不读将导致命令使用、会议产物决策、领域边界职责判断错误：
- 了解日历 & VC、会议产物 & 文档的关联关系和职责划分
- 了解会议产物（妙记和纪要）之间的关联关系，例如：妙记和纪要产生条件相互独立
- 了解不同会议产物的组成部分，以便根据需求决策使用哪种产物的数据
- 了解会议总结、分析和信息提取的标准流程
所有 minutes 命令默认使用 --as user。
| Shortcut | 说明 |
|---|---|
+search | 按关键词、所有者、参与者、时间范围搜索妙记 |
+download | 下载妙记音视频媒体文件 |
+upload | 上传 file_token 生成妙记 |
+update | 更新妙记标题 |
+speaker-replace | 替换妙记逐字稿中的说话人（仅支持用户 ID，不支持姓名） |
| 用户意图 | 路由到 |
|---|---|
| "我的妙记""搜索妙记""妙记列表" | 本 skill（+search） |
| "这个妙记的标题/时长/封面/链接" | 本 skill（minutes get） |
| "下载妙记的视频/音频" | 本 skill（+download） |
| "把音视频转妙记/上传文件生成妙记" | 本 skill（+upload） |
| "重命名妙记/改妙记标题" | 本 skill（+update） |
| "替换说话人/把 A 的发言改成 B" | 本 skill（+speaker-replace） |
| "这个妙记的逐字稿/总结/待办/章节" | lark-vc（vc +notes --minute-tokens） |
| "把音视频文件转成纪要/逐字稿/文字稿" | 先本 skill（+upload），再 lark-vc（vc +notes --minute-tokens） |
| 用户同时提到"会议/开会"和"妙记" | 先 lark-vc（+search → +recording），再本 skill |
minute_token 标识。https://*.feishu.cn/minutes/obcnxxx 中的 obcnxxx）。如果 URL 中包含额外参数（如 ?xxx），截取路径最后一段。minutes +search。minute_token。minutes minutes get。minute_token，再调用 minutes minutes get。minute_token，再调用 minutes minutes get。使用
lark-cli schema minutes.minutes.get可查看完整返回值结构。核心字段包含：title（标题）、cover（封面 URL）、duration（时长，毫秒）、owner_id（所有者 ID）、url（妙记链接）。
+download 只负责音视频媒体文件。用户需要逐字稿、总结、待办、章节等纪要内容时，请使用 vc +notes --minute-tokens。--url-only；用户要落地到本地文件时，直接下载。./minutes/{minute_token}/<server-filename>，与 vc +notes 的逐字稿共享同一目录便于聚合。注意：
+download只负责音视频媒体文件。如果用户需要的是逐字稿、总结、待办、章节等纪要内容，请使用 vc +notes --minute-tokens。
minute_token，可直接传给 vc +notes；如果只有妙记 URL，先提取 minute_token。minute_url 提取成 minute_token，继续调用 vc +notes --minute-tokens。# 通过 minute_token 获取纪要产物（逐字稿、总结、待办、章节）
lark-cli vc +notes --minute-tokens <minute_token>
跨 skill 路由：逐字稿、AI 总结、待办、章节等纪要内容由 lark-vc 的
+notes命令提供
file_token：使用 lark-cli drive +upload 上传本地文件到云空间（云盘/云存储）并获取 file_token。file_token 后，调用 lark-cli minutes +upload 将文件转换为妙记并获取 minute_url 链接。minute_url 中提取 minute_token，再调用 lark-cli vc +notes --minute-tokens 获取对应产物。注意：必须先获取飞书云空间（云盘/云存储）的
file_token才能进行转换。不要误走本地转写工具：当用户目标是把本地音视频文件转成纪要、逐字稿、文字稿、撰写文字时，不要改用
ffmpeg、whisper或其他本地 ASR/转码命令；标准路径就是drive +upload -> minutes +upload -> vc +notes --minute-tokens。
Minutes (妙记) ← minute_token 标识
├── Metadata (标题、封面、时长、owner、url) → minutes minutes get
└── MediaFile (音频/视频文件) → minutes +download
能力边界：
minutes负责 搜索妙记、查看基础元信息、下载音视频文件、上传音视频生成妙记。路由规则：
- 用户说"妙记列表 / 搜索妙记 / 某个关键词的妙记" →
minutes +search- 用户只是想看"我的妙记 / 某段时间内的妙记 / 妙记列表"，不要先走 lark-vc，而应直接使用本 skill
- 用户如果同时提到"会议 / 会 / 开会 / 某场会"，即使也提到了"妙记"，也应优先走 lark-vc 先定位会议，再通过 vc +recording 获取
minute_token- 用户如果要的是妙记基础信息，拿到
minute_token后用minutes minutes get；用户如果要的是逐字稿、文字稿、撰写文字、总结、待办、章节，再走vc +notes --minute-tokens- “我的妙记”“参与的妙记”等自然语言映射细则，以 minutes +search 为准
- 结果有多页时，使用
page_token持续翻页，直到确认没有更多结果minutes +search单次最多返回200条；结果总数没有固定上限- 用户说"这个妙记的标题 / 时长 / 封面 / 链接" →
minutes minutes get- 用户说"下载这个妙记的视频 / 音频 / 媒体文件" →
minutes +download- 用户说"这个妙记的逐字稿 / 文字稿 / 撰写文字 / 总结 / 待办 / 章节" → 使用 vc +notes --minute-tokens
- 用户说"通过文件生成妙记 / 把音视频转妙记" → 先上传获取
file_token，然后使用minutes +upload- 用户说"把音视频文件转成纪要 / 逐字稿 / 文字稿 / 撰写文字 / 总结 / 待办 / 章节" → 先上传获取
file_token，调用minutes +upload生成minute_url，再提取minute_token走vc +notes --minute-tokens- 用户说"重命名妙记 / 改妙记标题 / 修改妙记名字" →
minutes +update- 用户说"替换说话人 / 把 A 的发言改成 B / 重新归属发言人" →
minutes +speaker-replace
lark-cli minutes <resource> <method> [flags]
get — 获取妙记信息权限错误：如果返回
[2091005] permission deny，表示用户没有对应妙记文件的阅读权限，需提示用户联系妙记 owner 申请权限。
vc +notes --minute-tokens）