feishu-cli-storage
飞书云空间:Drive 上传下载(大文件分块、断点续传、覆盖为新版本)、DOCX/XLSX 等二进制导入与异步导出任务、目录镜像 push/pull、链接与 token 类型解析、重命名、上传文件的版本历史与恢复、基础 file/media 操作、Wiki 知识空间与节点结构(创建、移动、复制、删除)及成员、文档评论与回复(含表格/幻灯片局部评论)、协作者/公开链接/分享密码/转移所有权/权限申请与密级标签。用户提到云盘、文件夹、上传下载、导入 Office 文件、知识库目录、评论、共享或权限时使用。不用于:读取或改写文档/Wiki 正文和云盘原生 .md 文件(feishu-cli-docs)、会议录制与妙记(feishu-cli-meetings)、搜索文档(feishu-cli-platform)。
How do I install this agent skill?
npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-storageIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides instructions for managing Feishu (Lark) storage via a command-line interface. It includes security features like mandatory confirmation for deletions and prevents access to sensitive local folders. While it processes untrusted data like file names and comments, it incorporates safeguards to mitigate potential injection risks.
- Socketwarn
1 alert: gptSecurity
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
飞书云空间
加载工作流后,将其中 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 工作流。
执行规则
/wiki/链接或类型不明的 token 先drive inspect --url解析;Bitable 链接用bitable resolve。wiki 节点交给需要 node_token 的命令前先换出 node_token(见规则 6)。- 基础文件操作优先 file/media;需要分块、断点、URL/wiki 解包、原地覆盖、版本历史、镜像或异步任务时使用 drive。
上传文件的历史版本(
drive version-history,长数字 version)与在线文档命名版本(file version)不要混用。 - 删除、移动、覆盖、
--delete-local/--delete-remote、转移所有权和删除知识空间属于高风险操作:先确认目标,再带命令的确认参数; 非交互环境未带--yes(或命令级--force)时以退出码 10 拒绝执行,不代表成功。wiki delete默认级联删除整棵子树。 - 身份: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。 - 读类或镜像命令遇 99991679(User Token 缺 drive 读 scope)时,资源对应用可见可显式
--as bot,否则补授权;带--delete-*时 已配置但不可用的 User Token 会 fail-closed,不降级 Bot。异步任务续查沿用原命令输出里的--as。 - 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换出。 - Bot 身份新建文件、文件夹、文档或 wiki 节点后会自动给当前 CLI 登录用户授
full_access(JSONpermission_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。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/riba2534/feishu-cli/feishu-cli-storage">View feishu-cli-storage on skillZs</a>