calendar +agenda

前置条件： 先阅读 ../lark-shared/SKILL.md 了解认证、全局参数和安全规则。

查看近期日程安排。只读操作，不修改任何日程。

需要的scopes: ["calendar:calendar.event:read"]

命令

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

# 自定义时间范围（ISO 8601）
lark-cli calendar +agenda --start "2026-03-10T00:00+08:00" --end "2026-03-17T00:00+08:00"

# 自定义时间范围（仅日期）
lark-cli calendar +agenda --start 2026-03-10 --end 2026-03-17

# 人类可读格式输出
lark-cli calendar +agenda --format pretty

# 指定日历
lark-cli calendar +agenda --calendar-id cal_xxx

参数

参数	必填	说明
`--start <time>`	否	开始时间（ISO 8601 或仅日期，默认当天）
`--end <time>`	否	结束时间（默认与 `--start` 属于同一天，自动取当天结束时间）
`--calendar-id <id>`	否	日历 ID（省略则使用主日历）
`--format`	否	输出格式：json（默认） \| pretty
`--dry-run`	否	预览 API 调用，不执行

时间格式

--start 和 --end 支持以下格式：

格式	示例	说明
ISO 8601	`2026-03-10T14:00:00+08:00`	完整格式
日期+时间	`2026-03-10 14:00:00`	自动补全时区
仅日期	`2026-03-10`	start 取 00:00:00，end 取 23:59:59
Unix 时间戳	`1741564800`	秒级时间戳

输出格式

将结果整理为易读的日程表：

## 2026-03-10 周一

09:00 - 09:30  站会
10:00 - 11:00  产品评审
14:00 - 15:00  与 Alice 1:1

## 2026-03-11 周二

（无日程）

注意：按日期分组，并严格按照开始时间升序（从早到晚的时间线）排序输出。 显示标题、时长

提示

已取消的日程会自动过滤，无需额外处理。
如无日程，告知用户"日程清空"。
大于 40 天的时间范围会自动拆分查询并合并结果。
查看多个日历：先用 lark-cli calendar calendars list --page-all 列出日历列表，再逐个查询。

参考

lark-calendar -- 日历全部命令
lark-shared -- 认证和全局参数

2.3 KiB Raw Blame History Unescape Escape

calendar +agenda

命令

参数

时间格式

输出格式

提示

参考

2.3 KiB

Raw Blame History