csvglow 是一个开源项目,目标是让用户通过一条命令、零配置,从 CSV 或 Excel 文件生成美观的交互式 HTML 仪表板。生成的仪表板会在浏览器中打开,包含自动检测的图表、智能多列洞察、相关性分析以及可排序的数据表格。仪表板采用深色渐变主题,每个图表都提供复制按钮,方便粘贴到幻灯片中。
主要能力
- 智能发现:跨多列的叙述性分析,交叉引用指标以揭示矛盾、效率差距以及表现最佳/最差项。
- 直方图:为每个数值列生成直方图,并显示均值、中位数、标准差、四分位数和异常值计数。
- 柱状图:为类别列生成柱状图。
- 交叉分析:自动生成类别 x 数值的交叉表,并带有总体均值线。
- 时间序列图:为日期列生成带面积填充的折线图。
- 相关性热力图:显示数值列之间的相关性。
- 散点图:为高度相关的配对(|r| > 0.7)生成散点图。
- 数据表格:可排序、可筛选,显示前 1000 行。
- 复制按钮:每个图表都有复制按钮,方便粘贴到幻灯片中。
输出是一个单一的、自包含的 HTML 文件。无需服务器,无需 CDN,可离线工作。
使用方式
- 命令行:安装后一条命令即可生成仪表板。也可以使用 npx 直接运行,无需安装。
- MCP 工具:csvglow 可作为 MCP 工具在任意兼容 MCP 的客户端中使用。配置后,可以要求 AI 助手根据文件路径生成仪表板。将 csvglow 添加到客户端的 MCP 配置文件中,使用 npx 方式无需额外安装。如果已通过 pip 安装 csvglow,则可使用 "command": "csvglow" 配合 "args": ["--mcp"]。
- OpenClaw 技能:csvglow 也作为 OpenClaw 技能提供。任何兼容 OpenClaw 的客户端都可以自动发现并使用它,无需手动配置。
支持的格式
- .csv / .tsv(自动检测分隔符)
- .xlsx(仅第一个工作表——多工作表支持即将推出)
其他信息
- 初始版本包含:自动检测列类型(数值、类别、日期时间、标识符);智能发现:跨多列的矛盾检测、效率分析、表现最佳/最差项识别;直方图(带统计侧边栏)、柱状图、交叉分析交叉表、时间序列、相关性热力图、散点图;可排序/可筛选的数据表格;所有图表的复制到剪贴板功能;MCP 服务器模式(csvglow --mcp);OpenClaw 技能支持;大型文件(100k+ 行)的智能采样;多工作表 Excel 支持;多文件支持与连接键;自定义调色板。
限制:Excel 目前仅支持第一个工作表,多工作表支持尚未提供。其他高级功能如多文件连接和自定义调色板已在计划中,但当前版本可能暂未提供,具体以项目实际发布为准。