ooodc a7883dbed9 refactor(todo): 重构待办事项管理逻辑及更新状态规则

- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段
- 强制每个任务都必须有唯一 id，且由用户负责生成
- 修改合并模式逻辑，merge=true 下保留未提及的旧任务
- 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress）
- 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled
- 优化状态转换校验，允许特定状态间合法切换
- 简化任务变更消息，移除详细的新增/更新/移除统计
- 更新文档和示例，明确 id 必须由用户生成和使用
- 修复和补充测试，增强状态转换和合并模式验证
- 调整任务时间戳生成逻辑，统一使用当前时间及索引
- 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性

2026-06-13 09:22:33 +08:00

4.6 KiB

Raw Blame History

vc +meeting-leave

前置条件： 先阅读 ../lark-shared/SKILL.md 了解认证、全局参数和安全规则。

通过 meeting_id 离开当前身份所在的视频会议（bot leave）。这是一次写操作，会实际把当前身份从会议中移出。

本 skill 对应 shortcut：lark-cli vc +meeting-leave（调用 POST /open-apis/vc/v1/bots/leave）。

命令

# 通过 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：加入 → 用户明确要求时离开

# 第 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 查询会后产物。

# 第 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-events — 会中事件流
lark-vc-search — 搜索历史会议（获取 meeting_id）
lark-vc-recording — 查询 minute_token
lark-vc-notes — 获取会议纪要
lark-vc-agent — Agent 参会能力（本 skill）
lark-vc — 视频会议原子域（Meeting / Note 等核心概念）
lark-shared — 认证和全局参数

4.6 KiB Raw Blame History Unescape Escape