lark-calendar

核心用法

Lark Calendar Skill 是一款面向飞书（Lark/Feishu）生态的企业级日程管理工具，提供完整的日历事件与任务（Todo）CRUD 操作能力。用户可通过命令行脚本或程序化 API 两种方式调用：命令行模式适合快速创建会议、批量管理任务；程序化模式则便于集成到自动化工作流中。

核心功能覆盖六大场景：日历事件的增删改查、任务的全生命周期管理、事件参与者动态增减、任务成员分配、员工姓名自动解析（支持 20+ 位内部成员的别名映射），以及时区智能处理（默认 Asia/Singapore，支持 IANA 标准时区）。特别值得注意的是，系统会自动将 Boyang（老板）添加为所有日历事件的参与者，确保管理层信息同步。

显著优点

深度生态集成：直接对接飞书开放平台官方 API，而非模拟浏览器操作，稳定性与合规性兼具。员工目录功能尤为实用——支持 "Boyang/by/博洋" 等多别名自动解析为 user_id，大幅降低人工查找成本。

双模式灵活调用：既提供 8 个即开即用的 CLI 脚本（create-event、update-task、manage-attendees 等），也暴露模块化 JavaScript API，方便嵌入 CI/CD 流水线或内部管理系统。

企业级细节设计：内置 Token 自动缓存与 5 分钟过期缓冲机制，避免频繁调用认证接口；强制 HTTPS 通信；敏感配置隔离至 .secrets.env 文件，符合十二要素应用规范。

潜在缺点与局限性

权限配置门槛：任务创建需额外申请 task:task:write 权限，且员工动态查询依赖 contact:contact:readonly，否则回退至静态名单。对于人员流动频繁的团队，需手动维护 lib/employees.mjs 文件。

时区与格式约束：时间格式严格限定为 YYYY-MM-DD HH:MM:SS，不支持自然语言输入（如 "明天下午三点"）；时区虽可配置，但缺乏智能识别能力。

单租户架构：默认日历与员工目录均为 Claw AI 内部配置，外部企业 fork 后需深度改造才能复用，通用性受限。

适合的目标群体

• 已部署飞书作为协同平台的中小型企业技术团队
• 需要自动化会议安排、任务分发的 DevOps/运维工程师
• 追求"代码即文档"、偏好 CLI 工作流的技术管理者
• 希望将日程管理集成到内部 Bot 或自动化脚本中的开发者

使用风险

密钥泄露风险：FEISHU_APP_SECRET 存储于本地文件，若权限配置不当（未设 600）或误提交至 Git，可能导致企业数据泄露。建议配合 git-secrets 等工具做提交前检查。

API 限流风险：飞书开放平台对日历、任务接口有 QPS 限制，批量操作（如一次性创建数十个任务）可能触发限流，需自行实现退避重试逻辑。

数据误操作风险：删除事件/任务为不可逆操作，且 CLI 无二次确认交互，脚本化批量删除时需谨慎测试。

依赖单一供应商：深度绑定飞书生态，若企业迁移至钉钉、企业微信或其他平台，需完全重写集成层。