feishu-cli-file

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

飞书云空间文件管理技能

Feishu Drive File Management Skill

管理飞书云空间（Drive）中的文件和文件夹，包括列出、创建、移动、复制、删除操作。

Manage files and folders in Feishu Drive, including listing, creating, moving, copying, and deleting operations.

使用方法

Usage

bash

/feishu-file list [folder_token]         # 列出文件
/feishu-file mkdir <name> [--parent]     # 创建文件夹
/feishu-file move <token> --target       # 移动文件
/feishu-file copy <token> --target       # 复制文件
/feishu-file delete <token>              # 删除文件

bash

/feishu-file list [folder_token]         # List files
/feishu-file mkdir <name> [--parent]     # Create folder
/feishu-file move <token> --target       # Move file
/feishu-file copy <token> --target       # Copy file
/feishu-file delete <token>              # Delete file

CLI 命令详解

Detailed CLI Command Explanations

1. 列出文件夹内容

1. List Folder Contents

bash

undefined

bash

undefined

列出根目录（我的空间）

List root directory (My Space)

feishu-cli file list

列出指定文件夹

List specified folder

feishu-cli file list <folder_token>


**输出示例**：

文件列表（文件夹: root）:

[文件夹] 项目文档 Token: fldcnxxx 修改时间: 2024-01-21 14:30
[docx] 会议纪要 Token: doccnxxx 修改时间: 2024-01-20 10:15
[sheet] 数据表格 Token: shtcnxxx 修改时间: 2024-01-19 16:45


**文件类型**：
| 类型 | 说明 |
|------|------|
| `folder` | 文件夹 |
| `docx` | 云文档 |
| `sheet` | 电子表格 |
| `bitable` | 多维表格 |
| `mindnote` | 思维笔记 |
| `file` | 普通文件 |

feishu-cli file list <folder_token>


**Output Example**:

File List (Folder: root):

[Folder] Project Documents Token: fldcnxxx Modified Time: 2024-01-21 14:30
[docx] Meeting Minutes Token: doccnxxx Modified Time: 2024-01-20 10:15
[sheet] Data Sheet Token: shtcnxxx Modified Time: 2024-01-19 16:45


**File Types**:
| Type | Description |
|------|-------------|
| `folder` | Folder |
| `docx` | Cloud Document |
| `sheet` | Spreadsheet |
| `bitable` | Base (Multi-dimensional Sheet) |
| `mindnote` | Mind Note |
| `file` | Regular File |

2. 创建文件夹

2. Create Folder

bash

undefined

bash

undefined

在根目录创建

Create in root directory

feishu-cli file mkdir "新文件夹"

feishu-cli file mkdir "New Folder"

在指定位置创建

Create in specified location

feishu-cli file mkdir "子文件夹" --parent <folder_token>


**输出示例**：

文件夹创建成功！名称: 新文件夹 Token: fldcnAbCdEfGhIjK 路径: /我的空间/新文件夹

undefined

feishu-cli file mkdir "Subfolder" --parent <folder_token>


**Output Example**:

Folder created successfully! Name: New Folder Token: fldcnAbCdEfGhIjK Path: /My Space/New Folder

undefined

3. 移动文件或文件夹

3. Move File or Folder

bash

undefined

bash

undefined

移动文档

Move document

feishu-cli file move <file_token> --target <folder_token> --type docx

移动文件夹

Move folder

feishu-cli file move <folder_token> --target <parent_folder> --type folder


**参数说明**：
| 参数 | 说明 | 必需 |
|------|------|------|
| `file_token` | 要移动的文件/文件夹 Token | 是 |
| `--target` | 目标文件夹 Token | 是 |
| `--type` | 文件类型（docx/sheet/folder/file 等） | 是 |

**输出示例**：

文件移动成功！文件: doccnAbCdEfGhIjK 目标: fldcnXyZaBcDeFgH

undefined

feishu-cli file move <folder_token> --target <parent_folder> --type folder


**Parameter Explanation**:
| Parameter | Description | Required |
|-----------|-------------|----------|
| `file_token` | Token of the file/folder to move | Yes |
| `--target` | Target folder token | Yes |
| `--type` | File type (docx/sheet/folder/file, etc.) | Yes |

**Output Example**:

File moved successfully! File: doccnAbCdEfGhIjK Target: fldcnXyZaBcDeFgH

undefined

4. 复制文件

4. Copy File

bash

undefined

bash

undefined

复制文档

Copy document

feishu-cli file copy <file_token> --target <folder_token> --type docx

复制并重命名

Copy and rename

feishu-cli file copy <file_token> --target <folder_token> --type docx --name "副本"


**参数说明**：
| 参数 | 说明 | 必需 |
|------|------|------|
| `file_token` | 要复制的文件 Token | 是 |
| `--target` | 目标文件夹 Token | 是 |
| `--type` | 文件类型 | 是 |
| `--name` | 新文件名 | 否 |

**输出示例**：

文件复制成功！原文件: doccnAbCdEfGhIjK 新文件: doccnNewCopyToken 位置: fldcnXyZaBcDeFgH

undefined

feishu-cli file copy <file_token> --target <folder_token> --type docx --name "Copy"


**Parameter Explanation**:
| Parameter | Description | Required |
|-----------|-------------|----------|
| `file_token` | Token of the file to copy | Yes |
| `--target` | Target folder token | Yes |
| `--type` | File type | Yes |
| `--name` | New file name | No |

**Output Example**:

File copied successfully! Original File: doccnAbCdEfGhIjK New File: doccnNewCopyToken Location: fldcnXyZaBcDeFgH

undefined

5. 删除文件或文件夹

5. Delete File or Folder

bash

undefined

bash

undefined

删除文档

Delete document

feishu-cli file delete <file_token> --type docx

删除文件夹（包含内容）

Delete folder (including contents)

feishu-cli file delete <folder_token> --type folder


**注意**：删除操作会将文件移动到回收站，可在 30 天内恢复。

**输出示例**：

文件删除成功！文件: doccnAbCdEfGhIjK 类型: docx

undefined

feishu-cli file delete <folder_token> --type folder


**Note**: Deletion moves the file to the recycle bin, which can be restored within 30 days.

**Output Example**:

File deleted successfully! File: doccnAbCdEfGhIjK Type: docx

undefined

文件类型对照表

File Type Reference Table

--type 参数	说明	示例 Token
`docx`	新版云文档	`doccnXxx`
`doc`	旧版云文档	`docXxx`
`sheet`	电子表格	`shtcnXxx`
`bitable`	多维表格	`bitXxx`
`mindnote`	思维笔记	`mindXxx`
`folder`	文件夹	`fldcnXxx`
`file`	普通文件	`boxcnXxx`

--type Parameter	Description	Example Token
`docx`	New version cloud document	`doccnXxx`
`doc`	Old version cloud document	`docXxx`
`sheet`	Spreadsheet	`shtcnXxx`
`bitable`	Base	`bitXxx`
`mindnote`	Mind Note	`mindXxx`
`folder`	Folder	`fldcnXxx`
`file`	Regular File	`boxcnXxx`

典型工作流

Typical Workflows

整理文档目录

Organize Document Directory

bash

undefined

bash

undefined

1. 查看当前目录结构

1. View current directory structure

feishu-cli file list

2. 创建新文件夹

2. Create new folder

feishu-cli file mkdir "2024年项目"

feishu-cli file mkdir "2024 Projects"

3. 移动文档到新文件夹

3. Move document to new folder

feishu-cli file move doccnXxx --target fldcnXxx --type docx

undefined

feishu-cli file move doccnXxx --target fldcnXxx --type docx

undefined

备份重要文档

Backup Important Documents

bash

undefined

bash

undefined

1. 创建备份文件夹

1. Create backup folder

feishu-cli file mkdir "备份-$(date +%Y%m%d)"

feishu-cli file mkdir "Backup-$(date +%Y%m%d)"

2. 复制文档

2. Copy document

feishu-cli file copy doccnXxx --target fldcnBackup --type docx --name "文档备份"

undefined

feishu-cli file copy doccnXxx --target fldcnBackup --type docx --name "Document Backup"

undefined

权限要求

Permission Requirements

```
drive:drive:readonly
```
- 读取文件列表
```
drive:drive
```
- 文件操作（创建/移动/复制/删除）

```
drive:drive:readonly
```
- Read file list
```
drive:drive
```
- File operations (create/move/copy/delete)