ooodc
a7883dbed9
- 移除 TodoItem 中的 priority、created_at 和 updated_at 字段 - 强制每个任务都必须有唯一 id，且由用户负责生成 - 修改合并模式逻辑，merge=true 下保留未提及的旧任务 - 支持已完成和已取消任务重新激活（状态改回 pending 或 in_progress） - 禁止 in_progress 状态退回到 pending，必须标记为 completed 或 cancelled - 优化状态转换校验，允许特定状态间合法切换 - 简化任务变更消息，移除详细的新增/更新/移除统计 - 更新文档和示例，明确 id 必须由用户生成和使用 - 修复和补充测试，增强状态转换和合并模式验证 - 调整任务时间戳生成逻辑，统一使用当前时间及索引 - 该变更提供更合理的任务状态机械及管理模式，提升稳定性和易用性
3.7 KiB
3.7 KiB
VC Events
Prerequisite: Read
../SKILL.mdfirst for theevent consumeessentials (commands, subprocess contract, jq usage).
Key catalog (2)
| EventKey | Purpose |
|---|---|
vc.meeting.participant_meeting_ended_v1 |
A meeting the current user participates in has ended |
vc.note.generated_v1 |
A note has been generated (meeting, recording, upload, etc.) |
Both keys use a Custom schema (flat output) and carry a PreConsume hook that auto-subscribes / unsubscribes via OAPI on first / last consumer. Both require --as user.
Scopes & auth
| EventKey | Scope | Auth |
|---|---|---|
vc.meeting.participant_meeting_ended_v1 |
vc:meeting.meetingevent:read |
user |
vc.note.generated_v1 |
vc:note:read |
user |
vc.meeting.participant_meeting_ended_v1
Output fields
| Field | Type | Description |
|---|---|---|
type |
string | Event type; always vc.meeting.participant_meeting_ended_v1 |
event_id |
string | Globally unique event ID; safe for deduplication |
timestamp |
string (timestamp_ms) | Event delivery time (ms timestamp string) |
meeting_id |
string | Meeting ID |
topic |
string | Meeting topic |
meeting_no |
string | Meeting number |
start_time |
string | Meeting start time in RFC3339, converted to the local timezone |
end_time |
string | Meeting end time in RFC3339, converted to the local timezone |
calendar_event_id |
string | Calendar event ID associated with the meeting |
Gotchas
start_time/end_timeare not the raw unix-seconds from OAPI — the Process hook converts them to local-timezone RFC3339. If the raw value is empty or non-numeric, the field is left empty.- No detail API call is made; all fields come from the event payload itself.
Example
lark-cli event consume vc.meeting.participant_meeting_ended_v1 --as user
# Project meeting topic and end time only
lark-cli event consume vc.meeting.participant_meeting_ended_v1 --as user \
--jq '{meeting: .meeting_id, topic: .topic, ended: .end_time}'
vc.note.generated_v1
Fires when a note is generated — not just from meetings, but also from realtime recordings and local file uploads.
Output fields
| Field | Type | Description |
|---|---|---|
type |
string | Event type; always vc.note.generated_v1 |
event_id |
string | Globally unique event ID; safe for deduplication |
timestamp |
string (timestamp_ms) | Event delivery time (ms timestamp string) |
note_id |
string | Note ID |
note_token |
string | Note document token; may be empty if detail is not yet available |
verbatim_token |
string | Verbatim document token; may be empty if detail is not yet available |
note_source |
object | Source metadata; only present when source is a meeting |
note_source.source_type |
string | Source type; only present when source is a meeting (value: meeting) |
note_source.source_entity_id |
string | Source entity ID (meeting ID); only present when source is a meeting |
Source type semantics
source_type |
Trigger |
|---|---|
meeting |
Note generated from a meeting |
note_source (and its sub-fields) are only populated when source_type is meeting. For other sources the field is absent.
Example
lark-cli event consume vc.note.generated_v1 --as user
# Only notes with enriched tokens, skip incomplete ones
lark-cli event consume vc.note.generated_v1 --as user \
--jq 'select(.note_token != "") | {note_id, note_token, verbatim_token}'
# Filter to meeting-sourced notes only
lark-cli event consume vc.note.generated_v1 --as user \
--jq 'select(.note_source.source_type == "meeting") | {note_id, meeting_id: .note_source.source_entity_id}'