Telegram 聊天记录转图片

将 Telegram 聊天导出文件转换为长截图风格的图片，采用 iOS 风格的气泡式对话界面。

更新日志

v1.2.0（2026-03-07）

• 建议：长图发送优化 — 对于较长对话，建议打包为 ZIP 文件发送，避免 Telegram 图片压缩导致模糊

v1.1.0（2026-03-01）

• 修复：中文长文本换行问题 — 现在逐字符检查宽度，实现正确换行
• 修复：发件人显示问题 — 正确区分“我”（蓝色气泡）与其他联系人（灰色气泡 + 头像）
• 新增：显示每条消息的发件人名称

v1.0.0

• 初始版本

前置依赖

```bash
pip install Pillow
```

使用方法

命令行接口（CLI）

```bash

基础用法

python3 scripts/chat_to_image.py --input result.json --output chat.png

限制消息数量

python3 scripts/chat_to_image.py --input result.json --limit 50 --output chat.png

自定义字体（支持中文）

python3 scripts/chat_to_image.py --input result.json --font /System/Library/Fonts/PingFang.ttc
```

获取 Telegram 导出文件

1. 打开 Telegram Desktop
2. 进入你希望导出的聊天窗口
3. 点击菜单 → 导出聊天记录
4. 选择 JSON 格式
5. 选择要导出的消息范围并执行导出

输入格式

要求输入为 Telegram Desktop 的 JSON 导出格式，其中 messages 数组需包含 id、type、date、from、from_id 和 text 字段。

输出结果

生成一张 PNG 图片，具备以下特性：

• 宽度为 800 像素
• 采用 iOS 风格的气泡式对话界面
• 他人消息使用灰色气泡，用户自身消息使用蓝色气泡
• 圆形头像，显示姓名首字母缩写
• 时间戳（HH:MM 格式）
• 对长消息进行合理文本换行

限制说明

• 图片、贴纸及多媒体内容不会被渲染
• 回复线程（reply threads）无视觉标识
• 仅完全支持纯文本消息
• 导出数据量较大时，可能生成极高（tall）的图片

最佳实践

处理长对话

对于生成高度超过 2000px 的长对话图片，建议采取以下方式：

1. ZIP 打包：将 PNG 文件打包为 ZIP 后再发送，以规避 Telegram 的图片压缩机制

   zip chat.zip chat.png
   

   然后以文档形式发送该 ZIP 文件，而非作为图片发送。

2. 消息数量限制：若完整对话过长，可使用 --limit 参数生成部分导出图片

自定义配置

编辑 scripts/chat_to_image.py 文件可调整以下参数：

• WIDTH：图片宽度（默认为 800）
• MY_BUBBLE_COLOR：用户消息气泡颜色
• OTHER_BUBBLE_COLOR：他人消息气泡颜色
• FONT_SIZE、BUBBLE_PADDING：布局间距相关参数