feishu-drive

name	feishu-drive
description	飞书云盘/云空间管理。用于列出文件/文件夹、创建文件夹、移动/删除文件、搜索。当用户提到云盘、文件管理、文件夹、整理文件、找文件时触发。注意：读写文档内容用 feishu-doc，云盘管理文件树。

Feishu Drive

浏览、组织和管理飞书云盘中的文件和文件夹。

边界：Drive 管理文件树（文件的位置、组织结构），feishu-doc 管理文档内容（读写文档正文）。

File Types

file_type	说明
docx	文档
sheet	电子表格
bitable	多维表格
folder	文件夹
file	上传文件
mindnote	思维笔记
slides	幻灯片

CLI 调用方式

cd ~/Agent\ Space/agentic-feishu && python3 tools/builtin/skill_drive.py <action> --params '<json>'

示例：

python3 tools/builtin/skill_drive.py list --params '{}'

Actions

调用方式：python3 tools/builtin/skill_drive.py <action> --params '<json>'

• list — 列出文件/文件夹。params: {folder_token?, page_size?=20}。不传 folder_token 则列根目录。
• search — 按关键词搜索文件。params: {query, count?=10}。关键词匹配文件名。
• create_folder — 创建文件夹。params: {name, parent_token, force?=false}。parent_token 必填。自动去重（见 Coded Behaviors）；自动授予创建者 full_access。
• move — 移动文件/文件夹。params: {file_token, target_folder_token}。两个参数均必填。
• delete — 删除文件/文件夹（移入回收站，30 天内可恢复，非永久删除）。params: {file_token, file_type, confirmed?=false}。两段式确认（见 Coded Behaviors）。file_type 取值见上表。

Coded Behaviors

Auto-dedup on create_folder：创建文件夹前自动检查 parent_token 下是否已存在同名文件夹。若存在，返回重复信息（含已有文件夹的 token）而不创建，除非传 force=true。未提供 parent_token 时跳过去重检查。

Auto-share on create_folder：创建成功后自动调用 ensure_user_access，授予创建者 full_access。此步骤失败不阻塞主流程。

Confirmation-gated delete（两段式）：第一次调用返回确认提示，不执行删除；第二次传 confirmed=true 才真正执行。目的是防误删。

Delete = trash：删除操作将文件移入回收站，30 天内可从回收站恢复，期满后不可逆。

Params Examples

feishu_drive("list", {"folder_token": "fldcnXXX", "page_size": 50})
feishu_drive("list", {})                                                          # 列根目录
feishu_drive("create_folder", {"name": "项目文档", "parent_token": "fldcnXXX"})
feishu_drive("create_folder", {"name": "项目文档", "parent_token": "fldcnXXX", "force": true})  # 跳过去重
feishu_drive("delete", {"file_token": "xxx", "file_type": "docx"})               # 第一次：返回确认提示
feishu_drive("delete", {"file_token": "xxx", "file_type": "docx", "confirmed": true})  # 第二次：执行删除
feishu_drive("search", {"query": "周报", "count": 20})
feishu_drive("move", {"file_token": "xxx", "target_folder_token": "fldcnYYY"})