SuperAPI AI 工具集

xlsx-financial-report

数据与分析

查看项目

更新于 10-16 10:26

技能介绍

用途

该技能用于生成一个 .xlsx 文件,由 openpyxl 库生成,形式为简洁的财务 / KPI / 仪表盘式报表。适用于用户提出「Excel 报表」「财务报告」等请求的场景。生成方式为编写 Python 程序并通过 execute_python_code 工具运行;文件保存到工作区后,报告路径并附一行内容摘要。

主要能力

  • 生成原生的 Excel (.xlsx) 文件,采用财务 / KPI / 仪表盘报表的排版风格。
  • 支持标题行、冻结表头窗格、使用纸色调交替的行带、顶部摘要 KPI 区块。
  • 支持数字格式代码(整数、货币、百分比、变化率、大数格式、日期等)。
  • 支持图表样式:折线图(LineChart)、柱状图(BarChart type="col")、散点图(ScatterChart);最多两个数据系列,仅使用 ink 与 accent 两种颜色。
  • 支持冻结窗格、交替行带与条件格式(单色数据条、双档 min→max 刻度)。

使用方式

  • 通过编写 Python 程序并经由 execute_python_code 工具运行来生成 .xlsx 文件。
  • 所需运行时包:沙箱内的 execute_python_code 已预装 pandas、numpy、matplotlib、openpyxl>=3.1.0,无需额外安装步骤,直接在脚本顶部 import openpyxl 即可。execute_python_code 只接受 code 与 capture_output 参数,没有 packages 参数。
  • 文件保存:execute_python_code 已以任务输出目录作为当前工作目录,使用纯文件名保存,例如 wb.save("xagent_metrics_dashboard.xlsx")。不要使用 /workspace/foo.xlsx(该主机上不存在 /workspace),不要使用 output/foo.xlsx(没有嵌套的 output/ 子目录),不要使用 BytesIO + base64 往返。保存后用 os.path.getsize() 验证;真实的 openpyxl 生成的 xlsx 总是大于 5 KB,若保存文件小于 1 KB 则为损坏或空文件。
  • 在对话中生成可点击链接:Python 执行器在每个生成的工作区文件响应中返回 markdown_link 字段(或含每个文件一项的 file_refs[] 数组)。读取工具响应并原样使用返回的 markdown_link 字符串。最终答案的第一行必须是该链接。

适用场景

适用于需要生成财务 / KPI / 仪表盘式 Excel 报表的场景,报表内容需匹配用户的语言(若提示为中文,则工作簿中的所有文本均须使用中文)。配色从 5 个预设调色板中选择一个,每个调色板仅含 4 个十六进制值(ink、paper、paper_tint、accent)。字体仅限两种:标题 / 表头使用 Cambria,正文 / 数据使用 Calibri。

限制

  • 禁止三维图表、切片超过 5 块的环形 / 饼图、爆炸饼图。
  • 禁止彩虹色图表配色、图表阴影、发光、斜角、渐变填充、粗边框、滥用合并单元格(仅节横幅跨列合并)、用作装饰的 emoji。
  • 禁止 Comic Sans、Arial Black、MS Sans Serif 字体。
  • 禁止彩虹色条件格式(仅单色数据条 / 双档 min→max 刻度)。
  • 仅使用真实数据,不得虚构数字;若用户未提供数据需先询问。
  • 图表类型仅允许 LineChart、BarChart(type="col",绝不使用三维)、ScatterChart;绝不导入 BarChart3D、PieChart3D 等。
  • 单一数据系列不显示图例;两个数据系列时图例在右侧,无边框、无填充。
  • 若 execute_python_code 在多次重试后仍报错,应停止并向用户报告实际错误,不得写入占位文件以显示链接。若图表渲染失败,应交付无图表的真实 .xlsx 并告知用户图表已省略。