飞书电子表格：创建和操作电子表格。支持创建表格、管理工作表与行列结构（增删/合并/调整尺寸/隐藏/冻结）、读写单元格（值/公式/样式/批注/单元格图片）、查找替换、多操作批量更新，以及图表、透视表、条件格式、筛选器、迷你图、浮动图片等对象的创建与维护。当用户需要创建电子表格、管理工作表、批量读写或编辑数据、统计汇总与可视化、表格美化、公式计算（含 Excel 公式迁移）、金融/财务建模（DCF、三张表、预算、Sensitivity 等）等任务时使用。若用户是想按名称或关键词搜索云空间（云盘/云存储）里的表格文件，请改用 lark-drive 的 drive +search 先定位资源。当用户给

sheets CRITICAL — 开始前 MUST 先用 Read 工具读取 [ ../lark shared/SKILL.md ](../lark shared/SKILL.md)，其中包含认证、权限处理。术语约定同一对象的交替说法，按此映射解析用户口语：工作表（sheet） = 子表 / tab / 标签页（ sheet id 是稳定标识）；电子表格（spreadsheet） = 工作簿 / 表格（顶层容器，由 url 或 spreadsheet token 定位）； reference id = 表内对象的稳定标识，即各对象主键 flag 接受的值（与 image uri 图片上传句柄不是一回事）。每类对象用各自的主键 flag 定位（命名不统一，按此表对照，不要凭直觉拼）：对象主键 flag 对象主键 flag 工作表 sheet sheet id 条件格式规则 rule id 图表 chart chart id 筛选视图 view id 透视表 pivot pivot table id 迷你图（按组） group id 浮动图片 float image id 飞书表格编辑准则（动手前必守，所有编辑类任务一律生效）下列准则横切所有飞书表格任务，动手前先过一遍 ——被索引直接路由进某个工具参考时也一律生效；展开与边界见括注的 reference。 1. 最小改动：除任务要改的单元格 / 列外，原表其它单元格、行列结构、Sheet 名、合并区、格式 1:1 保持；中间结果放原数据右侧或新建空白 Sheet，禁止删 / 改名 / 隐藏 / 移动已存在 Sheet （用户明示要求的除外，确认影响后执行，见 lark sheets workbook ）；改写类任务精确圈定行列，不该转的原值 1:1 保留；补齐类只写空单元格，已有值（哪怕看着可疑）一律不动，最多在交付说明备注。原表数值列的显示格式（小数位 / 千分位 / 是否科学计数法）同属不可改动项；仅当原值已被压成科学计数法或丢小数位时补 number format 恢复可读，底层值不动。新增的计算列 / 汇总行（均值、占比、金额）必须显式设 number format ——公式默认吐出的多位小数（ 3.64507772 ）会被判为格式不合格，按语义定位数（比率两位小数、占比百分比、金额千分位）并与原表同列风格对齐。 2. 真实写回 + 回读校验：交付必须是对在线表格的真实写入，写完用 +csv get / +cells get / +<对象 list 回读确认生效（顺带确认无截断 / 溢出 / 科学计数法）—— 返回 ok 只代表请求被接受，不代表结果符合预期。回读值可能带「值(样式)」注记（如 49.6(V Align: bottom) ），据此回写前先剥离注记只留纯值；写公式后用 +cells get include formula 核对真实落格（仅看显示值不能证明联动）；筛选 / 排序后核对前几行，删除后确认已空。不要只在文本里声称"已完成"。 3. 读全再写：批量填充 / 补齐 / 修正类任务先确认真实数据末行再写，只探前 N 行会漏写表尾（确定末行流程见 lark sheets read data ）。 4. 公式优先于硬编码：凡可由表内其它单元格推导的值（总计 / 占比 / 增长率 / 提取 / 查找）一律写公式，即使用户没说"联动 / 自动更新"——本地算好再静默写进单元格，交付的是改输入不重算的死表。提取类产出同行源列的连续原文片段（逐字保真、不跨列取材，一格含多个片段要全列出）；语义判断类（无固定分隔符 / 模式可循）公式表达不了，逐行写静态值，别用固定偏移 / 通用正则硬套。输入列可能为空时公式先判空返回空（空格按 0 参与算术产出无错误码的错值， IFERROR 拦不住）。写聚合公式（SUM / COUNTIF / AVERAGE 等）前先确认区间的起止两端：起点跳过表头行、终点覆盖真实末行——漏掉末行或把表头算进计数是最常见的错值来源，且结果看着合理、不报错；写完抽查区间首尾两格确认落在数据内。写飞书公式前读 lark sheets formula translation ，落表后用 +formula verify 诊断。试错 3 次仍失败可降级静态值，交付说明写明「静态值 + 失败原因 + 不随源数据更新」。 5. 续写 / 扩展继承样式：续写、补齐、复制区块、新增行列时禁止只读值只写值——原表的字体 / 字号 / 颜色、四边框、对齐、底色（含奇偶行交替）、行高列宽、合并都要一并延续到新区域，判分与验收都按"新区域与相邻原始区域视觉一致"来看。新增行 / 列优先用 +dim insert inherit style before （或 after ），样式由原生继承，比"往空白区直接写值再补刷样式"可靠得多（后者最易整片丢失交替底色与边框）。它只选继承哪一侧，不是插入方向。行高是例外，不随样式继承：插行填长文本前读相邻行 row height ，补 +rows resize （可与插入链合批）。已经写进空白区、或要对齐非相邻区域时，先 +cells get include style 读原区样式，再随值一起写回（清单见 lark sheets write cells ，四边框最易漏）。新增列后把原跨列合并的标题扩展到新末列；插入行复制邻近行的合并分段，按分组合并前逐组核对边界行号，错界会吞掉组名。 6. 多步写入分流：美化收尾（样式 / 合并 / 行高列宽 / 冻结的任意组合）→ 一次 +styles put 声明式规格交付（见 lark sheets styles put ）；同一个写操作打多个区域 → 用该命令自身的复数形态（ ranges / map 入参）；只有跨类型、有顺序依赖的操作链（如插列 → 写表头 → 回填数据）才用 +batch update （high risk write：按下方审批协议先获用户同意再带 yes ；失败处置语义见 lark sheets batch update ）。 7. 分组汇总优先用透视表：参考速查表「分组汇总 / 透视」行；SUMIF / 本地脚本拼假透视表可能丢失原生透视能力，作为风险记录。 8. 回复里声称的每一项，产物里都要能指到位置：交付说明 / 回复正文写了"已生成趋势分析报告""图中对比了两个资产""覆盖 11 种格式"，就必须在产物中真实存在对应的 sheet / 图表对象 / 文字段落，并能说出它在哪张表第几行。文字描述不能替代产物 ——判分只认产物里能被读到的内容，回复里的描述一概不计分。交付前逐条对照自己写的每句"已完成 X"，指不到位置的要么补做，要么把该句删掉改成"未完成 + 原因"。 9. 拆成可验证 checklist ：落地前把指令拆成"独立可验证子要点"，优先逐点 assert 或抽样回读（多维排序每维一点、多目标每目标一点、范围类核起 / 末 / 边界；样式类子项也算——标色 / 标红可回读着色单元格数或规则数）；验证中发现的已知问题（算错 / 取不到数的格）在交付说明逐个列出，避免只报成功示例。 10. 全量处理前置断言条数：翻译 / 打标 / 批量公式等逐条任务，建议先把预期条数写入脚本再 assert actual == expected ；断言不过时优先补齐。机制上补不了时（预算将尽 / 能力缺失）先落地可打开的主体产物（数据与结构），未完成项在交付说明声明。 11. 批量替换 / 标注 / 删除建议残留复查：逐个旧值执行「搜索 → 替换 → 再搜索」循环，尽量让每个旧值剩余命中数归零（单次替换有数量上限，大表尾部常有残留）；回读采样覆盖前部 / 中段 / 表尾，不只抽前几行。 12. 新增内容要能被看懂：新增列给可区分含义的表头（不与原列同名）；题面 / 模板指定的 sheet 名 / 标题 / 备注 / 图例文案逐字照搬，不缩写、不润色、不省略修饰成分与双语形式；数值沿用原列显示格式（整数 / 千分位 / 百分比 / 日期）；日期列转换先扫全列锁定月 / 日位（如 9/3/24 ：出现过 12 的位置是日），逐格凭感觉解析必月日颠倒；图表必须含标题、坐标轴标签与图例；长文本列自动换行并给足列宽。单位 / 口径 / 来源等元信息另置（标题下副标题行，或并进字段名如营收（万元）），不得占用已有表头格或数据格。 13. 表外数据要交代依据：填入表内 / 附件 / 用户输入都取不到的外部数据（标准值、行情、法规参数等）时，交付说明写清取值依据、单位口径与不确定项；来自常识推算就写明"推算、未经核验"，不得伪造来源出处。 14. 缺失值不编造：源数据 / 附件内本应存在的事实数据查不到或无法确定时一律留空 + 备注（“暂未发布 / 未知 / 待核实”），不用推算值 / 估算值充数（表外参数按上条）；原表已示范缺失值写法就照抄该约定。实操展开（读取路径、原生工具优先级、脚本配合、易漏陷阱）见下方「执行要点」节。端到端工作流：了解结构（优先 scripts/lark inspect workbook.py / +workbook info ）→ 读数据 → 理解语义 → 原生工具优先 → 写入 → 回读验证。场景 → 命令速查（拿不准命令名先查这里，别按直觉拼）若本次读取被截断在本表中段：下列能力都原生存在，详细用法（flag、payload 形状、易错点）在本表后半部分与其后的「执行要点」「公共 flag」章节： +styles put 美化收尾（样式 / 边框 / 合并 / 行高列宽 / 冻结一次交付）· +chart create 原生图表 · +pivot create 透视表 · +filter create 筛选 · +cond format create 条件格式 · +range sort 排序 · +dim insert 插入行列 · +cells search / +cells replace 查找替换 · +workbook import 本地文件转在线表要用其中任一能力而对应行未读到时，用文件读取工具的偏移参数（ offset / 起始行）把后半段再读一次，取全对应行再动手。不要因为没读到展开就判定命令不存在，更不要改用本地脚本绕路—— 本地生成的透视表 / 图表导入后会退化成死表、静态图。把高频意图映射到真实存在的 shortcut / flag（agent 常从 Excel / Google Sheets / OpenAPI 误迁移命令名）。选定命令后先读「动手前读」列指向的 reference 再动手 ——命令名对得上不代表用法对。你要做的事 ✅ 正确写法动手前读 ❌ 不存在（会被 cobra 拒）读数据（纯值 / CSV） +csv get （ range 可省略 = 读整个子表，无需先探行列；限定范围才传） lark sheets read data +read data 、 +get range 、 +range get 、 +cells read 读值 + 公式 / 样式 / 批注 +cells get include value,formula,style,comment,data validation lark sheets read data +get cell 、 +cell get 、 sheet （定位只有 sheet id / sheet name ）、 value only 、 include style 、 value render option 、 with styles 、 with merges 、 include merged cells 写纯文本值（整块 CSV 平铺；列里没有需字面保真的数值 / 日期标签 / 编号——点分日期 12.10 、编号 001 会被 csv put 数值化，不算纯文本） +csv put （定位用 start cell ，单个左上角锚点格；也接受 range 别名，区间自动取左上角） lark sheets write cells 把含点分日期( 12.10 )/编号( 001 )的列裸灌 +csv put ——会被数值化（ 12.10 → 12.1 、 001 → 1 ，尾零/前导零丢失），改用 +table put 声明 dtypes:object 写带类型的数据到已有表（列里有数字 / 金额 / 百分比 / 日期 / 计数等本质是量值的数据——不看当下要不要排序 / 求和，量值一律走这里） +table put sheets 完整 payload {"sheets":[{...}]} （列名走 columns 、二维数据走 data 、列 pandas dtype 走 dtypes 、列展示格式走 formats ；来源不限 DataFrame——Counter / dict / list 同理；要同时美化加 styles 一步带样式（区域底色 / 边框 / 列宽 / 行高 / 合并），不必事后再刷；payload 里不存在的 sheet 名会自动建子表，详见 write cells） lark sheets write cells 在本地把数字拼成 "$1,234" / "30.5%" 字符串再 +csv put （会落成文本、丢失计算能力；常见借口见下方 ⚠️）新建电子表格并写带类型的数据（类型保真需求同上，但目标表还不存在） +workbook create sheets （协议与 +table put 同构、一步建表 + typed 写入，无需先建空表再 +table put ；date / number 不丢； styles 同样可在建表同一步带全套样式，详见 workbook） lark sheets workbook 用 values 灌日期 / 数字（会落成文本、丢类型）写公式 / 富写入（样式 · 批注 · 图片 · 富文本），或需精确矩形定位的值 +cells set （单区域 range + cells ；散布多处 / 跨表用 writes 一次批量交付，每项自带 sheet name；批注 / 图片 / 富文本只能用它；公式落表后可用 +formula verify 诊断） lark sheets write cells — 只改样式、值 / 公式不动 +cells set style （单区域小改）；多区域 / 整表美化收尾一次 +styles put 交付（见 lark sheets styles put ） lark sheets write cells +cells set copy to range 刷样式——它连值一起复制，会把整个区域的值覆盖成锚点格的值；拼 +batch update 的 operations 做美化已有表美化收尾（样式 / 边框 / 合并 / 行高列宽 / 冻结的任意组合，单表或多表） +styles put styles '{"styles":[{"name":…,"cell styles":[…],"cell merges":[…],"row sizes":[…],"col sizes":[…],"freeze":{…}}]}' （一份规格一次交付，词汇同 +table put styles ） lark sheets styles put 拼 +batch update 的 operations 子操作数组做美化、逐区域多次 +cells set style 画图表 / 可视化（柱 / 折线 / 饼 / 条 / 散点 / 组合…）普通单图用 +chart create basic ，多图用扁平输入的 +batch chart create ；已有图的数据源用 +chart data update 、常用配置用 +chart config update ；只有语义 shortcut 无法表达的单系列 / 单数据点 / 高级字段才用 +chart create / +chart update ，并只提交必要的局部 properties。多图先断言目标数量，图片迁移成真图表后必须删除并复查原浮动图片 lark sheets chart matplotlib / 本地画图再贴图（原生图表可交互、随数据更新）分组汇总 / 透视 +pivot create （默认不传落点 flag → 自动新建子表，零覆盖） lark sheets pivot table 用 SUMIF / 本地脚本拼一张假透视表排序（按列升 / 降序） +range sort （原生整行原子移动，值 / 样式 / 空值随行走） lark sheets range operations 本地排完再整块 +cells set 回写—— cells set 写空值不覆盖目标格（保留原值），会残留旧值，且样式不随行移动筛选 / 只看符合条件的行（仅行级不裁列；"只保留某几列 / 筛出来另存一张表"→ 不走这里，另建结果 sheet 物化行与列、原表原样保留） +filter create lark sheets filter pandas filter 后覆盖写回（会毁原数据；要保存多份筛选状态用 +filter view create ）查找 / 替换文本 +cells search （找，关键字用 find ）、 +cells replace （替换） lark sheets search replace +cells find 、 +find 、 query 条件格式 / 条件高亮 / 数据条 / 色阶 / 重复值标记 +cond format create lark sheets conditional format +highlight 、 +conditional format 、逐格 +cells set style 硬凑看子表结构（合并 / 行高列宽 / 冻结 / 隐藏） +sheet info lark sheets sheet structure +sheet get 、 +structure get 、 +sheet structure get 插图：图片绑定到某条记录、随行走（凭证 / 证件照 / 商品图 / 头像 / 二维码 / 每行配图） +cells set image （单格 range ，嵌入单元格内） lark sheets write cells — 插图：自由摆放、不绑数据的装饰 / 标识（logo / 水印 / 封面大图 / banner） +float image create （浮动图片，自由定位 + 尺寸 + 层级） lark sheets float image — 迷你图 / 单元格内趋势线 / 胜负图 +sparkline create 等 +sparkline lark sheets sparkline 文本字符（▁▂▃）拼接、matplotlib 贴图（不随数据更新）清除内容 / 格式 +cells clear （high risk write 需用户确认后带 yes ；范围维度用 scope ，取值 content / formats / all） lark sheets range operations type 批量清除多区域 +cells batch clear （high risk write 需用户确认后带 yes ； scope ） lark sheets batch update target 调整列宽 / 行高 +cols resize / +rows resize （行、列是两个独立命令；连同样式一起调时并入 +styles put 的 row sizes / col sizes ） lark sheets range operations dimension （无此 flag）看工作簿 / 子表清单 +workbook info lark sheets workbook +sheet list 、 +workbook get 、 +workbook list 导入本地 xlsx/xls/csv 文件为飞书电子表格 +workbook import file ./x.xlsx （本地表格文件 → 飞书电子表格的正解；仅要导成多维表格 bitable 时才用 drive +import type bitable ） lark sheets workbook drive +import （绕路且要多给 type ）、本地读出数据再 +workbook create 重灌（多此一举）；要给已有工作簿加子表别用它（只会新建独立表，走 +sheet copy / +sheet create ）参考某个已有在线表、把多个本地文件 / 数据各作为一张子表追加进去（不另起独立表）先 +workbook info 拿模板子表 sheet id → +sheet copy 逐张复制模板子表（公式 / 合并 / 分组底色 / 列宽 / 条件格式全继承）再用 +cells 只改数据；无模板可继承时 +sheet create 建空子表 + +table put sheets/ styles 写入 lark sheets workbook 把文件 +workbook import / +workbook create 另起一张独立新表（目标是并入已有工作簿时就跑偏了；这两条只产新表、不接受已有表定位）复核某次（AI）编辑改了什么 / 取两个版本间的变更 +changeset get start revision <编辑前版本（省略 end revision 取到最新；版本差 ≤ 20） lark sheets changeset — 取当前文档 revision（版本号） +revision get lark sheets workbook — 导出 xlsx / 单表 csv +workbook export lark sheets workbook — ⚠️ 动手前的触发式必读（按动作判定，不看主场景）：本次操作只要涉及样式 / 美化（底色 / 边框 / 字号 / 对齐 / 数字格式 / 汇总行 / 配色 / 列宽行高），动手前先读 lark sheets visual standards ；只要要写飞书公式，动手前先读 lark sheets formula translation （飞书函数与 Excel 有差异，凭直觉迁移易错），写完后可读 lark sheets formula verify 并执行 +formula verify 做一次诊断。哪怕主任务是"建表 / 展开数据 / 录入"，只要动作里含美化或写公式就适用——别因"这不算专门的美化 / 公式任务"而跳过。 ⚠️ 两种图片别选错：图若绑定某条记录、要随行排序 / 筛选 / 增删（凭证 / 证件照 / 每行配图，话里带「对应 / 每行 / 这列」等绑定词）→ 单元格图片 +cells set image ；只是自由摆放的装饰（logo / 水印 / 封面）→ 浮动图片 +float image create 。别因「浮动图更好控制 / 更熟」默认选浮动图。 ⚠️ 纯文本还是数值语义（看数据本质，不看当下用途）：金额 / 百分比 / 比率 / 计数 / 日期等本质是量值的数据 → 一律数值写入，常规二维表用 +table put （ dtypes 声明类型 + formats 设展示格式），版式装不下（多级 / 合并表头的宽表 leaderboard 等）改用 +cells set 传数字（百分比传小数 0.4 ）+ number format ，照样显示 40% 且数值无损。只有编号 / 身份证 / 单据号这类本质是标识符、要字面保真的才用 +csv put 平铺。几个常见借口都不成立 ——"只是 leaderboard / 报表展示不用算""版式复杂""样式以后再刷、先铺文本"都不是把百分比写成 "40%" 字符串灌 +csv put 的理由（展示不改变它是数值；类型不能后补，落成文本就回不来）。判据与操作展开见 lark sheets write cells 「数字还是文本」。 ⚠️ 要新建子表 / 整表美化 → 别默认「 +csv put 写值再事后刷样式」： +table put / +workbook create 的 styles 能在写数据的同一步带全套样式（区域底色 / 边框 / 列宽 / 行高 / 合并），且 +table put 的 payload 里若 sheet 名不在工作簿中会自动新建子表—— 纯文本表要新建子表 + 美化时同样走这里（ styles 与列是否 typed 无关），比「 +csv put 写值 + 多次 +cells batch set style / + resize 刷样式」少好几次调用（冻结行列等 sheet 级属性仍需 +dim freeze 单独一步）。存量表事后美化则一次 +styles put 交付（同一份 styles 词汇）。 ⚠️ 定位 flag ： +cells get / +cells set / +csv get 用 range ； +csv put 规范用 start cell （单个左上角锚点格），也接受 range 别名（区间自动取左上角），二者择一即可。 range 只写 A1:B2 纯区间——不接受 OpenAPI 的 sheetId!A1:B2 前缀写法，子表定位必须单独传 sheet id / sheet name （从 OpenAPI 迁移习惯最易踩）。 ⚠️ 读取附加信息一律走 +cells get include … ，没有 with styles 这类 flag；看合并单元格用 +sheet info 的 merged cells ，不要在 +cells get 里找 merge flag。 💡 高频写命令签名（照抄改参即可；各命令 help 的 Tips 段有同款示例）：执行要点（读取 / 原生工具 / 陷阱）读取：按需求选路径（细则见 lark sheets read data ）用户需求读取路径 "完善 / 补齐 / 修正所有 XX"、分析 / 清洗 / 大数据先 scripts/lark profile table.p

lark-sheets