使用方法

本文说明格式互转的完整操作流程。

关于截图

路径：docs/public/screenshots/session-convert/。

准备工作

1. 打开 tele.xiaohutou.top/convert 或点击顶部「格式互转」
2. 准备好授权码（与制作共用）
3. 准备好 Session 文本 或 tdata ZIP

互转在服务端本地完成，不会连接 Telegram 服务器（与 Session 制作的在线登录不同）。不会判断死号；转换成功不代表凭证仍可登录。

---

步骤一：站点登录

未登录时显示格式互转专属简介与授权码表单：

1. 输入授权码并登录
2. 若已在「Session 制作」Tab 登录，切换至互转 Tab 无需再次登录
3. 右上角显示剩余可用次数

额度规则见 授权码与额度。

---

步骤二：上传或粘贴

登录后进入互转界面：

方式 A：上传文件

• 文本文件 → 转为 tdata ZIP
• ZIP 文件（含 tdata）→ 转为 Session 文本
• 支持拖拽或点击选择

上传 tdata ZIP 的详细说明

1. 确认是 ZIP 格式
   必须是标准 ZIP（魔数 PK），不支持 RAR、7z 等。不支持加密 ZIP。

2. 确认 ZIP 内含 tdata 数据
   以下任一即可通过预检：

   • 路径中含 tdata/（如 tdata/key_datas）
   • 或 ZIP 内存在名为 key_datas 的文件

3. 推荐打包方式（任选其一）

   • 方式 1：在文件管理器中选中 tdata 文件夹 → 压缩，得到 tdata.zip
   • 方式 2：压缩 Session 制作下载 ZIP 解压后的整个账号目录（内含 tdata 子文件夹）
   • 方式 3：压缩从 Telegram Desktop 数据目录复制的 tdata 文件夹（请先关闭 Desktop 或确保文件未被占用）

4. 不要搞混「制作 ZIP」与「tdata ZIP」
   Session 制作下载的包同时含有 session.txt 与 tdata/。若目标是 tdata → Session：

   • 可直接上传整个制作 ZIP（服务端会在其中查找 tdata），或
   • 只将 tdata 子文件夹单独打成 ZIP 上传（体积更小）

5. 上传后方向
   识别为 ZIP 后自动走 tdata → Session，输出 converted_session.txt（StringSession 单行文本）。

Session → tdata 的上传说明

• 上传 .txt 等文本文件，或在下文方式 B 粘贴 StringSession
• 输出 converted_tdata.zip，解压后根目录为 tdata/，供 Telegram Desktop 使用
• StringSession 须完整、未截断，且会话仍然有效

方式 B：粘贴 Session

在下方文本框粘贴 StringSession（一般以 1 开头的 Telethon 字符串）。粘贴后会清空已选文件。

识别规则

服务端根据内容识别：非 ZIP 魔数的 UTF-8 文本 视为 Session；ZIP（PK 魔数） 视为 tdata。与文件名、扩展名无关。

若剩余次数为 0，「开始转换」按钮不可用。

---

步骤三：开始转换

点击「开始转换」后进入处理中状态：

• 请勿关闭页面
• 转换失败会显示错误，不扣次

---

步骤四：下载结果

转换成功后：

原输入	下载文件
Session 文本	converted_tdata.zip（含 tdata 目录）
tdata ZIP	converted_session.txt

Session → tdata 下载后：

1. 解压 converted_tdata.zip
2. 得到 tdata/ 文件夹（内含 key_datas 等）
3. 按您使用的 Telegram Desktop 版本，将 tdata 导入或替换到客户端数据目录（操作前请备份原有 tdata）

tdata → Session 下载后：

1. 打开 converted_session.txt，内容为单行 StringSession
2. 可在 Telethon、Pyrogram 等库中加载，或再次粘贴回本工具转为 tdata

点击「下载转换结果」保存。成功扣减 1 次额度。

可点击「转换另一个文件」继续（仍有剩余次数时）。

---

常见问题

现象	处理建议
请先使用授权码登录 / 登录已失效	重新输入授权码
剩余次数不足	购买新授权码
Session 格式无效 / 无效	确认 StringSession 完整未截断
ZIP 中未找到 tdata	确认 ZIP 内含 tdata/ 路径或 key_datas 文件；不要用仅含 session.txt 的包
无效的 tdata / 未找到有效的 tdata 目录	tdata 目录缺少 key_datas 等关键文件，或备份不完整
文件大小超过上限	压缩包过大，联系客服或拆分
转换超时	稍后重试

术语见 名词解释。购买见 授权码与额度 · 购买提示。