/feishu-cli-storage

name: feishu-cli-storage
description: >-
  飞书云空间：Drive 上传下载（大文件分块、断点续传、覆盖为新版本）、DOCX/XLSX 等二进制导入与异步导出任务、目录镜像 push/pull、链接与 token 类型解析、重命名、上传文件的版本历史与恢复、基础 file/media 操作、Wiki 知识空间与节点结构（创建、移动、复制、删除）及成员、文档评论与回复（含表格/幻灯片局部评论）、协作者/公开链接/分享密码/转移所有权/权限申请与密级标签。用户提到云盘、文件夹、上传下载、导入 Office 文件、知识库目录、评论、共享或权限时使用。不用于：读取或改写文档/Wiki 正文和云盘原生 .md 文件（feishu-cli-docs）、会议录制与妙记（feishu-cli-meetings）、搜索文档（feishu-cli-platform）。
compatibility: Requires feishu-cli v1.44.0+ and network access for Feishu API calls.
allowed-tools: Bash(feishu-cli:*) Bash(./feishu-cli:*) Bash(./bin/feishu-cli:*) Bash(jq:*) Read Write

飞书云空间

加载工作流后，将其中 `references/`、`scripts/`、`templates/`、`examples/` 相对路径按该 `workflow.md` 所在目录解析；执行脚本时使用解析后的实际路径，不要依赖当前 shell 目录。

路由

| 意图 | 读取文件 | |---|---| | 大文件分块上传、原地覆盖上传、流式/断点下载、URL 或 wiki 包装文件下载 | `references/workflows/drive/workflow.md` | | 解析 URL/裸 token 的类型与标题（`drive inspect`）、重命名文件/文件夹/文档/wiki 节点（`drive update-title`） | `references/workflows/drive/workflow.md` | | 上传文件（type=file）的版本历史与按版本下载（`drive version-history/version-get`） | `references/workflows/drive/workflow.md` | | 上传文件预览产物与封面（`drive preview/cover`） | `references/workflows/drive/workflow.md` | | 异步导入导出与续查（`drive import/export/export-download/task-result`）、文件夹移动、目录镜像（pull/push/status） | `references/workflows/drive/workflow.md` | | 文件夹浏览与分页、基础 file CRUD、快捷方式、元数据/统计、容量（`file quota`）、文档素材上传下载 | `references/workflows/file-media/workflow.md` | | 在线文档命名版本（`file version list/create/get/delete`）与上传文件回滚（`file version revert`） | `references/workflows/file-media/workflow.md` | | wiki 空间、节点解析（obj_token/URL）、创建/移动/复制/删除、云盘与知识库互移、成员、递归导出 | `references/workflows/wiki/workflow.md` | | 评论列出、读取、回复、编辑回复、表情回应、解决和取消解决；创建富文本/局部/单元格/记录/幻灯片评论（`drive add-comment`） | `references/workflows/comment/workflow.md` | | 协作者、公开权限、分享密码、转移所有权、权限检查、Bot 创建后的自动授权（`permission_grant`）；向所有者申请权限（`drive apply-permission`）、密级标签（`drive secure-label`） | `references/workflows/perm/workflow.md` |

按文件夹、知识库或创建者搜索文档（`drive search`）属于 `feishu-cli-platform` 的 search 工作流。

执行规则

1. `/wiki/` 链接或类型不明的 token 先 `drive inspect --url` 解析；Bitable 链接用 `bitable resolve`。wiki 节点交给需要 node_token 的命令前先换出 node_token（见规则 6）。 2. 基础文件操作优先 file/media；需要分块、断点、URL/wiki 解包、原地覆盖、版本历史、镜像或异步任务时使用 drive。 上传文件的历史版本（`drive version-history`，长数字 version）与在线文档命名版本（`file version`）不要混用。 3. 删除、移动、覆盖、`--delete-local/--delete-remote`、转移所有权和删除知识空间属于高风险操作：先确认目标，再带命令的确认参数； 非交互环境未带 `--yes`（或命令级 `--force`）时以退出码 10 拒绝执行，不代表成功。`wiki delete` 默认级联删除整棵子树。 4. 身份：perm 全组默认 Bot，操作用户自己的文档加 `--as user`（不读 `FEISHU_USER_ACCESS_TOKEN`），Bot 报 1063002/1063004 时改用 User； file/wiki 写类默认 Bot，只认显式 `--user-access-token`，Bot 移动、删除用户自有文件会失败；comment 读与 add/resolve 默认 User 优先， `comment reply add/update/react/delete` 默认 Bot 且必须与回复作者同身份；`drive add-comment/secure-label/apply-permission`、 `file quota`、`wiki space-create` 必须 User；`drive upload/download` 默认要求 User，可 `--as bot`；`drive preview/cover` 的 `--as` 默认 auto。 5. 读类或镜像命令遇 99991679（User Token 缺 drive 读 scope）时，资源对应用可见可显式 `--as bot`，否则补授权；带 `--delete-*` 时 已配置但不可用的 User Token 会 fail-closed，不降级 Bot。异步任务续查沿用原命令输出里的 `--as`。 6. wiki `get/update/move/export/export-tree/delete` 接受 node_token、已挂载文档的 obj_token 或 URL；`move-to-drive`、`node-copy`、 `nodes --parent`、`drive update-title --type wiki`、`perm --doc-type wiki` 只接受 node_token，先 `wiki get` 换出。 7. Bot 身份新建文件、文件夹、文档或 wiki 节点后会自动给当前 CLI 登录用户授 `full_access`（JSON `permission_grant`）， 交付给其他人仍需 `perm add`。

删除、覆盖类命令返回退出码 10 时，向用户确认目标与影响后追加全局 `--yes` 重跑，不要自行添加。身份或 scope 报错（如 99991663/99991668/99991672/99991679）读取 `../feishu-cli-platform/references/workflows/auth/references/identity.md`；判断成败、编写脚本或处理确认门禁读取 `../feishu-cli-platform/references/workflows/auth/references/agent-contract.md`。