用途:通过飞书 Drive API 管理云空间中的文件与文件夹,接口基址为 https://open.feishu.cn/open-apis/drive/v1。
主要能力:文件夹的创建、元数据查询、批量查询、内容列表、移动、复制、删除;文件的小文件上传(<20MB)与分片上传(预上传、分片、完成)、下载、元数据查询、列表、移动、复制、删除、创建快捷方式、访问统计;文件搜索(/files/search 与 /files/search_v2);权限管理(添加、移除、获取、更新协作者,转让所有者,公开访问设置);文件版本管理(列表、详情、删除);文件评论(全文评论、回复、解决/重开);订阅管理(订阅、查询、取消,类型含 file_edit、file_comment、file_share)。
使用方式:从 feishu_skills 根目录执行共享脚本获取 Token:TOKEN="$(./scripts/get_feishu_token.sh)",请求头统一使用 Authorization: Bearer ${TOKEN}。若接口返回 token 无效、过期或 401,强制刷新后仅重试一次原请求:TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"。需配置环境变量 FEISHU_APP_ID、FEISHU_APP_SECRET,本地缓存为 ./.feishu_token_cache.json(未过期直接复用,默认提前 5 分钟刷新)。快速启动建议:创建锚点文件夹(如 AI-Workspace),在文件夹【协作】设置中添加应用为【管理】权限,复制文件夹 URL 中的 Token,再调用 batch_query 查询该 Token 测试。
适用场景:需要以程序化方式在飞书云空间批量管理文件、同步资料、维护权限与版本、跟踪评论与变更通知的自动化流程。
限制:API 创建的文件夹默认只对机器人可见,需手动添加协作者;删除文件夹仅支持空文件夹;小文件上传适用于 20MB 以下,大文件需使用分片上传;权限类型为 view、edit、full_access。其余未在资料中说明的细节暂未提供。