table-image 是一款专为即时通讯场景设计的轻量级表格图片生成工具，核心解决 ASCII 表格在 Discord、Telegram 等平台显示不一致、排版断裂的痛点。
核心用法
通过 Node.js 脚本直接调用，接受 JSON 数组作为数据源，输出 PNG 格式表格图片。支持标准命令行参数配置，包括标题、主题模式、列选择、自定义表头、对齐方式等 10 余项样式选项。无需依赖浏览器或 Puppeteer，纯 Node.js 环境配合 Sharp 库即可完成 SVG 到 PNG 的渲染转换。
显著优点
- 零浏览器依赖：采用 Sharp 图像库替代 Puppeteer/Playwright，部署体积大幅缩减，启动速度 <100ms
- 平台适配优化：内置暗黑模式（--dark）专为 Discord 深色主题调校，视觉原生融入
- 智能排版：自动识别数值类型并右对齐，列宽自适应内容，超长文本自动截断省略
- 灵活配置：支持列筛选重排、自定义表头、斑马纹、紧凑模式等，满足多样化展示需求
- 环境兼容：可在 Fly.io、Docker 等受限容器环境稳定运行
潜在局限
- 输出为静态 PNG，无法交互排序或筛选
- 复杂嵌套数据结构需先扁平化处理
- 最大宽度限制（默认 800px）可能导致超宽表格信息密度下降
- 依赖 Node.js 运行时，非 Node 生态用户需额外环境配置
适合人群
- Discord/Telegram 机器人开发者，需推送结构化数据展示
- 数据分析师，希望快速分享表格快照而不依赖截图工具
- 运维人员，需要 CI/CD 报告中嵌入可读表格
- 任何厌恶 ASCII 表格跨平台显示差异的用户
常规风险
- 数据隐私：JSON 数据通过命令行参数传递，敏感信息可能暴露于 shell 历史或进程列表
- 输入注入：若数据来源不可信，需防范 JSON 解析异常或超大负载导致的内存/CPU 耗尽
- 文件覆写：--output 参数直接覆盖同名文件，建议配合唯一命名策略
- 依赖供应链：Sharp 库依赖 libvips 原生二进制，特定架构需确认预编译包可用性