飞书官方开放平台 API 集成工具箱，支持文档读写、群聊历史获取、文件发送、截图推送、权限管理及定时提醒，适合企业协作自动化场景。
说明：
## 核心功能
**feishu-toolkit** 是一套面向 AI Agent 的飞书（Lark）全功能集成方案，覆盖文档、通讯、文件、权限、定时任务五大维度：
### 文档操作（Document Operations）
支持读取、创建、覆盖写入及追加编辑飞书文档（Doc/Docx）、表格（Sheet）、多维表格（Bitable）及 Wiki。针对超长文档，采用分块追加策略避免单请求超限。Wiki URL 可通过 `/wiki/v2/spaces/get_node` 解析为实际文档 token。
### 群聊历史（Chat History）
基于 `/im/v1/messages` 接口获取群聊消息，支持分页拉取（默认 50 条/页），自动解析 text/interactive/image/system 等消息类型，可生成对话摘要。
### 文件发送（File Sending）
通过 `multipart/form-data` 上传文件（支持 opus/mp4/pdf/doc/xls/ppt/stream 等类型），获取 `file_key` 后以消息形式发送至指定会话。
### 截图推送（Screenshot）
调用 macOS `screencapture` 工具捕获屏幕，经 `/im/v1/images` 上传后推送至飞书聊天，适用于即时信息同步与故障反馈。
### 权限管理（Permission Management）
基于 `/drive/v1/permissions` 实现协作者列表查询、添加、移除，支持 view/edit/full_access 三级权限，兼容 email/openid/userid/unionid 等多种成员标识。
### 定时提醒（Cron Reminders）
封装 cron 语法创建周期性任务，支持自然语言间隔（如 `every 30m`）及标准 cron 表达式，可向指定会话或当前 IM 对话发送提醒。
## 显著优点
– **功能完整**：单一套件覆盖飞书高频 API 场景，无需多工具切换
– **官方协议**：基于飞书开放平台标准 REST API，稳定性有保障
– **分块处理**：长文档追加写入机制，规避 LLM 输出长度限制
– **跨端支持**：截图功能原生支持 macOS，其他平台可扩展
## 局限性与风险
– **平台绑定**：深度依赖飞书生态，迁移成本较高
– **认证门槛**：需企业管理员在开放平台创建应用并授予敏感权限（如 `im:resource`、`drive:permission`）
– **截图局限**：当前仅实现 macOS 方案，Linux/Windows 需自行适配
– **权限敏感**：`full_access` 权限可修改协作者列表，误操作可能导致信息泄露
– **定时任务持久化**：cron 任务依赖外部调度系统（如 system cron 或容器 cron），Skill 本身不保证任务状态持久化
## 适用人群
– 需将 AI Agent 接入飞书工作流的企业开发者
– 希望自动化文档协作、会议提醒、信息同步的飞书重度用户
– 有飞书管理员权限、能独立配置 App ID/Secret 的技术团队
## 常规风险
| 风险点 | 说明 | 缓解建议 |
|——–|——|———-|
| 凭据泄露 | `FEISHU_APP_SECRET` 泄露可导致 API 滥用 | 使用环境变量/密钥管理服务，避免硬编码 |
| 过度授权 | 申请过多权限增加攻击面 | 按最小权限原则申请，如无需权限管理则不开通 `drive:permission` |
| 消息轰炸 | cron 配置不当导致高频推送 | 设置合理间隔，上线前测试验证 |
| 数据合规 | 群聊历史可能含敏感信息 | 遵循企业数据安全规范，脱敏处理后存储/分析 |
会员专属
