From c86547dd13341bb76e34d09ba42e37744f85fb5c Mon Sep 17 00:00:00 2001 From: houzhicong Date: Tue, 16 Jun 2026 13:26:15 +0800 Subject: [PATCH] docs: clarify vc meeting product wording --- skills/lark-vc-agent/SKILL.md | 4 ++-- .../lark-vc-agent/references/lark-vc-agent-meeting-events.md | 4 ++-- skills/lark-vc-agent/references/lark-vc-agent-meeting-join.md | 2 +- .../lark-vc-agent/references/lark-vc-agent-meeting-leave.md | 2 +- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/skills/lark-vc-agent/SKILL.md b/skills/lark-vc-agent/SKILL.md index 3cbe1561..2d84e773 100644 --- a/skills/lark-vc-agent/SKILL.md +++ b/skills/lark-vc-agent/SKILL.md @@ -68,7 +68,7 @@ metadata: 2. 输入是 **`meeting_id`**（长数字 ID），不是 9 位会议号。 3. 不依赖默认身份。`meeting_id` 来自用户身份发现时，继续用 `--as user`；来自应用身份发现或 `+meeting-join` 时，继续用 `--as bot`。身份不一致会导致空结果或权限错误。 4. **不能做会后复盘**，**不能替代参会人快照查询**。如果会议已结束： - - 先用 `lark-cli vc +notes --meeting-ids ` 做产物发现。 + - 先用 `lark-cli vc +notes --meeting-ids ` 获取会议产物信息。 - 再根据 `note_display_type`、`note_id`、`minute_token` 和用户意图，按 [`lark-vc`](../lark-vc/SKILL.md) 的产物决策读取正文、逐字稿或妙记。 - 想看参会人快照：用 `vc meeting get --with-participants`（见 [`lark-vc`](../lark-vc/SKILL.md)） 5. **默认必须使用** **`--page-all`**，除非用户明确要求“只查一页”，或确实需要控制返回体大小。 @@ -107,7 +107,7 @@ MID=$(echo "$JOIN" | jq -r '.data.meeting.id') # 典型间隔 10-30 秒 lark-cli vc +meeting-events --as bot --meeting-id "$MID" --page-all --format pretty -# 3. 会后可选：进入 lark-vc 做产物发现，再按 note_display_type / minute_token 决策读取 +# 3. 会后可选：进入 lark-vc 获取会议产物信息，再按 note_display_type / minute_token 决策读取 lark-cli vc +notes --meeting-ids "$MID" ``` diff --git a/skills/lark-vc-agent/references/lark-vc-agent-meeting-events.md b/skills/lark-vc-agent/references/lark-vc-agent-meeting-events.md index 78fbe855..3ab699af 100644 --- a/skills/lark-vc-agent/references/lark-vc-agent-meeting-events.md +++ b/skills/lark-vc-agent/references/lark-vc-agent-meeting-events.md @@ -266,7 +266,7 @@ lark-cli vc +meeting-events \ | `--meeting-id is required` | 未传入 `--meeting-id` | 传入长数字 `meeting.id` | | `not a 9-digit meeting number` | 把 9 位会议号误传给 `--meeting-id` | 如果只是查询会中内容，先用 `+meeting-list-active` 按 `meeting_no` 匹配拿长数字 `meeting_id`；只有用户明确要求入会时才用 `+meeting-join --as bot --meeting-number <9位号>` | | `10005 bot is not in meeting` | 使用应用身份读取，但应用机器人从未真实入会该会议；或会议已结束但应用机器人从未在会中出现过 | 如果本来是用户身份发现的 `meeting_id`，改回 `--as user`；如果确实要应用身份读取，先 `+meeting-join --as bot --meeting-number <9位号>` 真实入会再查。**如果只是想看参会人快照，改用 `lark-cli vc meeting get --params '{"meeting_id":""}' --with-participants`** | -| `20001 meeting_status_MEETING_END` | 会议已结束且已超出后端允许的 5 分钟宽限窗口 | 本接口不再适合继续拉取事件。先用 `lark-cli vc +notes --meeting-ids ` 做产物发现，再根据 `note_display_type` / `note_id` / `minute_token` 和用户意图选择纪要正文、逐字稿或妙记；参会人请用 `lark-cli vc meeting get --params '{"meeting_id":""}' --with-participants` | +| `20001 meeting_status_MEETING_END` | 会议已结束且已超出后端允许的 5 分钟宽限窗口 | 本接口不再适合继续拉取事件。先用 `lark-cli vc +notes --meeting-ids ` 获取会议产物信息，再根据 `note_display_type` / `note_id` / `minute_token` 和用户意图选择纪要正文、逐字稿或妙记；参会人请用 `lark-cli vc meeting get --params '{"meeting_id":""}' --with-participants` | | `20002 meeting not exist` | `meeting_id` 错误，或会议实例当前已不可获取（常见于把 9 位会议号当 meeting_id 传） | 确认传入的是长数字 `meeting_id`，不是 9 位会议号 | | 应用身份权限不足 | 应用权限、租户安装、权限可访问的数据范围或 VC Agent privilege 未配置完整 | 不要执行 `auth login`。以 CLI 返回的 metadata / error envelope 为准确认缺失权限；检查应用发布/安装，以及开放平台“权限可访问的数据范围”：选择“按条件筛选”，条件为“会议的归属者 包含 与应用的可用范围一致”；仍失败再排查内测 privilege / 灰度 | | `HTTP 404` / `HTTP 500` | 服务端当前无法找到或处理该会议实例 | 换一个正在进行且 bot 可见的 meeting_id，或排查后端问题 | @@ -275,7 +275,7 @@ lark-cli vc +meeting-events \ - 这是**会中事件流**查询，不适合拿来搜历史会议记录；搜历史会议请用 `+search`。 - 如果会议已经结束，不要卡在 `+meeting-events`： - - 先用 `lark-cli vc +notes --meeting-ids ` 做产物发现。 + - 先用 `lark-cli vc +notes --meeting-ids ` 获取会议产物信息。 - 再根据 `note_display_type`、`note_id`、`minute_token` 和用户意图，按 `lark-vc` 的产物决策读取纪要正文、逐字稿或妙记。 - 事件列表是否完整，取决于应用机器人何时入会、何时离会，以及后端当前可见的会中事件范围。对于已结束会议，通常只在**结束后 5 分钟内**、且应用机器人**曾经在会中**时还能继续拉到事件。 - 查询"谁参加过某会议"请用 `vc meeting get --params '{"meeting_id":"","with_participants":true}'`——这是参会人**快照** API，不依赖 bot 是否参会，对已结束会议也可查；**不要** 用 `+meeting-events` 做参会人查询。 diff --git a/skills/lark-vc-agent/references/lark-vc-agent-meeting-join.md b/skills/lark-vc-agent/references/lark-vc-agent-meeting-join.md index da8e726a..076aecaa 100644 --- a/skills/lark-vc-agent/references/lark-vc-agent-meeting-join.md +++ b/skills/lark-vc-agent/references/lark-vc-agent-meeting-join.md @@ -102,7 +102,7 @@ lark-cli vc +meeting-events --as bot --meeting-id --page-all --form lark-cli vc +meeting-list-active --as bot --user-id --format json ``` -### 场景 2：加入会议 → 会后进入 lark-vc 做产物发现 +### 场景 2：加入会议 → 会后进入 lark-vc 获取会议产物信息 ```bash # 第 1 步：加入并参会 diff --git a/skills/lark-vc-agent/references/lark-vc-agent-meeting-leave.md b/skills/lark-vc-agent/references/lark-vc-agent-meeting-leave.md index 4ab9c043..dacb5f58 100644 --- a/skills/lark-vc-agent/references/lark-vc-agent-meeting-leave.md +++ b/skills/lark-vc-agent/references/lark-vc-agent-meeting-leave.md @@ -77,7 +77,7 @@ lark-cli vc +meeting-leave --as bot --meeting-id 如果用户只是要求会议结束后拉录制、纪要或逐字稿，不要先调用 `+meeting-leave`；直接跨到 `lark-vc` 查询会后产物。 ```bash -# 第 1 步：会议结束后进入 lark-vc 做产物发现 +# 第 1 步：会议结束后进入 lark-vc 获取会议产物信息 lark-cli vc +notes --meeting-ids ```