name	feishu-drive
description	飞书云空间文件管理。上传/下载/移动/搜索文件、创建文件夹。
required_permissions	["drive:file:upload","drive:file:download","drive:drive:readonly"]

飞书云空间文件管理

通过 Drive API 管理文件和文件夹。

Base URL: https://open.feishu.cn/open-apis/drive/v1

从 feishu_skills 根目录执行共享脚本：

TOKEN="$(./scripts/get_feishu_token.sh)"

请求头统一使用 Authorization: Bearer ${TOKEN}。

如果业务接口返回 token 无效、过期或 401，强制刷新后仅重试一次原请求：

TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"

环境变量:

本地缓存: ./.feishu_token_cache.json（未过期直接复用，默认提前 5 分钟刷新）

为避免文件进入"私有黑盒"：

⚠️ API 创建的文件夹默认只对机器人可见，需手动添加协作者。

API	端点	方法	请求体示例	说明
创建文件夹	`/folders`	POST	`{"name":"文件夹名","folder_token":"root"}`	创建新文件夹
获取文件夹元数据	`/folders/{folder_token}/meta`	GET	-	查询文件夹详情
获取元数据（批量）	`/metas/batch_query`	POST	`{"request_list":[{"token":"fldxxx","type":"folder"}]}`	批量查询文件/文件夹
获取文件夹内容	`/folders/{folder_token}/children`	GET	-	查询文件夹内文件列表
移动文件夹	`/folders/{folder_token}/move`	POST	`{"target_token":"fldxxx"}`	移动文件夹
复制文件夹	`/folders/{folder_token}/copy`	POST	`{"target_token":"fldxxx"}`	复制文件夹
删除文件夹	`/folders/{folder_token}`	DELETE	-	删除空文件夹

小文件上传:

POST /files/upload_all
Content-Type: multipart/form-data

file_name=test.txt
parent_type=explorer
parent_node=fldXXX
file=<binary>

API	端点	方法	请求体示例	说明
移动文件	`/files/{file_token}/move`	POST	`{"type":"explorer","folder_token":"fldXXX"}`	移动文件
复制文件	`/files/{file_token}/copy`	POST	`{"type":"explorer","folder_token":"fldXXX","name":"副本.txt"}`	复制文件
删除文件	`/files/{file_token}`	DELETE	-	删除文件
创建快捷方式	`/shortcuts`	POST	`{"target_token":"filexxx","parent_token":"fldxxx"}`	创建文件快捷方式
获取文件统计	`/files/{file_token}/statistics`	GET	-	查询文件访问统计

API	端点	方法	请求体示例	说明
搜索文件	`/files/search`	POST	`{"search_key":"关键词","owner_ids":["ou_xxx"]}`	全文搜索
搜索V2	`/files/search_v2`	POST	同上	新版搜索接口

API	端点	方法	请求体示例	说明
添加协作者	`/permissions/{token}/members`	POST	`{"member_type":"user","member_id":"ou_xxx","perm":"full_access"}`	添加权限
移除协作者	`/permissions/{token}/members/{member_id}`	DELETE	-	移除权限
获取协作者	`/permissions/{token}/members`	GET	-	查询权限列表
更新协作者	`/permissions/{token}/members/{member_id}/patch`	PATCH	`{"perm":"edit"}`	修改权限
转让所有者	`/permissions/{token}/transfer_owner`	POST	`{"member_type":"user","member_id":"ou_xxx"}`	转移所有权
获取权限设置	`/permissions/{token}/public`	GET	-	查询公开访问设置
更新权限设置	`/permissions/{token}/public`	PATCH	`{"external_access":false}`	修改公开访问

权限类型: view(查看) / edit(编辑) / full_access(完全访问)

API	端点	方法	请求体示例	说明
获取版本列表	`/files/{file_token}/versions`	GET	-	查询文件历史版本
获取版本详情	`/files/{file_token}/versions/{version_id}`	GET	-	查询指定版本信息
删除版本	`/files/{file_token}/versions/{version_id}`	DELETE	-	删除历史版本

API	端点	方法	请求体示例	说明
获取全文评论	`/files/{file_token}/comments`	GET	-	查询文件所有评论
获取回复列表	`/files/{file_token}/comments/{comment_id}/replies`	GET	-	查询评论的回复
添加全文评论	`/files/{file_token}/comments`	POST	`{"content":{"text":"评论内容"}}`	添加评论
回复评论	`/files/{file_token}/comments/{comment_id}/replies`	POST	`{"content":{"text":"回复内容"}}`	回复评论
解决/重开评论	`/files/{file_token}/comments/{comment_id}`	PATCH	`{"is_solved":true}`	标记评论状态

API	端点	方法	请求体示例	说明
订阅文件	`/files/{file_token}/subscriptions`	POST	`{"subscription_type":"file_edit"}`	订阅文件变更通知
获取订阅状态	`/files/{file_token}/subscriptions/{subscription_id}`	GET	-	查询订阅状态
取消订阅	`/files/{file_token}/subscriptions/{subscription_id}`	DELETE	-	取消订阅

订阅类型: file_edit(文件编辑) / file_comment(评论) / file_share(分享)