github/larksuite-cli
1
0
Fork 0
mirror of https://github.com/larksuite/cli.git synced 2026-07-08 10:08:02 +08:00
Code Issues Packages Projects Releases Wiki Activity

chore(vc-agent): update gray guide and boe endpoints

Browse Source
This commit is contained in:
houzhicong
2026-05-11 16:54:19 +08:00
parent 072e9233d1
commit 0547310e03
4 changed files with 9 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
skills/lark-vc-agent/SKILL.md
View File

@@ -40,7 +40,7 @@ metadata:
4. 入会对所有参会人可见，执行前核实 9 位会议号来源，避免误入错会。
5. 仅支持 `user` 身份，需提前 `lark-cli auth login` 并拥有 `vc:meeting.bot.join:write` scope。
6. 若 CLI stderr JSON 返回 `error.code=20017` / `ErrNotInGray`，说明当前用户未命中智能体参会灰度。提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd。
7. 若提示 `missing required scope(s)` / `permission_violations`，只按原逻辑提示 `lark-cli auth login --scope "vc:meeting.bot.join:write"`，不要混入早鸟群文案。
7. 若提示 `missing required scope(s)` / `permission_violations`，先提示用户当前账号可能尚未开通智能体参会灰度，加入早鸟群申请：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 提示执行 `lark-cli auth login --scope "vc:meeting.bot.join:write"` 补授权。
8. 若入会失败，优先查看 `+meeting-join` reference 的错误排查段落，重点确认会议号、密码、会议状态、等候室 / 审批以及会议是否禁止当前身份加入。
### 2. 感知会中事件（读操作）
@@ -58,7 +58,7 @@ metadata:
8. 保留响应里的 `page_token`，下次增量拉取直接续，不要从头再拉。
9. **只要你是基于 `+meeting-events` 来回答一场正在进行中的会议内容，就不能直接复用旧结果。** 无论用户是在问“现在/刚刚/最新”的状态，还是让你“总结一下这个会议讲什么”，都必须先重新拉一次当前事件流，确认拿到的是最新信息，再基于最新结果回答。只有在用户明确要求基于某次历史快照继续分析时，才可以复用旧结果。
10. 若 CLI stderr JSON 返回 `error.code=20017` / `ErrNotInGray`，说明当前用户未命中智能体参会灰度。提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd。
11. 若提示 `missing required scope(s)` / `permission_violations`，只按原逻辑提示 `lark-cli auth login --scope "vc:meeting.meetingevent:read"`，不要混入早鸟群文案。
11. 若提示 `missing required scope(s)` / `permission_violations`，先提示用户当前账号可能尚未开通智能体参会灰度，加入早鸟群申请：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 提示执行 `lark-cli auth login --scope "vc:meeting.meetingevent:read"` 补授权。
### 3. 离开会议（写操作）
@@ -67,7 +67,7 @@ metadata:
3. 离会**立即生效**，机器人从会议的参会人列表中消失，对其他参会人可见；若需要重新入会，再跑一次 `+meeting-join` 即可（非真正"不可逆"）。
4. 仅支持 `user` 身份，scope 同 `+meeting-join`（`vc:meeting.bot.join:write`）。
5. 若 CLI stderr JSON 返回 `error.code=20017` / `ErrNotInGray`，说明当前用户未命中智能体参会灰度。提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd。
6. 若提示 `missing required scope(s)` / `permission_violations`，只按原逻辑提示 `lark-cli auth login --scope "vc:meeting.bot.join:write"`，不要混入早鸟群文案。
6. 若提示 `missing required scope(s)` / `permission_violations`，先提示用户当前账号可能尚未开通智能体参会灰度，加入早鸟群申请：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 提示执行 `lark-cli auth login --scope "vc:meeting.bot.join:write"` 补授权。
### 4. Agent 参会最小闭环示范

4
skills/lark-vc-agent/references/lark-vc-agent-meeting-events.md
View File

@@ -52,7 +52,7 @@ lark-cli vc +meeting-events --meeting-id 69xxxxxxxxxxxxx28 --dry-run
### 2. 仅支持 user 身份
该命令仅支持 `user` 身份，使用前需完成 `lark-cli auth login`。
若提示 `missing required scope(s)` / `permission_violations`，只按 CLI hint 引导用户执行 `lark-cli auth login --scope "vc:meeting.meetingevent:read"`，不要混入早鸟群文案。
若提示 `missing required scope(s)` / `permission_violations`，先提示用户当前账号可能尚未开通智能体参会灰度，加入早鸟群申请：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 引导用户执行 `lark-cli auth login --scope "vc:meeting.meetingevent:read"`。
若 CLI stderr JSON 返回 `error.code=20017` / `ErrNotInGray`，说明当前用户未命中智能体参会灰度。提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd。暂不展示使用手册。
@@ -229,7 +229,7 @@ lark-cli vc +meeting-events \
| `20002 meeting not exist` | `meeting_id` 错误，或会议实例当前已不可获取（常见于把 9 位会议号当 meeting_id 传） | 确认传入的是长数字 `meeting_id`，不是 9 位会议号 |
| `HTTP 404` / `HTTP 500` | 服务端当前无法找到或处理该会议实例 | 换一个正在进行且 bot 可见的 meeting_id，或排查后端问题 |
| `error.code=20017` / `ErrNotInGray` | 当前用户未命中智能体参会灰度 | 提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd |
| `missing required scope(s)` / `permission_violations` | 未授权 `vc:meeting.meetingevent:read` | 只按 CLI hint 重新 `auth login --scope vc:meeting.meetingevent:read` 补 scope，不要混入早鸟群文案 |
| `missing required scope(s)` / `permission_violations` | 未授权 `vc:meeting.meetingevent:read` | 先提示用户加入早鸟群申请智能体参会灰度：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 重新 `auth login --scope vc:meeting.meetingevent:read` 补 scope |
## 提示

4
skills/lark-vc-agent/references/lark-vc-agent-meeting-join.md
View File

@@ -36,7 +36,7 @@ lark-cli vc +meeting-join --meeting-number 123456789 --dry-run
### 1. 仅支持 user 身份
该命令仅支持 `user` 身份，使用前需完成 `lark-cli auth login`。若提示 `missing required scope(s)` / `permission_violations`，只按 CLI hint 引导用户执行 `lark-cli auth login --scope "vc:meeting.bot.join:write"`，不要混入早鸟群文案。
该命令仅支持 `user` 身份，使用前需完成 `lark-cli auth login`。若提示 `missing required scope(s)` / `permission_violations`，先提示用户当前账号可能尚未开通智能体参会灰度，加入早鸟群申请：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 引导用户执行 `lark-cli auth login --scope "vc:meeting.bot.join:write"`。
> **灰度提示：** 若 CLI stderr JSON 返回 `error.code=20017` / `ErrNotInGray`，说明当前用户未命中智能体参会灰度。提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd。暂不展示使用手册。
@@ -113,7 +113,7 @@ lark-cli vc +notes --meeting-ids <meeting.id>
|---------|---------|---------|
| `--meeting-number must be exactly 9 digits` | 会议号不是 9 位纯数字 | 检查是否误传了会议链接或 meeting_id |
| `error.code=20017` / `ErrNotInGray` | 当前用户未命中智能体参会灰度 | 提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd |
| `missing required scope(s)` / `permission_violations` | 未授权 `vc:meeting.bot.join:write` | 只按 CLI hint 运行 `auth login --scope vc:meeting.bot.join:write` 完成授权，不要混入早鸟群文案 |
| `missing required scope(s)` / `permission_violations` | 未授权 `vc:meeting.bot.join:write` | 先提示用户加入早鸟群申请智能体参会灰度：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 运行 `auth login --scope vc:meeting.bot.join:write` 完成授权 |
| 会议密码错误 | `--password` 错误或未提供 | 向主持人确认会议密码 |
| 会议不存在 / 已结束 | 会议号错误或会议未进行中 | 确认会议正在进行中 |
| `HTTP 403: no permission` / `121003` | 入会前置条件不满足，通常不是单纯 scope 问题 | 依次确认：1）会议允许智能体加入；2）会议号正确；3）如有密码，已正确传入 `--password`；4）会议已开始；5）等候室 / 入会审批已放行；6）会议未禁止当前身份加入（如限制外部、限制 bot、仅特定成员可入会）；确认后重试 |

4
skills/lark-vc-agent/references/lark-vc-agent-meeting-leave.md
View File

@@ -37,7 +37,7 @@ lark-cli vc +meeting-leave --meeting-id 69xxxxxxxxxxxxx28 --dry-run
### 2. 仅支持 user 身份
该命令仅支持 `user` 身份，使用前需完成 `lark-cli auth login`。只能让当前身份自己离会，无法强制移出其他参会人。
若提示 `missing required scope(s)` / `permission_violations`，只按 CLI hint 引导用户执行 `lark-cli auth login --scope "vc:meeting.bot.join:write"`，不要混入早鸟群文案。
若提示 `missing required scope(s)` / `permission_violations`，先提示用户当前账号可能尚未开通智能体参会灰度，加入早鸟群申请：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 引导用户执行 `lark-cli auth login --scope "vc:meeting.bot.join:write"`。
若 CLI stderr JSON 返回 `error.code=20017` / `ErrNotInGray`，说明当前用户未命中智能体参会灰度。提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd。暂不展示使用手册。
@@ -96,7 +96,7 @@ lark-cli vc +notes --meeting-ids <meeting.id>
| `meeting not found` / `invalid meeting_id` | 误传了 9 位会议号 | 必须使用 `meeting.id`，不是会议号 |
| `not in meeting` | 当前身份并不在该会议中 | 确认先 `+meeting-join` 成功 |
| `error.code=20017` / `ErrNotInGray` | 当前用户未命中智能体参会灰度 | 提示用户加入早鸟群：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd |
| `missing required scope(s)` / `permission_violations` | 未授权 `vc:meeting.bot.join:write` | 只按 CLI hint 运行 `auth login --scope vc:meeting.bot.join:write` 完成授权，不要混入早鸟群文案 |
| `missing required scope(s)` / `permission_violations` | 未授权 `vc:meeting.bot.join:write` | 先提示用户加入早鸟群申请智能体参会灰度：https://go.larkoffice.com/join-chat/2f4nb0e1-fe00-4f67-bed7-25beaf533fbd；同时再按 CLI hint 运行 `auth login --scope vc:meeting.bot.join:write` 完成授权 |
## 提示