Lark Minutes

minutes +download

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

下载妙记的音视频媒体文件到本地，或获取有效期 1 天的下载链接。只读操作。

本 skill 对应 shortcut：lark-cli minutes +download。

命令

# 下载妙记（默认布局，落到 ./minutes/{minute_token}/<server-filename>）
lark-cli minutes +download --minute-tokens obcnxxxxxxxxxxxxxxxxxxxx

# 指定输出文件（单 token，文件路径）
lark-cli minutes +download --minute-tokens obcnxxxxxxxxxxxxxxxxxxxx --output ./meeting.mp4

# 指定输出目录（单/批量均可，目录路径）
lark-cli minutes +download --minute-tokens obcnxxxxxxxxxxxxxxxxxxxx --output-dir ./downloads

# 仅获取下载链接（有效期 1 天），不下载文件
lark-cli minutes +download --minute-tokens obcnxxxxxxxxxxxxxxxxxxxx --url-only

# 批量下载多个妙记（默认布局，逐个落到 ./minutes/{minute_token}/）
lark-cli minutes +download --minute-tokens obcnxxxxxxxxxxxxxxxxxxxx,obcnyyyyyyyyyyyyyyyyyyyy

# 批量下载到同一指定目录
lark-cli minutes +download --minute-tokens obcnxxxxxxxxxxxxxxxxxxxx,obcnyyyyyyyyyyyyyyyyyyyy --output-dir ./downloads

# 预览 API 调用
lark-cli minutes +download --minute-tokens obcnxxxxxxxxxxxxxxxxxxxx --dry-run

参数

默认落点：未指定 --output / --output-dir 时，文件落到 ./minutes/{minute_token}/<server-filename>。文件名沿用服务端 Content-Disposition / Content-Type 推断，Agent 可从 saved_path 字段读取实际路径。同一 minute_token 的录像和 vc +notes 的逐字稿默认会落在同一目录下，方便聚合。

核心约束

1. 妙记必须已完成转写

音视频文件仅在妙记转写完成后可下载。如果妙记尚未准备好，API 会返回 2091003 错误。

2. 下载链接有效期 1 天

--url-only 返回的链接有效期为 1 天，过期后需重新获取。

3. 频率限制

API 限流 5 次/秒，批量下载时需注意控制频率。

4. 所需权限

输出结果

下载模式（默认）

单 token：

{
  "minute_token": "obcnxxxxxxxxxxxxxxxxxxxx",
  "artifact_type": "recording",
  "saved_path": "/path/to/minutes/obcnxxxxxxxxxxxxxxxxxxxx/访谈一则.m4a",
  "size_bytes": 52428800
}

批量：downloads 数组，每条与上面结构一致，失败项带 error 字段。

URL 模式（--url-only）

{
  "minute_token": "obcnxxxxxxxxxxxxxxxxxxxx",
  "download_url": "https://..."
}

如何获取 minute_token

常见错误与排查

提示

• 音视频文件可能较大，下载无固定超时限制（由用户 Ctrl+C 控制取消）。
• 默认落点 ./minutes/{minute_token}/ 与 vc +notes 的逐字稿共享同一目录，方便 Agent 聚合同一会议的所有产物。
• 单 token 模式下 --output 若传入已存在目录（如 --output ./existing-dir），等价于 --output-dir，文件落入该目录（cp 语义）。
• 批量模式下 --output 不接受已存在的文件路径（会报错），应改用 --output-dir。
• 如需获取妙记的纪要内容（逐字稿、AI 总结等），请使用 vc +notes。

参考

• lark-minutes — 妙记全部命令
• lark-vc-notes — 会议纪要查询
• lark-shared — 认证和全局参数

minutes +search

前置条件： 先阅读 [