feishu_drive_file
Manage files in Feishu Drive by listing, copying, moving, deleting, uploading, or downloading documents, sheets, and other file types.
Instructions
【以用户身份】飞书云空间文件管理工具。当用户要求查看云空间(云盘)中的文件列表、获取文件信息、复制/移动/删除文件、上传/下载文件时使用。消息中的文件读写禁止使用该工具!
Actions:
list（列出文件）：列出文件夹下的文件。不提供 folder_token 时获取根目录清单
get_meta（批量获取元数据）：批量查询文档元信息，使用 request_docs 数组参数，格式：[{doc_token: '...', doc_type: 'sheet'}]
copy（复制文件）：复制文件到指定位置
move（移动文件）：移动文件到指定文件夹
delete（删除文件）：删除文件
upload（上传文件）：上传本地文件到云空间。提供 file_path（本地文件路径）或 file_content_base64（Base64 编码）
download（下载文件）：下载文件到本地。提供 output_path（本地保存路径）则保存到本地，否则返回 Base64 编码
【重要】copy/move/delete 操作需要 file_token 和 type 参数。get_meta 使用 request_docs 数组参数。 【重要】upload 优先使用 file_path（自动读取文件、提取文件名和大小），也支持 file_content_base64（需手动提供 file_name 和 size）。 【重要】download 提供 output_path 时保存到本地（可以是文件路径或文件夹路径+file_name），不提供则返回 Base64。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | ||
| folder_token | No | 文件夹 token（可选）。不填写或填空字符串时，获取用户云空间根目录下的清单（注意：根目录模式不支持分页和返回快捷方式） | |
| page_size | No | 分页大小（默认 200，最大 200） | |
| page_token | No | 分页标记。首次请求无需填写 | |
| order_by | No | 排序方式：EditedTime（编辑时间）、CreatedTime（创建时间） | |
| direction | No | 排序方向：ASC（升序）、DESC（降序） | |
| request_docs | No | 要查询的文档列表（批量查询，最多 50 个）。示例：[{doc_token: 'Z1FjxxxxxxxxxxxxxxxxxxxtnAc', doc_type: 'sheet'}] | |
| file_token | No | 文件 token（必填） | |
| name | No | 目标文件名（必填） | |
| type | No | 文档类型（必填） | |
| parent_node | No | 【folder_token 的别名】目标文件夹 token（为兼容性保留，建议使用 folder_token） | |
| file_path | No | 本地文件路径（与 file_content_base64 二选一）。优先使用此参数，会自动读取文件内容、计算大小、提取文件名。 | |
| file_content_base64 | No | 文件内容的 Base64 编码（与 file_path 二选一）。当不提供 file_path 时使用。 | |
| file_name | No | 文件名（可选）。如果提供了 file_path，会自动从路径中提取文件名；如果使用 file_content_base64，则必须提供此参数。 | |
| size | No | 文件大小（字节，可选）。如果提供了 file_path，会自动计算；如果使用 file_content_base64，则必须提供此参数。 | |
| output_path | No | 本地保存的完整文件路径（可选）。必须包含文件名和扩展名，例如 '/tmp/file.pdf'。如果不提供，则返回 Base64 编码的文件内容。 |