飞书日历管理 (feishu-calendar)

🚨 执行前必读

• ✅ 时区固定：Asia/Shanghai（UTC+8）
• ✅ 时间格式：ISO 8601 / RFC 3339（带时区），例如 2026-02-25T14:00:00+08:00
• ✅ create 最小必填：summary, start_time, end_time
• ✅ user_open_id 强烈建议：从 SenderId 获取（ou_xxx），确保用户能看到日程
• ✅ ID 格式约定：用户 ou_...，群 oc_...，会议室 omm_...，邮箱 email@...

📋 快速索引：意图 → 工具 → 必填参数

🎯 核心约束（Schema 未透露的知识）

1. user_open_id 为什么必填？

工具使用用户身份：日程创建在用户主日历上，用户本人能看到。

但为什么还要传 user_open_id：将发起人也添加为参会人，确保：

• ✅ 发起人会收到日程通知
• ✅ 发起人可以回复 RSVP 状态（接受/拒绝/待定）
• ✅ 发起人出现在参会人列表中
• ✅ 其他参会人能看到发起人

如果不传：

• ⚠️ 用户能看到日程，但不会作为参会人
• ⚠️ 如果只有其他参会人，发起人不在列表中（不符合常规逻辑）

2. 参会人权限（attendee_ability）

工具已默认设置 attendee_ability: "can_modify_event"，参会人可以编辑日程和管理参与者。

3. 统一使用 open_id（ou_...格式）

• ✅ 创建日程：user_open_id = SenderId
• ✅ 邀请参会人：attendees[].id = "ou_xxx"
• ✅ 删除参会人：user_open_ids = ["ou_xxx"]（工具已优化，直接传 open_id 即可）

⚠️ ID 格式区分：

• ou_xxx：用户的 open_id（你应该使用的）
• user_xxx：日程内部的 attendee_id（list 接口返回，仅用于内部记录）

4. 会议室预约是异步流程

添加会议室类型参会人后，会议室进入异步预约流程：

1. API 返回成功 → rsvp_status: "needs_action"（预约中）
2. 后台异步处理
3. 最终状态：accept（成功）或 decline（失败）

查询预约结果：使用 feishu_calendar_event_attendee.list 查看 rsvp_status。

5. instances action 仅对重复日程有效

⚠️ 重要：instances action 仅对重复日程有效，必须满足：

1. event_id 必须是重复日程的 ID（该日程具有 recurrence 字段）
2. 如果对普通日程调用，会返回错误

如何判断：

1. 先用 get action 获取日程详情
2. 检查返回值中是否有 recurrence 字段且不为空
3. 如果有，则可以调用 instances 获取实例列表

📌 使用场景示例

场景 1: 创建会议并邀请参会人

{
  "action": "create",
  "summary": "项目复盘会议",
  "description": "讨论 Q1 项目进展",
  "start_time": "2026-02-25 14:00:00",
  "end_time": "2026-02-25 15:30:00",
  "user_open_id": "ou_aaa",
  "attendees": [
    {"type": "user", "id": "ou_bbb"},
    {"type": "user", "id": "ou_ccc"},
    {"type": "resource", "id": "omm_xxx"}
  ]
}

场景 2: 查询用户未来一周的日程