lark-sheets

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md ，其中包含认证、权限处理 飞书开放平台中，不同类型的文档有不同的 URL 格式和 Token 处理方式。在进行文档操作（如添加评论、下载文件等）时，必须先获取正确的 file_token 。 知识库链接（ /wiki/TOKEN ）背后可能是云文档、电子表格、多维表格等不同类型的文档。 不能直接假设 URL 中的 token 就是 file_token ，必须先查询实际类型和真实 token。 使用 wiki.spaces.get_node 查询节点信息 从返回结果中提取关键信息 根据 obj_type 使用对应的 API 返回结果示例： 操作流程（重要）： create — 创建筛选 update — 更新筛选 delete — 删除筛选 get — 获取筛选状态 多列筛选示例： 创建媒体名称(B列)和情感分析(E列)的双重筛选： 常见错误： 接受二维数组的 shortcut（ +write / +append 的 --values 、 +create 的 --data ）中，每个单元格值支持以下类型。 公式、带文本链接、@人、@文档、下拉列表必须使用对象格式 ，直接传字符串会被当作纯文本存储。 写入公式示例 ： 公式语法参考 ：涉及 ARRAYFORMULA、原生数组函数、MAP/LAMBDA、日期差、Excel 公式改写等飞书特有规则时，先阅读 references/lark-sheets-formula.md 。 限制 ： Shortcut 是对常用操作的高级封装（ lark-cli sheets + [flags] ）。有 Shortcut 的操作优先使用。 浮动图片相关的读接口只返回元数据（含 float_image_token ）， 不包含图片字节 。要读取图片内容，用 token 调 lark-cli docs +media-preview --token " " --output ./image.png 。 重要 ：使用原生 API 时，必须先运行 schema 查看 --data / --params 参数结构，不要猜测字段格式。 - 按标题或关键词找云空间里的表格文件，先用 lark-cli docs +search 。 - docs +search 会直接返回 SHEET 结果，不要把它误解成只能搜文档 / Wiki。 - 已知 spreadsheet URL / token 后，再进入 sheets +info 、 sheets +read 、 sheets +find 等对象内部操作。 - 使用 wiki.spaces.get_node 查询节点信息 lark-cli wiki spaces get_node --params '{"token":"wiki_token"}' - 从返回结果中提取关键信息 - node.obj_type ：文档类型（docx/doc/sheet/bitable/slides/file/mindnote） - node.obj_token ： 真实的文档 token （用于后续操作） - node.title ：文档标题 - 根据 obj_type 使用对应的 API...