Back to Deer Flow

generate_spreadsheet — 电子表格/数据透视表

skills/public/chart-visualization/references/generate_spreadsheet.md

latest1.6 KB
Original Source

generate_spreadsheet — 电子表格/数据透视表

功能概述

生成电子表格或数据透视表,用于展示结构化的表格数据。当提供 rowsvalues 字段时,渲染为数据透视表(交叉表);否则渲染为常规表格。适合展示结构化数据、跨类别比较值以及创建数据汇总。

输入字段

必填

  • data: array<object>,表格数据数组,每个对象代表一行。键是列名,值可以是字符串、数字、null 或 undefined。例如:[{ name: 'John', age: 30 }, { name: 'Jane', age: 25 }]

可选

  • rows: array<string>,数据透视表的行标题字段。当提供 rowsvalues 时,电子表格将渲染为数据透视表。
  • columns: array<string>,列标题字段,用于指定列的顺序。对于常规表格,这决定列的顺序;对于数据透视表,用于列分组。
  • values: array<string>,数据透视表的值字段。当提供 rowsvalues 时,电子表格将渲染为数据透视表。
  • theme: string,默认 default,可选 default/dark
  • width: number,默认 600
  • height: number,默认 400

使用建议

  • 对于常规表格,只需提供 data 和可选的 columns 来控制列的顺序。
  • 对于数据透视表(交叉表),提供 rows 用于行分组,columns 用于列分组,values 用于聚合的值字段。
  • 确保数据中的字段名与 rowscolumnsvalues 中指定的字段名一致。

返回结果

  • 返回电子表格/数据透视表图片 URL,并附 _meta.spec 供后续编辑。