在飞书/豆包云空间管理 Drive 文件、解析…

通过 lark-cli 管理飞书/豆包云空间 Drive 文件、文件夹、导入导出、评论、权限、版本和密级标签。

适用场景

解决思路

1. 开始前必须先用 Read 工具读取 ../lark-shared/SKILL.md，获取认证、权限处理信息。
2. 术语说明：飞书云空间也常被称为「云盘」「云存储」「网盘」或「我的空间」，通常指同一产品。
3. 导入分流：本地 Excel / CSV / .base 快照导入成 Base / 多维表格 / bitable，必须优先使用 lark-cli drive +import --type bitable；不要先切到 lark-base；lark-base 只负责导入完成后的表内操作。
4. 副本分流：复制在线文档、创建文档副本、把文档复制到另一个文件夹，必须使用 lark-cli drive +copy；不要用 drive +export 下载后再 drive +import 上传，也不要用 docs +fetch + docs +create 重建正文；导出/导入只用于本地文件转换或离线产物。
5. 已有 Wiki 节点移出知识库，放到 Drive 文件夹或「我的空间」根目录：切到 lark-wiki，使用 lark-cli wiki +move-to-drive；不要把 Wiki token 直接交给 drive +move；这是改变文档归属和权限继承的写操作，执行前确认源节点与目标位置。
6. 复制文档 / 创建副本到云盘或文件夹：已提供可直接使用的 URL 或 token 时，按 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。
7. 识别飞书 / 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。
8. 高风险写操作（删除、公开权限修改、owner 转移、版本删除/回滚、批量移动/覆盖/同步）必须同时满足三个条件才执行：目标已解析为该操作可直接使用的执行对象，执行细节已明确到可直接调用命令，例如删除的 file-token/type、公开权限修改的共享范围、owner 转移的目标 owner、版本删除/回滚的 version id、移动/覆盖/同步的目标位置和冲突策略，且用户在本轮明确确认执行这些具体目标和执行细节；用户只说「删除没用的文件」「开放/共享给大家」「改成开放」「覆盖/移动这些」只表示目标状态；先只读发现并列出候选、权限档位或执行方案，停止等待用户确认。
9. 检查 / 治理文档权限、公开范围、链接分享、外部访问、复制下载权限、密级标签、owner 转移，或要权限风险报告、收紧权限、申请查看 / 编辑权限、转移 / 批量转移 owner，必须先阅读 references/lark-drive-workflow.md，再按其中 Workflow Registry 进入 permission_governance workflow。
10. 明确要移除单个云文档协作者权限时，使用 lark-cli drive +member-remove；先阅读 references/lark-drive-member-remove.md；这是高风险写操作，真实执行必须确认准确的资源、成员 ID/type 和 wiki 权限范围，并显式传 --yes。
11. 为指定飞书文档设置 / 修改密级标签（secure label），或查询当前用户可用的密级标签，直接读取 references/lark-drive-secure-label.md；这是 Drive 文件治理能力。
12. 查询文件、文件夹或云文档自身的公开访问、分享、协作者管理、安全与评论权限设置，优先使用 lark-cli drive +permission-get-setting；它只读取目标自身设置，不递归审计文件夹子文档权限；裸 token 必须显式传 --type。
13. 按特定主题、关键词或内容线索跨容器查找资料，并统一收集到 Drive 文件夹或 Wiki 节点，必须先阅读 references/lark-drive-workflow.md，再按其中 Workflow Registry 进入 topic_move_collector workflow；该 workflow 负责搜索召回、内容验证、相关性分类、移动计划、写前确认和结果验证；禁止直接从 drive +search 或 drive +move 开始。
14. 整理云盘 / 文件夹 / 文档库 / 知识库 / 个人文档库，或要盘点目录结构、找出未归档 / 临时 / 重复 / 空目录、生成整理方案，必须先阅读 references/lark-drive-workflow.md，再按其中 Workflow Registry 进入 knowledge_organize workflow；默认只生成方案；创建目录、移动资源、申请权限都必须单独确认。
15. 按主题跨范围查找并集中归档进入 topic_move_collector；对已知文件夹、文档库或知识库做目录盘点和结构重组进入 knowledge_organize；只移动一个已明确资源时仍使用原子移动命令。
16. 搜文档 / Wiki / 电子表格 / 多维表格 / 云空间对象，优先使用 lark-cli drive +search；按标题定位和处理重复候选时遵循 references/lark-drive-search.md；自然语言里「最近我编辑过的」「我创建的」（→ --created-by-me，原始创建者语义）、「我负责/owner 的」（→ --mine，owner 语义）、「最近一周我打开过的 xxx」「某人 owner 的 docx」等直接映射到扁平 flag，避免手写嵌套 JSON。
17. 对文档评论做任何操作（添加评论、列表 / 批量查询、回复、获取 / 更新 / 删除回复、解决 / 恢复、reaction），按 Shortcuts 表选择对应的 drive +<verb> 评论命令，执行前先阅读该命令的 ref；按评论定位文档正文位置见 references/lark-drive-comment-location.md。
18. 用户给出 doubao.com 的云空间资源 URL/token，或明确提到豆包里的 file/folder/docx/sheet/bitable/wiki 资源时，仍按资源类型、URL 路径和 token 路由到本 skill；不要因为域名不是飞书而回退到 WebFetch。
19. 用户要把本地 .xlsx / .csv / .base 导入成 Base / 多维表格 / bitable，第一步必须使用 lark-cli drive +import --type bitable。
20. 用户要把本地 .md / .docx / .doc / .txt / .html 导入成在线文档，使用 lark-cli drive +import --type docx。
21. 用户要把本地 .pptx 导入成飞书幻灯片，使用 lark-cli drive +import --type slides；当前 PPTX 导入上限是 500MB。
22. 批量执行 drive +import 且目标是同一个位置（同一 --folder-token、默认根目录，或同一 --target-token）时，必须串行执行；不要并发导入到同一位置，服务端可能返回并发冲突错误。
23. 用户要在 Drive 里上传、创建、读取、局部 patch 或覆盖更新原生 .md 文件（不是导入成 docx），切到 lark-markdown。
24. 用户要比较原生 .md 文件的历史版本差异，或比较远端 Markdown 与本地草稿，切到 lark-markdown 的 lark-cli markdown +diff；需要版本号时先用 drive +version-history。
25. 用户要查看、下载、回滚或删除文件的历史版本，使用 drive +version-history、drive +version-get、drive +version-revert、drive +version-delete；这组命令同时支持 --as user 和 --as bot，自动化场景优先 --as bot。
26. 用户要把本地 .xlsx / .xls / .csv 导入成电子表格，使用 lark-cli drive +import --type sheet。
27. 用户要在云空间（云盘/云存储）里新建文件夹，优先使用 lark-cli drive +create-folder。
28. 用户要查看或下载文件内容，或者查看文件可用预览格式并获取 PDF / HTML / 文本 / 图片等转换预览产物，使用 lark-cli drive +preview；+preview 和 +download 都支持 --file-token / --url / --wiki-token 三选一（Wiki 会解析到底层 file）；但两者只处理 Drive 文件；若目标是 docx/sheet/bitable/slides 等在线文档，改用 drive +export。
29. 用户要获取某个文件的封面图，优先使用 lark-cli drive +cover；先 --list-only 看规格，再选 --spec 下载。
30. 用户要导出云文档时，优先使用 lark-cli drive +export --url '<文档 URL>' --file-extension <格式>；详细参数、Wiki token 和错误码处理见 references/lark-drive-export.md。
31. 用户要把本地文件上传到知识库 / 文档库里的某个 wiki 节点下时，仍然使用 lark-cli drive +upload --wiki-token <wiki_token>；不要误切到 wiki 域命令。
32. lark-base 只负责导入完成后的 Base 内部操作（表、字段、记录、视图），不要在「本地文件 -> Base」这一步提前切到 lark-base。
33. 用户给的是 wiki URL / token，且后续还没明确底层资源类型时，先用 lark-cli drive +inspect 解包；+inspect 失败后不要自动切到别的写接口继续尝试，先按错误提示处理权限、scope 或链接问题。
34. drive +inspect / drive +upload 遇到 not found、permission denied、missing scope 时，默认停止重试；只有 rate limit 或临时网络错误才适合有限重试。
35. 重命名 / 改标题 / 改文件名，使用 lark-cli drive +update-title，用法见 references/lark-drive-update-title.md。
36. 文档类型与 Token：飞书开放平台中不同类型文档有不同 URL 格式和 Token 处理方式；进行文档操作时必须先获取正确的 file_token。
37. URL 格式 /docx/：URL 路径中的 token 直接作为 file_token 使用。
38. URL 格式 /doc/：URL 路径中的 token 直接作为 file_token 使用。
39. URL 格式 /wiki/：token 是 wiki_token，不能直接当底层 file_token；优先用 drive +inspect 解包获取 obj_token。
40. URL 格式 /sheets/：URL 路径中的 token 直接作为 file_token 使用。
41. URL 格式 /page/：URL 路径中的 token 直接使用，资源类型为 apps。
42. URL 格式 /drive/folder/：URL 路径中的 token 作为文件夹 token 使用。
43. Wiki 链接特殊处理：使用 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> 猜底层类型。
44. 读取文档内容需要 file_token / 通过 docs +fetch 自动处理；docs +fetch 支持直接传入 URL。
45. 下载文件需要 file_token；从文件 URL 中直接提取。
46. 上传文件需要 folder_token / wiki_node_token；目标位置的 token。
47. 错误 not exist：原因是使用了错误的 token；检查 token 类型，wiki 链接必须先查询获取 obj_token。
48. 错误 permission denied：原因是没有相关操作权限；引导用户检查当前身份对文档 / 文件是否有相应操作权限；如果需要，可以授予相应权限。
49. 错误 invalid file_type：原因是 file_type 参数错误；根据 obj_type 传入正确的 file_type（docx/doc/sheet/slides/bitable/apps）。
50. 错误 232140101 / 232140100 / 233523001（常见于 drive +import 的 job_error_msg）：原因是同一位置下存在并发导入 / 创建操作；批量导入到同一文件夹、根目录或同一 --target-token 时改为串行执行；每个失败项每次重试前等待几秒，总共最多重试 3 次，仍失败就停止并报告冲突。
51. 权限能力入口：用户要管理 Drive 文档/文件协作者、公开权限、授权当前应用访问文档，或处理 permission.public.patch 的 91009 / 91010 / 91011 / 91012 错误时，先读 references/lark-drive-permission-guide.md。
52. 权限能力入口：查询文件、文件夹或云文档自身的公开访问、分享、协作者管理、安全与评论权限设置，使用 +permission-get-setting；如果要递归审计文件夹下子文档权限，再进入 permission_governance workflow。
53. 权限能力入口：用户只是没有访问权限并希望向 owner 申请访问，优先使用 +apply-permission。
54. 权限能力入口：普通 scope、身份或登录问题仍按 lark-shared 处理；不要把租户安全策略、对外分享、密级拦截简单归类为缺 scope。
55. Shortcut +search：搜索文档、Wiki、表格、文件夹等云空间对象；支持 --edited-since、--created-by-me、--mine、--doc-types 等扁平 flag；区分 original creator 与 owner 语义。
56. Shortcut +upload：上传本地文件到 Drive 文件夹或 wiki 节点；修改 / 重写 / 更新已有文件时优先覆盖上传，而不是直接上传一个新文件。
57. Shortcut +create-folder：新建 Drive 文件夹，支持父文件夹与 bot 创建后自动授权。
58. Shortcut +download：下载 Drive 文件到本地。
59. Shortcut +preview：查看或下载文件内容，或者查看文件可用预览格式并获取 PDF / HTML / 文本 / 图片等转换预览产物。
60. Shortcut +cover：查看或下载文件封面图规格。
61. Shortcut +status：比较本地目录与 Drive 文件夹差异；默认按 SHA-256 精确比较，--quick 使用修改时间近似比较。
62. Shortcut +pull：从 Drive 拉取文件到本地目录，支持重复远端路径处理和增量模式。
63. Shortcut +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，且不会删除两端多余文件。
64. Shortcut +push：将本地目录推送到 Drive 文件夹，支持 skip / smart / overwrite 与确认后删除远端。
65. Shortcut +create-shortcut：在另一个文件夹里创建现有 Drive 文件的快捷方式。
66. Shortcut +copy：复制资源到目标文件夹；如果要复制到知识库，使用 wiki +node-copy。
67. Shortcut +add-comment：给 doc/docx/file/sheet/slides/base(bitable) 添加全文 / 局部评论；不支持妙搭 apps。
68. Shortcut +list-comments：分页获取评论列表。
69. Shortcut +batch-query-comments：按评论 ID 批量获取评论。
70. Shortcut +resolve-comment：把评论标记为已解决（is_solved=true）。
71. Shortcut +restore-comment：恢复 / 重新打开已解决评论（is_solved=false）。
72. Shortcut +add-reply：给已有评论添加回复。
73. Shortcut +list-replies：分页获取某条评论下的回复。
74. Shortcut +update-reply：整体替换某条回复的内容。
75. Shortcut +delete-reply：删除评论下的某条回复（高风险，需 --yes）。
76. Shortcut +react-reply：给回复加 / 删表情回应。
77. Shortcut +export：将 doc/docx/sheet/bitable/slides 导出为本地文件。
78. Shortcut +export-download：根据导出产物的 file_token 下载文件。
79. Shortcut +import：将本地文件导入为飞书在线文档、表格、多维表格或幻灯片。
80. Shortcut +version-history：查看文件历史版本。
81. Shortcut +version-get：下载指定历史版本。
82. Shortcut +version-revert：回滚到指定历史版本。
83. Shortcut +version-delete：删除指定历史版本。
84. Shortcut +move：移动 Drive 文件或文件夹；Wiki 层级移动走 lark-wiki。
85. Shortcut +update-title：重命名文件、文件夹、在线文档或知识库。
86. Shortcut +delete：删除 Drive 文件或文件夹，文件夹删除会轮询异步任务。
87. Shortcut +task_result：查询 import/export/move/delete 等异步任务结果。
88. Shortcut +inspect：检视 URL 的类型、标题和 canonical token；wiki URL 会自动解包到底层文档。
89. Shortcut +apply-permission：以 user 身份向文档 owner 申请访问权限。
90. Shortcut +member-add：添加一个或最多 10 个 Drive 文档、文件、文件夹或 wiki 节点协作者 / 授权成员；封装 Drive permission member create/batch_create，真实写入需要 --yes。
91. Shortcut +member-list：查询 Drive 文档、文件、文件夹或 wiki 节点的协作者 / 授权成员列表。
92. Shortcut +member-remove：移除一个 Drive 文档、文件、文件夹或 wiki 节点协作者；封装 Drive permission member delete，真实写入需要 --yes。
93. Shortcut +permission-get-setting：查询文件、文件夹或云文档自身的公开访问、分享、协作者管理、安全与评论权限设置；支持 URL 或裸 token + --type；不递归读取文件夹子文档权限。
94. Shortcut +secure-label-list：列出当前用户可用的密级标签。
95. Shortcut +secure-label-update：更新 Drive 文件或文档的密级标签。
96. API Resources：调用 API 前必须先查看参数结构，使用 lark-cli schema drive.<resource>.<method>；调用 API 使用 lark-cli drive <resource> <method> [flags]。
97. API Resources 重要：使用原生 API 时，必须先运行 schema 查看 --data / --params 参数结构，不要猜测字段格式。
98. API Resources 高频原生命令：读取 Drive 文件夹清单时使用 drive files list，使用前先读 references/lark-drive-files-list.md，按模板通过 --params 传参并手动处理分页；不要把 --page-all 输出直接交给 JSON 解析脚本。
99. API files.copy：复制文件；优先使用 drive +copy。
100. API files.create_folder：新建文件夹。
101. API files.list：获取文件夹下的清单；使用前阅读 references/lark-drive-files-list.md。
102. API files.patch：修改文件标题；优先使用 drive +update-title shortcut。
103. API permission.members.auth：执行 auth。
104. API permission.members.create：增加协作者权限。
105. API permission.members.transfer_owner：转移 owner。
106. API metas.batch_query：获取文档元数据。
107. API user.remove_subscription：取消订阅用户、应用维度事件。
108. API user.subscription：订阅用户、应用维度事件（本次开放评论添加事件）。
109. API user.subscription_status：查询用户、应用对指定事件的订阅状态。
110. API file.statistics.get：获取文件统计信息；获取 docx / 文件统计信息时，建议优先使用 typed flags：lark-cli drive file.statistics get --file-token <token> --file-type <type> --format json；--params JSON 也支持，适合批量拼装或 raw 参数场景。
111. API file.view_records.list：获取文档的访问者记录；查看 docx 最近访问记录、返回 open_id、最多 N 条时，建议优先使用 typed flags：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 参数场景。
112. API file.comment.reply.reactions.update_reaction：添加 / 删除 reaction；优先使用 drive +react-reply。
113. API quota_details.get：获取当前用户的容量信息，包含各业务使用量、租户配额是否超限、用户配额、所在部门配额；仅支持 --as user，不要使用默认的 bot 身份；quota_detail_id 传当前用户的 user_id。

适用边界 · 注意事项

• 不适用于文档正文读取、总结、创建、编辑、图片/附件插入或下载；这些使用 lark-doc。
• 不适用于电子表格单元格、筛选、公式、样式等表内操作，以及 Base / 多维表格内部的表、字段、记录、视图、仪表盘等操作；这些使用 lark-sheets / lark-base。
• 不适用于知识空间、Wiki 节点层级、空间成员管理，以及原生 Markdown 文件读取、写入、patch、diff；这些使用 lark-wiki / lark-markdown；但上传本地文件到 wiki 节点仍用 drive +upload --wiki-token。