用途：gccli 是用于操作 Google Calendar 的命令行界面，支持列出日历、查看/创建/更新事件以及检查可用性。
安装：npm install -g @mariozechner/gccli
配置（一次性）：在 Google Cloud Console 新建或选择项目，启用 Google Calendar API，在 OAuth 品牌中设置应用名称，添加测试用户（要使用的 Gmail 地址），创建 OAuth 客户端（应用类型选“Desktop app”）并下载 JSON 文件。随后检查是否已配置：gccli accounts list；若无账户，运行 gccli accounts credentials ~/path/to/credentials.json，再运行 gccli accounts add <email>（无浏览器环境可用 --manual）。
常用命令：gccli <email> calendars 列出所有日历；gccli <email> events <calendarId> [--from <dt>] [--to <dt>] 列出事件；gccli <email> event <calendarId> <eventId> 查看事件详情；gccli <email> create <calendarId> --summary <s> --start <dt> --end <dt> 创建事件；gccli <email> freebusy <calendarIds> --from <dt> --to <dt> 检查可用性。主日历的 calendarId 用 primary。完整命令参考见 gccli --help。
时间格式：定时事件用 YYYY-MM-DDTHH:MM:SSZ（UTC）或 YYYY-MM-DDTHH:MM:SS（本地）；全天事件用 YYYY-MM-DD 并加 --all-day 标志。
数据存储：~/.gccli/credentials.json 保存 OAuth 客户端凭据，~/.gccli/accounts.json 保存账户令牌。
限制：需自行准备 Google Cloud 项目与 OAuth 凭据；测试用户需在 OAuth 品牌中登记；其他限制资料暂未提供。