| 读数据（纯值 / CSV） | +csv-get（--range 可省略 = 读整个子表，无需先探行列；限定范围才传） | lark-sheets-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、--with-styles、--with-merges、--include-merged-cells |
| 写纯文本值（整块 CSV 平铺；列里没有需字面保真的编号 / 点分日期） | +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 '{"sheets":[{"name":…,"columns":[…],"dtypes":{…},"formats":{…},"data":[[…]]}]}'（不存在的 sheet 名自动建子表；同时美化加 --styles 一步带样式，详见 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-image（单格 --range，嵌入单元格内） | lark-sheets-write-cells | — |
| 插图：自由摆放、不绑数据的装饰 / 标识（logo / 水印 / 封面大图 / banner） | +float-image-create（浮动图片，自由定位 + 尺寸 + 层级） | lark-sheets-float-image | — |
| 查找 / 替换文本 | +cells-search（找，关键字用 --find）、+cells-replace（替换） | lark-sheets-search-replace | +cells-find、+find、--query |
| 看子表结构（合并 / 行高列宽 / 冻结 / 隐藏） | +sheet-info | lark-sheets-sheet-structure | +sheet-get、+structure-get、+sheet-structure-get |
| 看工作簿 / 子表清单 | +workbook-info | lark-sheets-workbook | +sheet-list、+workbook-get、+workbook-list |
| 复核某次（AI）编辑改了什么 / 取两个版本间的变更 | +changeset-get --start-revision <编辑前版本>（省略 --end-revision 取到最新；版本差 ≤ 20） | lark-sheets-changeset | — |
| 取当前文档 revision（版本号） | +revision-get | lark-sheets-workbook | — |
| 导出 xlsx / 单表 csv | +workbook-export | lark-sheets-workbook | — |
| 导入本地 xlsx/xls/csv 文件为飞书电子表格 | +workbook-import --file ./x.xlsx（仅要导成多维表格 bitable 时才用 drive +import --type bitable） | lark-sheets-workbook | drive +import（绕路）、本地读 .xlsx 再 +workbook-create 重灌（多此一举）、想并入已有工作簿却用它（import 只会另起新表，加子表走 +sheet-copy / +sheet-create） |
| 参考某个已有在线表、把多份数据各作为一张子表追加进去 | 先 +workbook-info → +sheet-copy 复制模板子表（公式 / 合并 / 底色 / 列宽全继承）再 +cells-* 只改数据；无模板可继承时 +sheet-create + +table-put --sheets/--styles | lark-sheets-workbook | +workbook-import / +workbook-create 另起独立新表（这两条只产新表、不接受已有表定位） |
| 已有表美化收尾（样式 / 边框 / 合并 / 行高列宽 / 冻结的任意组合，单表或多表） | +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 |
| 清除内容 / 格式 | +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） |
| 分组汇总 / 透视 | +pivot-create（默认不传落点 flag → 自动新建子表，零覆盖） | lark-sheets-pivot-table | 用 SUMIF / 本地脚本拼一张假透视表 |
| 画图表 / 可视化（柱 / 折线 / 饼 / 条 / 散点 / 组合…） | +chart-create（先 +chart-create --print-example <column|bar|line|pie|combo…> 本地拿最小可用 --properties 模板，改 refs / index 即可用） | lark-sheets-chart | matplotlib / 本地画图再贴图（原生图表可交互、随数据更新） |
| 条件高亮 / 数据条 / 色阶 / 重复值标记 | +cond-format-create | lark-sheets-conditional-format | +highlight、+conditional-format、逐格 +cells-set-style 硬凑 |
| 筛选 / 只看符合条件的行 | +filter-create | lark-sheets-filter | pandas filter 后覆盖写回（会毁原数据；要保存多份筛选状态用 +filter-view-create） |
