Chart Craft Free

SKILL.md

---
slug: chart-craft-free
name: chart-craft-free
version: 1.0.0
displayName: 图表工坊免费版
summary: 本地优先的图表生成引擎，支持柱状图、折线图、饼图、散点图四种基础类型与智能图表推荐
license: Proprietary
edition: free
description: '图表工坊免费版是一款面向独立开发者的本地图表生成工具，将数字转化为清晰的可视化图形，支持柱状图、折线图、饼图、散点图四种基础类型，并提供智能图表类型推荐能力。核心能力：

  - 四种基础图表类型：柱状图、折线图、饼图、散点图

  - 智能图表推荐：根据数据特征自动建议最佳图表类型

  - 本地生成与存储，无需网络访问，数据不离开本机

  - 历史记录管理，可查看与复用之前生成的图表

  - 基于Python与matplotlib...'
tags:
- 集成工具
- 数据可视化
- 图表生成
tools:
- - read
- exec
homepage: https://skillhub.cn
pricing_tier: "L2-标准级"
pricing_model: per_use
suggested_price: "19.9 CNY/per_use"
tools: ["read", "write", "exec"]
tags: "工具,效率,自动化"
---
# 图表工坊免费版

一款本地优先的图表生成引擎，将数字转化为清晰的可视化图形，支持四种基础图表类型与智能推荐。

## 概述

在数据分析与汇报场景中，将数字转化为图表是最直接的表达方式。然而，大多数在线图表工具需要上传数据到云端，存在隐私泄露风险；专业可视化库学习成本高，不适合快速出图。本工具通过本地Python脚本生成图表，数据不离开本机，兼顾隐私与效率。

免费版聚焦于四种最常用的基础图表类型与智能推荐能力，适合个人开发者快速将数据可视化。

## 核心能力

### 四种基础图表类型

| 图表类型 | 适用场景 | 典型用途 |
|----|----|----|
| `bar`（柱状图） | 类别比较 | 各产品销量对比 |
| `line`（折线图） | 趋势变化 | 月度增长趋势 |
| `pie`（饼图） | 占比构成 | 预算分配比例 |
| `scatter`（散点图） | 关系探索 | 价格与销量相关性 |

**输入**: 用户提供四种基础图表类型所需的指令和必要参数。
**处理**: 解析四种基础图表类型的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回四种基础图表类型的响应数据,包含状态码、结果和日志。

### 智能图表推荐
- 根据数据特征（类别数、时间维度、数值范围）自动建议最佳图表类型
- 输入标签与数值后，推荐引擎分析数据分布给出建议
- 支持多维度数据时推荐组合图表方案

**输入**: 用户提供智能图表推荐所需的指令和必要参数。
**处理**: 解析智能图表推荐的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回智能图表推荐的响应数据,包含状态码、结果和日志。

### 本地生成与存储
- 所有图表在本地通过Python与matplotlib生成
- 数据存储在本地文件系统，不上传任何云端
- 图表历史记录持久化，可随时查看与复用
- 输出高质量PNG图片，适合嵌入报告与幻灯片

**输入**: 用户提供本地生成与存储所需的指令和必要参数。
**处理**: 解析本地生成与存储的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回本地生成与存储的响应数据,包含状态码、结果和日志。

### 历史记录管理
- 自动记录每次生成的图表元数据（类型、标题、时间）
- 通过`list_charts.py`查看历史图表列表
- 图表文件按时间戳命名，避免覆盖

**输入**: 用户提供历史记录管理所需的指令和必要参数。
**处理**: 解析历史记录管理的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回历史记录管理的响应数据,包含状态码、结果和日志。
**能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：本地优先的图表生、成引擎、支持柱状图、散点图四种基础类、型与智能图表推荐、图表工坊免费版是、一款面向独立开发、者的本地图表生成、将数字转化为清晰、的可视化图形、并提供智能图表类、型推荐能力、核心能力、根据数据特征自动、无需网络访问、数据不离开本机、可查看与复用之前等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

## 使用场景

### 场景一：报表配图快速生成
月度报告中需要展示各产品线销量对比。通过命令行输入产品名与销量数据，一键生成柱状图PNG，直接嵌入到报告文档中。

### 场景二：数据趋势快速验证
分析师拿到一组时序数据，希望快速判断趋势走向。通过折线图生成脚本输入数据，几秒内得到可视化结果，辅助决策。

### 场景三：占比关系直观展示
团队预算分配需要向成员公示。输入各部门预算数值，生成饼图，直观展示占比关系，提升沟通效率。

### 场景四：数据关系探索
研究者有一组价格与销量的配对数据，希望探索两者关系。通过散点图生成脚本输入数据，观察点的分布趋势，判断相关性。

## 不适用场景

以下场景图表工坊免费版不适合处理：

- 实时流数据处理
- 小规模数据手动分析
- 非结构化文本情感分析

## 触发条件

需要数据分析、报表生成、统计洞察、数据可视化时使用。不适用于非本工具能力范围的需求。

## 快速开始

预计上手时间：约60秒。

### 第一步：初始化存储

## 输入格式
| 参数名 | 类型 | 必填 | 说明 |
|:-----|:-----|:-----|:-----|
| input | string | 是 | 图表工坊免费版处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |

```bash
python3 （请参考skill目录中的脚本文件）
```

### 第二步：生成第一张图表

```bash
# 生成柱状图
python3 （请参考skill目录中的脚本文件） --type bar --title "各产品销量对比" --labels "产品A,产品B,产品C" --values "120,85,150"
```

### 第三步：使用智能推荐

```bash
# 让工具推荐最佳图表类型
python3 （请参考skill目录中的脚本文件） --labels "1月,2月,3月,4月,5月" --values "100,120,115,140,160"
# 输出: 建议使用折线图（line），数据呈时间序列且有明显趋势
```

### 第四步：查看历史图表

```bash
python3 （请参考skill目录中的脚本文件）
```

输出示例：

```
ID  类型    标题              生成时间
1   bar     各产品销量对比     2024-03-15 10:30
2   line    月度增长趋势       2024-03-15 11:20
```

## 示例

### 存储路径配置

所有数据存储在本地固定路径：

```
~/.skill-platform/workspace/memory/chart/charts.json    # 图表元数据
~/.skill-platform/workspace/memory/chart/output/        # 图表图片输出目录
```

无云同步，无第三方图表API调用。

#
## 最佳实践

### 图表类型选择
- 比较不同类别的数值：用柱状图
- 展示时间序列的变化趋势：用折线图
- 表达各部分占整体的比例：用饼图
- 探索两个变量之间的关系：用散点图
- 不确定时先用`suggest_chart.py`获取建议

### 数据准备建议
- 标签与数值数量必须一致
- 数值使用英文逗号分隔，不要包含空格
- 标签过长时图表会自动旋转，建议控制在6个字符以内
- 饼图的数值会自动归一化为百分比

### 输出与使用建议
- 生成的PNG图片分辨率默认为300dpi，适合打印与投影
- 图片文件名包含时间戳，不会覆盖历史文件
- 定期清理`output/`目录，避免文件过多占用磁盘
- 嵌入到报告时建议保持图片比例，避免拉伸变形

### 隐私与安全
- 所有数据处理在本地完成，不上传任何云端
- 敏感数据可放心使用，无需担心泄露
- 图表文件存储在用户目录下，注意设置适当权限

## 常见问题

### Q1：提示找不到python3命令？
确保Python 3已安装并在PATH中。Windows下可能需要使用`python`而非`python3`。执行`python3 --version`验证。

### 依赖详情
执行`pip3 install matplotlib`安装。若权限不足，使用`pip3 install --user matplotlib`安装到用户目录。

### Q3：中文标签显示为方框？
matplotlib默认字体不支持中文。在脚本中设置中文字体：`plt.rcParams['font.sans-serif'] = ['SimHei']`（Windows）或`['Arial Unicode MS']`（macOS）。

### Q4：数值中有小数可以吗？
可以。数值支持整数与小数，例如`--values "12.5,18.3,15.7"`。

### Q5：能否生成更多图表类型？
免费版支持四种基础类型。如需堆叠柱状图、面积图、雷达图、热力图等高级类型与自定义模板，请使用专业版。

## 已知限制

本免费体验版限制以下高级功能：
- 仅支持四种基础图表类型，无堆叠/面积/雷达/热力图等高级类型
- 无自定义模板与主题样式
- 无批量生成与自动化流水线
- 无多格式导出（仅PNG），无SVG/PDF矢量格式
- 无图表历史分析与使用统计

解锁全部功能请使用专业版：chart-craft-pro
- 当前为免费版本,如需完整功能请升级到付费版获取全部能力
## 依赖说明

### 运行环境
- **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` |
| LLM API | API | 必需 | 由Agent内置LLM提供 |

> 除matplotlib外无其他外部依赖，图表生成完全本地完成。

### API Key 配置
- 本工具完全本地运行，无需任何API Key
- 无需网络访问，无外部服务调用
- 数据不离开本机，隐私有保障

### 可用性分类
- **分类**: MD+EXEC（纯Markdown指令，部分功能需要exec命令行执行能力）
- **说明**: 基于Markdown的AI Skill，通过自然语言指令驱动Agent完成操作

## 错误处理

| 错误场景 | 原因 | 处理方式 |
|:---:|:---:|:---:|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |