lark-meeting 是做什麼的？
飛書視訊會議業務的統一入口，支援查詢會議記錄、即時會議互動、管理妙記、閱讀智能紀要等操作。本技能負責領域關係、任務路由和跨命令編排。
無需預讀 lark-shared 或預跑 auth status --verify，僅遇到未認證、token / 身份或 scope 錯誤時讀取該 Skill，修復後重試。認證、身份或 scope 管理請求則直接使用該 Skill。
身份初始化與延續
把 source_identity 作為跨命令工作流的狀態：
- 上下文已有來源身份：嚴格沿用。使用者要求切換時先說明身份連續性和權限影響，不靜默切換。
- 沒有來源身份，使用者明確指定身份：使用使用者指定的
--as。 - 沒有來源身份且使用者未指定：操作語義明確要求應用機器人時使用
--as bot，否則顯式使用--as user。
確定 source_identity 後，再檢查目標命令是否支援該身份：
- 支援：顯式傳入並繼續執行。
- 不支援：說明限制並停止；不要為了讓命令成功而替換身份。
- 只有使用者明確同意切換身份後，才以新身份重新開始一條工作流。
領域模型與概念
[會議來源]
Calendar 日程 (event_id) ──預約或關聯──┐
即時會議（無 event_id）────────────────┴──► 會議 (meeting_id)
Calendar 日程 ──meeting_note────────────► Doc（使用者紀要，獨立於 AI 智能紀要）
[會議產物]
會議 (meeting_id)
├── AI 總結 ──► Note 智能紀要 (note_id)
│ ├── 智能紀要文件 ───────────► Doc (note_doc_token)
│ ├── 逐字稿
│ │ ├── normal ──────────► Doc (verbatim_doc_token)
│ │ └── unified ──────────► note +transcript（非獨立 Doc）
│ └── 共享文件 ──────────────► Doc (shared_doc_tokens)
│
└── 錄製 ──► Minutes 妙記 (minute_token)
├── AI 產物：Summary / Todo / Chapter / Keyword
├── Transcript（文字記錄，別名：「轉寫」「逐字稿」「文字記錄」）
└── 原始音訊影片
本地音訊影片 ─────────────────────────────► Minutes 妙記 (minute_token)
| 對象 | 主標識 | 概念與關係 |
|---|---|---|
| Calendar 日程 | event_id | 日曆上的日程，包含時間、參與人、會議室和 RSVP，可預約或關聯 VC 會議；不是完整的會議記錄。日程上的 meeting_note 是使用者手工綁定的 Doc，與 AI 智能紀要無關。 |
| Meeting 會議 | meeting_id | 實際發生的視訊會議，可以來自 Calendar，也可以是沒有日程的即時會議。會議主題、時間、參會人快照和會中事件屬於會議資料；Note 與 Minutes 是它可能關聯的會後產物。 |
| Note 智能紀要 | note_id | 開啟 AI 總結後形成的邏輯產物集合。note_display_type 決定獲取逐字稿中文字記錄的不同方式。 |
| Minutes 妙記 | minute_token | 由會議錄製或本地音訊影片上傳生成，包含總結、待辦、章節、關鍵詞、文字記錄（別名：「轉寫」「逐字稿」「文字記錄」）和原始音訊影片；可以關聯 VC 會議，也可以獨立存在。 |
| Doc 文件 | Doc token | 內容載體，不是會議標識。note_doc_token、shared_doc_tokens 和部分 verbatim_doc_token 指向 Doc；Doc token 不能當作 note_id 或 meeting_id。 |
核心標識
meeting_id：會議 ID。長數字字串，不是 9 位會議號。meeting_no：會議號。9 位純數字；CLI 參數名為--meeting-number。minute_token：妙記 Token。小寫字母數字串，通常取自妙記 URL/minutes/<minute_token>。
以上標識均按字串原樣傳遞，不能相互替代。
領域不變量
- Note 與 Minutes 分別來自 AI 總結和錄製兩條獨立鏈路。一場會議可能同時有兩類產物、只有其中一類，也可能都沒有；不能根據
note_id推斷必然存在minute_token，反之亦然。 - Minutes 可以由本地音訊影片直接生成，因此不一定關聯
meeting_id或 Calendarevent_id。 - Calendar
meeting_note、Notenote_id、Minutesminute_token和各類 Doc token 標識不同物件，不能互換、代入其他域的命令或從一者反推另一者。
快速行動
查詢進行中的會議內容
# 當前使用者所在會議
lark-cli vc +meeting-list-active --as user
# 應用機器人可見的目標使用者會議
lark-cli vc +meeting-list-active --as bot --user-id <open_id>
# 確定唯一 meeting_id 後沿用來源身份
lark-cli vc +meeting-events --as <source_identity> --meeting-id <meeting_id> --page-all --format pretty
同時有多場會議時，需要先選擇要查詢的會議；只有一場會議時，直接查詢該場會議的會議事件。
應用身份只返回「目標使用者正在參會、且應用機器人也在同一會議中」的會議；返回空不代表目標使用者沒有在開會。向使用者說明結果時使用「使用者身份」或「應用身份」，不要暴露 user / bot 這類內部縮寫。
場景手冊
當任務目標與場景匹配時，閱讀對應的場景手冊，按流程執行任務。
- 查詢會議及其產物：按主題、時間、參會人或
meeting_id/meeting_no/event_id定位歷史會議；查詢參會人、錄影和會議關聯的智能紀要或妙記；基於會議記錄總結或複盤。 - 查詢妙記及其產物：已有妙記 URL /
minute_token，或按標題、擁有者、參與者搜尋妙記；讀取總結、待辦、章節、關鍵詞、逐字稿，下載原始音訊影片，或查詢關聯智能紀要。 - 生成和修改妙記、管理妙記權限：將本地音訊影片生成妙記、逐字稿、總結、待辦或章節；修改妙記標題、總結、待辦、關鍵詞或說話人；申請妙記權限，或查看、分配妙記協作者權限。
- 查詢智能紀要及關聯產物：已有
note_id、智能紀要 Docx URL/token，或需要查詢紀要正文、逐字稿、妙記和共享文件等關聯產物。 - 應用機器人參會與會中互動：完整編排應用機器人的活躍會議發現、發起或加入、邀請、事件拉取、會議截圖、文字/表情/倒數計時互動、結束會議和明確授權後的離會。
- 會中事件與會中互動：在不觸發新的入會/離會操作時，使用使用者身份或已在會中的應用身份查詢活躍會議、查看發言/聊天/共享內容、按需讀取當前會議畫面，或發送文字/表情、操作倒數計時。
命令參考
| 命令 | 用途 | 參考方式 |
|---|---|---|
vc +search | 搜尋歷史會議 | lark-vc-search |
vc +detail | 查詢會議資訊及關聯的 Note、Minutes 標識 | lark-vc-detail |
vc meeting get | 查詢會議基礎資訊和參會人快照 | lark-cli vc meeting get --help |
vc +recording | 從會議定位錄製及妙記 | lark-vc-recording |
vc +meeting-list-active | 發現當前可見的進行中會議 | lark-vc-meeting-list-active |
vc +meeting-events | 讀取會中事件和共享內容 | lark-vc-meeting-events |
vc +meeting-message-send | 發送會中文字訊息或表情 | lark-vc-meeting-message-send |
vc +meeting-screenshot | 獲取視訊會議截圖 | lark-vc-meeting-screenshot |
vc +meeting-countdown | 設定、延長、提前結束或關閉會中倒數計時 | lark-vc-meeting-countdown |
vc +meeting-join | 讓應用機器人加入會議 | lark-vc-agent-meeting-join |
vc +meeting-invite | 以應用機器人邀請指定使用者或全部合格日程參會人 | lark-vc-agent-meeting-invite |
vc +meeting-end | 讓目前 Host 應用機器人結束會議 | lark-vc-agent-meeting-end |
vc +meeting-leave | 讓應用機器人離開會議 | lark-vc-agent-meeting-leave |
minutes +search | 搜尋妙記 | lark-minutes-search |
minutes minutes get | 查詢妙記基礎資訊 | lark-cli minutes minutes get --help |
minutes +detail | 讀取妙記資訊和指定產物 | lark-minutes-detail |
minutes +download | 下載妙記原始音訊影片 | lark-minutes-download |
minutes +upload | 從雲端空間音訊影片生成妙記 | lark-minutes-upload |
minutes +update | 修改妙記標題 | lark-minutes-update |
minutes +speaker-replace | 替換妙記逐字稿說話人 | lark-minutes-speaker-replace |
minutes +summary | 替換妙記 AI 總結 | lark-minutes-summary |
minutes +todo | 增刪改妙記 AI 待辦 | lark-minutes-todo |
minutes +apply-permission | 申請妙記檢視或編輯權限 | lark-minutes-apply-permission |
drive +member-list | 檢視妙記協作者及其權限 | lark-drive-member-list |
drive +member-add | 給指定成員分配妙記檢視或編輯權限 | lark-drive-member-add |
minutes +word-replace | 批次替換妙記逐字稿關鍵詞 | lark-cli minutes +word-replace --help |
note +detail | 查詢智能紀要及關聯文件標識 | lark-note-detail |
note +transcript | 獲取 unified 智能紀要逐字稿 | lark-note-transcript |
漸進載入規則
按「快速行動 → 場景手冊 → 命令參考」漸進載入：
- 使用者目标符合「快速行動」的進入條件時，直接執行對應 CLI；不要預讀場景手冊、命令參考、
--help或 schema。 - 不符合快速行動條件，或缺少關鍵標識、需要消歧、涉及寫操作時，讀取與目標匹配的一個主場景手冊；主場景明確轉交到下游場景時，只繼續讀取被引用的場景或章節，並按其中流程執行 CLI。
- 僅當缺少具體參數、返回字段、特殊約束或異常處理方式時：有參考手冊的命令讀取對應文件；沒有參考手冊的命令運行表中列出的精確
lark-cli ... --help。場景或 reference 已給出精確命令時，不再調用--help；僅在參數缺失、命令不識別或文件與運行結果衝突時調用。