calendar (v4)

开始前先读 ../lark-shared/SKILL.md（认证、权限处理）。

CRITICAL, 凡涉及预约日程/会议室、调整时间或查询/搜索会议室，第一步 MUST 读 references/lark-calendar-schedule-meeting.md。仅编辑字段（改标题/描述）或增删参会人（不涉及时间和会议室）时可跳过，直接读 references/lark-calendar-update.md。

身份

按日程归属选身份：

• 查看/管理登录用户本人的日程 → --as user（默认，绝大多数场景）。
• 查看/管理 bot 自己创建/拥有的日程 → --as bot

对话人称映射：「我」= 登录用户，「你」= 应用（bot）；作为字段取值的人称（参会人、会议 owner 等）不参与身份判定，如「你创建日程，邀请我、会议 owner 为我」→ --as bot 创建，登录用户仅作参会人与会议 owner。

# 用户本人日程 → user
lark-cli calendar +agenda --as user
# bot 自建或参与的日程 → bot
lark-cli calendar +agenda --as bot

Shortcuts

Shortcut	说明
+agenda	查看日程安排（默认今天）
+meeting	通过日程事件 ID 获取关联的视频会议信息（meeting_id、meeting_note），日程开过视频会议才会有meeting_id,注意: 视频会议链接获取走+get命令
+create	创建日程并邀请参会人（ISO 8601 时间）
+update	更新既有日程字段，或独立增量添加/移除参会人和会议室；重复性日程/例外必须传 --apply-to（详见 重复性日程操作规范）
+delete	删除日程；重复性日程/例外必须传 --apply-to（详见 重复性日程操作规范）
+freebusy	查询主日历的忙闲/RSVP状态/空闲时间段。(如需预约/推荐时间段走 +suggestion, , 它综合工作时间、忙碌区间和休息时间推荐。)
+room-find	针对一个或多个明确的时间块查找可用会议室（无明确时间时禁止直接调用，需先走 +suggestion）
+rsvp	回复日程（接受/拒绝/待定）
+join-event	凭分享 token 加入日程（分享链接/二维码/分享卡片/RSVP 卡片）
+suggestion	根据非明确时间或一段时间范围，推荐多个可用时间块方案
+transfer	把日程组织者转让给另一个用户或机器人；不可逆，需 --yes
+list-attendees	列出日程的参与人和会议室（支持按 --type 过滤：user / resource / chat / third_party）

+get, 单日程详情