AxTps/Starlight_Lancher
2
2
Fork 1
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
42b0c7e7af085d0de9cd1d24830a51e60ac2dbc3
Starlight_Lancher/.agents/skills/lark-vc-agent/references/lark-vc-agent-meeting-list-active.md

5.0 KiB
Raw Blame History

vc +meeting-list-active

列出当前进行中的会议，用来发现 +meeting-events 需要的长数字 meeting_id。

本 skill 对应 shortcut：lark-cli vc +meeting-list-active（调用 GET /open-apis/vc/v1/bots/user_active_meeting）。

命令

# 查询当前登录用户正在参加的会议
lark-cli vc +meeting-list-active --as user --format json

# 查询指定用户当前参加、且应用机器人也在会中的会议
lark-cli vc +meeting-list-active --as bot --user-id ou_xxx --format json

参数

参数 必填 说明
--user-id <id> 应用身份必填 目标用户 open_id，格式为 ou_...。用户身份不传；应用身份直接透传给接口，不接受 internal user_id 或数字 ID

身份语义

不要向用户暴露内部身份缩写；对用户只说“用户身份”或“应用身份”。

身份 命令 返回范围 后续事件读取
用户身份 --as user 当前登录用户正在参加的会议 继续 +meeting-events --as user
应用身份 --as bot --user-id <user_open_id> 目标用户正在参加、且应用机器人也在会中的会议 继续 +meeting-events --as bot

硬规则：meeting_id 从哪种身份路径拿到，后续 +meeting-events 就沿用哪种身份。不要把应用身份拿到的 meeting_id 改用用户身份读事件，也不要把用户身份拿到的 meeting_id 强制切到应用身份。

应用身份返回空，不代表目标用户不在任何会议中，只能说明没有找到“目标用户在会中且应用机器人也在会中”的当前会。

常见流程：

# 方式 1：先让应用机器人入会，直接从 join 响应拿 meeting.id
lark-cli vc +meeting-join --as bot --meeting-number 123456789 --format json
lark-cli vc +meeting-events --as bot --meeting-id <id> --page-all --format pretty

# 方式 2：应用机器人已经在会中时，用应用身份发现 meeting_id
lark-cli vc +meeting-list-active --as bot --user-id <user_open_id> --format json
lark-cli vc +meeting-events --as bot --meeting-id <id> --page-all --format pretty

# 方式 3：查询当前登录用户所在会议发生了什么
lark-cli vc +meeting-list-active --as user --format json
lark-cli vc +meeting-events --as user --meeting-id <id> --page-all --format pretty

多会议选择

  • 如果返回多个会议，不要自动挑第一个。
  • 向用户展示每个候选的 meeting_title / meeting_no / meeting_id，等待用户选择。
  • 选择后用同一身份执行 +meeting-events 读取事件。

9 位会议号匹配

用户提供 9 位会议号但没有明确要求应用机器人入会时，把会议号当作 active meeting 的筛选条件，而不是写操作指令。

# 用户问“我当前这个会讲了什么”
lark-cli vc +meeting-list-active --as user --format json

# 用户问“让应用机器人所在/可见的这个会讲了什么”
lark-cli vc +meeting-list-active --as bot --user-id <user_open_id> --format json

匹配规则：

  • 在返回会议中匹配 meeting_no == <9位会议号>。
  • 匹配到唯一会议：取该项的长数字 meeting_id，后续用同一身份调用 +meeting-events。
  • 匹配到多个会议：展示候选，让用户选择。
  • 没有匹配：说明当前身份没有发现该会议号对应的 active meeting；不要自动调用 +meeting-join，除非用户明确要求应用机器人入会。

常见错误与排查

错误现象 根本原因 解决方案
--user-id is required when --as bot 应用身份未传目标用户 传入目标用户 open_id
用户身份返回空列表 当前登录用户没有可见的进行中会议 确认用户是否在会中，或是否切错身份
用户身份无权限 / 不可见 当前登录用户没有可见的进行中会议，或当前身份无法读取该会议 不要反复执行 auth login。确认用户是否在会中、是否切错 profile；用户明确要查询应用机器人可见的会议时，再拿目标用户 open_id 执行 +meeting-list-active --as bot --user-id <user_open_id>
应用身份返回空列表 没有满足“目标用户在会中且应用机器人也在会中”的当前会 先让应用机器人入会，或确认 user_id 和会议状态
--user-id 格式错误 传入了 internal user_id 或其他非 ou_... 值 改传目标用户 open_id
应用身份权限不足 应用权限、租户安装、权限可访问的数据范围或 VC Agent privilege 未配置完整 不要执行 auth login。请应用开发者开通 vc:meeting.bot.join:write；再检查应用发布/安装和权限可访问的数据范围，均正确仍失败时再排查内测灰度权限

参考