用途:面向飞书电子表格的创建与数据操作,包括创建表格、批量读写数据、追加行、查找单元格内容、导出/下载表格。若需按标题或关键词搜索云空间中的表格文件,应使用 lark-cli docs +search 等文档检索能力,而非本技能。
前置要求:开始前必须先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证与权限处理说明。
主要能力(Shortcut,优先使用):+info 查看表格与工作表信息;+read 读取单元格值;+write 覆盖写入单元格;+write-image 向单元格写入图片;+append 追加行;+find 查找单元格;+create 创建表格(可选表头行和初始数据);+export 导出表格(异步任务轮询与可选下载);+merge-cells / +unmerge-cells 合并与拆分单元格;+replace 查找替换;+set-style / +batch-set-style 设置单元格样式;+add-dimension / +insert-dimension / +update-dimension / +move-dimension / +delete-dimension 行列增删改移。
原生 API:调用前必须先运行 lark-cli schema sheets.<resource>.<method> 查看参数结构,不要猜测字段格式,再执行 lark-cli sheets <resource> <method> [flags]。资源包括 spreadsheets(create/get/patch)、spreadsheet.sheets(find)、spreadsheet.sheet.filters(create/delete/get/update)。
筛选注意事项:range 必须覆盖所有需筛选的列;已有筛选存在时再 create 会覆盖整个筛选;update 用于在已有筛选上添加或更新指定列条件,只需指定 col 和 condition,无需 range。常见错误包括 Wrong Filter Value(需先 delete 再 create)与 Excess Limit(update 时重复添加同一列条件)。
Token 处理:/docx/、/doc/、/sheets/ 路径中的 token 可直接作为 file_token;/wiki/ 链接的 token 不能直接使用,需先用 wiki.spaces.get_node 查询,依据返回的 obj_type 与 obj_token 选择对应 API。
权限:不同方法需要不同 scope,如 sheets:spreadsheet:create、sheets:spreadsheet.meta:read、sheets:spreadsheet:read、sheets:spreadsheet:write_only 等。
限制:本资料未提供收费、价格与性能等信息,暂未提供。