核心用法
Feishu Calendar Advanced 是一个基于 feishu-agent CLI 的飞书日历管理工具，封装了飞书开放平台的日历接口，提供以下核心能力：
| 功能模块 | 具体能力 |
|---------|---------|
| 日历浏览 | `calendars` 命令列出所有主日历和订阅日历 |
| 日程查询 | `events` 命令查看主日历中的日程列表 |
| 日程创建 | `create` 命令支持指定标题、起止时间、添加参会人 |
| 日程删除 | `delete` 命令按事件 ID 删除指定日程 |
| 冲突检测 | 创建日程时自动检测时间冲突并提示 |
使用前提：需先完成 feishu-agent 的三步配置：① 安装并配置应用 ID/Secret ② OAuth 授权 ③ 验证身份。
技术实现特点
- 底层依赖
@teamclaw/feishu-agent包，通过bunx动态执行 - 支持跨平台运行（Darwin/Linux）
- 命令行参数设计遵循 POSIX 风格，支持多参会人重复传参
显著优点
1. 企业级集成：直接对接飞书开放平台，与飞书原生日历体验一致
2. 冲突智能提示：创建日程时自动检测时间冲突，避免重复预约
3. 参会人管理：支持通过 user_id 批量添加参会人，适合会议场景
4. 轻量部署：仅需 bun 运行时，无需复杂环境配置
5. Token 自动管理：内置授权刷新机制，降低凭证过期导致的故障
潜在局限与风险
| 局限项 | 说明 |
|-------|------|
| 凭证依赖重 | 必须预先在飞书开发者平台创建应用并获取 `appId`/`appSecret`，个人用户门槛较高 |
| 时间格式严格 | 仅支持 `"YYYY-MM-DD HH:MM"` 格式，无时区处理说明，跨时区团队需谨慎 |
| 权限粒度粗 | 需要 `calendar:calendar` 和 `calendar:event` 两项权限，无法细粒度控制只读/读写 |
| 无日历订阅管理 | 仅能查看已订阅的日历，无法通过命令行订阅/取消订阅新日历 |
| 参会人限制 | 需预先知道对方 `user_id`，不支持通过邮箱/手机号邀请 |
常规风险
- 授权过期风险：OAuth Token 有效期有限，需定期重新授权
- 数据误删风险：
delete命令无二次确认机制，删除后不可恢复 - 权限泄露风险：
appSecret以明文形式存储在本地配置中，多用户环境需注意隔离 - API 限流风险：高频调用可能触发飞书开放平台频率限制
适合人群
- 已部署飞书企业版的团队管理员或开发者
- 需要将日历操作自动化集成到 CI/CD 或内部工作流的工程师
- 习惯命令行操作、追求效率的飞书重度用户
- 需要批量创建会议日程的行政/项目管理角色
与通用日历工具对比
| 维度 | 本工具 | 通用 CalDAV 工具 |
|-----|-------|---------------|
| 认证方式 | OAuth 2.0 + 应用凭证 | 用户名密码/Token |
| 冲突检测 | ✅ 原生支持 | 依赖客户端实现 |
| 参会人管理 | ✅ 支持企业组织架构 | 通常仅支持邮件邀请 |
| 部署复杂度 | 中等（需飞书应用配置） | 较低 |
| 企业合规性 | ✅ 符合飞书审计要求 | 视具体工具而定 |