Feishu Sheet

📊 命令行操控飞书表格的全能工具

通过命令行完整操控飞书电子表格,支持数据读写、样式设置、图片插入、行列管理等企业级表格操作,需配置飞书应用凭证。

收藏
3.3k
安装
1.4k
版本
1.1.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

飞书电子表格 Skill 是一套基于 Shell 脚本的命令行工具,通过调用飞书开放平台 API 实现对电子表格的全生命周期管理。用户需先在 ~/.openclaw/openclaw.json 中配置飞书应用的 appIdappSecret,脚本将自动读取凭证完成 OAuth 鉴权。

主要功能模块

基础操作:创建表格、获取元数据、管理多工作表(增删复制)

数据读写:支持单/多范围读取、覆盖写入、行尾追加、行前插入,数据格式为 JSON 二维数组

富媒体处理:单元格内嵌图片(本地文件)、浮动图片(支持本地/URL,自动上传)

样式系统:涵盖字体(加粗、斜体、字号、颜色)、对齐方式(水平/垂直)、装饰线(下划线、删除线)、背景色等完整样式属性,支持批量设置

结构操作:合并/拆分单元格(三种合并模式)、行列增删(支持指定位置插入)

数据处理:查找替换功能

显著优点

1. 完整 API 覆盖:相比简单的读写操作,该 Skill 提供了飞书 Sheets API 的几乎全部能力,包括浮动图片、复杂样式、行列操作等企业级需求
2. 命令行友好:纯 Shell 实现,兼容各类自动化场景和 CI/CD 流程

3. 安全凭证管理:凭证集中存储于配置文件,脚本仅读取不硬编码,支持环境变量覆盖配置路径

4. 批量操作支持style_batchread_multi 等命令减少 API 调用次数

潜在缺点与局限性

1. 配置门槛较高:必须注册飞书应用、开通 sheets:spreadsheet 权限、配置凭证,对非技术用户不友好
2. 依赖外部服务:完全依赖飞书 API 可用性,受网络波动和平台限制影响

3. Range 格式严格:必须预先通过 meta 获取 sheetId,不支持类似 Excel 的 Sheet1!A1 简写

4. Shell 转义复杂:JSON 数据在命令行中需要复杂的引号转义,易出错

5. 无事务机制:多步操作失败时无自动回滚能力

6. 权限依赖:目标表格必须对应用机器人开放权限

适合人群

  • 需要将表格操作集成到自动化工作流的开发者/DevOps 工程师
  • 使用飞书作为协作平台的企业 IT 管理员
  • 需要批量生成格式化报表的数据分析师
  • 构建内部工具集的 Python/Shell 开发者

常规风险

  • 凭证泄露风险:配置文件若权限设置不当可能导致 appSecret 泄露
  • 数据覆盖风险write 操作为覆盖模式,误操作可能导致数据丢失
  • API 限流风险:高频批量操作可能触发飞书平台限流
  • 网络中断风险:图片上传等操作在弱网环境下易失败

Feishu Sheet 内容

scripts文件夹
手动下载zip · 7.4 kB
feishu-sheet.shtext/x-shellscript
请选择文件