飞书视频会议与妙记 搜索历史会议、获取纪要/AI 产物/逐字稿、查询会议录制、下载妙记媒体。 feishu-cli ：如尚未安装，请前往 riba2534/feishu-cli 获取安装方式。 前置条件 认证 ：所有 vc / minutes 命令都需要 User Access Token （推荐先 auth check --scope "..." ，再执行 feishu-cli auth login --scope "..." 或 --domain vc --domain minutes --recommend ） App 凭证 ：应用 App ID + App Secret（环境变量 FEISHU_APP_ID + FEISHU_APP_SECRET 或 ~/.feishu-cli/config.yaml ） 预检 ： feishu-cli auth status 查看登录状态； feishu-cli auth check --scope "vc:meeting.search:read" 预检 scope 命令速查 1. 搜索历史会议（多维过滤） feishu-cli vc search [ 过滤条件 ] 底层走 POST /open-apis/vc/v1/meetings/search 。 至少指定一个过滤条件 。 参数 类型 说明 --query string 关键词（1-50 字符） --start string 起始时间（YYYY-MM-DD 或 RFC3339） --end string 结束时间（YYYY-MM-DD 或 RFC3339，纯日期自动对齐 23:59:59） --organizer-ids string 主持人 open_id 列表，逗号分隔 --participant-ids string 参会者 open_id 列表，逗号分隔 --room-ids string 会议室 ID 列表，逗号分隔 --page-size int 每页数量（1-30，默认 15） --page-token string 分页标记 -o, --output string json 格式化输出 2. 获取会议纪要（三路径） feishu-cli vc notes ( --meeting-ids | --minute-tokens | --calendar-event-ids ) [ 选项 ] 三入口 互斥 ，均支持逗号分隔批量（最多 50 条）。 参数 类型 说明 --meeting-ids CSV 会议 ID 列表 --minute-tokens CSV 妙记 token 列表 --calendar-event-ids CSV 日历事件实例 ID 列表（自动反查 meeting_ids + meeting_notes） --with-artifacts bool 额外获取 AI 产物（summary / todos / chapters） --download-transcript bool 下载逐字稿到 {output-dir}/artifact-{sanitized_title}-{token}/transcript.txt （已存在时需加 --overwrite ） --output-dir string 逐字稿落盘目录（默认当前目录） --overwrite bool 覆盖已存在的逐字稿文件 -o, --output string json 格式化输出 输出字段： source / meeting_id / minute_token / title / minute_url / create_time / note_doc / verbatim_doc / shared_docs / artifacts / transcript_path 3. 查询会议录制 → minute_token feishu-cli vc recording ( --meeting-ids | --calendar-event-ids ) 从会议录制 URL 中提取 minute_token ，用于后续下载媒体或获取妙记。互斥入口，批量最多 50 条。 参数 类型 说明 --meeting-ids CSV 会议 ID 列表 --calendar-event-ids CSV 日历事件实例 ID 列表 -o, --output string json 格式化输出 4. 获取妙记基础信息（可合并 AI 产物） feishu-cli minutes get < minute_token
[ --with-artifacts ] [ -o json ] 参数 说明
位置参数，必填 --with-artifacts 额外调用 artifacts API 合并输出（summary / todos / chapters） -o, --output json JSON 格式输出 5. 下载妙记媒体文件（批量） feishu-cli minutes download --minute-tokens < t1,t2, .. . [ --output < path
] [ --overwrite ] [ --url-only ] 先调 GET /open-apis/minutes/v1/minutes/{token}/media 拿预签名 URL，再走 HTTP 流式下载。内置 SSRF 防护（拒绝 localhost/回环/内网段）、重定向校验（最多 5 次、禁止 HTTPS→HTTP 降级）、文件名解析（Content-Disposition / RFC 5987 filename* / Content-Type 推导扩展名）、批量文件名冲突去重（加 {token}- 前缀）、5 req/s 速率限制（ time.Ticker ）。 参数 类型 说明 --minute-tokens CSV 必填 ，最多 50 条 --output string 输出路径：单 token 为文件或目录；批量必须是目录；默认当前目录 --overwrite bool 覆盖已存在文件 --url-only bool 只打印下载 URL，不实际下载 使用示例
关键词 + 时间范围搜索
feishu-cli vc search --query "周会" --start 2026 -03-20 --end 2026 -04-11
按主持人过滤 + JSON 输出
feishu-cli vc search --organizer-ids ou_xxx,ou_yyy -o json
通过会议 ID 批量查纪要
feishu-cli vc notes --meeting-ids 6900001,6900002
通过妙记 token 查 + 获取 AI 产物 + 下载逐字稿
feishu-cli vc notes --minute-tokens obcnxxxx \ --with-artifacts --download-transcript --output-dir ./notes
从日历事件反查并下载全部逐字稿
feishu-cli vc notes --calendar-event-ids < event_id
--download-transcript --output-dir ./notes
从会议 ID 反查 minute_token
feishu-cli vc recording --meeting-ids 6900001 -o json
单条妙记下载到当前目录（自动解析文件名）
feishu-cli minutes download --minute-tokens obcnxxxx
批量下载到指定目录
feishu-cli minutes download --minute-tokens t1,t2,t3 --output ./media --overwrite
只取下载链接不下载
feishu-cli minutes download --minute-tokens obcnxxxx --url-only
获取妙记信息并展示 AI 摘要
feishu-cli minutes get obcnxxxx --with-artifacts 典型工作流 工作流 A：会议搜索 → 录制 → 妙记媒体
1. 搜索目标会议
feishu-cli vc search --query "架构评审" --start 2026 -03-01 -o json
→ 记录 meeting_id
2. 查会议录制，拿 minute_token
feishu-cli vc recording --meeting-ids < meeting_id
-o json
→ 记录 minute_token
3. 下载媒体文件
feishu-cli minutes download --minute-tokens < minute_token
--output ./media 工作流 B：日历事件直达妙记下载
1. 从日历事件一次性拿到纪要、AI 产物、逐字稿
feishu-cli vc notes --calendar-event-ids < event_id
\ --with-artifacts --download-transcript --output-dir ./notes -o json
2. 若要下载音视频，配合 recording 命令
feishu-cli vc recording --calendar-event-ids < event_id
-o json
→ 取得 minute_token
feishu-cli minutes download --minute-tokens < minute_token
--output ./media 权限要求 命令 / 功能 必需 scope vc search vc:meeting.search:read vc notes （meeting-ids 路径） vc:meeting.meetingevent:read 、 vc:note:read vc notes （minute-tokens 路径） minutes:minutes:readonly 、 vc:note:read vc notes --with-artifacts + minutes:minutes.artifacts:read vc notes --download-transcript + minutes:minutes.transcript:export vc notes （calendar-event-ids 路径） + calendar:calendar:read 、 calendar:calendar.event:read vc recording vc:record:readonly （calendar 路径同上追加日历权限） minutes get minutes:minutes:readonly （ --with-artifacts 额外需 minutes:minutes.artifacts:read ） minutes download minutes:minutes.media:export 权限在飞书开放平台的应用权限管理页面开通；开通后执行 feishu-cli auth login --scope "所需 scope..." 或 feishu-cli auth login --domain vc --domain minutes --recommend 重新授权即可。 注意事项 Token 必需 ：所有命令都走 User Access Token。未登录时会中文错误提示并引导 feishu-cli auth login 。可通过 --user-access-token 或 FEISHU_USER_ACCESS_TOKEN 环境变量覆盖。 时间格式 ： vc search --start/--end 接受 YYYY-MM-DD / YYYY-MM-DD HH:MM:SS / RFC3339，均按本地时区解析；纯日期的 --end 自动对齐到 23:59:59。 批量上限 ：所有 CSV 类入参统一 50 条上限，超出直接报错。 minute_token 格式 ：字母数字组合，长度≥5；命令会前置校验。 calendar-event-id ：指"日历事件实例 ID"，不是日程 event_id 本身；可从 feishu-cli calendar agenda 或日程视图 API 获取。 文件名解析 ： minutes download 按 Content-Disposition > Content-Type 扩展 > {token}.media 的优先级决定文件名；批量模式冲突时自动加 {token}- 前缀。 SSRF 防护 ：下载 URL 会被校验，拒绝指向内网段 / localhost / 非 http(s) scheme；重定向最多 5 次且禁止 HTTPS → HTTP 降级。 数据时效 ：会议结束后一段时间才能查到纪要/妙记；实时会议无法获取。 逐字稿去重 ：同一 vc notes 调用中同一 minute_token 的逐字稿只下载一次。