Feishu CLI 日历与日程管理

查看每日日程、创建带参会者的事件、查询团队成员忙闲状态，以及获取 AI 智能最佳会议时间建议。

概述

终端中的日历管理

Feishu CLI 日历模块提供 4 个快捷命令，实现完整的日历管理。查看每日日程、创建带参会者的事件、查询团队成员忙闲状态，以及获取 AI 智能最佳会议时间建议。这些快捷命令封装了飞书开放平台日历 API，支持用户和机器人两种身份。

查看日程

+agenda — 查看日历日程

显示今天或自定义日期范围内的即将到来的事件。默认情况下，+agenda 显示今天的事件。输出包括事件标题、时间、参会者和状态。

    # 查看今天的日程（默认）
    $ lark-cli calendar +agenda
  

    # 查看特定一周的日程
    $ lark-cli calendar +agenda --start "2026-04-01" --end "2026-04-07"
  

    # 查看特定日历的日程
    $ lark-cli calendar +agenda --calendar-id "primary"
  

参数

参数	说明
`--start`	起始日期或日期时间（默认为今天）
`--end`	结束日期或日期时间（默认为今天结束）
`--calendar-id`	目标日历 ID（默认为主日历）

输出字段

输出中的每个事件包括：事件标题、开始/结束时间、参会者（姓名和回复状态）、地点和组织者。全天事件与定时事件分开显示。

创建事件

+create — 创建日历事件

创建包含摘要、时间范围、参会者、描述和重复规则的事件。--start 和 --end 参数为必填项。

    # 创建一个简单的一小时事件
    $ lark-cli calendar +create --summary "Sprint Planning" --start "2026-04-01T09:00" --end "2026-04-01T10:00"
  

    # 创建带参会者的事件
    $ lark-cli calendar +create --summary "Design Review" --start "2026-04-02T14:00" --end "2026-04-02T15:00" --attendee-ids "ou_xxx,ou_yyy"
  

    # 创建带描述的事件
    $ lark-cli calendar +create --summary "Quarterly Review" --start "2026-04-05T10:00" --end "2026-04-05T11:30" --description "Review Q1 metrics and set Q2 targets"
  

    # 创建每周重复事件（共 4 次）
    $ lark-cli calendar +create --summary "Weekly Standup" --start "2026-04-01T09:00" --end "2026-04-01T09:30" --rrule "FREQ=WEEKLY;COUNT=4"
  

参数

参数	说明	必填
`--summary`	事件标题	是
`--start`	起始日期或日期时间（ISO 8601）	是
`--end`	结束日期或日期时间（ISO 8601）	是
`--attendee-ids`	逗号分隔的受邀用户 ID	否
`--description`	事件描述或备注	否
`--rrule`	iCalendar 重复规则（RFC 5545）	否

忙闲查询

+freebusy — 查看可用性

查询一个或多个用户在指定时间范围内的忙闲状态。在安排会议前查找可用时段的必备工具。

    # 查看用户全天的可用性
    $ lark-cli calendar +freebusy --user-id "ou_xxx" --start "2026-04-01" --end "2026-04-02"
  

    # 查看特定时间窗口的可用性
    $ lark-cli calendar +freebusy --user-id "ou_xxx" --start "2026-04-01T09:00" --end "2026-04-01T17:00"
  

参数

参数	说明
`--user-id`	要查询可用性的用户 ID
`--start`	时间范围的起始时间
`--end`	时间范围的结束时间

输出显示查询范围内的忙碌时间段，便于识别可用于安排会议的空闲时段。

时间建议

+suggestion — AI 智能会议时间推荐

基于参会者日历获取智能会议时间建议。AI 分析所有参与者的可用性，推荐最佳时间段。

    # 获取 AI 智能时间建议
    $ lark-cli calendar +suggestion
  

该快捷命令利用飞书的 AI 日程引擎，在考虑时区差异和工作时间偏好的基础上，推荐所有参会者均可参加的时间。

API 命令

底层日历 API 访问

除快捷命令外，您还可以直接访问完整的日历 API 以满足高级使用场景。这些命令直接映射到飞书开放平台日历 API 端点。

    # 列出所有日历
    $ lark-cli calendar calendars list
  

    # 使用原始 API 参数查看事件实例
    $ lark-cli calendar events instance_view --params '{"calendar_id":"primary","start_time":"1711929600","end_time":"1712016000"}'
  

    # 查看日历 API 端点的 schema
    $ lark-cli schema calendar.events.instance_view
  

使用 lark-cli schema 可在直接调用前探索任何 API 端点的完整参数集。

权限

所需权限范围与身份

日历命令根据操作类型需要特定的 OAuth 权限范围。大多数命令同时支持用户和机器人身份。

操作	所需权限范围	身份
查看日程 / 列出事件	`calendar:calendar:readonly`	用户、机器人
创建事件	`calendar:calendar`	用户、机器人
查询忙闲状态	`calendar:calendar:readonly`	用户、机器人
时间建议	`calendar:calendar:readonly`	用户

使用这些命令前，请确保您的应用已在 Lark Open Platform 开发者控制台中启用所需权限范围。

使用场景

常见日历工作流

跨时区日程安排

跨时区安排会议时，结合 +freebusy 和 +suggestion 查找适合分布式团队的时间段。Feishu CLI 根据每个用户配置的时区自动处理时区转换。

    # 跨时区检查可用性，然后创建事件
    $ lark-cli calendar +freebusy --user-id "ou_xxx" --start "2026-04-01" --end "2026-04-02"
    $ lark-cli calendar +create --summary "Cross-team Sync" --start "2026-04-01T22:00" --end "2026-04-01T23:00" --attendee-ids "ou_xxx,ou_yyy"
  

自动化站会报告

结合日历数据和消息功能，生成自动化每日站会总结。使用 +agenda 获取今天的事件，然后将输出通过管道传递到消息模块，发布到团队频道中。

会议室预订

使用底层 API 查询会议室日历并创建预订。会议室在 Lark 平台中以日历资源的形式呈现。

命令参考

所有日历快捷命令

快捷命令	说明	风险等级	关键参数
`+agenda`	查看指定日期范围的日历日程	安全	--start, --end, --calendar-id
`+create`	创建新的日历事件	中	--summary, --start, --end, --attendee-ids, --rrule
`+freebusy`	查询忙闲状态	安全	--user-id, --start, --end
`+suggestion`	AI 智能会议时间建议	安全	（交互式）

继续阅读