Echarts Chart Skill

📊 自然语言一键生成专业 ECharts 图表

基于 ECharts 的智能图表生成工具,支持自然语言转图表、自动类型推荐及 HTML/SVG 导出,适用于 Agent 工作流中的可视化需求

收藏
5.1k
安装
1.5k
版本
0.1.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

ECharts Chart Skill 是一款面向 Agent 工作流的智能图表生成工具,支持从自然语言描述或结构化数据自动生成专业级可视化图表。用户可通过简单的 JSON 描述(ChartRequest)指定数据集、目标图表类型及字段映射,系统自动完成图表类型推荐、ECharts 配置生成及最终渲染输出。核心工作流分为三步:首先通过 recommend-chart 命令智能推荐最优图表类型;随后 generate-chart 生成标准化的 ECharts option 配置;最后 render-chart 输出可嵌入的 HTML 或 SVG 文件。工具采用 MIT 开源协议,支持桌面级一键部署(npm install && npm run build),并提供灵活的输出路径管理(支持 --out--out-dirdesktop/home 别名及 ~ 路径扩展)。

显著优点

1. 智能自动化:内置推荐引擎可根据数据特征(字段类型、数据量、目标场景)自动匹配最佳图表类型,降低用户决策成本;
2. 双模输入:同时支持自然语言指令和结构化 JSON 数据,兼顾非技术用户的便捷性与开发者的精确控制需求;

3. 企业级输出:基于 Apache ECharts 引擎生成工业级可视化,支持交互式 HTML 和高保真 SVG 两种格式,满足报告嵌入、打印及大屏展示等多场景需求;

4. Agent 原生设计:专为 AI Agent 工作流优化,提供清晰的命令行接口和确定性输出,便于集成至自动化管道。

潜在缺点与局限性

  • 生态依赖:完全依赖 ECharts 渲染引擎,自定义视觉风格需深入 ECharts 配置体系,对非前端用户存在一定学习曲线;
  • 字段映射约束:对于复杂多表关联或嵌套数据结构,需手动预处理为扁平化 dataset,自动化程度受限;
  • 实时数据支持不足:当前版本未内置数据流更新机制,动态刷新需外部脚本轮询触发重新生成。

适合人群

  • 数据分析师:需要快速将探索性分析结果转化为可交付图表;
  • 产品经理/运营:通过自然语言生成周报、月报中的趋势图、占比图;
  • AI Agent 开发者:为智能助手集成标准化、可复用的可视化能力;
  • 教育/科研人员:低门槛生成学术图表,支持 SVG 矢量输出便于论文排版。

常规风险

  • XSS 风险:生成的 HTML 文件若包含用户输入的未转义内容,可能存在脚本注入隐患(建议对 titleseries.name 等字段实施输入校验);
  • 路径遍历--out 参数若直接拼接用户输入路径,需防范 ../ 等非法路径穿越(当前版本未明确显示路径白名单机制);
  • 依赖供应链:依赖 openclaw 框架及 npm 生态,需关注底层依赖的安全更新;
  • 数据隐私:本地 CLI 执行模式理论上数据不出域,但若未来扩展云端渲染需重新评估传输加密与存储合规性。

综合评估

该工具定位精准,填补了 Agent 工作流中「意图→图表」的自动化鸿沟。开源协议友好(MIT),代码结构清晰(TypeScript),适合作为更大系统的可视化模块嵌入。建议在生产部署前补充输入校验、路径 sanitization 及依赖漏洞扫描。

Echarts Chart Skill 内容

agents文件夹
examples文件夹
src文件夹
cli文件夹
core文件夹
types文件夹
手动下载zip · 35.0 kB
openai.yamltext/plain
请选择文件