用途:面向飞书云文档(Lark Docs)的文档操作技能,支持创建、读取、更新、搜索文档,以及处理文档中的图片、文件和画板。使用前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证与权限处理。
主要能力:通过 Shortcut(lark-cli docs +<verb>)完成常用操作:+search 搜索文档、Wiki 与电子表格文件;+create 创建文档;+fetch 获取文档内容;+update 更新文档(追加、覆盖、替换、插入、删除);+media-insert 在文档末尾插入本地图片或文件;+media-download 下载文档媒体或画板缩略图;+whiteboard-update 用 whiteboard DSL 更新已有画板。
必要用法与 Token 处理:操作前需取得正确的 file_token。URL 含 /docx/、/doc/、/sheets/ 时路径中 token 可直接作为 file_token;/drive/folder/ 中 token 作为文件夹 token;/wiki/TOKEN 不能直接使用,须先用 lark-cli wiki spaces get_node --params '{"token":"wiki_token"}' 查询,取得 node.obj_type 与 node.obj_token 后再按类型调用对应 API(docx、doc、sheet、bitable、slides、file、mindnote)。
画板限制:lark-doc 不能直接编辑已有画板内容,但 docs +update 可新建空白画板。用 <whiteboard type="blank"></whiteboard> 创建后,从响应 data.board_tokens 记录 token,再参考 ../lark-whiteboard/SKILL.md 编辑;已有画板(<whiteboard token="xxx"/>)同样交由该技能处理。
适用场景:用户需要创建或编辑飞书文档、读取文档内容、在文档中插入图片、搜索云空间文档,或按名称、关键词定位电子表格、报表等云空间对象时。找到 spreadsheet 的 URL/token 后应切换到 lark-sheets 处理对象内部读写。
限制:认证与权限依赖 lark-shared;Wiki 链接必须先查询真实 token;画板编辑需专用技能;其余收费、平台与配额信息资料未提供。