mcpField
F
feishu-cli-data

feishu-cli-data

github.com/riba2534数据与数据库1.4k142 次安装3 周前更新
代码仓库

关于 feishu-cli-data

面向 Feishu Sheet 和多维表格操作的工作流 Skill，按任务类型提供对应流程与执行规则。涵盖 URL 识别、身份控制、写入预览和图片单元格处理。

主要功能

  1. 01区分 Sheet 与 Bitable 任务
  2. 02覆盖表格读写与格式操作
  3. 03支持字段、记录和视图管理
  4. 04写操作可先进行 dry-run
  5. 05规范原生图片单元格写入

适用场景

  1. 01按链接类型选择表格操作流程
  2. 02批量修改 Bitable 记录前验证字段
  3. 03预览写操作后再执行
  4. 04将图片写入 Sheet 原生图片单元格

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-data

安装后在 Claude Code 中输入/feishu-cli-data确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
evals.json
evals/fixtures/
select-field.json
references/workflows/bitable/
workflow.md
references/workflows/sheet/
workflow.md
references/workflows/sheet/references/
basic-commands.md

详细介绍

来自项目 README

飞书表格与多维表格

加载工作流后，将其中 references/、scripts/、templates/、examples/ 相对路径按该 workflow.md 所在目录解析；执行脚本时使用解析后的实际路径，不要依赖当前 shell 目录。

路由

意图读取文件
Sheet 创建、读写、样式、筛选视图、下拉、图片、导入导出references/workflows/sheet/workflow.md
Bitable/Base 表、字段、记录、视图、权限、表单、工作流references/workflows/bitable/workflow.md

执行规则

  1. 先识别 URL：/sheets/ 是 Sheet，/base/ 是 Bitable。
  2. Sheet 使用 spreadsheet token + sheet ID；Bitable 统一使用 --base-token，身份通过 --as bot|user|auto 控制。
  3. 写操作先用 --dry-run（命令支持时），批量操作先用少量记录验证字段类型。
  4. 不要把 Bitable field create 的 body 额外包进 field 对象；直接使用命令帮助要求的字段 JSON。
  5. Sheet 写入单元格图片规则：单个图片使用 sheet image write-image <spreadsheet_token> <sheet_id> --range <cell> --image <path|url>；批量图片统一使用 sheet image write-batch <spreadsheet_token> <sheet_id> --manifest <file|-|json>。严禁用 V2 sheet write 写 =IMAGE(...) 字符串公式，也严禁在 sheet import-md 中使用 Markdown 图片语法 ![]()，两者均无法生成可渲染的原生图片单元格。命令统一支持本地路径与 HTTPS URL，写入原生图片单元格后均自动通过 V3 read-rich 回读验证 image_token。

评论

支持 Markdown