关于 chartli
chartli 是供 Agent 将数值数据转换为终端图表或 SVG 的技能。它可读取文件或标准输入中的空格分隔数据,并提供多种图表样式和标签选项。
主要功能
- 01生成 ASCII、Unicode、Braille 和 SVG 图表
- 02支持火花线、条形图、柱状图和热力图
- 03从文件或标准输入读取数值行
- 04设置图表尺寸和坐标轴标签
- 05添加类别标签和数据标签
适用场景
- 01在终端中预览数值数据
- 02用热力图比较多个数据系列
- 03将折线或圆点图导出为 SVG
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ ahmadawais/ chartli --skill chartli安装后在 Claude Code 中输入/chartli确认已加载。
详细介绍
chartli 技能
当 Agent 需要在终端中将数值数据可视化为 ASCII/Unicode/SVG 图表时,请使用此技能。
安装
npx skills add ahmadawais/chartli
CLI 安装/使用
立即使用:
npx chartli --help
全局安装:
npm i -g chartli
chartli 的功能
- 渲染图表类型:
ascii、spark、bars、columns、heatmap、unicode、braille、svg - 从文件路径读取输入
- 未传入文件时从 stdin 读取
- 使用
--width和--height控制输出尺寸 - 使用
--mode circles|lines渲染 SVG - 使用
--x-axis-label和--y-axis-label添加x轴和y轴标题 - 使用
--x-labels和--series-labels添加自定义刻度/类别标签 - 使用
--data-labels在绘制的数据上显示原始值 - 使用
--first-column-x将第一列数值转换为x轴标签
命令模板
从文件读取:
npx chartli <file> -t <type> [--width N] [--height N] [--mode circles|lines] [--x-axis-label LABEL] [--y-axis-label LABEL] [--x-labels a,b,c] [--series-labels foo,bar] [--data-labels] [--first-column-x]
从 stdin 读取:
printf 'x y\n1 10\n2 20\n3 15\n' | npx chartli -t ascii -w 24 -h 8
带标签的双列图表:
printf 'day value\n1 10\n2 20\n3 15\n' | npx chartli -t ascii -w 24 -h 8 --first-column-x --data-labels
各类型示例:
npx chartli data.txt -t ascii -w 24 -h 8
npx chartli data.txt -t spark
npx chartli data.txt -t bars -w 28
npx chartli data.txt -t columns -h 8
npx chartli data.txt -t heatmap
npx chartli data.txt -t unicode
npx chartli data.txt -t braille -w 16 -h 6
npx chartli data.txt -t svg -m lines -w 320 -h 120
输入格式
以空白字符分隔的数值行;允许有可选的标题行。
day sales costs profit
1 10 8 2
2 14 9 5
3 12 11 3
设置 --first-column-x 后,第一列数值将作为 x 轴标签。如果存在标题行,chartli 会将第一个标题单元格用作 x 轴标题,其余标题用作系列标签。对于常见的双列输入,第二个标题单元格将用作 y 轴标题。
仓库示例资源
examples/assets/core-single-series.txtexamples/assets/core-multi-series.txtexamples/assets/image-data.txtexamples/assets/image-columns-variant.txt
评论
支持 Markdown