ClawHub

Aios Make Chart Image

Other

当 OpenClaw 或 AIOS agent 需要把 JSON、Markdown 表格或 ECharts option 渲染成图表图片时，必须使用本技能。使用内置 JavaScript 脚本解析数据、生成 ECharts 配置，并导出 PNG、SVG、JPEG 或 WebP 图片；不要临时手写浏览器截图流程。

Install

openclaw skills install aios-make-chart-image

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 的真实错误并据实报告，不要声称图片已生成。