lark-note

飞书会议纪要(Note)直查:已知 note_id 时查询纪要详情、展示类型、关联文档 token,并读取 unified 原始逐字记录。当用户已持有 note_id,或从文档显式 vc-node-id 获得 note_id 时使用。不负责会议/日程/妙记定位、文档标题搜索或 Docx 正文读取。

INSTALLATION
npx skills add https://github.com/larksuite/cli --skill lark-note
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

note (v1)

身份:+detail 支持 --as user / --as bot+transcript 仅支持 --as usernote_id 若由某个身份取得(例如 vc +detail --as bot),+detail 必须显式沿用同一个 --as——不要依赖 profile 默认身份。完整身份延续规则见 ../lark-shared/SKILL.md,使用前必读。

+detail 返回的 note_doc_token / verbatim_doc_token / shared_doc_tokens 交给 lark-doc 读正文时,仍要显式带上同一个 --as。lark-doc 对普通文档推荐 --as user不覆盖这些纪要文档 token 的来源身份

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-vc/references/vc-domain-boundaries.md,不读将导致命令使用、会议产物决策、领域边界职责判断错误:

  • 了解日历 & VC、会议产物 & 文档的关联关系和职责划分
  • 了解会议产物(妙记和纪要)之间的关联关系,例如:妙记和纪要产生条件相互独立
  • 了解不同会议产物的组成部分,以便根据需求决策使用哪种产物的数据

Note 域只接受显式 note_id:用户直接提供,或 docs +fetch 返回的 <vc-transcribe-tab vc-node-id="..."> 中的 vc-node-id。不要从 doc_token、标题、正文或 backlink 反推 note_id

命令路由

用户表达 / 上下文路由
已知 note_id,查纪要类型 / 文档 tokennote +detail --note-id NOTE_ID
docs +fetch 返回 vc-node-id 作为 NOTE_ID,先 note +detail --note-id NOTE_ID
只持有 meeting_idvc +detail --meeting-ids note_id,再 note +detail --note-id NOTE_ID
只持有 minute_token(妙记 URL)minutes +detail --minute-tokens 顶层取 note_id,再 note +detail --note-id NOTE_ID(不要把 minute_tokennote_id
只持有日程 event_idcalendar +meeting --event-ids meeting_id,再按上一行继续
已知 note_id,读纪要正文note +detaildocs +fetch --doc
已知 note_id,查 unified 原始记录 / 逐字稿note +transcript --note-id NOTE_ID
只有自然语言纪要标题,用户要逐字稿 / 原始记录 / 谁说了什么不进本 skill;先走文档搜索与 docs +fetch,拿到 vc-node-id 后再回来

note_display_type 路由

note +detail 结果用户要逐字稿 / 原始记录时
normal + verbatim_doc_token 非空docs +fetch --doc (沿用 +detail 用的身份)
unknown + verbatim_doc_token 非空先按独立文档处理;不要猜成 unified
unknown + 无逐字稿 token停止重试并说明无法确定逐字稿入口
unifiednote +transcript --note-id (仅支持 --as user

判别键是 note_display_type,不是 verbatim_doc_token 是否为空:unified 纪要也可能返回非空 verbatim_doc_token

bot + unified 的边界+transcript 目前仅支持 --as user。如果 +detail --as bot 返回 unified,不要静默切到 --as user 继续——先停下来向用户说明"该纪要逐字稿只能以 user 身份读取",只有用户明确同意才切换身份重试。

关键字段

  • note_id:Note 域唯一入口。
  • note_display_typeunknown / normal / unified
  • note_doc_token:纪要正文文档,正文读取交给 lark-doc
  • verbatim_doc_token:普通纪要逐字稿文档;unified 逐字稿不按这个 token 路由。

不在本 Skill 范围

  • 通过 meeting_id 定位纪要(note_id)→ lark-vcvc +detail)。
  • 通过 minute_token 定位纪要(note_id)→ lark-minutesminutes +detail 顶层返回 note_id)。
  • 通过日程 event_id 定位会议(meeting_id) / 用户绑定纪要(meeting_note) → lark-calendarcalendar +meeting)。

Shortcuts

Shortcut何时读 reference
+detail需要解释输出字段或根据展示类型继续路由
+transcript需要拉取 unified 原始记录或处理本地输出文件

核心概念

  • 会议纪要(Note):视频会议结束后生成的结构化文档,通过 note_id 标识。一个 Note 包含 AI 智能纪要文档、逐字稿文档和会中共享文档。
  • note_id:纪要的唯一标识符,可通过 vc +detail --meeting-ids 获取。
  • AI 智能纪要(MainDoc):AI 生成的会议总结与待办,对应 note_doc_token
  • 逐字稿(VerbatimDoc):会议的逐句发言记录,含说话人和时间戳,对应 verbatim_doc_token
  • 共享文档(SharedDoc):会中投屏共享的文档,对应 shared_doc_tokens

核心场景

1. 通过 note_id 获取纪要文档 Token

  • 当用户已有 note_id,需要获取对应的 note_doc_tokenverbatim_doc_tokenshared_doc_tokens 时,使用 note +detail
  • note_id 通常来自 vc +detail 的返回结果。
  • 获取到文档 Token 后,可使用 docs +fetch 读取文档内容,或使用 drive metas batch_query 获取文档元信息。
# 1. 从会议获取 note_id(这里以 bot 身份为例)

lark-cli vc +detail --meeting-ids <meeting_id> --as bot

# 2. 用 note_id 拿文档 Token;沿用第 1 步的身份,不要省略 --as

lark-cli note +detail --note-id <note_id> --as bot

# 3. 读取纪要文档内容;同样沿用第 1 步的身份

lark-cli docs +fetch --doc <note_doc_token> --doc-format markdown --as bot
BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card