chart-image

核心用法

chart-image 是一款专为服务器端部署优化的图表生成技能，通过命令行接口将JSON数据转换为PNG或SVG格式的可视化图表。用户通过--type指定图表类型（line/bar/area/pie/donut/candlestick/heatmap等），--data传入JSON数组数据，，--output设定输出路径即可完成生成。支持多系列对比、堆叠柱状图、K线图OHLC数据、热力图、成交量叠加等复杂场景，并提供丰富的视觉定制选项包括暗黑模式、坐标轴格式、颜色方案、时间序列处理等。

显著优点

部署友好性是该技能最大亮点：采用Sharp预编译二进制替代Canvas原生编译，彻底摆脱Puppeteer/Chrome依赖，镜像体积从400MB+压缩至约15MB，冷启动时间控制在500ms以内，完美适配Fly.io、VPS、Docker等受限环境。功能层面覆盖9大图表类型与20+配置参数，支持Sparkline微图表、动态注解、百分比/货币/科学计数等专业格式，且完全离线运行无需API密钥。Vega-Lite的声明式语法保证了图表的学术出版品质。

潜在缺点与局限性

输入数据依赖JSON.parse()()解析但未做严格校验，异常数据可能导致崩溃；文件输出路径完全由用户参数控制，存在误覆盖风险；不支持实时交互式图表，仅生成静态图片；复杂自定义需求需直接编写Vega-Lite规范JSON。此外，Sharp预编译二进制在部分ARM架构或精简容器环境中可能遇到兼容性问题。

适合的目标群体

DevOps工程师与后端开发者（需要监控告警图表）、数据分析师（快速生成报告插图）、量化交易团队（K线与成交量可视化）、SaaS产品团队（用户数据导出功能）、以及任何在容器化/无服务器环境中需要图表能力的开发者。

使用风险

主要风险集中于输入处理环节：未经验证的JSON数据可能触发解析异常或内存占用过高；用户可控的输出路径若指向系统关键文件将导致覆盖损失。建议始终将输出目录限定于/data/clawd/tmp//等隔离路径，并对输入数据实施大小限制与结构预检。依赖项Vega与Sharp均为活跃维护的主流库，供应链风险可控。