飞书电子表格是很多团队日常协作中离不开的工具——做项目排期、记财务流水、统计运营数据，都靠它。但有一个麻烦一直存在：你想让 AI 帮你处理表格里的数据，比如从一堆数字里提取规律、批量填充内容、或者把分析结果写回表格，AI 却够不着这些数据。你得手动导出、处理、再导进去，来回折腾。
lark-sheets 就是来解决这个问题的。它是飞书官方 CLI 工具 lark-cli 的 AI Agent Skill 套件之一，由 larksuite 团队维护。整个 lark-cli 体系覆盖了飞书的 17 个业务领域，提供了 200 多条命令和 24 个 AI Agent Skill。lark-sheets 专门负责电子表格这一块——让 AI 编程助手（Claude Code、Cursor、Codex 等）能够通过自然语言直接操作飞书电子表格，读写数据、管理表结构、做分析，全程不用离开聊天窗口。
这个技能能做什么
lark-sheets 覆盖了飞书电子表格操作的绝大部分需求。技能版本 3.0.0，功能已经相当成熟。
表格与工作表管理：创建新的电子表格；在工作簿内创建、复制、删除、更新工作表；管理工作表与行列结构——增删行列、合并单元格、调整尺寸、隐藏、冻结。
单元格读写：读取和写入单元格的值；支持公式、样式、批注、数据验证、单元格图片等丰富内容类型；批量读写和编辑数据；追加行数据；查找和替换内容。
数据导入导出：导出整个工作簿为 xlsx 格式，或导出单个工作表为 csv；导入本地 xlsx、xls、csv 文件为飞书电子表格。注意，导入电子表格要用 +workbook-import，而不是走 drive 通道再转一道。
数据可视化与分析：创建图表（柱状图、折线图、饼图、条形图、散点图、组合图等）；创建透视表进行数据分组汇总；创建条件格式（数据条、色阶、重复值标记等）；创建筛选器；迷你图和浮动图片对象的创建与维护。
高级单元格操作：富文本单元格——支持超链接（带显示文本）、@提及、@文档、下拉列表等；跨表公式引用（IMPORTRANGE），支持最多 5 层嵌套。
URL 智能识别：当用户给出飞书电子表格的 URL 时（包括 doubao.com 域名的 /sheets/ 链接），技能会直接识别并处理，路由依据是 URL 路径模式和 token，而不是域名。
安装方法
lark-sheets 支持 Claude Code、Codex、Cursor、Windsurf 等多种 AI 编程助手。
通过 npx skills 安装（推荐） ：
在项目根目录打开终端，执行以下命令：
npx skills add https://github.com/larksuite/cli --skill lark-sheets
执行后 CLI 会列出可用的 AI 编程助手列表，用箭头键和空格选择你使用的工具（如 Cursor、Claude Code 等），技能会自动配置到对应环境中。
指定 Agent 安装：
如果只想为某个特定的 AI 助手安装，可以用 --agent 参数指定：
npx skills add larksuite/cli --skill lark-sheets --agent claude-code
这条命令会把技能安装到当前项目的 .claude/skills/ 目录下。
全局安装（适用于所有项目） ：
npx skills add larksuite/cli --skill lark-sheets -g -y
通过 skillsauth 安装：
npx skillsauth add aiskillstore/marketplace lark-sheets前置条件：
安装完成后，技能文件会存放在对应目录下（如 .cursor/skills/lark-sheets/ 或 .claude/skills/）。重启 AI 编程助手即可生效。
重要提醒：开始操作前，技能会先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含了认证和权限处理的关键信息。这一步不能跳过。
什么时候该用它
lark-sheets 的使用边界非常清晰。
应该使用的情况：
需要创建新的飞书电子表格
需要在已有的电子表格中批量读写或编辑数据
需要管理工作表（增删改查子表）
需要做统计汇总与数据可视化
需要对表格进行美化、设置条件格式
需要做公式计算，包括从 Excel 迁移公式
需要进行金融/财务建模——DCF 分析、三张表、预算编制、敏感性分析等
需要导出表格或导入本地 Excel/CSV 文件
不应该使用的情况：
想按名称或关键词搜索云空间里的表格文件——这种情况应该用
lark-drive的drive +search先定位资源上传文件到知识库节点下——走
lark-drive编辑文档内容或操作多维表格（Base）——分别走
lark-doc和lark-base知识空间节点和成员管理——走
lark-wiki
使用案例
案例一：创建项目预算表
你正在启动一个新项目，需要一张预算跟踪表。对 AI 助手说：“帮我建一个飞书电子表格，标题是‘项目预算’，表头是：类别、预算金额、已支出、剩余。”
lark-sheets 会创建一个新的电子表格，生成四个列的表头，并返回表格的标题、链接和 token 摘要。你直接打开链接就能继续编辑。
案例二：批量导入本地数据
你的本地电脑上有一个 销售数据.xlsx 文件，里面是上个月的销售明细，想导入到飞书里做成在线表格方便团队协作。
对 AI 助手说：“把这个 Excel 文件导入到飞书电子表格。”
lark-sheets 会执行 +workbook-import --file ./销售数据.xlsx，把本地文件完整转换为飞书在线电子表格。导入后直接生成一个可分享的在线链接。
案例三：从表格里提取数据做分析
你的团队用飞书表格记录了三个月的运营数据，有几千行。你想看看哪个渠道的转化率最高。
对 AI 助手说：“帮我读取‘运营数据’表格里 B 列到 G 列的数据，按渠道分组算一下平均转化率。”
lark-sheets 会读取指定范围的数据，完成分组统计，把结果返回给你。数据量大的时候，结果可以直接落盘做分析，不用全部塞进上下文。
案例四：批量更新库存表
仓库的库存表格每天都需要更新——新到货的 SKU 要加进去，卖完的要标记为“缺货”。逐行手动操作太费时间。
对 AI 助手说：“把‘库存表’里 SKU 以‘A’开头的行，状态列全部改成‘在售’。”
lark-sheets 会在表格中查找匹配条件的内容，批量更新对应的单元格。整个过程一句话完成。
案例五：把表格数据做成图表
表格里有一年的月度销售数据，老板想看趋势图。
对 AI 助手说：“在‘年度销售’表格里，用 A 列（月份）和 B 列（销售额）生成一个折线图。”
lark-sheets 会调用 +chart-create 在表格中创建原生图表。这个图表是交互式的，会随数据更新而变化，不是一张静态截图。
案例六：导出表格给外部合作方
合作方需要一份 Excel 格式的数据，但他们不用飞书。
对 AI 助手说：“把‘供应商清单’表格导出成 Excel 文件。”
lark-sheets 执行 +workbook-export，导出 xlsx 格式文件，返回下载链接或文件信息。
几个值得注意的细节
lark-sheets 和 lark-base 是两回事：飞书有“电子表格”（Sheets）和“多维表格”（Base）两种产品。前者是传统网格状表格，适合财务计算、自由格式数据；后者是结构化的业务数据库。lark-sheets 只管电子表格，多维表格的操作要交给 lark-base。
导入文件有正确的路径：要把本地 Excel 导入成飞书电子表格，应该用 +workbook-import。如果走 drive +import --type sheet 也能行，但那是绕了远路。只有导入成多维表格（bitable）时才用 drive +import --type bitable。
导入 vs 追加，场景不同：+workbook-import 会创建一个全新的独立表格。如果你的目标是往已有的在线工作簿里增加子表，应该用 +sheet-copy 或 +sheet-create。
条件格式不是静态背景色：飞书表格的“颜色标记”本质上是条件格式规则，不是静态背景色。用户说“把销售额大于 10 万的行标成绿色”时，应该走 +cond-format-create，而不是用 +cells-set 去写静态背景色。当数据量超过 1000 行时，条件格式是首选方案——它由飞书自身渲染，性能更好。
URL 中的 token 直接可用：飞书电子表格 URL 路径中的 token（如 https://xxx.larksuite.com/sheets/shtcnxxxxxxxxx 中的 shtcnxxxxxxxxx）可以直接作为 file_token 使用。
◯ 评论 0