飞书云空间(也常被称为云盘、云存储、网盘或我的空间)是飞书官方的云端文件存储与管理中心。本技能用于管理 Drive 文件与文件夹,覆盖上传、下载、创建文件夹、复制、移动、删除、查看元数据、查询权限设置、评论、订阅、标题修改、版本管理、密级标签以及本地文件导入等操作。
使用方式:本技能基于 lark-cli drive 命令及一系列 Shortcut(如 +search、+upload、+create-folder、+download、+preview、+copy、+move、+delete、+export、+import、+version-history 等)提供操作能力。开始前需先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证与权限处理。使用原生 API 时,必须先运行 schema 查看参数结构,不要猜测字段格式。
主要能力:
- 文件与文件夹管理:上传、下载、创建文件夹、复制、移动、删除、重命名、创建快捷方式。
- 搜索与识别:搜索文档、Wiki、表格、文件夹等云空间对象;检视 URL 的类型、标题和 canonical token,wiki URL 会自动解包到底层文档。
- 导入导出:将本地文件导入为飞书在线文档、表格、多维表格或幻灯片;将 doc/docx/sheet/bitable/slides 导出为本地文件。
- 版本管理:查看、下载、回滚、删除文件历史版本。
- 评论操作:添加、列表、批量查询、回复、解决、恢复评论及 reaction。
- 权限管理:查询权限设置、添加/移除协作者、申请访问权限、密级标签管理。
- 同步:比较本地目录与 Drive 文件夹差异,双向同步、拉取、推送。
适用场景:整理云盘目录、处理云空间资源 URL/token、判断链接类型、导入本地文件、复制在线文档、治理文档权限、按主题跨范围查找并集中归档、盘点目录结构等。
限制与注意事项:
- 高风险写操作(删除、公开权限修改、owner 转移、版本删除/回滚、批量移动/覆盖/同步)必须同时满足目标已解析、执行细节明确、用户本轮明确确认三个条件才执行。
- 批量导入到同一位置时必须串行执行,避免并发冲突。
- 文档正文读取、总结、创建、编辑等使用 lark-doc;电子表格表内操作使用 lark-sheets;Base 内部操作使用 lark-base;知识空间与 Wiki 节点层级管理使用 lark-wiki;原生 Markdown 文件操作使用 lark-markdown。
- 部分命令仅支持特定身份(如 quota_details get 仅支持 --as user)。
- 具体收费、价格、平台支持范围等事实暂未提供。