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="your_api_key_here"

配置后需重启会话或开启新终端生效。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. 内联数据生成图表(补充)

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"

付费版专享能力(补充)

• 饼图 pie：简单部分占整体比例可视化.
• 散点图 scatter：两个变量间关系分析.
• 智能选型 suggest_chart.py：根据数据特征自动推荐最佳图表类型与理由.
• 历史管理 list_charts.py：查看历史生成记录，按时间/类型/标题回溯.
• 多类型组合工作流：选型→生成→回溯的完整链路.
• 高级渲染选项：自定义颜色、字体、坐标系等.

错误处理

常见问题

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
}