Chart MPL

使用 scripts/chart_mpl.py 从 CSV 文件生成图表图像。

环境准备

创建虚拟环境并安装 matplotlib（仅需执行一次）：

python3 -m venv ~/.openclaw/workspace/.venv_chart
~/.openclaw/workspace/.venv_chart/bin/pip install matplotlib

快速开始

在工作区根目录下运行：

~/.openclaw/workspace/.venv_chart/bin/python skills/chart-mpl/scripts/chart_mpl.py 
  --csv /path/to/data.csv 
  --xcol Mois 
  --ycol Valeur 
  --kind line 
  --title "Monthly trend" 
  --xlabel "Month" 
  --ylabel "Value"

默认输出路径为：~/.openclaw/workspace/exports/images

输入参数

• --csv：CSV 文件路径
• --xcol：X 轴所用列名
• --ycol：Y 轴所用数值列名（支持多列，以英文逗号分隔，例如 Sales,Costs）
• --kind：图表类型，可选值：line、bar、hbar、pie、stacked、scatter、area
• 可选：--delim：当自动识别分隔符失败时手动指定（支持 ;、,、t、|）
• 可选：--out：自定义输出路径（支持 PNG 或 SVG 格式，格式由文件扩展名自动推断）
• 可选：--title、--xlabel、--ylabel
• 可选：--top N：仅显示按数值排序的前 N 个类别（适用于 bar、hbar、pie、stacked 图表；多序列时按行总和排序）
• 可选：--sort：绘图前对数据排序，可选值：x-asc、x-desc、y-desc、none（默认为 none）
• 可选：--numfmt：Y 轴数字格式，fr（如 1,5M）或 en（如 1.5M），默认为 fr

图表类型

注意事项

• 脚本在可能的情况下自动检测 CSV 分隔符。
• 脚本兼容欧洲与美国数字格式（例如 1 234,56 和 1,234.56）。
• ycol 中的非数值内容将被转换为 NaN，并输出警告信息。
• 支持带 BOM 的 CSV 文件（编码为 utf-8-sig）。
• 多序列图表将自动显示图例，并循环使用 8 色配色方案。
• Y 轴刻度采用人性化格式（带 K、M、G 后缀），小数点格式支持法语或英语风格。
• --top N 保留数值最高的 N 个类别：对于饼图，其余部分合并为 “Other” 扇区；对于柱状图 / 水平柱状图 / 堆叠柱状图，其余类别则被排除。
• 输出格式（PNG 或 SVG）由 --out 参数指定的文件扩展名决定；默认为 PNG。

与 SQL 技能端到端协作流程

1. 使用 mssql 技能将查询结果导出为 CSV 文件。
2. 对该 CSV 文件运行本脚本。
3. 分享生成的 PNG 文件路径。