feishu-drive

Feishu Drive 工具

用于云存储操作的单一工具 feishu_drive。

令牌提取

从 URL https://xxx.feishu.cn/drive/folder/ABC123 → folder_token = ABC123

操作

列出文件夹内容

{ "action": "list" }

根目录（无 folder_token）。

{ "action": "list", "folder_token": "fldcnXXX" }

返回：包含令牌、名称、类型、URL 和时间戳的文件。

获取文件信息

{ "action": "info", "file_token": "ABC123", "type": "docx" }

在根目录中搜索文件。注意：文件必须位于根目录中，或先使用 list 浏览文件夹。

type：doc、docx、sheet、bitable、folder、file、mindnote、shortcut

创建文件夹

{ "action": "create_folder", "name": "New Folder" }

在父文件夹中：

{ "action": "create_folder", "name": "New Folder", "folder_token": "fldcnXXX" }

移动文件

{ "action": "move", "file_token": "ABC123", "type": "docx", "folder_token": "fldcnXXX" }

删除文件

{ "action": "delete", "file_token": "ABC123", "type": "docx" }

文件类型

类型	描述
doc	旧格式文档
docx	新格式文档
sheet	电子表格
bitable	多维表格
folder	文件夹
file	已上传的文件
mindnote	思维导图
shortcut	快捷方式

配置

channels:
  feishu:
    tools:
      drive: true  # default: true

权限

• drive:drive - 完全访问权限（创建、移动、删除）
• drive:drive:readonly - 只读（列表、信息）

已知限制

• 机器人没有根文件夹：Feishu 机器人使用 tenant_access_token，没有自己的“我的空间”。根文件夹的概念仅适用于用户帐户。这意味着：
  • 不带 folder_token 的 create_folder 会失败（400 错误）
  • 机器人只能访问已与其共享的文件/文件夹
  • 解决方法：用户必须先手动创建文件夹并与机器人共享，然后机器人才能在其中创建子文件夹