lark-drive【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书云空间:管理 Drive 文件/文件夹,上传下载、复制移动删除、评论、权限、密级标签、版本、改标题,导入 Word/Markdown/Excel/CSV/PPTX/.base 为在线文档;doubao.com 云空间 URL 同走本 skill,不回退 WebFetch。不负责:文档内容编辑(lark-doc)、表格/Base 表内数据(lark-sheets/lark-base)、知识库节点(lark-wiki)。
Independent GitHub snapshot · Automated classification · Original documentation governs
CRITICAL — 开始前 MUST 先用 read 读取 ../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重建正文；导出/导入只用于本地文件转换或离线产物。
lark-wiki，使用 lark-cli wiki +move-to-drive；不要把 Wiki token 直接交给 drive +move。这是会改变文档归属和权限继承的写操作，执行前确认源节点与目标位置。references/lark-drive-copy.md 使用 lark-cli drive +copy；仅提供标题时，先按 references/lark-drive-search.md 使用 drive +search 唯一定位源资源，再按 copy reference 复制。如果是要复制文档 / 创建副本到知识库，使用 wiki +node-copy（见 lark-wiki-node-copy.md）。lark-cli drive +inspect --url '<url>' 进行识别；具体用法、失败处理和边界见 references/lark-drive-inspect.md。lark-cli drive +member-remove；先阅读 references/lark-drive-member-remove.md。这是高风险写操作，真实执行必须确认准确的资源、成员 ID/type 和 wiki 权限范围，并显式传 --yes。references/lark-drive-secure-label.md；这是 Drive 文件治理能力。references/lark-drive-workflow.md，再按其中 Workflow Registry 进入 permission_governance workflow。lark-cli drive +permission-get-setting；它只读取目标自身设置，不递归审计文件夹子文档权限。裸 token 必须显式传 --type。references/lark-drive-workflow.md，再按其中 Workflow Registry 进入 topic_move_collector workflow。该 workflow 负责搜索召回、内容验证、相关性分类、移动计划、写前确认和结果验证；禁止直接从 drive +search 或 drive +move 开始。references/lark-drive-workflow.md，再按其中 Workflow Registry 进入 knowledge_organize workflow。默认只生成方案；创建目录、移动资源、申请权限都必须单独确认。topic_move_collector；对已知文件夹、文档库或知识库做目录盘点和结构重组，进入 knowledge_organize；只移动一个已明确资源时仍使用原子移动命令。lark-cli drive +search；按标题定位和处理重复候选时遵循 references/lark-drive-search.md。自然语言里"最近我编辑过的"、"我创建的"（→ --created-by-me，原始创建者语义）、"我负责/owner 的"（→ --mine，owner 语义）、"最近一周我打开过的 xxx"、"某人 owner 的 docx" 等直接映射到扁平 flag，避免手写嵌套 JSON。drive +<verb> 评论命令，执行前先阅读该命令的 ref。按评论定位文档正文位置见 references/lark-drive-comment-location.md。lark-cli drive +import --type <类型>。drive +import 且目标是同一个位置（同一 --folder-token、默认根目录，或同一 --target-token）时，必须串行执行；不要并发导入到同一位置，服务端可能返回并发冲突错误。.md 文件（不是导入成 docx）：本环境无 lark-markdown 技能；远端下载用 drive +download、本地编辑用文件工具、回传用 drive +upload（组合说明见 references/lark-drive-upload.md）。.md 历史版本差异，或比较远端 Markdown 与本地草稿：先用 drive +version-history / +version-get 拿到历史版本到本地，再用本地 diff。drive +version-history、drive +version-get、drive +version-revert、drive +version-delete；这组命令同时支持 --as user 和 --as bot，自动化场景优先 --as bot。lark-cli drive +create-folder。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。lark-cli drive +upload --wiki-token <wiki_token>；不要误切到 wiki 域命令。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。飞书开放平台中，不同类型的文档有不同的 URL 格式和 Token 处理方式。在进行文档操作（如添加评论、下载文件等）时，必须先获取正确的 file_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 使用 |
lark-cli drive +inspect --url 'https://xxx.feishu.cn/wiki/wikcnXXX'
知识库链接背后可能是 docx、sheet、bitable、slides、file 等不同对象。后续要做评论、下载、导出或内容读取时，优先用 drive +inspect 拿到 type、token、title、url；完整手动解析和跨 skill 路由见共享文档 lark-wiki-token-routing.md。不要只根据 /wiki/<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 次，仍失败就停止并报告冲突 |
permission.public.patch 的 91009 / 91010 / 91011 / 91012 错误时，先读 lark-drive-permission-guide.md。+permission-get-setting；如果要递归审计文件夹下子文档权限，再进入 permission_governance workflow。+apply-permission。lark-shared 处理；不要把租户安全策略、对外分享、密级拦截简单归类为缺 scope。lark-doc。lark-sheets。lark-base。lark-wiki；上传本地文件到 wiki 节点仍用 drive +upload --wiki-token。lark-doc 的 +history-list / +history-revert，不走本 skill 的 +version-*。Shortcut 是对常用操作的高级封装（lark-cli drive +<verb> [flags]）。有 Shortcut 的操作优先使用。
| Shortcut | 说明 |
|---|---|
+search | 搜索文档、Wiki、表格、文件夹等云空间对象；支持 --edited-since、--created-by-me、--mine、--doc-types 等扁平 flag；区分 original creator 与 owner 语义。 |
+upload | 上传本地文件到 Drive 文件夹或 wiki 节点；修改/重写/更新已有文件时优先覆盖上传，而不是直接上传一个新文件。 |
+create-folder | 新建 Drive 文件夹，支持父文件夹与 bot 创建后自动授权。 |
+download | 下载 Drive 文件到本地。 |
+preview | 查看或下载文件内容，或者查看文件可用预览格式并获取 PDF / HTML / 文本 / 图片等转换预览产物。 |
+cover | 查看或下载文件封面图规格。 |
+status | 比较本地目录与 Drive 文件夹差异；默认按 SHA-256 精确比较，--quick 使用修改时间近似比较。 |
+pull | 从 Drive 拉取文件到本地目录，支持重复远端路径处理和增量模式。 |
+sync | 双向同步本地目录与 Drive 文件夹：拉取 new_remote、推送 new_local，双向处理 modified；只同步 type=file，跳过在线文档和 shortcut，且不会删除两端多余文件（镜像删除分别用 +pull --delete-local / +push --delete-remote）。参数语义：--on-conflict 只对 modified 生效（remote-wins / local-wins / keep-both / ask）；--on-duplicate-remote 只对远端同名冲突生效（fail 默认 / newest / oldest）；--quick 改用修改时间近似比较（默认 SHA-256 精确比较）。 |
+push | 将本地目录推送到 Drive 文件夹，支持 skip / smart / overwrite 与确认后删除远端。 |
+create-shortcut | 在另一个文件夹里创建现有 Drive 文件的快捷方式。 |
+copy | 复制资源到目标文件夹；如果要复制到知识库，使用 wiki +node-copy； |
+add-comment | 给 doc/docx/file/sheet/slides/base(bitable) 添加全文/局部评论；不支持妙搭 apps。 |
+list-comments | 分页获取评论列表。 |
+batch-query-comments | 按评论 ID 批量获取评论。 |
+resolve-comment | 把评论标记为已解决（is_solved=true）。 |
+restore-comment | 恢复/重新打开已解决评论（is_solved=false）。 |
+add-reply | 给已有评论添加回复。 |
+list-replies | 分页获取某条评论下的回复。 |
+update-reply | 整体替换某条回复的内容。 |
+delete-reply | 删除评论下的某条回复（高风险，需 --yes）。 |
+react-reply | 给回复加/删表情回应。 |
+export | 将 doc/docx/sheet/bitable/slides 导出为本地文件。 |
+export-download | 根据导出产物的 file_token 下载文件。 |
+import | 将本地文件导入为飞书在线文档、表格、多维表格或幻灯片。 |
+version-history | 查看文件历史版本。 |
+version-get | 下载指定历史版本。 |
+version-revert | 回滚到指定历史版本。 |
+version-delete | 删除指定历史版本。 |
+move | 移动 Drive 文件或文件夹；Wiki 层级移动走 lark-wiki。 |
+update-title | 重命名文件、文件夹、在线文档或知识库。 |
+delete | 删除 Drive 文件或文件夹，文件夹删除会轮询异步任务。 |
+task_result | 查询 import/export/move/delete 等异步任务结果。 |
+inspect | 检视 URL 的类型、标题和 canonical token；wiki URL 会自动解包到底层文档。 |
+apply-permission | 以 user 身份向文档 owner 申请访问权限。 |
+member-add | 添加一个或最多 10 个 Drive 文档、文件、文件夹或 wiki 节点协作者/授权成员；封装 Drive permission member create/batch_create，真实写入需要 --yes。 |
+member-list | 查询 Drive 文档、文件、文件夹或 wiki 节点的协作者/授权成员列表。 |
+member-remove | 移除一个 Drive 文档、文件、文件夹或 wiki 节点协作者；封装 Drive permission member delete，真实写入需要 --yes。 |
+permission-get-setting | 查询文件、文件夹或云文档自身的公开访问、分享、协作者管理、安全与评论权限设置；支持 URL 或裸 token + --type；不递归读取文件夹子文档权限。 |
+secure-label-list | 列出当前用户可用的密级标签。 |
+secure-label-update | 更新 Drive 文件或文档的密级标签。 |
lark-cli schema drive.<resource>.<method> # 调用 API 前必须先查看参数结构
lark-cli drive <resource> <method> [flags] # 调用 API
重要：使用原生 API 时，必须先运行
schema查看--data/--params参数结构，不要猜测字段格式。高频原生命令： 读取 Drive 文件夹清单时使用
drive files list，使用前先读references/lark-drive-files-list.md，按模板通过--params传参并手动处理分页；不要把--page-all输出直接交给 JSON 解析脚本。
copy — 复制文件；优先使用 drive +copycreate_folder — 新建文件夹list — 获取文件夹下的清单；使用前阅读 references/lark-drive-files-list.mdpatch — 修改文件标题；优先使用 drive +update-title shortcutauth — 公共访问/协作权限设置修改前的 manage-public 权限预检；详见 references/lark-drive-workflow-permission-governance.mdcreate — 增加协作者权限transfer_owner — owner 转移，高风险写：需 --yes 并走 permission_governance 确认（见 references/lark-drive-workflow-permission-governance.md）batch_query — 获取文档元数据remove_subscription — 取消订阅用户、应用维度事件subscription — 订阅用户、应用维度事件（本次开放评论添加事件）subscription_status — 查询用户、应用对指定事件的订阅状态get — 获取文件统计信息
lark-cli drive file.statistics get --file-token <token> --file-type <type> --format json；--params JSON 也支持，适合批量拼装或 raw 参数场景。list — 获取文档的访问者记录
lark-cli drive file.view_records list --file-token <docx_token> --file-type docx --page-size <N> --viewer-id-type open_id --format json；--params JSON 也支持，适合批量拼装、分页续跑或 raw 参数场景。update_reaction — 添加/删除 reaction；优先使用 drive +react-replyget — 获取当前用户的容量信息，包含各业务使用量、租户配额是否超限、用户配额、所在部门配额
--as user，不要使用默认的 bot 身份quota_detail_id 传当前用户的 user_id