CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理
术语说明： 飞书云空间也常被称为"云盘"、"云存储"、"网盘"或"我的空间"，这些说法通常指的是同一个产品，是飞书官方的云端文件存储与管理中心。
导入分流规则： 如果用户要把本地 Excel / CSV /
.base快照导入成 Base / 多维表格 / bitable，必须优先使用lark-cli drive +import --type bitable。不要先切到lark-base；lark-base只负责导入完成后的表内操作。
references/lark-drive-workflow-knowledge-organize.md。默认只生成方案；创建目录、移动资源、申请权限都必须单独确认。lark-cli drive +search。自然语言里"最近我编辑过的"、"我创建的"（→ --created-by-me，原始创建者语义）、"我负责/owner 的"（→ --mine，owner 语义）、"最近一周我打开过的 xxx"、"某人 owner 的 docx" 等直接映射到扁平 flag，避免手写嵌套 JSON。file_type=docx）的文档支持通过 need_relation=true 返回评论位置，其他类型暂不支持，具体用法需要先阅读 references/lark-drive-comment-location.md 了解。.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。.md 文件（不是导入成 docx），切到 lark-markdown。.md 文件的历史版本差异，或比较远端 Markdown 与本地草稿，切到 lark-markdown 的 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。lark-cli drive +preview。lark-cli drive +cover；先 --list-only 看规格，再选 --spec 下载。lark-cli drive +upload --wiki-token <wiki_token>；不要误切到 wiki 域命令。lark-base 只负责导入完成后的 Base 内部操作（表、字段、记录、视图），不要在“本地文件 -> Base”这一步提前切到 lark-base。lark-cli drive +inspect 解包；+inspect 失败后不要自动切到别的写接口继续尝试，先按错误提示处理权限、scope 或链接问题。drive +inspect / drive +upload 遇到 not found、permission denied、missing scope 时，默认停止重试；只有 rate limit 或临时网络错误才适合有限重试。drive files patch 命令，通过new_title字段可以修改标题，支持 docx、sheet、bitable、file、wiki、folder 类型飞书开放平台中，不同类型的文档有不同的 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 使用 |
/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 --api-version v2 自动处理 |
docs +fetch --api-version v2 支持直接传入 URL |
| 添加局部评论（划词评论） | file_token |
传 --block-id 时，drive +add-comment 会创建局部评论；docx 支持文本定位或 block_id，sheet 使用 <sheetId>!<cell>，slides 使用 <slide-block-type>!<xml-id>，且都支持最终解析到对应类型的 wiki URL；Drive file 不支持局部评论 |
| 添加全文评论 | file_token |
不传 --block-id 时，drive +add-comment 默认创建全文评论；支持 docx、旧版 doc URL、白名单扩展名的 Drive file，以及最终解析为 doc/docx/file 的 wiki URL |
| 下载文件 | file_token |
从文件 URL 中直接提取 |
| 上传文件 | folder_token / wiki_node_token |
目标位置的 token |
| 列出文档评论 | file_token |
同添加评论 |
+add-comment：review / 审阅 / 校对场景默认尽量创建局部评论，不要把多个可定位问题合并为一条全文评论。lark-drive-comments-guide.md。file_type=docx，再读 lark-drive-comment-location.md；其他文档类型暂不支持返回定位字段。lark-drive-reactions.md；只有用户明确需要 reaction 信息时才带 need_reaction=true。| 错误信息 | 原因 | 解决方案 |
|---|---|---|
not exist |
使用了错误的 token | 检查 token 类型，wiki 链接必须先查询获取 obj_token |
permission denied |
没有相关操作权限 | 引导用户检查当前身份对文档/文件是否有相应操作权限；如果需要，可以授予相应权限 |
invalid file_type |
file_type 参数错误 | 根据 obj_type 传入正确的 file_type（docx/doc/sheet/slides） |
permission.public.patch 的 91009 / 91010 / 91011 / 91012 错误时，先读 lark-drive-permission-guide.md。+apply-permission。lark-shared 处理；不要把租户安全策略、对外分享、密级拦截简单归类为缺 scope。lark-doc。lark-sheets。lark-base。lark-wiki；上传本地文件到 wiki 节点仍用 drive +upload --wiki-token。lark-markdown；把 Markdown 导入成在线 docx 才用 drive +import --type docx。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 按 --on-conflict=remote-wins|local-wins|keep-both|ask 处理；--quick 用修改时间近似比较；--on-duplicate-remote 支持 fail / newest / oldest；只同步 type=file，跳过在线文档和 shortcut，且不会删除两端多余文件。 |
+push |
将本地目录推送到 Drive 文件夹，支持 skip / smart / overwrite 与确认后删除远端。 |
+create-shortcut |
在另一个文件夹里创建现有 Drive 文件的快捷方式。 |
+add-comment |
给 doc/docx/file/sheet/slides 添加评论；评论统计、回复和 reaction 细则见 lark-drive-comments-guide.md。 |
+export |
将 doc/docx/sheet/bitable/slides 导出为本地文件。 |
+export-download |
根据导出产物的 file_token 下载文件。 |
+import |
将本地文件导入为飞书在线文档、表格、多维表格或幻灯片。 |
+version-history |
查看文件历史版本。 |
+version-get |
下载指定历史版本。 |
+version-revert |
回滚到指定历史版本。 |
+version-delete |
删除指定历史版本。 |
+move |
移动 Drive 文件或文件夹；Wiki 层级移动走 lark-wiki。 |
+delete |
删除 Drive 文件或文件夹，文件夹删除会轮询异步任务。 |
+task_result |
查询 import/export/move/delete 等异步任务结果。 |
+inspect |
检视 URL 的类型、标题和 canonical token；wiki URL 会自动解包到底层文档。 |
+apply-permission |
以 user 身份向文档 owner 申请访问权限。 |
+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传folder_token/page_token，并手动处理分页；不要把--page-all输出直接交给 JSON 解析脚本。
copy — 复制文件create_folder — 新建文件夹list — 获取文件夹下的清单；使用前阅读 references/lark-drive-files-list.md
patch — 修改文件标题batch_query — 批量获取评论create_v2 — 添加全文/局部（划词）评论list — 分页获取文档评论patch — 解决/恢复 评论create — 添加回复delete — 删除回复list — 获取回复update — 更新回复auth —create — 增加协作者权限transfer_owner —batch_query — 获取文档元数据remove_subscription — 取消订阅用户、应用维度事件subscription — 订阅用户、应用维度事件（本次开放评论添加事件）subscription_status — 查询用户、应用对指定事件的订阅状态get — 获取文件统计信息list — 获取文档的访问者记录update_reaction — 添加/删除 reactionget — 获取当前用户的容量信息，包含各业务使用量、租户配额是否超限、用户配额、所在部门配额
--as user，不要使用默认的 bot 身份quota_detail_id 传当前用户的 user_id