核心用法
Data Visualizer 是一款基于终端的数据可视化工具，通过 Unicode 块字符（▓█▁▂▃▄▅▆▇）直接在标准输出中渲染图表，无需图像库或浏览器环境。
主要功能
| 类型 | 命令 | 说明 |
|------|------|------|
| **基础图表** | `bar`、`histogram`、`sparkline`、`treemap`、`gauge` | 输入 label:value 或数值序列，即时生成 ASCII 风格图表 |
| **CSV 分析** | `summarize`、`distribution`、`from-csv` | 基于 Python3 标准库计算统计量（最小值、最大值、平均值、中位数）及分布直方图 |
| **实用工具** | `help`、`version` | 命令查询与版本管理 |
典型工作流
# 快速条形图对比 bar "Team-A:150" "Team-B:89" "Team-C:210" # CSV 数据统计分析 summarize sales_data.csv # 数值序列趋势 sparkline 12 18 25 31 28 35 42
显著优点
1. 零依赖部署：仅需 bash 4+ 和 Python3 标准库，适合受限环境（服务器、CI/CD、容器）
2. 即时反馈：无需等待图像生成，毫秒级终端渲染
3. 轻量嵌入：输出为纯文本，可直接粘贴到日志、文档、聊天工具
4. 隐私友好：数据本地处理，不上传至外部服务
局限性与风险
| 问题 | 说明 |
|------|------|
| **功能未完整实现** | heatmap、matrix、correlate、pivot、normalize、from-json、to-svg、to-html 等命令为占位符（TODO），实际不可用 |
| **视觉表现力有限** | Unicode 块字符分辨率低，无法呈现复杂配色、渐变、交互效果 |
| **无持久化配置** | 缺乏主题定制、输出格式模板等高级选项 |
| **数据规模限制** | 大规模数据集可能导致终端换行混乱，适合百级数据点以内 |
适合人群
- 运维工程师：服务器性能指标快速可视化
- 数据分析师：CSV 文件的即时探索性分析（EDA）
- 开发者：CLI 工具集成、CI 报告生成、日志增强
- 技术写作者：文档中嵌入轻量级数据图表
常规风险提示
- 占位符命令陷阱：调用未实现功能仅返回 "TODO" 字符串，可能误导自动化脚本
- 输入验证：需确保 CSV 包含表头且数值列格式正确，否则 Python 解析可能报错
- 终端兼容性：老旧终端可能无法正确显示 Unicode 块字符，建议优先使用现代终端模拟器