AIOS 图表图片生成

本技能用于把结构化数据生成 ECharts 图表，并导出为图片文件。优先使用内置脚本 scripts/make_chart_image.mjs，不要在对话中临时拼一个替代渲染脚本。

适用场景

• 用户提供 JSON 数据并要求生成柱状图、折线图、饼图、散点图等图片。
• 用户提供 Markdown 表格并要求生成图表图片。
• 用户提供完整 ECharts option，需要稳定导出为图片。
• 需要把图表文件继续通过 aios-transfer-file 返回给用户。

不可违反的规则

• 必须在本 skill 目录中运行内置脚本，确保依赖从本地 node_modules 解析。
• 本项目统一使用 JavaScript/TypeScript；不要为本技能添加 Python 渲染流程。
• 优先输出到当前工作区内的 file_output 或用户明确指定的工作区路径。
• 如果需要把生成的图片发给用户，先生成本地文件，再使用 aios-transfer-file 上传返回。
• 如果输入是完整 ECharts option，保留用户提供的 option，只补必要的画布尺寸和背景色。
• 如果输入是表格数据，先选择合适的 chartType、分类字段和数值字段；字段不明确时说明假设。

依赖处理

本技能在 package.json 中声明：

• echarts
• sharp

首次使用前检查依赖：

cd /path/to/aios-make-chart-image
npm ls echarts sharp --depth=0

如果依赖缺失，在本 skill 目录执行：

npm install

基本用法

从 JSON 或 Markdown 文件生成 PNG：

node scripts/make_chart_image.mjs --input "/abs/path/data.json" --output "/abs/path/chart.png"
node scripts/make_chart_image.mjs --input "/abs/path/table.md" --output "/abs/path/chart.png" --chart-type line

从 stdin 读取：

cat table.md | node scripts/make_chart_image.mjs --input - --output "/abs/path/chart.png"

保存推断出的 ECharts option 便于审查：

node scripts/make_chart_image.mjs --input data.md --output chart.png --save-option chart.option.json

支持的输入

JSON 输入可以是：

• 完整 ECharts option，例如包含 series、xAxis、yAxis 等字段的对象。
• { "option": { ... } } 包装形式。
• 行对象数组：[{ "month": "Jan", "sales": 120 }, ...]
• 首行为表头的二维数组：[["month", "sales"], ["Jan", 120]]
• { "columns": [...], "rows": [...] }
• { "labels": [...], "values": [...] }

Markdown 输入使用第一张标准 Markdown 表格，并会尝试从第一个一级/二级标题读取默认标题。

常用参数

• --chart-type auto|bar|line|pie|scatter，默认 auto。
• --title "标题"，覆盖输入里的标题。
• --width 1200 --height 800，默认 1200x800。
• --format png|svg|jpg|jpeg|webp，未指定时从输出扩展名推断。
• --x field，指定分类字段。
• --y field1,field2，指定数值字段。
• --name field --value field，指定饼图字段。
• --theme light|dark，默认 light。
• --save-option file.json，保存最终 ECharts option。

输出要求

脚本成功后会在 stdout 输出 JSON，至少包含：

• output
• format
• width
• height
• chartType

如果脚本失败，读取 stderr 的真实错误并据实报告，不要声称图片已生成。