feishu-cli-storage

用途

本技能面向飞书云空间（Drive）与文件/媒体、Wiki、评论、权限等资源的命令行操作，通过 feishu-cli 完成上传、下载、导入导出、镜像、版本管理、节点解析、评论与授权等任务。

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

加载工作流后，将 references/、scripts/、templates/、examples/ 相对路径按 workflow.md 所在目录解析，执行脚本使用解析后的实际路径。
路由：读取文件、大文件分块等见 references/workflows/drive/workflow.md；文件夹浏览、基础 file CRUD 等见 references/workflows/file-media/workflow.md；wiki 相关见 references/workflows/wiki/workflow.md；评论见 references/workflows/comment/workflow.md；权限见 references/workflows/perm/workflow.md。
身份规则：perm 全组默认 Bot，操作用户自己的文档加 --as user；file/wiki 写类默认 Bot，只认显式 --user-access-token；comment 读与 add/resolve 默认 User 优先，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。
规则：/wiki/ 链接或类型不明 token 先 drive inspect --url 解析，Bitable 链接用 bitable resolve；wiki 节点交给需要 node_token 的命令前先换出 node_token；基础操作优先 file/media，需分块、断点、URL/wiki 解包、原地覆盖、版本历史、镜像或异步任务时使用 drive；上传文件的历史版本（长数字 version）与在线文档命名版本不要混用。

需要批量上传下载、目录镜像同步、异步导入导出、版本管理与回滚、wiki 节点迁移、评论协作以及权限授予等飞书云空间操作时使用。

删除、移动、覆盖、--delete-local/--delete-remote、转移所有权和删除知识空间属高风险操作：先确认目标，再带命令的确认参数；非交互环境未带 --yes（或命令级 --force）时以退出码 10 拒绝执行，不代表成功。wiki delete 默认级联删除整棵子树。
删除、覆盖类命令返回退出码 10 时，向用户确认目标与影响后追加全局 --yes 重跑，不要自行添加。
读类或镜像命令遇 99991679（User Token 缺 drive 读 scope）时，资源对应用可见可显式 --as bot，否则补授权；带 --delete-* 时已配置但不可用的 User Token 会 fail-closed，不降级 Bot。
身份或 scope 报错（如 99991663/99991668/99991672/99991679）读取 ../feishu-cli-platform/references/workflows/auth/references/identity.md；判断成败、编写脚本或处理确认门禁读取 ../feishu-cli-platform/references/workflows/auth/references/agent-contract.md。
非交互环境未带 --yes（或命令级 --force）时以退出码 10 拒绝执行，不代表成功。
定价、安装命令等未在资料中提供。