SuperAPI AI 工具集

smart-charts

数据与分析

查看项目

更新于 10-15 22:13

技能介绍

用途:把表格数据文件转成交互式 ECharts HTML 图表,适合需要快速出图、离线交付、不搭后端的场景。支持 CSV/TSV/TXT/XLSX/XLS/JSON,内置 32 种图表类型与 default/classic/dark 三套主题,产物为独立 HTML,无 CDN 依赖。

主要能力:CLI 提供数据画像(--profile,输出每列 dtype、基数、缺失率、样本、统计、实体粒度、候选洞察信号、疑似非数据行)、图表生成、多图批量(--charts-file)、多文件合并、地图渲染(内置中国省级与世界国家级,更细区域需自备 GeoJSON 并用 --geo-path)。清洗与聚合通过 --transform-code 在沙箱内执行,可用变量仅 df/pd/np,须产出名为 result 的 DataFrame,禁止 import/open/try 等。

使用方式:先按意图分支。意图明确时直接选图型、轴与聚合口径出图;意图不明确时先运行 python {skill_base}/scripts/cli.py <file> --profile,再据客观事实决定 1~3 张图。常用命令如 python {skill_base}/scripts/cli.py data.xlsx bar --title "标题" --output-dir ./out --x-axis name --y-axis value --transform-code "result = df['类别列'].fillna('未标注').value_counts().rename_axis('name').reset_index(name='value')"。多图用 --charts-file charts.json。轴与系列显示名用 --x-name/--y-name/--series-name(s)。脏表头用 --header-row N、--drop-rows、--sheet 等 flags。交付时须附 LLM 撰写的文字解读并通过 --annotation 注入,且显式指定 --output-dir。

限制:不支持带后端的 dashboard、图片/音频/视频等非表格内容、无数据文件的纯文字需求;嵌套 JSON 超过一层不支持;市级/区县级地图需自备 GeoJSON;gauge/liquid 出达成率须传 --target;解读数字须可溯源,不得编造。具体错误码、完整参数与 FAQ 见 REFERENCE.md。