ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

基于 lark-cli 的会议纪要汇总工作流:从时间范围查询到结构化报告生成

基于 lark-cli 的会议纪要汇总工作流:从时间范围查询到结构化报告生成 基于 lark-cli 的会议纪要汇总工作流从时间范围查询到结构化报告生成【免费下载链接】cliThe official Lark/飞书 CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, Meetings, and more, with 200 commands and 20 AI Agent Skills.项目地址: https://gitcode.com/gh_mirrors/cli414/cli导读本文以官方技能 SKILL.md 为骨架系统讲解如何在飞书LarkCLI 中落地会议纪要汇总工作流按时间范围搜索历史会议、逐层解析智能纪要Note与妙记Minutes产物、批量解析文档链接最终输出单日概览或会议周报并可一键生成云文档。读者完成后将掌握vc search/vc detail/note detail/drive metas batch_query的完整调用链以及note_display_type逐字稿路由、妙记备选路径、分页与批量上限等关键工程细节。该技能位于仓库 skills/lark-workflow-meeting-summary/属于 skills/ 目录下 20 个 AI Agent Skill 之一其底层能力来自飞书视频会议域VC、文档域Note / Minutes / Drive / Docs的真实 CLI 命令。技能元数据声明了版本1.0.0运行时依赖lark-cli可执行文件并要求前置加载 lark-meeting 技能。适用场景与触发表达该工作流的定位是按时间段汇总会议纪要并生成结构化报告其元数据 description 明确适用于整理会议纪要、生成会议周报、回顾一段时间内的会议内容。官方给出的典型触发表达包括帮我整理这周的会议纪要 / 总结最近的会议 / 生成会议周报看看今天开了哪些会 / 回顾过去一周开了哪些会从命令层面看这类请求的核心是历史会议列表 后续总结取证。参考 lark-vc-search.md 的命令参考vc search只支持搜索已结束的历史会议不用于查询未来日程未来日程应走 lark-calendar。因此今天开了哪些会这类问题本质是先用时间范围搜索全量候选会议再逐层取得纪要或录制信息——这正是本工作流要完成的编排。前置条件身份与授权域工作流仅支持 user 身份执行这是与 lark-meeting 技能支持 user / bot 双身份的主要差异。执行前需按需完成授权授权域按实际需要的深度递增lark-cli auth login --domain vc # 基础查询纪要 lark-cli auth login --domain vc,drive # 含读取纪要文档正文、生成文档 lark-cli auth login --domain vc,drive,minutes # 含无 note_id 时的妙记备选路径只查询会议与纪要标识时vc域即可满足需要在 Step 4 读取纪要文档正文、或在 Step 5 生成云文档时追加drive域若部分会议只有妙记无note_id、需走妙记备选路径读取逐字稿时再追加minutes域。认证、身份与 scope 的完整语义以 lark-shared 为准该技能强调--as user代表用户本人、可访问其个人日历与云空间资源而--as bot只能访问应用自身资源bot 查询用户资源会返回空成功而非报错。因此本工作流必须在 user 身份下执行且整个链路中所有命令应显式传入--as user保持身份连续不要为了绕过权限错误静默切换身份。工作流全景技能文档给出了完整的数据流可概括为五步管道{时间范围} ─► vc search ──► 会议列表 (meeting_ids) │ ▼ vc detail ──► 获取 note_id │ ▼ note detail ──► 纪要文档 tokens │ ▼ drive metas batch_query 纪要元数据 │ ▼ 结构化报告从领域模型看见 lark-meeting/SKILL.mdmeeting_id会议、note_id智能纪要、minute_token妙记是三个相互独立的标识Note 来自 AI 总结链路Minutes 来自录制链路一场会议可能同时有两者、只有其一或都没有。因此工作流每步都必须容忍产物缺失不能根据note_id推断minute_token存在与否。Step 1确定时间范围默认时间范围是过去 7 天。技能给出如下推断规则用户表达时间范围今天当天这周本周一 now上周上周一 上周日这个月本月 1 日 now关键约束日期转换必须调用系统命令如date计算不要心算时间范围参数需按 CLI 实际要求格式化通常为YYYY-MM-DD或 ISO 8601。参考 lark-vc-search.md 的时间格式表格式示例说明ISO 8601带时区2026-03-10T14:00:0008:00推荐ISO 8601不带时区2026-03-10T14:00:00按本地时区解析仅日期2026-03-10按天粒度解析用于--end时表示当天23:59:59注意两个易错语义日期型--end包含当天整天--start 2026-03-10 --end 2026-03-10表示只查当天而非从当天 00:00 起因此查今天时--start与--end填同一天。另外禁止使用yesterday、today这类相对时间字面量必须先转换为明确日期。Step 2查询会议记录使用vc search按时间范围拉取会议列表# page-size 最大为 30 lark-cli vc search --start YYYY-MM-DD --end YYYY-MM-DD --format json --page-size 30配套规则时间范围拆分单次搜索的时间范围最大为 1 个月要覆盖更长范围需拆分为多次单月查询后合并。--end包含当天查今天时start和end都填今天。--format json以 JSON 输出便于 Agent 稳定解析这也是 lark-shared 输出契约的推荐做法。--page-size 30每页最多 30 条默认 15最大 30。翻页响应中has_moretrue时必须携带响应里的page_token继续翻页收集所有id字段即meeting_idlark-cli vc search --start YYYY-MM-DD --end YYYY-MM-DD --format json --page-size 30 --page-token PAGE_TOKEN从 lark-vc-search.md 还可以补充以下细节至少提供一个过滤条件--query、时间范围、--organizer-ids、--participant-ids、--room-ids至少其一本工作流使用时间范围即满足。--query边界只放 9 位会议号或真实会议关键词主题、项目名、评审名、客户名不要把总结回顾所有会议等动作词放进--query。身份vc search支持 user / botuser 身份需具备vc:meeting.search:read权限搜索取得meeting_id后后续所有命令必须显式沿用同一身份。批量上限累计超过 50 条且仍有更多结果时未明确要求全量前应先与用户确认是否继续用户明确要求全部/统计/排序时直接翻完所有页并去重。排查手段参数与请求结构有疑问时优先使用--dry-run预览。Step 3获取纪要元数据本步骤分为两段先取note_id与minute_token再取纪要文档与逐字稿文档链接。3.1 查询会议关联的纪要信息# 首先获取 note_id 和 minute_token lark-cli vc detail --meeting-ids id1,id2,...,idN # 然后用 note_id 获取文档 tokens如有多个需分别获取 lark-cli note detail --note-id note_id规则要点批量上限vc detail单次最多查询50个meeting_id超过 50 需分批调用。产物缺失处理部分会议没有note_id或报错no notes available不要直接标注无纪要。先看vc detail是否返回了minute_token有则走下文妙记备选路径note_id和minute_token都没有时才标注无纪要。记录关键字段对每个纪要记录note_id纪要 ID、note_display_type展示类型unknown/normal/unified、note_doc_token纪要文档 Token和verbatim_doc_token逐字稿文档 Token。参考 lark-vc-detail.mdvc detail输出含meeting_id、meeting_no9 位会议号、topic、start_time、end_time、note_id、minute_token。3.2 妙记备选路径无 note_id、有 minute_token 时智能纪要Note与妙记Minutes是两条独立产物链路——缺少智能纪要不代表这场会议没有内容。技能文档强调不要照搬 AI 总结应基于原始发言独立提炼# --minute-tokens 是复数形式download 同--output-dir 只接受相对路径 lark-cli minutes detail --minute-tokens minute_token --transcript --output-dir ./transcripts --as user逐字稿会落盘到本地./transcripts/供 Step 4 基于原始发言独立提炼。参考 lark-minutes-detail.md不传产物 flag 时只返回基础信息--summary/--todo/--chapter/--keyword/--transcript均为可选逐字稿默认落地./minutes/{minute_token}/transcript.txt指定--output-dir后改写为dir/artifact-{title}-{minute_token}/transcript.txt。无权限处理若返回No read permission错误码2091005先把无权限事实告知用户用户明确同意后才用单数 flag 申请权限lark-cli minutes apply-permission --minute-token minute_token --perm view --as user申请是异步流程需妙记 owner 在飞书客户端批准后才可重试不代表命令执行失败。参考 lark-minutes-apply-permission.md--perm只能取view或edit遇到权限错误时先区分missing_scope缺 scopeauth login补与资源 ACL单条妙记无权才用apply-permission禁止通过切换身份绕过资源权限。3.3 逐字稿路由按 note_display_type 决定note_display_type决定逐字稿的获取方式详见 query-note-and-artifacts.mdnormal逐字稿是独立文档链接/正文走verbatim_doc_token后续用docs fetch读取。unified逐字稿不是独立文档没有可分享的逐字稿文档链接需要逐字稿内容时用note transcript拉取到本地报告中标注unified 纪要即可lark-cli note transcript --note-id note_id参考 lark-note-transcript.mdnote transcript仅支持--as userCLI 会先校验该 Note 是否为unified非 unified 不拉取自动翻页并拼接完整内容任一页失败则整体报错不保存半截内容默认保存到./notes/{note_id}/unified_transcript.md--transcript-format plain_text时保存为.txt目标文件已存在时会失败需用户明确要求才加--overwrite。unknown类型若存在verbatim_doc_token按normal处理unknown且无verbatim_doc_token时停止并说明无法确定逐字稿入口不要猜测。3.4 获取纪要文档与逐字稿文档链接# 学习命令使用方式 lark-cli schema drive.metas.batch_query # 批量获取纪要文档与逐字稿链接一次最多查询 10 个文档 # 仅对 note_doc_token 与 normal 纪要的 verbatim_doc_token 查询链接 lark-cli drive metas batch_query --data {request_docs: [{doc_type: docx, doc_token: doc_token}], with_url: true}一次最多查询10个文档超过需分批。只对note_doc_token与normal纪要的verbatim_doc_token查询链接unified纪要的逐字稿不是独立 Doc没有可查询链接不需要、也不应传入batch_query。with_url: true用于同时取回文档名称与可分享 URL供报告链接展示如果只需要名称或 URL用此接口而非读取文档正文参考 query-note-and-artifacts.md 中只需要文档名称或 URL 时不要读取正文的约束。Step 4整理纪要报告根据时间跨度选择输出格式单日汇总今天/昨天用今日会议概览标题逐会议列出会议时间、主题、纪要链接、逐字稿链接unified纪要无逐字稿链接标注unified 纪要逐字稿需note transcript拉取。多日/周报这周/过去 7 天等用会议纪要周报标题含概览统计、逐会议详情。报告内容的事实边界参考 query-meeting-and-artifacts.md 的基于会议内容回答或分析一节用户只要现成 AI 总结、待办或章节时直接返回选定链路的 AI 产物即可不必额外读取逐字稿。用户要求提炼、重新总结、复盘、争议分析或谁说了什么时必须读取 Note 逐字稿或 Minutes Transcript 的原始对话并独立分析禁止把现成 AI 总结重新排版后冒充独立结论。若产物不存在或无权限如实说明并保留已取得的meeting_id、note_id、minute_token或文档 token方便用户继续处理不得编造议题内容。Step 5生成文档可选当用户要求把汇总结果落成云文档时先阅读 lark-doc/SKILL.md 学习云文档技能再使用以下命令# 创建新文档 lark-cli docs create --doc-format markdown --content $title会议纪要汇总 (start - end)/title\n内容 # 或追加到已有文档 lark-cli docs update --doc url_or_token --command append --doc-format markdown --content $内容create用于从零生成汇总文档标题模板为会议纪要汇总 (start - end)例如会议纪要汇总 (2026-03-09 - 2026-03-15)。update --command append用于把新报告追加到已有文档避免重复建文档。文档操作推荐显式指定--as user此环节依赖drive授权域对应前置条件中的auth login --domain vc,drive。参考资源lark-shared/SKILL.md — 认证、身份、权限与输出契约必读lark-meeting/SKILL.md — 会议与产物统一路由、领域模型与标识规则查询会议与会议产物 — 搜索、消歧、产物获取与逐字稿分析流程查询妙记及关联产物 — 无note_id时的妙记备选路径查询智能纪要及关联产物 —note_display_type逐字稿路由与 Doc 元信息查询命令细节参考vc search、vc detail、note detail、note transcript、minutes detail、minutes apply-permissionlark-doc/SKILL.md —create、update详细用法【免费下载链接】cliThe official Lark/飞书 CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, Meetings, and more, with 200 commands and 20 AI Agent Skills.项目地址: https://gitcode.com/gh_mirrors/cli414/cli创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表