Chart Image

核心用法

Chart Image Generator 是一款专为 Fly.io/VPS/Docker 无头部署环境设计的图表生成工具，基于 Vega-Lite 规范渲染 PNG/SVG 图片。通过纯 Node.js 实现，无需浏览器或原生编译，解决了传统方案（Puppeteer、node-canvas）体积庞大、启动慢、依赖复杂的问题。

基础调用模式：

node chart.mjs --type <chart-type> --data '[JSON-array]' --output chart.png

支持图表类型包括：折线图（多系列）、柱状图（堆叠）、面积图、散点图、饼图/环形图、K 线图、热力图等，以及双 Y 轴组合图、迷你 Sparkline 等高级形态。

显著优点

1. 部署友好：~15MB 依赖体积，对比 Puppeteer 方案 400MB+ 缩减 95% 以上；预编译 Sharp 二进制，无需 gcc/make 等构建工具
2. 性能优异：冷启动 <500ms，无浏览器 spin-up 延迟，适合 Serverless/边缘计算场景
3. 功能完整：内置货币/百分比/科学计数法等格式化、暗色模式、社交尺寸预设、时间序列自动解析、注解标记等生产级特性
4. 零外部依赖：纯离线运行，不依赖 QuickChart.io 等第三方 API

潜在局限

• 样式定制深度受限于 Vega-Lite 规范，极端复杂可视化需直接提交自定义 spec
• 无交互能力（静态图片输出），不支持图表动画或用户端tooltip
• JSON 数据输入需前置处理，不直接支持 CSV/Excel 等格式

适合人群

• 运维/监控场景：生成告警配图、Dashboard 截图
• 数据分析师：快速产出报告级图表，无需打开 BI 工具
• 开发者：需要内嵌图表生成的后端服务、Bot、自动化工作流

常规风险

• 输入 JSON 未经验证时可能存在解析异常，需确保数据来源可信
• 文件输出路径需有写入权限，建议使用 /data/clawd/tmp/ 持久化目录
• 大量并发生成时需关注 Sharp 的内存占用（通常单图 <50MB）

核心能力

chart-image 是一款专为无头服务器环境设计的图表生成工具，支持10种图表类型（线图、柱状图、面积图、散点图、饼图/环形图、K线图、热力图、多线图、堆叠图、双轴图）。采用Vega-Lite声明式语法，通过Sharp库输出PNG/SVG，完全脱离浏览器生态。

显著优势

部署友好性是其最大差异化竞争力。对比传统方案：

• 无需Puppeteer/Chrome（节省400MB+空间）
• 无需原生编译工具链（Sharp使用预编译二进制）
• 冷启动<500ms，适合Serverless/Fly.io边缘部署
• 纯离线运行，零外部API依赖

功能完整性覆盖专业场景：

• 金融级K线图+成交量叠加
• 时间序列自动间距（temporal轴类型）
• 多主题/深色模式自动切换
• 社交媒体预设尺寸（Twitter/X/Bluesky/Instagram等）
• 注解系统、参考线、变化率标注等告警场景优化

局限性与约束

1. 交互性缺失：输出静态图片，不支持tooltip/缩放/刷选等交互
2. 样式深度受限：依赖Vega-Lite主题系统，复杂自定义需直接修改Vega-Lite spec
3. 数据规模边界：未明确文档化大数据集性能阈值
4. 字体控制：服务器环境字体依赖系统预装，中文字体需额外配置

适用人群

| 场景 | 匹配度 |

|------|--------|

| Fly.io/VPS/Docker部署的监控告警系统 | ⭐⭐⭐⭐⭐ |

| 需要离线运行的安全敏感环境 | ⭐⭐⭐⭐⭐ |

| Serverless函数快速生成社交分享图 | ⭐⭐⭐⭐⭐ |

| 需要交互式探索性数据分析 | ⭐⭐☆☆☆ |

| 像素级定制品牌视觉规范 | ⭐⭐⭐☆☆ |

风险考量

• 依赖风险：Sharp虽成熟但涉及原生二进制，跨架构部署需验证预编译包可用性
• 输入注入：JSON数据解析需确保来源可信，避免原型链污染攻击
• 路径遍历：--output参数建议增加路径校验，防止写入系统敏感目录

使用建议

推荐搭配--dark --show-change --focus-change --show-values四联参数生成监控告警图，并设置定时任务在20:00-07:00自动启用深色模式。对于中文内容，建议预先在Docker镜像中安装中文字体包。