飞书日历：管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责：查询过去的视频会议记录（走 lark-meeting）、待办任务（走 lark-task）。

calendar (v4) 开始前先读 [ ../lark shared/SKILL.md ](../lark shared/SKILL.md)（认证、权限处理）。 CRITICAL — 凡涉及预约日程/会议室、调整时间或查询/搜索会议室，第一步 MUST 读 [ references/lark calendar schedule meeting.md ](references/lark calendar schedule meeting.md)。仅编辑字段（改标题/描述）或增删参会人（不涉及时间和会议室）时可跳过，直接读 [ references/lark calendar update.md ](references/lark calendar update.md)。身份按日程归属选身份：查看/管理登录用户本人的日程 → as user （默认，绝大多数场景）。查看/管理 bot 自己创建/拥有的日程 → as bot 对话人称映射：「我」= 登录用户，「你」= 应用（bot）；作为字段取值的人称（参会人、会议 owner 等）不参与身份判定，如「你创建日程，邀请我、会议 owner 为我」→ as bot 创建，登录用户仅作参会人与会议 owner。 Shortcuts Shortcut 说明 +agenda 查看日程安排（默认今天） [ +meeting ](references/lark calendar meeting.md) 通过日程事件 ID 获取关联的视频会议信息（meeting id、meeting note），日程开过视频会议才会有meeting id, 注意 : 视频会议链接获取走+get命令 [ +create ](references/lark calendar create.md) 创建日程并邀请参会人（ISO 8601 时间） [ +update ](references/lark calendar update.md) 更新既有日程字段，或独立增量添加/移除参会人和会议室；重复性日程/例外必须传 apply to （详见 [重复性日程操作规范](references/lark calendar recurring.md)） +delete 删除日程；重复性日程/例外必须传 apply to （详见 [重复性日程操作规范](references/lark calendar recurring.md)） +freebusy 查询主日历的忙闲/RSVP状态/空闲时间段。( 如需预约/推荐时间段走 +suggestion ——它综合工作时间、忙碌区间和休息时间推荐。) [ +room find ](references/lark calendar room find.md) 针对一个或多个明确的时间块查找可用会议室（无明确时间时禁止直接调用，需先走 +suggestion） [ +rsvp ](references/lark calendar rsvp.md) 回复日程（接受/拒绝/待定） [ +join event ](references/lark calendar join event.md) 凭分享 token 加入日程（分享链接/二维码/分享卡片/RSVP 卡片） [ +suggestion ](references/lark calendar suggestion.md) 根据非明确时间或一段时间范围，推荐多个可用时间块方案 [ +transfer ](references/lark calendar transfer.md) 把日程组织者转让给另一个用户或机器人；不可逆，需 yes [ +list attendees ](references/lark calendar list attendees.md) 列出日程的参与人和会议室（支持按 type 过滤：user / resource / chat / third party） +get — 单日程详情通过 calendar id + event id 获取单个日程详情。日程描述统一使用 description 一个字段，按 Markdown 富文本处理。读取日程时 description 返回 Markdown 富文本（仅有纯文本描述时返回该纯文本）；创建/更新日程时也通过 description 传入 Markdown。 +get 返回不含参会人和会议室。需要参与人视角（用户 / 会议室 / 群 / 三方邮箱）请调用 [ +list attendees ](references/lark calendar list attendees.md)。 +search event — 按关键词、时间范围和参会人搜索日程仅返回基础字段（ event id / summary / start / end 等），需要详情请走 +get 。 attendee ids 的多值语义：同类型内为 OR（并集） ——只要日程命中列表中的任意一个同类型 ID，就会返回。 attendee ids "ou A,ou B" = A 或 B 参加的日程（不是 A 和 B 都参加的）。 +delete — 删除日程 +agenda — 查看近期日程安排默认查询当天。结果应整理为按日期分组、按开始时间升序的易读时间线。注意：已取消的日程自动过滤；无日程时直接告知"日程清空"。时间范围超过 40 天会自动拆分查询并合并结果。 +freebusy — 查询主日历忙闲时段 / 事件 / 公共空闲 +freebusy 一个入口承担四种视角：几何计算类（ busy / free / common free ）走自动合并；事件维度类（ raw busy ）保留每条上游日程 + rsvp status 。用法提示： +freebusy 只适用于查询忙碌/空闲时间段这一事实。如果目标是"给会议推荐一个合适的时间段"（单人或多人），必须优先使用 [ +suggestion ](references/lark calendar suggestion.md)——它会综合工作时间段、忙碌时间段、休息时间段来推荐， +freebusy 只回答"哪些区间空着"，不判断该区间是否适合排会。多人公共空闲：只想拿"哪些区间共同没被占"→ type common free [ min duration <dur ] ；想拿"推荐的会议时间段"→ 走 +suggestion 。前置条件路由先判断是否重复性日程：若操作对象是重复性日程，必须先读 [重复性日程操作规范](references/lark calendar recurring.md)，并在用户未明确范围时先确认「仅此次/全部/此次及后续」（不要默认仅此次），再按下表进入具体操作流程。场景前置要求预约日程/会议、调整时间、查会议室先读 [lark calendar schedule meeting.md](references/lark calendar schedule meeting.md) 仅编辑字段（标题/描述）或增删参会人先定位 event id ，再读 [lark calendar update.md](references/lark calendar update.md) 调用任何 Shortcut 先读其对应 reference 文档写操作反馈创建、更新、删除、RSVP 等写操作完成后，直接基于命令返回结果反馈用户；不要为了“确认是否生效”主动发起二次查询。只有用户明确要求复查，或命令返回信息不足以回答用户问题时，才需要再查询。核心概念日程实例（Instance）：重复性日程展开后的具体时间实例。「仅此次」操作时使用具体实例的 event id ；「全部」或「此次及后续」操作时需对原重复性日程操作（使用原日程 event id ），并按需处理例外。重复性日程例外（Exception）：对重复性日程某次实例做过「仅此次」编辑后产生的独立日程（拥有独立 event id ）。删除/更新「全部」时必须同时处理例外，否则例外会残留。全天日程（All day Event）：只按日期占用、没有具体起止时刻的日程，结束日期是包含在日程时间内的。时间块 vs 时间范围：时间块是具体确定的连续时间段（如 14:00~15:00 ），时间范围是泛指（如"今天下午"）。 +room find 必须基于确定时间块，不能基于模糊范围。会议室（Room）："room"不是"房间"，是"会议室"。会议室是日程的一种参与人（resource attendee），不能脱离日程单独预定。日程会议 ID（Meeting ID）：日程的历史视频会议 ID，在日程上开过视频会议才会有。日程分享链接 vs 会议链接：两者是不同事物，不可混用。日程分享链接： https://<domain /calendar/share?token=<token ，指向日程本身，用于分享日程详情。分享日程给某个人、某个群或粘贴到文档中，需要的都是这个日程分享链接（通过 calendar events share info 获取），不是 applink ；禁止自己拼接 applink 或用 applink 代替。会议链接： https://<domain /j/<number ，指向视频会议入口；同一重复性日程序列的所有实例共用同一个会议链接。术语映射用户日常说的"帮我约个日历""查一下今天的日历"，实际意图是针对日程（Event）的创建或查询，而非操作日历（Calendar）容器本身。自动将口语化的"日历"意图映射为"日程"操作。意图路由日程与会议的关系：用户口中的「会议」通常不区分日程和视频会议。定义、三种查询意图（当前/未来/过去）的分流规则见 [日程与视频会议的关系](references/lark calendar meeting relation.md)。用户意图路由到查询过去的会议（"昨天的会议""上周的会"）/今天有哪些会议 / 当前正在开的会议先读 [日程与视频会议的关系](references/lark calendar meeting relation.md) 未来的会议 / 明天/下周的会议本 skill：视频会议不存在于未来，等价于查日程按关键词搜索日程本 skill（ +search event ）从日程获取关联的视频会议 ID 或用户绑定的会议纪要文档本 skill（[ +meeting ](references/lark calendar meeting.md)）查看日程的参会人 / 会议室（含 type resource 只看会议室）本 skill（[ +list attendees ](references/lark calendar list attendees.md)）把日程分享给某人 / 群 / 粘贴到文档本 skill：先 calendar events share info 取日程分享链接，再走 [lark im](../lark im/SKILL.md) 发送或粘贴该链接；分享日程给某个人、某个群或粘贴到文档中，需要的都是日程分享链接，不是 applink ，不要自己拼接或用 applink 代替从日程进一步拿 AI 智能纪要 / 逐字稿 / 妙记产物先 +meeting 取 meeting id ，再进入 [ lark meeting ](../lark meeting/SKILL.md)：[ vc +detail ](../lark meeting/references/lark vc detail.md) → [ note +detail ](../lark meeting/references/lark note detail.md) / [ minutes +detail ](../lark meeting/references/lark minutes detail.md) 预约/改约日程、调整时间、添加/更换会议室、查会议室先判断新建 vs 编辑，再进入 [schedule meeting 工作流](references/lark calendar schedule meeting.md) 仅编辑日程字段（标题/描述）或增删参会人（不涉及时间和会议室）先定位 event id ，再读 [+update](references/lark calendar update.md) 执行变更编辑/删除重复性日程（「改这个重复日程」「删掉后面的」「全部取消」等）先读 [重复性日程操作规范](references/lark calendar recurring.md)； +update / +delete 均通过 apply to=single all this and following 指定范围转让日程组织者（「把这个日程交给 XX」「组织者改成 XX」「这个会转给我」「bot 建完还给我」）读 [+transfer](references/lark calendar transfer.md)； as 用当前组织者身份， to user id 传接收人，用户和机器人任意互转任务类型分流处理"预约/改约日程、添加/移除参会人、添加/更换会议室、调整时间"时，必须先判断新建 vs 编辑：编辑已有日程的强信号：用户提到已存在的日程锚点（标题、时间段、这个日程、这场会）并表达修改动作（添加、移除、改到、换会议室、调整时间）。默认走编辑流，绝不能按新建处理。新建日程：用户表达新增意图（"新约一个会""创建一个日程""安排一次会议"），且没有指向既有日程的修改动作。时间推断规范星期的定义：周一是一周的第一天，周日是最后一天。计算"下周一"等相对日期时，基于当前真实日期推算。一天的范围：用户提到"明天""今天"等泛指某天时，时间范围应覆盖整天，不要自行缩减。历史时间约束：不能预约已经完全过去的时间。唯一例外是"跨越当前时间"的日程（开始在过去、结束在未来）。会议室规则凡是"预定/查询/搜索可用会议室"，都必须进入 [schedule meeting 工作流](references/lark calendar schedule meeting.md)，会议室参数规范详见 [+room find](references/lark calendar room find.md)。 +room find 的时间输入必须是确定时间块，不能是时间区间搜索。用户仅要求"查会议室"但未提供明确时间时，必须先调用 +suggestion 获取可用时间块，再将时间块交给 +room find 。严禁猜测时间盲目调用。编辑已有日程时，"添加会议室"默认是增量语义，保留已有会议室；只有用户明确说"更换会议室""移除会议室"时才删除旧会议室。 API Resources calendar id 可以直接传 primary ，代表当前调用身份的主日历 ID。查询资源的方法列表以及方法的使用方式列出某资源下的方法： lark cli calendar <resource h 查看方法的cli flag： lark cli calendar <resource <method h 查看方法API参数： lark cli schema calendar.<resource .<method <resource 为 calendars （日历本身）/ events （日程）/ event.attendees （参与人）/ freebusys （忙闲）。例： lark cli schema calendar.events.delete 。常用其他域命令搜索用户/群不支持 bot 身份，必须用 as user 。解析不到或类型不明确时，向用户澄清该参会人类型，不要靠名字形态硬猜类型。不在本 skill 范围查询过去的视频会议记录 → [lark meeting](../lark meeting/SKILL.md) 待办任务管理 → [lark task](../lark task/SKILL.md) 通讯录 → [lark contact](../lark contact/SKILL.md) 即时通讯 → [lark im](../lark im/SKILL.md) 会议室物理设施管理 → 管理员后台注意（强制性）：涉及日期（时间）字符串与时间戳的相互转换时，务必调用系统命令或脚本代码等外部工具进行处理，以确保转换的绝对准确；换算禁止依赖容器默认时区（常为 UTC，会导致 8 小时偏移），必须显式指定目标时区。违者将导致严重的逻辑错误！

lark-calendar