---

slug: "chart-craft"
name: "chart-craft"
version: 1.0.1
displayName: "图表工坊专业版"
summary: "企业级图表生成平台，支持12种高级图表类型、自定义模板、批量生成、多格式导出与使用分析。图表工坊专业版是一款面向团队与企业的图表生成平台，在免费版四种基础图表基础上，新增堆叠柱状图、面积图、"
summary_zh: "企业级图表生成平台，支持12种高级图表类型、自定义模板、批量生成、多格式导出与使用分析。图表工坊专业版是一款面向团队与企业的图表生成平台，在免费版四种基础图表基础上，新增堆叠柱状图、面积图、"
license: "MIT"
edition: "pro"
description: |-
  图表工坊专业版是一款面向团队与企业的图表生成平台，在免费版四种基础图表基础上，新增堆叠柱状图、面积图、雷达图、热力图等8种高级图表类型，并提供自定义模板、批量生成、多格式导出与使用统计分析等高级能力。核心能力：
  - 12种图表类型：基础4种+高级8种（堆叠柱状、面积、雷达、热力图、箱线图、气泡图、瀑布图、组合图）
  - 自定义模板与主题样式，一键应用企业品牌配色
  - 批量生成与自动化流水线，支持CSV数据源批量出图
  - 多格式导出：PNG、SVG、PDF、JSON四种格式
  - 图表历史分析与使用统计...
tags:
  - 图表生成
  - 批量生成
  - 多格式导出
  - matplotlib
  - 自定义模板
tools:
  - read
  - exec
  - write
homepage: ""
category: "Automation"

---

# 图表工坊专业版

## 付费版专享能力

| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| 图表工坊专业版企业级图表生成 | 不支持 | 支持 |
| 图表工坊专业版批量生成 | 不支持 | 支持 |
| 图表工坊专业版多格式导出与使用分析 | 不支持 | 支持 |
| 高清分辨率与无损输出 | 不支持 | 支持 |
| 批量生成与风格预设 | 不支持 | 支持 |

## 核心能力

### 12种图表类型
| 分类 | 图表类型 | 适用场景 |
|:-----|:-----|:-----|
| 基础 | `bar`柱状图 | 类别比较 |
| 基础 | `line`折线图 | 趋势变化 |
| 基础 | `pie`饼图 | 占比构成 |
| 基础 | `scatter`散点图 | 关系探索 |
| 高级 | `stacked_bar`堆叠柱状图 | 分层比较 |
| 高级 | `area`面积图 | 累积趋势 |
| 高级 | `radar`雷达图 | 多维评估 |
| 高级 | `heatmap`热力图 | 二维密度 |
| 高级 | `boxplot`箱线图 | 分布统计 |
| 高级 | `bubble`气泡图 | 三维关系 |
| 高级 | `waterfall`瀑布图 | 累增累减 |
| 高级 | `combo`组合图 | 多指标对比 |

**输入**: 用户提供种图表类型所需的指令和必要参数.
**处理**: 解析种图表类型的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
**输出**: 返回种图表类型的处理结果,包含执行状态码、结果数据和执行日志。### 自定义模板与主题
- 预置6套主题：商务蓝、科技紫、活力橙、沉稳灰、清新绿、极简白
- 支持自定义主题：定义主色、辅色、背景色、字体
- 模板系统：保存常用图表配置（标题、轴标签、图例位置），一键复用
- 企业品牌模式：导入品牌色板，所有图表自动应用企业配色

**输入**: 用户提供自定义模板与主题所需的指令和必要参数.
**处理**: 解析自定义模板与主题的输入参数,执行核心处理逻辑,返回结构化结果和执行状态。### 批量生成与自动化
- CSV数据源批量出图：一行数据生成一张图表
- 模板驱动批量生成：同一模板套用不同数据集
- 自动化流水线：数据清洗→图表生成→命名归档，一键执行
- 定时任务支持：配合cron定期生成报表图表

### 多格式导出
| 格式 | 用途 | 特点 |
|---:|---:|---:|
| PNG | 屏幕展示、嵌入文档 | 位图，适合日常使用 |
| SVG | 网页嵌入、矢量编辑 | 无损缩放，适合前端 |
| PDF | 印刷出版、正式报告 | 矢量+高DPI，适合打印 |
| JSON | 数据交换、二次开发 | 结构化数据，可程序化处理 |

**输入**: 用户提供多格式导出所需的指令和必要参数.
**输出**: 返回多格式导出的处理结果,包含执行状态码、结果数据和执行日志。### 智能推荐引擎升级
- 分析数据维度数量、分布特征、时间属性
- 多维数据推荐组合图表（如柱状+折线组合图）
- 时序数据自动判断是否适合面积图或折线图
- 分类数据推荐最合适的比较图表类型

**输入**: 用户提供智能推荐引擎升级所需的指令和必要参数.
**输出**: 返回智能推荐引擎升级的处理结果,包含执行状态码、结果数据和执行日志。### 使用统计分析
- 图表生成次数统计：按类型、按时间、按用户
- 热门图表类型排行
- 模板使用频率分析
- 导出格式偏好统计
### PNG

针对PNG,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应.
**输入**: 用户提供PNG相关的配置参数、输入数据和处理选项.
**输出**: 返回PNG的处理结果。- 验证返回数据的完整性和格式正确性
- 参考`PNG`的配置文档进行参数调优
#
## 快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

## 适用场景

### 场景一：企业月报批量出图
月报需要20张图表，涵盖各业务线。准备CSV数据文件，配置模板与主题，执行批量生成命令，20张图表按命名规范自动归档到报表目录，全程无需人工干预.
### 场景二：多维数据雷达图
产品需要从性能、易用性、成本、支持度、生态5个维度对比3个竞品。雷达图直观展示各产品的能力分布，辅助决策.
### 场景三：出版级矢量输出
学术论文需要投稿，图表要求矢量格式。使用PDF导出，300dpi矢量精度，满足期刊排版要求.
### 场景四：热力图密度分析
运营团队有用户行为数据（时间×页面的访问量），需要直观展示访问密度。热力图将二维数据映射为颜色深浅，一眼识别高峰时段与热门页面.
### 场景五：瀑布图财务分析
财务需要展示从营收到净利润的逐项扣减过程。瀑布图清晰展示每一步的增减变化，比表格更直观.
## 使用流程

预计上手时间：约120秒.
### 优秀步：初始化专业版

```bash
# 初始化存储与模板
python3 （请参考skill目录中的脚本文件） --workspace ~/.skill-platform/workspace/memory/chart
# ...
# 查看可用主题
python3 （请参考skill目录中的脚本文件）
```

### 第二步：生成高级图表

```bash
# 雷达图
python3 （请参考skill目录中的脚本文件） --type radar --title "竞品能力对比" --labels "性能,易用性,成本,支持度,生态" --values "90,85,70,80,75" --theme tech-purple
# ...
# 热力图
python3 （请参考skill目录中的脚本文件） --type heatmap --title "访问密度" --data-file heatmap_data.csv --theme business-blue
```

### 第三步：批量生成

```bash
# 从CSV批量生成
python3 （请参考skill目录中的脚本文件） --data monthly_report.csv --template report_template.json --output-dir ./reports/march
```

### 第四步：多格式导出

```bash
# 导出SVG矢量格式
python3 （请参考skill目录中的脚本文件） --type line --title "增长趋势" --labels "Q1,Q2,Q3,Q4" --values "100,150,180,250" --format svg --output growth.svg
# ...
# 导出PDF
python3 （请参考skill目录中的脚本文件） --type bar --title "营收对比" --labels "2023,2024" --values "1200,1800" --format pdf --output revenue.pdf
```

### 第五步：查看使用统计

```bash
python3 （请参考skill目录中的脚本文件） --range 2024-01-01:2024-03-31
```

#
## 输入格式

| 参数名 | 类型 | 必填 | 说明 |
|:---:|:---:|:---:|:---:|
| content | string | 否 | chart-craft处理的内容输入 |,  |
| content | string | 否 | chart-craft处理的内容输入 |, 可选值: json/text/markdown |
| style | string | 否 | 输出风格, 参考 `references/style.md` |

## 输出格式

```json
{
  "success": true,
  "data": {
    result: "craft 相关配置参数",
    result: "craft 相关配置参数",
    result: "craft 相关配置参数",
    "metadata": {
      "template_used": "reviewer",
      "word_count": 0,
      "style": "专业"
    }
  },
  "error": null
}
```

输出模板参考: `assets/output.json`

## 异常处理

| 错误场景 | 原因 | 处理方式 |
|:------|------:|:------|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 

## 依赖说明

### 运行环境
- **Agent平台**: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
- **操作系统**: Windows / macOS / Linux
- **Python**: 3.8+（必须可作为`python3`调用）
- **网络**: 无需网络，完全本地运行

### 第三方依赖
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---:|:---|---:|---:|
| Python 3 | 运行时 | 必需 | python.org官方下载 |
| matplotlib | Python库 | 必需 | `pip3 install matplotlib` |
| numpy | Python库 | 必需 | `pip3 install numpy` |
| pandas | Python库 | 可选 | `pip3 install pandas`（批量生成CSV数据源需要） |
| LLM API | API | 必需 | 由Agent内置LLM提供 |

> 高级图表类型（雷达图、热力图等）需要numpy支持。批量生成功能需要pandas.
### API Key 配置
- 本工具完全本地运行，无需任何API Key
- 无需网络访问，无外部服务调用
- 数据不离开本机，隐私有保障

### 可用性分类
- **分类**: MD+EXEC（）
- **说明**: 基于Markdown的AI Skill，

## 案例展示

### 主题配置

```json
{
  "theme": "business-blue",
  "colors": {
    "primary": "#1a73e8",
    "secondary": "#4285f4",
    "accent": "#34a853",
    "background": "#ffffff",
    "text": "#202124"
  },
  "font": {
    "family": "SimHei",
    "titleSize": 16,
    "labelSize": 12
  }
}
```

### 模板配置

```json
{
  "templateName": "monthly-report",
  "chartType": "combo",
  "title": "{month}月度运营报告",
  "theme": "business-blue",
  "layout": {
    "figsize": [12, 7],
    "dpi": 300,
    "legendPosition": "upper right"
  },
  "axes": {
    "xLabel": "日期",
    "yLabel": "数值",
    "rotateLabels": 45
  }
}
```

### 批量生成CSV格式

```csv
title,type,labels,values,theme,output
Q1营收,bar,Q1,Q2,Q3,Q4,280,320,290,410,business-blue,q1_revenue.png
用户增长,line,1月,2月,3月,1000,1200,1500,tech-purple,user_growth.svg
预算分配,pie,研发,市场,运营,45,25,30,business-blue,budget.pdf
```

### 高级图表数据格式

#### 热力图数据（CSV）

```csv
时段,页面A,页面B,页面C
00:00,10,5,3
06:00,25,15,8
12:00,180,95,120
18:00,220,110,150
```

#### 雷达图数据（JSON）

```json
{
  "dimensions": ["性能", "易用性", "成本", "支持度", "生态"],
  "series": [
    { "name": "产品A", "values": [90, 85, 70, 80, 75] },
    { "name": "产品B", "values": [75, 90, 85, 70, 80] }
  ]
}
```

## 常见问题

### 依赖说明(补充)
雷达图、热力图、箱线图等高级类型依赖matplotlib的额外模块。执行`pip3 install matplotlib numpy pandas`安装完整依赖.
### Q2：自定义主题如何共享给团队？
将主题JSON文件提交到团队共享仓库，各成员执行`python3 （请参考skill目录中的脚本文件） --file theme.json`导入。也可放在共享文件系统中直接引用.
### Q3：批量生成中途失败如何恢复？
批量生成支持断点续传。重新执行时添加`--resume`参数，从中断处继续。已生成的图表不会重复生成.
### Q4：SVG文件过大怎么办？
SVG包含完整矢量信息，数据点多时文件较大。使用`--svg-compress`参数压缩，或减少数据点密度。也可导出PDF作为替代.
### Q5：能否将多张图表合并为一张图片？
使用`--layout grid`参数，指定行列数，将多张图表排版为网格布局。适合生成对比视图或仪表盘截图.
### Q6：组合图如何配置双Y轴？
在模板配置中设置`dualYAxis: true`，并为每个数据系列指定`yAxis: left`或`yAxis: right`。适合同时展示数量与百分比的趋势.
### Q7：热力图颜色梯度如何自定义？
在主题配置中定义`colormap`字段，支持matplotlib所有内置colormap（如`viridis`、`coolwarm`），也支持自定义颜色列表.
### Q8：使用统计数据能否导出？
执行`python3 （请参考skill目录中的脚本文件） --export stats.csv`导出使用统计为CSV，便于在Excel中分析图表产出趋势.
## 错误处理

| 错误场景(续)| 原因 | 处理方式 |
|:---------:|-----------|:----------|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | ，请求；确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |