核心用法
Lark Calendar Skill 是一款面向飞书(Lark/Feishu)企业用户的日历与任务管理工具,提供完整的 CRUD 操作能力。核心功能包括:
- 日历事件管理:创建、更新、删除会议,支持设置标题、描述、起止时间、地点、时区及参会人
- 任务(Todo)管理:创建带截止日期的待办事项,支持指派给团队成员
- 员工目录集成:内置 20+ 员工的姓名-user_id 映射表,支持中英文别名自动解析(如 "Boyang/by/博洋" →
dgg163e1) - 参会人/成员管理:支持动态添加/移除会议参会人和任务成员
显著优点
1. 零配置上手:预设默认日历和时区(Asia/Singapore),提供静态员工目录,无需实时查询企业通讯录即可快速解析常用联系人
2. 智能名称解析:支持多别名映射(如 RK、jc、sagiri 等),降低记忆 user_id 的负担
3. 命令行与程序化双模式:既可通过 CLI 快速操作,也支持 ES Module 导入进行编程调用
4. 内置业务规则:自动将 Boyang 添加为所有日历事件的参会人,确保关键人员不错过会议
潜在缺点与局限性
1. 权限依赖较重:任务创建需额外申请 task:task:write 权限,动态员工查询需 contact:contact:readonly,否则降级为静态列表
2. 静态员工表维护成本:团队变动时需手动更新 lib/employees.mjs,存在信息滞后风险
3. 时区与格式严格:强制要求 IANA 时区标识和 YYYY-MM-DD HH:MM:SS 格式,对用户输入规范性要求高
4. 企业级锁定:深度绑定飞书生态,无法迁移至其他协作平台
适合人群
- 飞书企业用户,尤其是需要批量管理会议和任务的行政、项目经理
- 开发团队希望将日历操作集成到自动化工作流(CI/CD、机器人通知等)
- 中小团队(20-50人),员工变动不频繁的场景
常规风险
- 凭证泄露风险:
FEISHU_APP_SECRET存储于.secrets.env,若版本控制配置不当可能导致密钥暴露 - 权限扩散:
calendar:calendar和task:task:write权限范围较宽,误操作可能影响他人日程 - 数据一致性:静态员工表与实际企业通讯录不同步时,可能导致邀请失败或误邀
- API 限流:高频调用可能触发飞书开放平台速率限制