Telegram表格格式化

技能简介

将表格数据转换为ASCII框线表格，在Telegram代码块中正确显示。支持智能列宽计算、文本自动换行和等宽字体对齐。

业务背景

Telegram原生不支持表格展示，数据汇报易显混乱。该技能将结构化数据转为ASCII框线表格，在代码块中保持等宽对齐，支持桌面端与移动端双模式渲染，让库存清单、销售报表等数据在聊天场景中清晰可读。

落地案例：区域经理需向群组推送当日门店业绩，执行命令后将"门店A|￥12,500|98%\n门店B|￥8,300|87%"等管道符数据输入技能，生成带框线的ASCII表格，用三重反引号包裹发送至Telegram。团队成员在手机或电脑端均可查看对齐整齐的业绩对比表。

能做什么

• 把管道符分隔的数据转为美观的框线表格
• 提供桌面端（Unicode字符）和移动端（ASCII字符）两种渲染模式
• 自动处理列宽和文本换行
• 通过标准输入接收数据，避免shell注入风险

使用说明

安装

# 克隆仓库后直接使用
chmod +x {baseDir}/scripts/ascii-table.py

基础用法

推荐使用heredoc方式传入数据：

# 桌面模式（默认）：Unicode框线，58字符宽度
ascii-table <<'EOF'
Name|Value|Status
Server|web-01|Online
Database|db-01|Syncing
EOF

# 移动端模式：ASCII字符，48字符宽度
ascii-table --mobile <<'EOF'
Task|Status
Deploy|Done
Test|Pending
EOF

# 自定义宽度
ascii-table --width 80 <<'EOF'
Column|Another Column
data|more data
EOF

管道输入

cat data.txt | ascii-table
echo -e 'Name|Value\nRow1|Data1' | ascii-table
some-command | ascii-table --mobile

输出到Telegram

将脚本输出用三重反引号包裹后发送。

输入与输出

见下方输入与输出表格。

风险提示

• 单元格内容不能包含管道符|，该符号被用作列分隔符
• 长单词可能在任意位置断开换行
• 表情符号和中日韩文字可能导致对齐偏移
• 仅支持左对齐，不支持数字右对齐
• Unicode框线字符在移动端Telegram上显示宽度不一致，向手机用户发送时请使用--mobile参数

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/nalg/telegram-ascii-table/SKILL.md
来源类型：GitHub仓库