核心功能
feishu-agent 是一款专为飞书(Lark)平台设计的命令行代理工具,为 AI 助手提供完整的办公自动化能力。主要涵盖三大核心模块:
日历管理:支持查看多日历列表、查询日程事件、创建带冲突检测的会议(自动调用 FreeBusy API 检查时间冲突),并可邀请参会人。
任务管理:基于飞书多维表格(Bitable)实现待办事项的增删改查,支持优先级设置。
联系人查询:快速检索组织架构中的用户信息。
显著优点
- 官方 API 对接:基于飞书开放平台官方接口,数据安全性和兼容性有保障
- OAuth 2.0 认证:采用标准授权流程,支持自动 token 刷新
- 智能冲突检测:创建会议时自动检测时间冲突,避免日程重叠
- 交互式配置向导:
setup命令提供傻瓜式初始化流程 - AI 原生设计:命令结构和输出格式针对 AI 助手调用场景优化
潜在局限
- 依赖外部环境:必须拥有飞书企业账号并通过开发者控制台配置应用权限
- 本地化回调限制:OAuth 回调固定为
localhost:3000,远程部署需额外处理 - Bitable 前置要求:任务功能需预先配置多维表格结构
- 运行时依赖:需要 Bun 环境,对 Node.js 用户不够友好
适合人群
- 使用飞书作为主力办公协同平台的企业团队
- 需要将日历/任务管理能力集成到 AI 工作流的开发者
- 追求命令行效率的飞书重度用户
常规风险
认证安全:access_token 和 refresh_token 以明文形式存储于本地 ~/.feishu-agent/config.json,在多用户环境中存在泄露风险,建议配合文件权限控制(chmod 600)使用。
权限范围:应用需申请 calendar:event 等敏感权限,企业管理员需审慎评估最小权限原则。