chart-free

Chart — 本地图表生成引擎（免费版）

参数说明

核心理念

1. 优先清晰，而非图表种类繁多.
2. 选择让对比一目了然的最简图表.
3. 仅使用本地生成，不调用任何云端图表API.

运行环境

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

能力矩阵

核心理念(补充)

存储路径

所有数据仅落地本地：

• ~/.skill-platform/workspace/memory/chart/charts.json — 图表历史索引
• ~/.skill-platform/workspace/memory/chart/output/ — 图表图片输出目录

无云同步，无第三方图表API.

支持的图表类型（免费版）

饼图 pie 与散点图 scatter 为付费版专享.

脚本一览（免费版）

suggest_chart.py（智能选型）与 list_charts.py（历史管理）为付费版专享.

核心能力（免费版）

1. 内联数据生成图表

使用 make_chart.py 直接从命令行参数生成图表图片：

python3 {baseDir}/（请参考skill目录中的脚本文件） \
  --type bar \
  --title "季度销售额" \
  --labels "Q1,Q2,Q3,Q4" \
  --values "10,20,15,25"

• `--

付费版专享能力

升级付费版解锁以下高级能力：

• 饼图 pie：简单部分占整体比例可视化.
• 散点图 scatter：两个变量间关系分析.
• 智能选型 suggest_chart.py：根据数据特征自动推荐优选图表类型与理由.
• 历史管理 list_charts.py：查看历史生成记录，按时间/类型/标题回溯.
• 多类型组合工作流：选型→生成→

上线流程

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

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

存储路径(补充)

支持的图表类型（免费版）(补充)

脚本一览（免费版）(补充)

核心能力（免费版）(补充)

1. 内联数据生成图表(补充)

python3 {baseDir}/（请参考skill目录中的脚本文件） \
  --type bar \
  --title "季度销售额" \
  --labels "Q1,Q2,Q3,Q4" \
  --values "10,20,15,25"

• --type：必填，免费版仅支持 bar/line
• --title：图表标题
• --labels：以英文逗号分隔的标签序列
• --values：以英文逗号分隔的数值序列，须与labels等长

输出PNG文件落地到 ~/.skill-platform/workspace/memory/chart/output/.

2. 存储初始化

首次使用前运行 init_storage.py 创建目录结构与索引文件：

python3 {baseDir}/（请参考skill目录中的脚本文件）

操作步骤

1. 确认环境：检查 python3 与 matplotlib 是否可用（python3 -c "import matplotlib"）.
2. 初始化存储：首次使用运行 init_storage.py 建立目录与索引.
3. 生成图表：用 make_chart.py --type bar|line --title "..." --labels "..." --values "..." 生成PNG.
4. 校验输出：检查 output/ 目录下的图片文件，确认渲染正确.
5. 复用产物：将PNG嵌入报告、幻灯片或决策文档.

示例展示

示例1：柱状图对比季度销售

python3 {baseDir}/（请参考skill目录中的脚本文件） \
  --type bar \
  --title "2024年季度销售额(万元)" \
  --labels "Q1,Q2,Q3,Q4" \
  --values "120,180,150,210"

输出文件：~/.skill-platform/workspace/memory/chart/output/chart_20250320_001.png

示例2：折线图展示月度趋势

python3 {baseDir}/（请参考skill目录中的脚本文件） \
  --type line \
  --title "月度活跃用户" \
  --labels "1月,2月,3月,4月,5月,6月" \
  --values "3200,3500,4100,4500,4300,4900"

付费版专享能力(补充)

• 多类型组合工作流：选型→生成→回溯的完整链路.
• 高级渲染选项：自定义颜色、字体、坐标系等.

错误管理机制

常见疑问

Q1：免费版支持哪些图表类型？

免费版支持 bar（柱状图）与 line（折线图）两种基础类型。pie 与 scatter 为付费版专享.

Q2：是否需要联网？

不需要。所有生成过程本地完成，不调用任何第三方图表API，无云同步.

Q3：如何选择图表类型？

免费版需手动判断：类别对比用 bar，时间趋势用 line。付费版提供 suggest_chart.py 自动推荐.

Q4：生成的图片存在哪里？

统一落地到 ~/.skill-platform/workspace/memory/chart/output/ 目录，文件名带时间戳.

Q5：matplotlib默认字体不支持中文怎么办？

通过 matplotlib.rcParams['font.sans-serif'] = ['SimHei', 'Arial Unicode MS'] 配置中文字体.

Q6：如何升级到付费版？

参考 chart 付费版SKILL.md，解锁pie/scatter类型、智能选型、历史管理与多类型组合工作流.

功能边界

• 仅支持 bar 与 line 两种基础类型，pie/scatter为付费版专享.
• 数据需通过 --labels/--values 内联传入，暂不支持直接读取CSV.
• 输出固定为PNG格式，暂不支持SVG或PDF矢量输出.
• 中文字体需手动配置 matplotlib.rcParams，否则会出现乱码.
• 无历史管理能力，无法回溯历史生成记录.
• 无智能选型能力，需手动判断图表类型.

输出说明

{
  "success": true,
  "data": {
    "result": "本地图表生成-免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "chart"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}

---

用户体验亮点提升

为了提升用户体验，以下建议可以增强 chart-free 技能的用户友好性：

• 交互式引导: 在技能启动时，提供一个交互式的引导流程，介绍技能的基本用法和功能。
• 可视化反馈: 当用户输入数据或选择图表类型时，提供实时预览或进度条，增强用户的交互体验。
• 错误提示优化: 提供更友好的错误提示信息，例如当用户输入格式错误时，给出具体的错误原因和修正建议。

功能细节优化

以下是对 chart-free 技能功能细节的优化建议：

• 图表样式自定义: 允许用户自定义图表的样式，如颜色、标签字体等，提供更丰富的可视化效果。
• 数据导入功能: 除了内联数据，增加从文件导入数据的功能，支持CSV等常见格式。
• 图表导出选项: 提供导出图表为不同格式（如SVG、PDF）的选项，以满足不同需求。

用户文档结构优化

为了使文档更易于阅读和理解，以下是对用户文档结构的优化建议：

• 增加目录: 在文档开头添加目录，方便用户快速定位到所需信息。
• 分节标题: 使用更清晰的标题结构，将功能描述、使用流程、示例等部分分节。
• 图示和表格: 使用图示和表格来展示输入输出格式、错误代码等信息，提高可读性。

质量增强补充

可靠性增强(Reliability Enhancement)

已实现以下异常处理与可靠性保障:

• • 边界条件检查(空输入、超长输入等edge case)
• 降级策略与默认值(fallback/default value)处理

适用性增强(Adaptability Enhancement)

• • 限制说明(limitation)与不适用场景
• 触发条件(trigger)与激活方式

排障手册

安全免责声明

技术创新

性能数据

优势对比