القائمة
飞书云空间文件管理。上传/下载/移动/搜索文件、创建文件夹。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
飞书多维表格操作。记录 CRUD、字段管理、视图、权限、公式、关联。
飞书日历。创建日程、查询日程、更新日程。
飞书审批。创建审批实例、查询审批状态。
飞书交互卡片。构建和发送带按钮/选择器的消息卡片。
飞书组织架构与 ID 转换。搜索成员、部门管理、ID 互转（OpenID/UserID/UnionID）。
飞书文档写入。Markdown 转 Block、创建文档块、处理并发，支持 Mermaid 绘图块。
استنادا إلى تصنيف SOC المهني
| name | feishu-drive |
| description | 飞书云空间文件管理。上传/下载/移动/搜索文件、创建文件夹。 |
| required_permissions | ["drive:file:upload","drive:file:download","drive:drive:readonly"] |
通过 Drive API 管理文件和文件夹。
Base URL: https://open.feishu.cn/open-apis/drive/v1
从 feishu_skills 根目录执行共享脚本：
TOKEN="$(./scripts/get_feishu_token.sh)"
请求头统一使用 Authorization: Bearer ${TOKEN}。
如果业务接口返回 token 无效、过期或 401，强制刷新后仅重试一次原请求：
TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"
环境变量:
FEISHU_APP_IDFEISHU_APP_SECRET本地缓存: ./.feishu_token_cache.json（未过期直接复用，默认提前 5 分钟刷新）
为避免文件进入"私有黑盒"：
AI-Workspace）batch_query 查询该 Token⚠️ API 创建的文件夹默认只对机器人可见，需手动添加协作者。
| API | 端点 | 方法 | 请求体示例 | 说明 |
|---|---|---|---|---|
| 创建文件夹 | /folders | POST | {"name":"文件夹名","folder_token":"root"} | 创建新文件夹 |
| 获取文件夹元数据 | /folders/{folder_token}/meta | GET | - | 查询文件夹详情 |
| 获取元数据（批量） | /metas/batch_query | POST | {"request_list":[{"token":"fldxxx","type":"folder"}]} | 批量查询文件/文件夹 |
| 获取文件夹内容 | /folders/{folder_token}/children | GET | - | 查询文件夹内文件列表 |
| 移动文件夹 | /folders/{folder_token}/move | POST | {"target_token":"fldxxx"} | 移动文件夹 |
| 复制文件夹 | /folders/{folder_token}/copy | POST | {"target_token":"fldxxx"} | 复制文件夹 |
| 删除文件夹 | /folders/{folder_token} | DELETE | - | 删除空文件夹 |
| API | 端点 | 方法 | 请求体 | 说明 |
|---|---|---|---|---|
| 小文件上传 | /files/upload_all | POST | multipart/form-data | 一次性上传（<20MB） |
| 大文件预上传 | /files/upload_prepare | POST | {"file_name":"big.zip","size":104857600} | 初始化分片上传 |
| 分片上传 | /files/upload_part | POST | multipart/form-data | 上传单个分片 |
| 完成分片上传 | /files/upload_finish | POST | {"upload_id":"xxx","block_num":10} | 完成上传 |
小文件上传:
POST /files/upload_all
Content-Type: multipart/form-data
file_name=test.txt
parent_type=explorer
parent_node=fldXXX
file=<binary>
| API | 端点 | 方法 | 说明 |
|---|---|---|---|
| 下载文件 | /files/{file_token}/download | GET | 返回文件二进制流 |
| 获取文件元数据 | /files/{file_token}/meta | GET | 查询文件详情 |
| 获取文件列表 | /files | GET | 参数：folder_token 父文件夹 |
| API | 端点 | 方法 | 请求体示例 | 说明 |
|---|---|---|---|---|
| 移动文件 | /files/{file_token}/move | POST | {"type":"explorer","folder_token":"fldXXX"} | 移动文件 |
| 复制文件 | /files/{file_token}/copy | POST | {"type":"explorer","folder_token":"fldXXX","name":"副本.txt"} | 复制文件 |
| 删除文件 | /files/{file_token} | DELETE | - | 删除文件 |
| 创建快捷方式 | /shortcuts | POST | {"target_token":"filexxx","parent_token":"fldxxx"} | 创建文件快捷方式 |
| 获取文件统计 | /files/{file_token}/statistics | GET | - | 查询文件访问统计 |
| API | 端点 | 方法 | 请求体示例 | 说明 |
|---|---|---|---|---|
| 搜索文件 | /files/search | POST | {"search_key":"关键词","owner_ids":["ou_xxx"]} | 全文搜索 |
| 搜索V2 | /files/search_v2 | POST | 同上 | 新版搜索接口 |
| API | 端点 | 方法 | 请求体示例 | 说明 |
|---|---|---|---|---|
| 添加协作者 | /permissions/{token}/members | POST | {"member_type":"user","member_id":"ou_xxx","perm":"full_access"} | 添加权限 |
| 移除协作者 | /permissions/{token}/members/{member_id} | DELETE | - | 移除权限 |
| 获取协作者 | /permissions/{token}/members | GET | - | 查询权限列表 |
| 更新协作者 | /permissions/{token}/members/{member_id}/patch | PATCH | {"perm":"edit"} | 修改权限 |
| 转让所有者 | /permissions/{token}/transfer_owner | POST | {"member_type":"user","member_id":"ou_xxx"} | 转移所有权 |
| 获取权限设置 | /permissions/{token}/public | GET | - | 查询公开访问设置 |
| 更新权限设置 | /permissions/{token}/public | PATCH | {"external_access":false} | 修改公开访问 |
权限类型: view(查看) / edit(编辑) / full_access(完全访问)
| API | 端点 | 方法 | 请求体示例 | 说明 |
|---|---|---|---|---|
| 获取版本列表 | /files/{file_token}/versions | GET | - | 查询文件历史版本 |
| 获取版本详情 | /files/{file_token}/versions/{version_id} | GET | - | 查询指定版本信息 |
| 删除版本 | /files/{file_token}/versions/{version_id} | DELETE | - | 删除历史版本 |
| API | 端点 | 方法 | 请求体示例 | 说明 |
|---|---|---|---|---|
| 获取全文评论 | /files/{file_token}/comments | GET | - | 查询文件所有评论 |
| 获取回复列表 | /files/{file_token}/comments/{comment_id}/replies | GET | - | 查询评论的回复 |
| 添加全文评论 | /files/{file_token}/comments | POST | {"content":{"text":"评论内容"}} | 添加评论 |
| 回复评论 | /files/{file_token}/comments/{comment_id}/replies | POST | {"content":{"text":"回复内容"}} | 回复评论 |
| 解决/重开评论 | /files/{file_token}/comments/{comment_id} | PATCH | {"is_solved":true} | 标记评论状态 |
| API | 端点 | 方法 | 请求体示例 | 说明 |
|---|---|---|---|---|
| 订阅文件 | /files/{file_token}/subscriptions | POST | {"subscription_type":"file_edit"} | 订阅文件变更通知 |
| 获取订阅状态 | /files/{file_token}/subscriptions/{subscription_id} | GET | - | 查询订阅状态 |
| 取消订阅 | /files/{file_token}/subscriptions/{subscription_id} | DELETE | - | 取消订阅 |
订阅类型: file_edit(文件编辑) / file_comment(评论) / file_share(分享)