Feishu Sheet

飞书电子表格管理

Standalone Wrapper

• 共享环境变量：FEISHU_APP_ID、FEISHU_APP_SECRET，可选 FEISHU_BASE_URL、FEISHU_OAUTH_STORE_DIR
• feishu_sheet -> node scripts/sheet.js '<json>'

执行前必读

• 本 skill 面向飞书电子表格，不是多维表格；Airtable 风格数据请改用 feishu-bitable
• create 之外的所有动作都支持 url 或 spreadsheet_token，并支持 wiki URL / wiki token 自动解析
• write 是覆盖写入，高风险；用户没有明确同意时，不要把它当“append”用
• read 默认最多返回 200 行；大表请缩小 range

快速索引：意图 → 工具 → 必填参数

核心约束（Schema 未透露的知识）

1. 支持 wiki URL / wiki token 自动解析

• 如果用户给的是知识库里的表格链接，工具会先把 wiki 节点解析成真实 spreadsheet_token
• 这也是为什么 url 和 spreadsheet_token 二选一即可
• 对用户来说，最稳的是直接给完整表格 URL

2. info 一次返回两类信息

• 表格基础信息
• 全部工作表清单

后续 read / write / find 里需要的 sheet_id，通常都应该先从 info 拿。

3. read 有默认截断保护

• 不指定 range 时，默认读取第一个工作表
• 结果最多返回 200 行；超过时会返回 truncated 和提示信息
• 大表应尽量用显式 range，例如 sheet1!A1:D50

4. write 和 append 不是一回事

写入边界：

• 单次最多 5000 行
• write 单行最多 100 列

5. 导出 CSV 和导出 XLSX 的约束不同

• xlsx 可以导整个表格
• csv 一次只能导一个工作表，因此必须给 sheet_id
• 如果给了 output_path，文件会直接落到本地；不填则只返回导出结果信息

使用场景示例

场景 1：获取表格信息

{
  "action": "info",
  "spreadsheet_token": "sht_xxx"
}

场景 2：读取指定范围

{
  "action": "read",
  "spreadsheet_token": "sht_xxx",
  "range": "sheet1!A1:C20"
}

场景 3：追加多行数据

{
  "action": "append",
  "spreadsheet_token": "sht_xxx",
  "sheet_id": "sheet1",
  "values": [
    ["张三", "工程"],
    ["李四", "运营"]
  ]
}

场景 4：导出为 xlsx

{
  "action": "export",
  "spreadsheet_token": "sht_xxx",
  "file_extension": "xlsx",
  "output_path": "/tmp/report.xlsx"
}

常见错误与排查

官方文档参考

• 电子表格概述: https://open.feishu.cn/document/ukTMukTMukTM/uATMzUjLwEzM14CMxMTN/overview
• 创建电子表格: https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet/create
• 获取电子表格信息: https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet/get
• 读取单个范围: https://open.feishu.cn/document/ukTMukTMukTM/ugTMzUjL4EzM14COxMTN
• 向单个范围写入数据: https://open.feishu.cn/document/ukTMukTMukTM/uAjMzUjLwIzM14CMyMTN
• 追加数据: https://open.feishu.cn/document/ukTMukTMukTM/uMjMzUjLzIzM14yMyMTN
• 查找单元格: https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/sheets-v3/spreadsheet-sheet/find
• 创建导出任务: https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/export_task/create