lark-drive
飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用；doubao.com 云空间 URL/token 也按资源路径和 token 路由，不回退 WebFetch。不负责：文档内容编辑（走 l
By larksuite · 441,117 installs
npx skills add larksuite/cli --skill lark-drive
Source repository · Upstream listing
drive (v1)
CRITICAL — 开始前 MUST 先用 Read 工具读取 [ ../lark shared/SKILL.md ](../lark shared/SKILL.md)，其中包含认证、权限处理
术语说明： 飞书云空间也常被称为"云盘"、"云存储"、"网盘"或"我的空间"，这些说法通常指的是同一个产品，是飞书官方的云端文件存储与管理中心。
导入分流规则： 如果用户要把本地 Excel / CSV / .base 快照导入成 Base / 多维表格 / bitable，必须优先使用 lark cli drive +import type bitable 。不要先切到 lark base ； lark base 只负责导入完成后的表内操作。
副本分流规则： 如果用户要复制在线文档、创建文档副本、把文档复制到另一个文件夹，必须使用 lark cli drive +copy 。不要用 drive +export 下载后再 drive +import 上传，也不要用 docs +fetch + docs +create 重建正文；导出/导入只用于本地文件转换或离线产物。
快速决策
用户要把 已有 Wiki 节点移出知识库，放到 Drive 文件夹或“我的空间”根目录 ：切到 lark wiki ，使用 lark cli wiki +move to drive ；不要把 Wiki token 直接交给 drive +move 。这是会改变文档归属和权限继承的写操作，执行前确认源节点与目标位置。
用户要 复制文档 / 创建副本 到云盘或者文件夹 时：已提供可直接使用的 URL 或 token，按 [ references/lark drive copy.md ](references/lark drive copy.md) 使用 lark cli drive +copy ；仅提供标题时，先按 [ references/lark drive search.md ](references/lark drive search.md) 使用 drive +search 唯一定位源资源，再按 copy reference 复制。如果是要复制文档 / 创建副本到知识库，使用 wiki +node copy （见 [ lark wiki node copy.md ](../lark wiki/references/lark wiki node copy.md)）。
用户要 识别飞书 / doubao 云空间 URL 的类型和 token 时，可以先按 URL 路径形态做轻量判断；当路径已明确指向 docx / sheet / bitable / slides / file / folder 等资源时，可直接提取对应 token/type。传入 wiki URL、需要识别标题或 canonical URL、URL/token 有歧义，或后续操作依赖底层真实资源时，再使用 lark cli drive +inspect url '<url ' 进行识别；具体用法、失败处理和边界见 [ references/lark drive inspect.md ](references/lark drive inspect.md)。
高风险写操作（删除、公开权限修改、owner 转移、版本删除/回滚、批量移动/覆盖/同步）必须同时满足三个条件才执行：目标已解析为该操作可直接使用的执行对象，执行细节已明确到可直接调用命令（例如删除的 file token/type、公开权限修改的共享范围、owner 转移的目标 owner、版本删除/回滚的 version id、移动/覆盖/同步的目标位置和冲突策略），且用户在本轮明确确认执行这些具体目标和执行细节。用户只说“删除没用的文件”“开放/共享给大家”“改成开放”“覆盖/移动这些”只表示目标状态；先只读发现并列出候选、权限档位或执行方案，停止等待用户确认。
用户要 检查 / 治理文档权限、公开范围、链接分享、外部访问、复制下载权限、密级标签、owner 转移 ，或要”权限风险报告、收紧权限、申请查看 / 编辑权限、转移 / 批量转移 owner”，必须先阅读 [ references/lark drive workflow.md ](references/lark drive workflow.md)，再按其中 Workflow Registry 进入 [ permission governance ](references/lark drive workflow permission governance.md) workflow。
用户明确要 移除单个云文档协作者权限 时，使用 lark cli drive +member remove ；先阅读 [ references/lark drive member remove.md ](references/lark drive member remove.md)。这是高风险写操作，真实执行必须确认准确的资源、成员 ID/type 和 wiki 权限范围，并显式传 yes 。
用户要为指定飞书文档 设置 / 修改密级标签（secure label） ，或查询当前用户可用的密级标签，直接读取 [ references/lark drive secure label.md ](references/lark drive secure label.md)；这是 Drive 文件治理能力。
用户要 检查 / 治理文档权限、公开范围、链接分享、外部访问、复制下载权限、密级标签、owner 转移 ，或要“权限风险报告、收紧权限、申请查看 / 编辑权限、转移 / 批量转移 owner”，必须先阅读 [ references/lark drive workflow.md ](references/lark drive workflow.md)，再按其中 Workflow Registry 进入 [ permission governance ](references/lark drive workflow permission governance.md) workflow。
用户要 查询文件、文件夹或云文档自身的公开访问、分享、协作者管理、安全与评论权限设置 ，优先使用 lark cli drive +permission get setting ；它只读取目标自身设置，不递归审计文件夹子文档权限。裸 token 必须显式传 type 。
用户要 按特定主题、关键词或内容线索跨容器查找资料，并统一收集到 Drive 文件夹或 Wiki 节点 ，必须先阅读 [ references/lark drive workflow.md ](references/lark drive workflow.md)，再按其中 Workflow Registry 进入 [ topic move collector ](references/lark drive workflow topic move collector.md) workflow。该 workflow 负责搜索召回、内容验证、相关性分类、移动计划、写前确认和结果验证；禁止直接从 drive +search 或 drive +move 开始。
用户要 整理云盘 / 文件夹 / 文档库 / 知识库 / 个人文档库 ，或要“盘点目录结构、找出未归档/临时/重复/空目录、生成整理方案”，必须先阅读 [ references/lark drive workflow.md ](references/lark drive workflow.md)，再按其中 Workflow Registry 进入 [ knowledge organize ](references/lark drive workflow knowledge organize.md) workflow。默认只生成方案；创建目录、移动资源、申请权限都必须单独确认。
按主题跨范围查找并集中归档，进入 topic move collector ；对已知文件夹、文档库或知识库做目录盘点和结构重组，进入 knowledge organize ；只移动一个已明确资源时仍使用原子移动命令。
用户要 搜文档 / Wiki / 电子表格 / 多维表格 / 云空间（云盘/云存储）对象 ，优先使用 lark cli drive +search ；按标题定位和处理重复候选时遵循 [ references/lark drive search.md ](references/lark drive search.md)。自然语言里"最近我编辑过的"、"我创建的"（→ created by me ，原始创建者语义）、"我负责/owner 的"（→ mine ，owner 语义）、"最近一周我打开过的 xxx"、"某人 owner 的 docx" 等直接映射到扁平 flag，避免手写嵌套 JSON。
用户要对 文档评论 做任何操作（添加评论、列表 / 批量查询、回复、获取 / 更新 / 删除回复、解决 / 恢复、reaction），按下方 Shortcuts 表选择对应的 drive +<verb 评论命令，执行前先阅读该命令的 ref。按评论定位文档正文位置见 [ references/lark drive comment location.md ](references/lark drive comment location.md)。
用户给出 doubao.com 的云空间资源 URL/token，或明确提到豆包里的 file/folder/docx/sheet/bitable/wiki 资源时，仍按资源类型、URL 路径和 token 路由到本 skill；不要因为域名不是飞书而回退到 WebFetch。
用户要把本地 .xlsx / .csv / .base 导入成 Base / 多维表格 / bitable，第一步必须使用 lark cli drive +import type bitable 。
用户要把本地 .md / .docx / .doc / .txt / .html 导入成在线文档，使用 lark cli drive +import type docx 。
用户要把本地 .pptx 导入成飞书幻灯片，使用 lark cli drive +import type slides ；当前 PPTX 导入上限是 500MB。
批量执行 drive +import 且目标是同一个位置（同一 folder token 、默认根目录，或同一 target token ）时，必须串行执行；不要并发导入到同一位置，服务端可能返回并发冲突错误。
用户要在 Drive 里上传、创建、读取、局部 patch 或覆盖更新 原生 .md 文件 （不是导入成 docx），切到 [ lark markdown ](../lark markdown/SKILL.md)。
用户要比较原生 .md 文件的 历史版本差异 ，或比较远端 Markdown 与本地草稿，切到 [ lark markdown ](../lark markdown/SKILL.md) 的 lark cli markdown +diff ；需要版本号时先用 drive +version history 。
用户要查看、下载、回滚或删除文件的 历史版本 ，使用 drive +version history 、 drive +version get 、 drive +version revert 、 drive +version delete ；这组命令同时支持 as user 和 as bot ，自动化场景优先 as bot 。
用户要把本地 .xlsx / .xls / .csv 导入成电子表格，使用 lark cli drive +import type sheet 。
用户要在云空间（云盘/云存储）里新建文件夹，优先使用 lark cli drive +create folder 。
用户要查看或下载文件内容，或者查看文件可用预览格式并获取 PDF / HTML / 文本 / 图片等转换预览产物，使用 lark cli drive +preview 。 +preview 和 +download 都支持 file token / url / wiki token 三选一（Wiki 会解析到底层 file ）；但两者只处理 Drive 文件 ，若目标是 docx/sheet/bitable/slides 等在线文档，改用 drive +export 。
用户要获取某个文件的封面图，优先使用 lark cli drive +cover ；先 list only 看规格，再选 spec 下载。
用户要导出云文档时，优先使用 lark cli drive +export url '<文档 URL ' file extension <格式 ；详细参数、Wiki token 和错误码处理见 [ references/lark drive export.md ](references/lark drive export.md)。
用户要把本地文件上传到知识库 / 文档库里的某个 wiki 节点下时，仍然使用 lark cli drive +upload wiki token <wiki token ；不要误切到 wiki 域命令。
lark base 只负责导入完成后的 Base 内部操作（表、字段、记录、视图），不要在“本地文件 Base”这一步提前切到 lark base 。
用户给的是 wiki URL / token，且后续还没明确底层资源类型时，先用 lark cli drive +inspect 解包； +inspect 失败后不要自动切到别的写接口继续尝试，先按错误提示处理权限、scope 或链接问题。
drive +inspect / drive +upload 遇到 not found 、 permission denied 、 missing scope 时，默认停止重试；只有 rate limit 或临时网络错误才适合有限重试。
修改标题
用户要 重命名 / 改标题 / 改文件名 ，使用 lark cli drive +update title ，用法见 [ references/lark drive update title.md ](references/lark drive update title.md)。
核心概念
文档类型与 Token
飞书开放平台中，不同类型的文档有不同的 URL 格式和 Token 处理方式。在进行文档操作（如添加评论、下载文件等）时，必须先获取正确的 file token 。
文档 URL 格式与 Token 处理
URL 格式 示例 Token 类型 处理方式
/docx/ https://example.larksuite.com/docx/doxcnxxxxxxxxx file token URL 路径中的 token 直接作为 file token 使用
/doc/ https://example.larksuite.com/doc/doccnxxxxxxxxx file token URL 路径中的 token 直接作为 file token 使用
/wiki/ https://example.larksuite.com/wiki/wikcnxxxxxxxxx wiki token 不能直接当底层 file token ；优先用 drive +inspect 解包获取 obj token
/sheets/ https://example.larksuite.com/sheets/shtcnxxxxxxxxx file token URL 路径中的 token 直接作为 file token 使用
/page/ https://example.feishu.cn/page/pagcnxxxxxxxx/ apps token URL 路径中的 token 直接使用，资源类型为 apps
/drive/folder/ https://example.larksuite.com/drive/folder/fldcnxxxx folder token URL 路径中的 token 作为文件夹 token 使用
Wiki 链接特殊处理
知识库链接背后可能是 docx、sheet、bitable、slides、file 等不同对象。后续要做评论、下载、导出或内容读取时，优先用 drive +inspect 拿到 type 、 token 、 title 、 url ；完整手动解析和跨 skill 路由见共享文档 [ lark wiki token routing.md ](../lark shared/references/lark wiki token routing.md)。不要只根据 /wiki/<token 猜底层类型。
常见操作 Token 需求
操作 需要的 Token 说明
读取文档内容 file token / 通过 docs +fetch 自动处理 docs +fetch 支持直接传入 URL
下载文件 file token 从文件 URL 中直接提取
上传文件 folder token / wiki node token 目标位置的 token
典型错误与解决方案
错误信息 原因 解决方案
not exist 使用了错误的 token 检查 token 类型，wiki 链接必须先查询获取 obj token
permission denied 没有相关操作权限 引导用户检查当前身份对文档/文件是否有相应操作权限；如果需要，可以授予相应权限
invalid file type file type 参数错误 根据 obj type 传入正确的 file type（docx/doc/sheet/slides/bitable/apps）
232140101 / 232140100 / 233523001 （常见于 drive +import 的 job error msg ） 同一位置下存在并发导入 / 创建操作 批量导入到同一文件夹、根目录或同一 target token 时改为串行执行；每个失败项每次重试前等待几秒，总共最多重试 3 次，仍失败就停止并报告冲突
权限能力入口
用户要管理 Drive 文档/文件协作者、公开权限、授权当前应用访问文档，或处理 permission.public.patch 的 91009 / 91010 / 91011 / 91012 错误时，先读 [ lark drive permission guide.md ](references/lark drive permission guide.md)。
用户要查询文件、文件夹或云文档自身的公开访问、分享、协作者管理、安全与评论权限设置，使用 [ +permission get setting ](references/lark drive permission get setting.md)；如果要递归审计文件夹下子文档权限，再进入 [ permission governance ](references/lark drive workflow permission governance.md) workflow。
用户只是没有访问权限并希望向 owner 申请访问，优先使用 [ +apply permission ](references/lark drive apply permission.md)。
普通 scope、身份或登录问题仍按 [ lark shared ](../lark shared/SKILL.md) 处理；不要把租户安全策略、对外分享、密级拦截简单归类为缺 scope。
不在本 skill 范围
文档正文读取、总结、创建、编辑、图片/附件插入或下载：使用 [ lark doc ](../lark doc/SKILL.md)。
电子表格单元格、筛选、公式、样式等表内操作：使用 [ lark sheets ](../lark sheets/SKILL.md)。
Base / 多维表格内部的表、字段、记录、视图、仪表盘等操作：使用 [ lark base ](../lark base/SKILL.md)。
知识空间、Wiki 节点层级、空间成员管理：使用 [ lark wiki ](../lark wiki/SKILL.md)；上传本地文件到 wiki 节点仍用 drive +upload wiki token 。
原生 Markdown 文件读取、写入、patch、diff：使用 [ lark markdown ](../lark markdown/SKILL.md)；把 Markdown 导入成在线 docx 才用 drive +import type docx 。
Shortcuts（推荐优先使用）
Shortcut 是对常用操作的高级封装（ lark cli drive +<verb [flags] ）。有 Shortcut 的操作优先使用。
Shortcut 说明
[ +search ](references/lark drive search.md) 搜索文档、Wiki、表格、文件夹等云空间对象；支持 edited since 、 created by me 、 mine 、 doc types 等扁平 flag；区分 original creator 与 owner 语义。
[ +upload ](references/lark drive upload.md) 上传本地文件到 Drive 文件夹或 wiki 节点；修改/重写/更新已有文件时优先覆盖上传，而不是直接上传一个新文件。
[ +create folder ](references/lark drive create folder.md) 新建 Drive 文件夹，支持父文件夹与 bot 创建后自动授权。
[ +download ](references/lark drive download.md) 下载 Drive 文件到本地。
[ +preview ](references/lark drive preview.md) 查看或下载文件内容，或者查看文件可用预览格式并获取 PDF / HTML / 文本 / 图片等转换预览产物。
[ +cover ](references/lark drive cover.md) 查看或下载文件封面图规格。
[ +status ](references/lark drive status.md) 比较本地目录与 Drive 文件夹差异；默认按 SHA 256 精确比较， quick 使用修改时间近似比较。
[ +pull ](references/lark drive pull.md) 从 Drive 拉取文件到本地目录，支持重复远端路径处理和增量模式。
+sync 双向同步本地目录与 Drive 文件夹：拉取 new remote 、推送 new local ， modified 按 on conflict=remote wins\ local wins\ keep both\ ask 处理； quick 用修改时间近似比较； on duplicate remote 支持 fail / newest / oldest ；只同步 type=file ，跳过在线文档和 shortcut，且不会删除两端多余文件。
[ +push ](references/lark drive push.md) 将本地目录推送到 Drive 文件夹，支持 skip / smart / overwrite 与确认后删除远端。
[ +create shortcut ](references/lark drive create shortcut.md) 在另一个文件夹里创建现有 Drive 文件的快捷方式。
[ +copy ](references/lark drive copy.md) 复制资源到目标文件夹；如果要复制到知识库，使用 wiki +node copy ；
[ +add comment ](references/lark drive add comment.md) 给 doc/docx/file/sheet/slides/base(bitable) 添加全文/局部评论；不支持妙搭 apps。
[ +list comments ](references/lark drive list comments.md) 分页获取评论列表。
[ +batch query comments ](references/lark drive batch query comments.md) 按评论 ID 批量获取评论。
[ +resolve comment ](references/lark drive resolve comment.md) 把评论标记为已解决（ is solved=true ）。
[ +restore comment ](references/lark drive restore comment.md) 恢复/重新打开已解决评论（ is solved=false ）。
[ +add reply ](references/lark drive add reply.md) 给已有评论添加回复。
[ +list replies ](references/lark drive list replies.md) 分页获取某条评论下的回复。
[ +update reply ](references/lark drive update reply.md) 整体替换某条回复的内容。
[ +delete reply ](references/lark drive delete reply.md) 删除评论下的某条回复（高风险，需 yes ）。
[ +react reply ](references/lark drive react reply.md) 给回复加/删表情回应。
[ +export ](references/lark drive export.md) 将 doc/docx/sheet/bitable/slides 导出为本地文件。
[ +export download ](references/lark drive export download.md) 根据导出产物的 file token 下载文件。
[ +import ](references/lark drive import.