Telegram Ascii Table

将表格数据格式化为适用于Telegram的ASCII表格。纯标准输入杜绝shell注入风险。支持智能列宽、自动换行及适配等宽字体的填充。

安装

概览

Telegram Ascii Table 是一款专为在 Telegram 中展示表格数据而设计的命令行工具,能够将标准输入的制表符分隔数据转换为美观的 ASCII 表格格式。该工具的核心设计理念是确保生成的表格在 Telegram 的消息代码块(code blocks)中能正确渲染,尤其适用于需要向团队成员或用户清晰传递结构化信息的场景。通过纯标准输入的方式接收数据,有效避免了 shell 注入等安全风险,提升了脚本使用的安全性与可靠性。 该工具支持多种输出模式,默认采用 Unicode 框线字符生成宽度为 58 字符的桌面端友好表格,同时提供 `–mobile` 选项以适配移动端 Telegram 客户端,后者使用 ASCII 字符并限制宽度为 48 字符,确保在不同设备上都能稳定显示。此外,用户还可通过 `–width N` 参数自定义表格总宽度,满足特殊布局需求。无论输入内容是否包含换行或多列文本,工具均能智能处理列宽与自动换行,保证输出结果整洁易读。

核心功能特点

  1. 支持 Unicode 和 ASCII 两种框线风格,适配桌面端与移动端 Telegram 显示差异
  2. 基于标准输入(stdin)接收数据,杜绝 shell 注入风险,提升安全性
  3. 智能计算列宽并支持自动换行,确保长文本内容完整呈现
  4. 可自定义表格总宽度,灵活适应不同屏幕尺寸或排版要求
  5. 输入格式简洁:每行一条记录,列间用 `|` 分隔,空白行自动忽略

适用场景

Telegram Ascii Table 特别适合需要在即时通讯场景中快速分享系统状态、任务进度或配置信息的开发者与运维人员。例如,当你在远程服务器上执行监控命令后,可以将 `systemctl status` 或 `docker ps` 的输出通过管道传递给此工具,生成结构清晰的表格推送给技术群组,让团队成员一目了然地掌握服务运行状况。这种用法不仅提高了信息传递效率,也避免了冗长的纯文本描述带来的阅读负担。 另一个典型应用场景是在自动化脚本中集成状态报告功能。比如 CI/CD 流水线完成构建后,可将测试结果、部署状态和耗时等信息格式化后发送至 Telegram 通知频道。由于工具支持移动端优化模式,即使接收者正在使用手机查看消息,也能获得良好的阅读体验。此外,对于经常需要跨设备协作的团队而言,该工具提供的两种输出模式确保了信息在任何终端上都不会出现错位或乱码问题。