lark-drive

价格

以上为公开标价。你的组织可能有协议价，以控制台显示的价格为准。

如何使用

1. 1

   为组织安装

   开通即安装：组织固定使用开通时的版本（当前为 1.0.0）。升级到新版本需要取消后重新开通。

2. 2

   创建凭证

   客户端使用组织凭证读取；绑定到数字人后，数字人使用绑定凭证按需加载。请求中携带：

   Authorization: Bearer $ZGI_MARKET_KEY

3. 3

   读取清单与安装包

   清单列出版本、文件和校验值；安装包是一个 zip 文件。

   curl "https://market-api.zgi.im/v1/market/skills/lark-drive/manifest" \
     -H "Authorization: Bearer $ZGI_MARKET_KEY"

   curl "https://market-api.zgi.im/v1/market/skills/lark-drive/package" \
     -H "Authorization: Bearer $ZGI_MARKET_KEY" \
     -o lark-drive.zip

   读取清单和下载安装包不计入用量。下载后请用响应头中的 SHA-256 校验文件。

技能说明

名称

lark-drive

说明

飞书云空间（云盘/云存储）：管理 Drive 文件和文件夹，包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签（secure labels）和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题，或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用；doubao.com 云空间 URL/token 也按资源路径和 token 路由，不回退 WebFetch。不负责：文档内容编辑（走 lark-doc）、表格/Base 表内数据操作（走 lark-sheets/lark-base）、知识空间节点/成员管理（走 lark-wiki）、原生 Markdown 文件读写/patch/diff（走 lark-markdown）。

# 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`。

• SKILL.md24.7 KiB
• references/lark-drive-add-comment.md11.9 KiB
• references/lark-drive-add-reply.md2.5 KiB
• references/lark-drive-apply-permission.md3.6 KiB
• references/lark-drive-batch-query-comments.md2.4 KiB
• references/lark-drive-comment-content.md2.6 KiB
• references/lark-drive-comment-location.md10.7 KiB
• references/lark-drive-copy.md3.9 KiB
• references/lark-drive-cover.md2.4 KiB
• references/lark-drive-create-folder.md3.6 KiB
• references/lark-drive-create-shortcut.md4.3 KiB
• references/lark-drive-delete-reply.md2.4 KiB
• references/lark-drive-delete.md4.5 KiB
• references/lark-drive-download.md2.8 KiB
• references/lark-drive-export-download.md1.5 KiB
• references/lark-drive-export.md8.1 KiB
• references/lark-drive-files-list.md10.2 KiB
• references/lark-drive-import.md10.8 KiB
• references/lark-drive-inspect.md2.1 KiB
• references/lark-drive-list-comments.md5.9 KiB
• references/lark-drive-list-replies.md2.6 KiB
• references/lark-drive-member-add.md5.1 KiB
• references/lark-drive-member-list.md3.0 KiB
• references/lark-drive-member-remove.md2.8 KiB
• references/lark-drive-move.md5.0 KiB
• references/lark-drive-permission-get-setting.md1.8 KiB
• references/lark-drive-permission-guide.md3.7 KiB
• references/lark-drive-preview.md4.6 KiB
• references/lark-drive-pull.md9.7 KiB
• references/lark-drive-push.md17.8 KiB
• references/lark-drive-react-reply.md2.9 KiB
• references/lark-drive-reactions.md7.1 KiB
• references/lark-drive-resolve-comment.md1.7 KiB
• references/lark-drive-restore-comment.md2.1 KiB
• references/lark-drive-search.md22.4 KiB
• references/lark-drive-secure-label.md2.0 KiB
• references/lark-drive-status.md7.3 KiB
• references/lark-drive-task-result.md13.3 KiB
• references/lark-drive-update-reply.md2.4 KiB
• references/lark-drive-update-title.md3.3 KiB
• references/lark-drive-upload.md5.1 KiB
• references/lark-drive-version-delete.md1.0 KiB
• references/lark-drive-version-get.md2.0 KiB
• references/lark-drive-version-history.md1.9 KiB
• references/lark-drive-version-revert.md979 B
• references/lark-drive-workflow-knowledge-organize-analysis.md12.6 KiB
• references/lark-drive-workflow-knowledge-organize-discovery.md18.9 KiB
• references/lark-drive-workflow-knowledge-organize-execution.md9.4 KiB
• references/lark-drive-workflow-knowledge-organize-planning.md14.2 KiB
• references/lark-drive-workflow-knowledge-organize-rollback.md10.8 KiB
• references/lark-drive-workflow-knowledge-organize.md19.8 KiB
• references/lark-drive-workflow-permission-governance-commands.md6.4 KiB
• references/lark-drive-workflow-permission-governance-outputs.md27.7 KiB
• references/lark-drive-workflow-permission-governance.md25.6 KiB
• references/lark-drive-workflow-topic-move-collector-execute.md13.4 KiB
• references/lark-drive-workflow-topic-move-collector-recall.md9.3 KiB
• references/lark-drive-workflow-topic-move-collector-resolve-verify.md13.6 KiB
• references/lark-drive-workflow-topic-move-collector-review-plan.md12.5 KiB
• references/lark-drive-workflow-topic-move-collector-setup.md8.3 KiB
• references/lark-drive-workflow-topic-move-collector.md15.8 KiB
• references/lark-drive-workflow.md8.3 KiB

来源与审核

审核状态

尚未审核，内容来自上游来源

许可证

未说明

审核状态是平台对上架信息的记录，不构成对上游服务质量或可用性的担保。