SuperAPI AI 工具集

lark-drive

数据与分析

查看项目

更新于 10-16 01:31

技能介绍

用途:通过 lark-cli 管理飞书云空间中的文件与文件夹,并处理文档评论、权限与事件订阅。开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证与权限处理。

主要能力:上传下载文件、创建文件夹、复制/移动/删除文件、查看文件元数据、管理文档评论(全文与局部/划词评论)、管理文档权限、订阅用户评论变更事件。优先使用 Shortcut:+upload、+download、+add-comment。原生 API 需先执行 lark-cli schema drive.<resource>.<method> 查看参数结构,再调用 lark-cli drive <resource> <method> [flags]。

关键概念:文档 URL 的 Token 处理不同。/docx/、/doc/、/sheets/ 路径中的 token 可直接作为 file_token;/wiki/ 链接需先用 lark-cli wiki spaces get_node --params '{"token":"wiki_token"}' 查询 node.obj_type 与 node.obj_token,再按类型调用对应 API。

评论能力边界:+add-comment 未传 --selection-with-ellipsis / --block-id 时为全文评论,支持 docx、旧版 doc 及解析为 doc/docx 的 wiki;传参时为局部评论,仅支持 docx 及解析为 docx 的 wiki。--content 需传 reply_elements JSON 数组字符串。全文评论与已解决评论不支持回复。统计评论数用 items 长度,回复数为 replies 之和减去 items 数,总互动数为 replies 之和。

限制:权限不足会 permission denied,需检查身份权限;token 错误或 wiki 未解析会报 not exist;file_type 需按 obj_type 传入。具体收费、价格等暂未提供。