图表工坊免费版

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

概述

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

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

核心能力

四种基础图表类型

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

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

智能图表推荐

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

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

本地生成与存储

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

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

历史记录管理

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

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

使用场景

场景一：报表配图快速生成

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

场景二：数据趋势快速验证

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

场景三：占比关系直观展示

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

场景四：数据关系探索

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

不适用场景

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

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

触发条件

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

快速开始

预计上手时间：约60秒。

第一步：初始化存储

输入格式

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

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

第二步：生成第一张图表

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

第三步：使用智能推荐

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

第四步：查看历史图表

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命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

Chart Craft Free

安装到 Tokeny（自动）

SKILL.md