| 读数据（纯值 / 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、--query（+find 是 +cells-search 的隐藏别名，不在 sheets --help 清单，正式名直给） |
| 条件格式 / 条件高亮 / 数据条 / 色阶 / 重复值标记 | +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 | — |
