Telegram ASCII 表格

将表格数据格式化为 ASCII 边框绘图表格，使其在 Telegram 的代码块中正确渲染。

快速开始

{baseDir}/scripts/ascii-table.py <<'EOF'
Name|Value|Status
Server|web-01|Online
Database|db-01|Syncing
EOF

发送至 Telegram 时，请将输出内容用三重反引号（```）包裹。

使用方法

Here Document（推荐）

# 桌面模式（默认）：Unicode 边框字符，宽度 58 字符
ascii-table <<'EOF'
Server|Status|Uptime
web-01|Online|14d 3h
db-01|Syncing|2d 12h
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

管道输入（Pipe）

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

选项

┌───────────┬───────┬────────────────────────────────────────────┐
│ Flag      │ Short │ Description                                │
├───────────┼───────┼────────────────────────────────────────────┤
│ --desktop │ -d    │ Unicode 边框字符，宽度 58 字符（默认）     │
├───────────┼───────┼────────────────────────────────────────────┤
│ --mobile  │ -m    │ ASCII 字符，宽度 48 字符                   │
├───────────┼───────┼────────────────────────────────────────────┤
│ --width N │ -w N  │ 覆盖默认宽度                               │
└───────────┴───────┴────────────────────────────────────────────┘

模式对比

┌───────────────┬──────────────────────┬─────────────────────┐
│ Aspect        │ Desktop（默认）       │ Mobile              │
├───────────────┼──────────────────────┼─────────────────────┤
│ Characters    │ Box drawing 字符     │ ASCII 字符（+、- 等）│
├───────────────┼──────────────────────┼─────────────────────┤
│ Default width │ 58 字符              │ 48 字符             │
├───────────────┼──────────────────────┼─────────────────────┤
│ Rendering     │ 桌面端显示整洁       │ 全平台兼容性更可靠  │
├───────────────┼──────────────────────┼─────────────────────┤
│ Use when      │ 接收方使用桌面版 Telegram │ 接收方使用移动端 Telegram │
└───────────────┴──────────────────────┴─────────────────────┘

Unicode 边框绘图字符在移动端 Telegram 中渲染宽度不一致。如目标用户为移动端，请使用 --mobile 参数。

输入格式

• 通过 stdin 输入，每行一条记录
• 列之间以 | 分隔
• 空行将被忽略
• 单元格前后空白字符将被自动裁剪

输出示例

桌面模式

┌──────────┬──────────┬──────────┐
│ Server   │ Status   │ Uptime   │
├──────────┼──────────┼──────────┤
│ web-01   │ Online   │ 14d 3h   │
├──────────┼──────────┼──────────┤
│ db-01    │ Syncing  │ 2d 12h   │
└──────────┴──────────┴──────────┘

移动端模式

+------------+----------+----------+
| Server     | Status   | Uptime   |
+------------+----------+----------+
| web-01     | Online   | 14d 3h   |
+------------+----------+----------+
| db-01      | Syncing  | 2d 12h   |
+------------+----------+----------+

支持自动换行的示例

┌─────────┬────────┬──────────────────────────────────────┐
│ Task    │ Status │ Notes                                │
├─────────┼────────┼──────────────────────────────────────┤
│ Deploy  │ Done   │ Rolled out to prod successfully      │
│ API     │        │                                      │
├─────────┼────────┼──────────────────────────────────────┤
│ Fix bug │ WIP    │ Waiting on upstream OAuth fix        │
└─────────┴────────┴──────────────────────────────────────┘

设计说明：仅支持 stdin 输入

该脚本**刻意不接受**将行数据作为命令行参数传入。

Shell 对命令行参数的解析发生在**任何脚本运行之前**。例如，在双引号包围的参数中出现的反引号（`）、美元符号（$）和感叹号（!）等字符，会在参数传递给脚本前即被 Shell 执行或展开——而非由脚本本身处理。举例来说，`whoami` 会被 Shell 先执行，并将其输出结果替换进命令中，脚本最终收到的只是执行后的字符串，而非原始字面量。

通过强制要求从 stdin 读取输入，用户数据可完全绕过 Shell 解析阶段。带引号的 here document（如 <<'EOF'）会将所有内容原样传递，无需转义，也杜绝了意外执行的风险。

限制

• 分隔符固定为竖线 —— 列必须用 | 分隔（该字符不可出现在单元格内容中）
• 单词断行 —— 长单词可能被截断于词中
• 宽字符支持有限 —— emoji 或 CJK 字符可能导致对齐异常
• 仅支持左对齐 —— 不支持数字右对齐等高级对齐方式