AIOS Chart Image

Render JSON or Markdown data into ECharts images

AIOS 图表图片生成

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

所有输入文件和输出文件必须遵守 OpenClaw workspace 的 senderId 文件隔离规则。senderId 是生成、下载、上传文件的唯一目录隔离标识；topic_id 不得作为文件目录。图表图片、保存的 ECharts option 和其他渲染中间产物都属于 AI 生成文件，必须写入当前 workspace 的 <senderId>/generated。

适用场景

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

不可违反的规则

• 必须在本 skill 目录中运行内置脚本，确保依赖从本地 node_modules 解析。
• 本项目统一使用 JavaScript/TypeScript；不要为本技能添加 Python 渲染流程。
• 每次运行脚本都必须显式传入当前通道的 --sender-id <senderId>；如果无法确认 senderId，停止生成，不得用 topic_id、用户名或推测值替代。
• 输出到当前工作区内的 <senderId>/generated 目录。
• 输入文件必须来自当前 <senderId> 目录内的 upload、download 或 generated，或通过 stdin / --data 提供；禁止读取其他 senderId 目录。
• 如果需要把生成的图片发给用户，先生成本地文件，再使用 aios-transfer-file 上传返回。
• 如果输入是完整 ECharts option，保留用户提供的 option，只补必要的画布尺寸和背景色。
• 如果输入是表格数据，先选择合适的 chartType、分类字段和数值字段；字段不明确时说明假设。

依赖处理

本技能在 package.json 中声明：

• echarts
• sharp

首次使用前检查依赖：

bash

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

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

bash

npm install

基本用法

从 JSON 或 Markdown 文件生成 PNG：

bash

node scripts/make_chart_image.mjs --workspace "/abs/path/workspace" --sender-id "<senderId>" --input "<senderId>/upload/data.json" --output "chart.png"
node scripts/make_chart_image.mjs --workspace "/abs/path/workspace" --sender-id "<senderId>" --input "<senderId>/upload/table.md" --output "chart.png" --chart-type line

从 stdin 读取：

bash

cat table.md | node scripts/make_chart_image.mjs --workspace "/abs/path/workspace" --sender-id "<senderId>" --input - --output "chart.png"

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

bash

node scripts/make_chart_image.mjs --workspace "/abs/path/workspace" --sender-id "<senderId>" --input "<senderId>/upload/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，未指定时从输出扩展名推断。
• --workspace "/abs/path/workspace"，当前 agent workspace 根目录。
• --sender-id "<senderId>"，当前通道提供的文件隔离标识，必填。
• --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 的真实错误并据实报告，不要声称图片已生成。

脚本成功后，output 和可选的 option 路径必须位于当前 <senderId>/generated 内；如果不是，视为违反文件隔离规则，不得继续使用或发送该文件。