ooodc
a7883dbed9
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段 - 强制每个任务都必须有唯一 id，且由用户负责生成 - 修改合并模式逻辑，merge=true 下保留未提及的旧任务 - 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress） - 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled - 优化状态转换校验，允许特定状态间合法切换 - 简化任务变更消息，移除详细的新增/更新/移除统计 - 更新文档和示例，明确 id 必须由用户生成和使用 - 修复和补充测试，增强状态转换和合并模式验证 - 调整任务时间戳生成逻辑，统一使用当前时间及索引 - 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性
111 lines
4.6 KiB
Markdown
111 lines
4.6 KiB
Markdown
|
||
# vc +meeting-leave
|
||
|
||
> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
|
||
|
||
通过 `meeting_id` 离开当前身份所在的视频会议（bot leave）。这是一次**写操作**，会实际把当前身份从会议中移出。
|
||
|
||
本 skill 对应 shortcut：`lark-cli vc +meeting-leave`（调用 `POST /open-apis/vc/v1/bots/leave`）。
|
||
|
||
## 命令
|
||
|
||
```bash
|
||
# 通过 meeting_id 离会
|
||
lark-cli vc +meeting-leave --meeting-id 69xxxxxxxxxxxxx28
|
||
|
||
# 输出格式
|
||
lark-cli vc +meeting-leave --meeting-id 69xxxxxxxxxxxxx28 --format json
|
||
|
||
# 预览 API 调用（不实际离会）
|
||
lark-cli vc +meeting-leave --meeting-id 69xxxxxxxxxxxxx28 --dry-run
|
||
```
|
||
|
||
## 参数
|
||
|
||
| 参数 | 必填 | 说明 |
|
||
|------|------|------|
|
||
| `--meeting-id <id>` | 是 | 会议 ID（**不是 9 位会议号**） |
|
||
| `--format <fmt>` | 否 | 输出格式：json (默认) / pretty / table / ndjson / csv |
|
||
| `--dry-run` | 否 | 预览 API 调用，不执行 |
|
||
|
||
## 核心约束
|
||
|
||
### 1. 入参是 meeting_id，不是会议号
|
||
|
||
`--meeting-id` 必须是会议的长数字 ID，通常由 `+meeting-join` 返回体中的 `meeting.id` 提供，也可从 `+search` 结果中的 `id` 字段获取。**传 9 位会议号会失败**。
|
||
|
||
### 2. 仅支持 user 身份
|
||
|
||
该命令仅支持 `user` 身份。只能让当前身份自己离会，无法强制移出其他参会人。
|
||
|
||
### 3. 当前身份必须在会议中
|
||
|
||
必须先通过 `+meeting-join` 或其他方式在该会议中，否则接口会报错。
|
||
|
||
### 4. 离会立即生效，对其他参会人可见
|
||
|
||
机器人会立刻从参会列表消失；若会议启用了录制/纪要，bot 的参会时段到此截止。只有在用户明确要求退出 / 离开 / 结束参会时才调用；如需要重新入会，再跑 `+meeting-join` 即可（非真正"不可逆"）。
|
||
|
||
## 输出结果
|
||
|
||
接口成功返回时，默认输出：`Left meeting <meeting-id> successfully.`。
|
||
`--format json` 返回 API 原始响应体。
|
||
|
||
## 如何获取输入参数
|
||
|
||
| 输入参数 | 获取方式 |
|
||
|---------|---------|
|
||
| `meeting-id` | `+meeting-join` 返回的 `meeting.id`；或 `+search` 结果中的 `id` 字段 |
|
||
|
||
## Agent 组合场景
|
||
|
||
### 场景 1：加入 → 用户明确要求时离开
|
||
|
||
```bash
|
||
# 第 1 步：加入会议，记录 meeting.id
|
||
lark-cli vc +meeting-join --meeting-number 123456789
|
||
|
||
# 第 2 步：在会中处理用户请求（如监听发言、记录信息等）
|
||
# ...
|
||
|
||
# 第 3 步：仅在用户明确要求退出 / 离开 / 结束参会时，使用上一步记录的 meeting.id 离会
|
||
lark-cli vc +meeting-leave --meeting-id <meeting.id>
|
||
```
|
||
|
||
### 场景 2：会后补拉产物（不需要离会）
|
||
|
||
如果用户只是要求会议结束后拉录制、纪要或逐字稿，不要先调用 `+meeting-leave`；直接跨到 `lark-vc` 查询会后产物。
|
||
|
||
```bash
|
||
# 第 1 步：会议结束后查询录制
|
||
lark-cli vc +recording --meeting-ids <meeting.id>
|
||
|
||
# 第 2 步：查询会议纪要
|
||
lark-cli vc +notes --meeting-ids <meeting.id>
|
||
```
|
||
|
||
## 常见错误与排查
|
||
|
||
| 错误现象 | 根本原因 | 解决方案 |
|
||
|---------|---------|---------|
|
||
| `--meeting-id is required` | 未传入 `--meeting-id` | 传入从 `+meeting-join` 得到的 `meeting.id` |
|
||
| `meeting not found` / `invalid meeting_id` | 误传了 9 位会议号 | 必须使用 `meeting.id`，不是会议号 |
|
||
| `not in meeting` | 当前身份并不在该会议中 | 确认先 `+meeting-join` 成功 |
|
||
|
||
## 提示
|
||
|
||
- 只有用户明确要求退出 / 离开 / 结束参会时才调用；离会会让机器人从参会列表消失，对其他参会人可见。若需要重新入会直接再 `+meeting-join`，不是真正的"不可逆"。参数格式不确定时可选 `--dry-run` 预览。
|
||
- `+meeting-leave` 依赖 `+meeting-join` 返回的 `meeting.id`，但不是每次 join 后都必须调用 leave。
|
||
- `meeting_id` 优先使用 `+meeting-join` 返回的 `meeting.id`；如果来自 `+search`，也必须先确认当前身份就在该会议中。不要用 9 位会议号。
|
||
|
||
## 参考
|
||
|
||
- [lark-vc-agent-meeting-join](lark-vc-agent-meeting-join.md) — 对应的入会命令
|
||
- [lark-vc-agent-meeting-events](lark-vc-agent-meeting-events.md) — 会中事件流
|
||
- [lark-vc-search](../../lark-vc/references/lark-vc-search.md) — 搜索历史会议（获取 meeting_id）
|
||
- [lark-vc-recording](../../lark-vc/references/lark-vc-recording.md) — 查询 minute_token
|
||
- [lark-vc-notes](../../lark-vc/references/lark-vc-notes.md) — 获取会议纪要
|
||
- [lark-vc-agent](../SKILL.md) — Agent 参会能力（本 skill）
|
||
- [lark-vc](../../lark-vc/SKILL.md) — 视频会议原子域（Meeting / Note 等核心概念）
|
||
- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数
|