| 读数据（纯值 / 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 平铺；列里没有需字面保真的数值 / 日期标签 / 编号——点分日期 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；批注 / 图片 / 富文本只能用它，公式也可；公式落表后继续 +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（导电子表格时绕了 drive 通道、还要多给 --type，应直接用 +workbook-import）、把 .xlsx 在本地读成数据再 +workbook-create 重灌（多此一举，应直接 +workbook-import）、要把文件并入某个已有在线工作簿（给它加子表）却用它——import 只会新建独立表，加子表应走 +sheet-copy / +sheet-create |
| 参考某个已有在线表、把多个本地文件 / 数据各作为一张子表追加进去（不另起独立表） | 先 +workbook-info 拿模板子表 sheet_id → +sheet-copy 逐张复制模板子表（公式 / 合并 / 分组底色 / 列宽 / 条件格式全继承）再用 +cells-* 只改数据；无模板可继承时 +sheet-create 建空子表 + +table-put --sheets/--styles 写入 | lark-sheets-workbook | 把文件 +workbook-import / +workbook-create 另起一张独立新表（目标是并入已有工作簿时就跑偏了；这两条只产新表、不接受已有表定位） |
| 清除内容 / 格式 | +cells-clear（范围维度用 --scope，取值 content / formats / all） | lark-sheets-range-operations | --type |
| 批量清除多区域 | +cells-batch-clear（--scope） | lark-sheets-batch-update | --target |
| 调整列宽 / 行高 | +cols-resize / +rows-resize（行、列是两个独立命令） | lark-sheets-range-operations | --dimension（无此 flag） |
| 分组汇总 / 透视 | +pivot-create（默认不传落点 flag → 自动新建子表，零覆盖） | lark-sheets-pivot-table | 用 SUMIF / 本地脚本拼一张假透视表 |
| 画图表 / 可视化（柱 / 折线 / 饼 / 条 / 散点 / 组合…） | +chart-create | 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） |
