| 读数据（纯值 / CSV） | lark_sheets_csv_get（范围用 range） | lark_get_skill(domain="sheets", section="read-data") | lark_sheets_get_range、lark_sheets_range_get、lark_sheets_cells_read |
| 读值 + 公式 / 样式 / 批注 | lark_sheets_cells_get(include="value,formula,style,comment,data_validation") | lark_get_skill(domain="sheets", section="read-data") | lark_sheets_get_cell、lark_sheets_cell_get、with_styles、with_merges、include_merged_cells |
写纯文本值（整块 CSV 平铺；列里没有需字面保真的数值 / 日期标签 / 编号——点分日期 12.10、编号 001 会被 csv-put 数值化，不算纯文本） | lark_sheets_csv_put（定位用 start_cell，单个左上角锚点格；也接受 range 别名，区间自动取左上角） | lark_get_skill(domain="sheets", section="write-cells") | 把含点分日期(12.10)/编号(001)的列裸灌 lark_sheets_csv_put——会被数值化（12.10→12.1、001→1，尾零/前导零丢失），改用 lark_sheets_table_put 声明 dtypes:object |
| 写带类型的数据到已有表（列里有数字 / 金额 / 百分比 / 日期 / 计数等本质是量值的数据——不看当下要不要排序 / 求和，量值一律走这里） | lark_sheets_table_put(sheets=…) 完整 payload {"sheets":[{...}]}（列名走 columns、二维数据走 data、列 pandas dtype 走 dtypes、列展示格式走 formats；来源不限 DataFrame——Counter / dict / list 同理；要同时美化加 styles 一步带样式（区域底色 / 边框 / 列宽 / 行高 / 合并），不必事后再刷；payload 里不存在的 sheet 名会自动建子表，详见 write-cells） | lark_get_skill(domain="sheets", section="write-cells") | 在本地把数字拼成 "$1,234" / "30.5%" 字符串再 lark_sheets_csv_put（会落成文本、丢失计算能力；常见借口见下方 ⚠️） |
| 新建电子表格并写带类型的数据（类型保真需求同上，但目标表还不存在） | lark_sheets_workbook_create(sheets=…)（协议与 lark_sheets_table_put 同构、一步建表 + typed 写入，无需先建空表再 lark_sheets_table_put；date / number 不丢；styles 同样可在建表同一步带全套样式，详见 workbook） | lark_get_skill(domain="sheets", section="workbook") | 用 values 灌日期 / 数字（会落成文本、丢类型） |
| 写公式 / 富写入（样式 · 批注 · 图片 · 富文本），或需精确矩形定位的值 | lark_sheets_cells_set（定位用 range；批注 / 图片 / 富文本只能用它，公式也可；公式落表后继续 lark_sheets_formula_verify 收尾） | lark_get_skill(domain="sheets", section="write-cells") | — |
| 插图：图片绑定到某条记录、随行走（凭证 / 证件照 / 商品图 / 头像 / 二维码 / 每行配图） | lark_sheets_cells_set_image（单格 range，嵌入单元格内） | lark_get_skill(domain="sheets", section="write-cells") | — |
| 插图：自由摆放、不绑数据的装饰 / 标识（logo / 水印 / 封面大图 / banner） | lark_sheets_float_image_create（浮动图片，自由定位 + 尺寸 + 层级） | lark_get_skill(domain="sheets", section="float-image") | — |
| 查找 / 替换文本 | lark_sheets_cells_search（找，关键字用 find）、lark_sheets_cells_replace（替换） | lark_get_skill(domain="sheets", section="search-replace") | lark_sheets_cells_find、lark_sheets_find、query |
| 看子表结构（合并 / 行高列宽 / 冻结 / 隐藏） | lark_sheets_sheet_info | lark_get_skill(domain="sheets", section="sheet-structure") | lark_sheets_sheet_get、lark_sheets_structure_get、lark_sheets_sheet_structure_get |
| 看工作簿 / 子表清单 | lark_sheets_workbook_info | lark_get_skill(domain="sheets", section="workbook") | lark_sheets_sheet_list、lark_sheets_workbook_get、lark_sheets_workbook_list |
| 复核某次（AI）编辑改了什么 / 取两个版本间的变更 | lark_sheets_changeset_get(start_revision=<编辑前版本>)（省略 end_revision 取到最新；版本差 ≤ 20） | lark_get_skill(domain="sheets", section="changeset") | — |
| 取当前文档 revision（版本号） | lark_sheets_revision_get | lark_get_skill(domain="sheets", section="workbook") | — |
| 导出 xlsx / 单表 csv | lark_sheets_workbook_export | lark_get_skill(domain="sheets", section="workbook") | — |
| 导入本地 xlsx/xls/csv 文件为飞书电子表格 | lark_sheets_workbook_import(file="./x.xlsx")（本地表格文件 → 飞书电子表格的正解；仅要导成多维表格 bitable 时才用 lark-drive 的 lark_drive_import(type="bitable")） | lark_get_skill(domain="sheets", section="workbook") | lark_drive_import（导电子表格时绕了 drive 通道、还要多给 type，应直接用 lark_sheets_workbook_import）、把 .xlsx 在本地读成数据再 lark_sheets_workbook_create 重灌（多此一举，应直接 lark_sheets_workbook_import）、要把文件并入某个已有在线工作簿（给它加子表）却用它——import 只会新建独立表，加子表应走 lark_sheets_sheet_copy / lark_sheets_sheet_create |
| 参考某个已有在线表、把多个本地文件 / 数据各作为一张子表追加进去（不另起独立表） | 先 lark_sheets_workbook_info 拿模板子表 sheet_id → lark_sheets_sheet_copy 逐张复制模板子表（公式 / 合并 / 分组底色 / 列宽 / 条件格式全继承）再用 lark_sheets_cells_* 只改数据；无模板可继承时 lark_sheets_sheet_create 建空子表 + lark_sheets_table_put(sheets=…, styles=…) 写入 | lark_get_skill(domain="sheets", section="workbook") | 把文件 lark_sheets_workbook_import / lark_sheets_workbook_create 另起一张独立新表（目标是并入已有工作簿时就跑偏了；这两条只产新表、不接受已有表定位） |
| 清除内容 / 格式 | lark_sheets_cells_clear（范围维度用 scope，取值 content / formats / all） | lark_get_skill(domain="sheets", section="range-operations") | type |
| 批量清除多区域 | lark_sheets_cells_batch_clear（scope） | lark_get_skill(domain="sheets", section="batch-update") | target |
| 调整列宽 / 行高 | lark_sheets_cols_resize / lark_sheets_rows_resize（行、列是两个独立工具） | lark_get_skill(domain="sheets", section="range-operations") | dimension（无此参数） |
| 分组汇总 / 透视 | lark_sheets_pivot_create（默认不传落点参数 → 自动新建子表，零覆盖） | lark_get_skill(domain="sheets", section="pivot-table") | 用 SUMIF / 本地脚本拼一张假透视表 |
| 画图表 / 可视化（柱 / 折线 / 饼 / 条 / 散点 / 组合…） | lark_sheets_chart_create | lark_get_skill(domain="sheets", section="chart") | matplotlib / 本地画图再贴图（原生图表可交互、随数据更新） |
| 条件高亮 / 数据条 / 色阶 / 重复值标记 | lark_sheets_cond_format_create | lark_get_skill(domain="sheets", section="conditional-format") | lark_sheets_highlight、lark_sheets_conditional_format、逐格 lark_sheets_cells_set_style 硬凑 |
| 筛选 / 只看符合条件的行 | lark_sheets_filter_create | lark_get_skill(domain="sheets", section="filter") | pandas filter 后覆盖写回（会毁原数据；要保存多份筛选状态用 lark_sheets_filter_view_create） |
