核心功能
Table Image Generator 是一个专为即时通讯场景设计的表格图片生成工具。它将 JSON 数组数据转换为美观的 PNG 图片,彻底解决 ASCII 表格在 Discord、Telegram、WhatsApp 等平台显示错乱、格式断裂的问题。
核心用法:通过 CLI 调用 Node.js 脚本,输入 JSON 数据即可输出 PNG 图片。支持三种数据输入方式(文件、stdin、命令行参数),推荐使用 --data-file 或管道输入以避免 shell 转义问题。
显著优点:
- ⚡ 极速生成:纯 Node.js 实现,基于 Sharp 图像库,无需 Puppeteer/浏览器,<100ms 完成渲染
- 🎨 原生暗黑模式:
--dark参数完美匹配 Discord 深色主题,视觉原生感强 - 📐 智能排版:自动列宽调整、数字右对齐、长文本截断省略号
- 🔧 高度可定制:支持列顺序调整、自定义表头、字体大小、配色、紧凑模式等
- 🪶 轻量部署:单依赖 sharp@0.33.0,无原生 Canvas 依赖,Fly.io/Docker 友好
潜在局限:
- 需要 Node.js 运行时环境,首次使用需执行
npm install安装依赖 - 外部网络依赖:需从 jsDelivr CDN 获取 Twemoji SVG(已本地缓存,失败降级为文本)
- 最大宽度限制 800px,超宽表格内容会被截断
- 不支持复杂合并单元格、嵌套表格等高级表格特性
适合人群:
- Discord/Telegram 社群运营者需要展示结构化数据
- 开发者需要在聊天机器人中输出可读性强的表格
- 任何需要「在不能渲染 HTML 的环境中展示表格」的场景
常规风险:
- 输入 JSON 需符合预期格式(对象数组),异常数据可能导致渲染失败
- 缓存目录
.emoji-cache无自动清理,长期使用需关注磁盘空间 - 外部 CDN 可用性虽高(jsDelivr 99.9% SLA),但仍存在理论上的网络依赖风险