From f61d6b4cd31514e1bf2f3951642a2d9a484c370d Mon Sep 17 00:00:00 2001 From: renaocheng Date: Wed, 24 Jun 2026 15:39:43 +0800 Subject: [PATCH] docs: clarify meeting events identity flow --- .../references/lark-vc-agent-meeting-events.md | 10 +++++----- .../references/lark-vc-agent-meeting-list-active.md | 4 ++-- 2 files changed, 7 insertions(+), 7 deletions(-) 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 24e2baf76..ed4a35e86 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 @@ -75,7 +75,7 @@ lark-cli vc +meeting-list-active --as bot --user-id --format json lark-cli vc +meeting-events --as bot --meeting-id --page-all --format pretty ``` -如果只是用当前登录用户发现会议： +如果要查询当前登录用户所在会议： ```bash lark-cli vc +meeting-list-active --as user --format json @@ -227,7 +227,7 @@ lark-cli vc +meeting-events --as user --meeting-id --page-all --format pret ```bash lark-cli vc +meeting-events \ - --as bot \ + --as \ --meeting-id \ --start 2026-04-17T15:00:00+08:00 \ --end 2026-04-17T16:00:00+08:00 \ @@ -241,7 +241,7 @@ lark-cli vc +meeting-events \ # 上一次查询结束后，保留最后返回的 page_token # 这次直接从该游标继续拉新增事件 lark-cli vc +meeting-events \ - --as bot \ + --as \ --meeting-id \ --page-token \ --page-all \ @@ -260,8 +260,8 @@ 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 bot` 读取。**如果只是想看参会人快照，改用 `lark-cli vc meeting get --params '{"meeting_id":""}' --with-participants`** | -| 用户身份不支持 | 当前事件读取接口不支持用用户身份访问 | 不要反复执行 `auth login`。改用应用身份流程：先通过 `+meeting-list-active --as bot --user-id ` 获取应用身份可读的 `meeting_id`，或在用户明确同意后让应用机器人入会，再用 `+meeting-events --as bot` 读取 | +| `10005 bot is not in meeting` | 使用应用身份读取，但应用机器人从未真实入会该会议；或会议已结束但应用机器人从未在会中出现过 | 如果 `meeting_id` 来自用户身份发现，改回 `--as user`；如果确实要应用身份读取，先让应用机器人入会或确认它曾参会后再用 `--as bot`。**如果只是想看参会人快照，改用 `lark-cli vc meeting get --params '{"meeting_id":""}' --with-participants`** | +| 用户身份无权限 / 不可见 | 当前用户不是该会议的可见参与者，或 `meeting_id` 不是从用户身份路径获得 | 不要反复执行 `auth login`。先确认 `meeting_id` 是否来自 `+meeting-list-active --as user`；如果用户明确要切到应用身份，再通过 `+meeting-list-active --as bot --user-id ` 获取应用身份可读的 `meeting_id`，或在用户明确同意后让应用机器人入会，再用 `+meeting-events --as bot` 读取 | | `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 / 灰度 | diff --git a/skills/lark-vc-agent/references/lark-vc-agent-meeting-list-active.md b/skills/lark-vc-agent/references/lark-vc-agent-meeting-list-active.md index c6105a3bc..f0cd9be08 100644 --- a/skills/lark-vc-agent/references/lark-vc-agent-meeting-list-active.md +++ b/skills/lark-vc-agent/references/lark-vc-agent-meeting-list-active.md @@ -44,7 +44,7 @@ lark-cli vc +meeting-events --as bot --meeting-id --page-all --format prett lark-cli vc +meeting-list-active --as bot --user-id --format json lark-cli vc +meeting-events --as bot --meeting-id --page-all --format pretty -# 方式 3：只回答当前登录用户所在会议发生了什么 +# 方式 3：查询当前登录用户所在会议发生了什么 lark-cli vc +meeting-list-active --as user --format json lark-cli vc +meeting-events --as user --meeting-id --page-all --format pretty ``` @@ -80,7 +80,7 @@ lark-cli vc +meeting-list-active --as bot --user-id --format json |---------|---------|---------| | `--user-id is required when --as bot` | 应用身份未传目标用户 | 传入目标用户 open_id | | 用户身份返回空列表 | 当前登录用户没有可见的进行中会议 | 确认用户是否在会中，或是否切错身份 | -| 用户身份不支持 | 当前接口不支持用用户身份访问 | 不要反复执行 `auth login`。改用应用身份流程：先拿目标用户 open_id，再执行 `+meeting-list-active --as bot --user-id `；同时按应用身份权限配置检查应用权限、安装、数据范围和灰度 | +| 用户身份无权限 / 不可见 | 当前登录用户没有可见的进行中会议，或当前身份无法读取该会议 | 不要反复执行 `auth login`。先确认当前登录用户是否在会中、是否切错 profile；如果用户明确要查询应用机器人可见的会议，再拿目标用户 open_id 执行 `+meeting-list-active --as bot --user-id `，并按应用身份权限配置检查应用权限、安装、数据范围和灰度 | | 应用身份返回空列表 | 没有满足“目标用户在会中且应用机器人也在会中”的当前会 | 先让应用机器人入会，或确认 `user_id` 和会议状态 | | `--user-id` 格式错误 | 传入了 internal user_id 或其他非 `ou_...` 值 | 改传目标用户 open_id | | 应用身份权限不足 | 应用权限、租户安装、权限可访问的数据范围或 VC Agent privilege 未配置完整 | 不要执行 `auth login`。以 CLI 返回的 metadata / error envelope 为准确认缺失权限；检查应用发布/安装，以及开放平台“权限可访问的数据范围”：选择“按条件筛选”，条件为“会议的归属者 包含 与应用的可用范围一致”；仍失败再排查内测 privilege / 灰度 |