Feishu Drive File

飞书云空间文件管理

Standalone Wrapper

• 共享环境变量：FEISHU_APP_ID、FEISHU_APP_SECRET，可选 FEISHU_BASE_URL、FEISHU_OAUTH_STORE_DIR
• feishu_drive_file -> node scripts/drive-file.js '<json>'

执行前必读

• 本 skill 管的是“云空间文件”，不是 IM 消息里的附件；消息附件请用 feishu-im-read
• copy / move / delete 都要求同时提供 file_token 和 type
• get_meta 使用 request_docs 数组，一次最多 50 个
• upload 优先用 file_path；只有在无法直接读本地文件时才用 file_content_base64

快速索引：意图 → 工具 → 必填参数

核心约束（Schema 未透露的知识）

1. 云空间文件和消息附件不是一回事

• feishu-drive-file 面向云盘、文档、文件夹
• 聊天消息中的 file_key / image_key 资源，不要拿来这里下载
• 如果用户说的是“群里那条消息里的文件”，应该转到 feishu-im-read

2. 根目录模式和文件夹模式行为不同

• list 不传 folder_token 或传空字符串时，列的是用户云空间根目录
• 根目录模式下，飞书原生返回行为和普通文件夹不完全一致，尤其是分页与快捷方式表现
• 如果用户要稳定分页结果，优先定位到具体 folder_token

3. type 不是可省略提示，而是写操作必填锚点

传错 type 往往会导致 copy、move、delete 直接失败。

4. 上传有两种输入方式，但优先级不同

• 提供 file_path 时，工具会自动读文件、计算大小、提取文件名
• 只有在不能直接访问本地文件时，才使用 file_content_base64
• 使用 file_content_base64 时必须自己补齐 file_name 和 size

5. 下载既可以落地，也可以回传内容

• 提供 output_path 时，文件会保存到本地
• 不提供 output_path 时，工具返回 Base64 内容，更适合后续程序化处理

使用场景示例

场景 1：列出某个文件夹的文件

{
  "action": "list",
  "folder_token": "fld_xxx",
  "page_size": 100
}

场景 2：批量获取元数据

{
  "action": "get_meta",
  "request_docs": [
    { "doc_token": "sht_xxx", "doc_type": "sheet" },
    { "doc_token": "dox_xxx", "doc_type": "docx" }
  ]
}

场景 3：上传本地文件到云空间

{
  "action": "upload",
  "parent_node": "fld_xxx",
  "file_path": "/tmp/spec.pdf"
}

场景 4：下载文件到本地

{
  "action": "download",
  "file_token": "box_xxx",
  "output_path": "/tmp/spec.pdf"
}

常见错误与排查

官方文档参考

• 云空间能力概述: https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/files/guide/introduction
• 文件夹中文件清单: https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/list
• 批量获取文件元数据: https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/meta/batch_query
• 上传文件: https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/upload_all
• 下载文件: https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/download