名词解释
格式互转
在 StringSession 与 tdata 目录结构之间转换，不经过 Telegram 登录；服务端在转换时也不连接 Telegram 服务器，仅在本地读写凭证文件。
不会判断死号：不与 Telegram 交互，无法得知会话是否已撤销、账号是否被封；只要文件结构合法即可转换成功，不代表输出仍可用于登录。
StringSession
Telethon 格式的会话字符串，通常为单行文本。可作为 .txt 上传或粘贴到页面。
tdata
Telegram Desktop 用来保存本地登录状态的目录（不是单个 .tdata 扩展名文件）。目录内包含加密密钥与账号映射文件，属于敏感登录信息，与 Session 等价，切勿泄露。
怎样算「有效的 tdata 目录」
服务端（opentele-ng）认定目录有效需满足：
- 是一个文件夹，且其中存在
key_datas，或 - 存在以
D877F783D5开头的文件名（Telegram Desktop 账号目录标识）
仅有空文件夹或普通配置文件、没有上述 marker 的目录不能用于 tdata → Session。
ZIP 上传时的 tdata 识别
上传 ZIP 后，服务端不解压到磁盘前先读压缩包目录列表，检查是否包含：
- 路径片段
tdata/（如tdata/key_datas、8613988881111/tdata/…） - 或任意路径下名为
key_datas的文件
通过后才会解压并在目录树中 定位 tdata 文件夹（可能在 ZIP 根目录、子目录，或 Session 制作导出的手机号目录下）。
Session → tdata 的输出结构
转换成功后 ZIP 内固定为：
tdata/
├── key_datas
└── D877F783D5… （及其他 Desktop 所需文件）即根目录下只有 tdata/ 一层，不含 session.txt 或 account.json（那些属于 Session 制作导出包，不是互转输出）。
与 Telegram Desktop 的关系
- tdata → Session：从 Desktop 备份/复制的 tdata 还原为 Telethon StringSession
- Session → tdata：从 StringSession 生成 Desktop 可识别的 tdata 目录
本工具不会启动 Telegram Desktop，也不会修改您电脑上的 Desktop 安装目录；只负责格式转换，导入 Desktop 需您在本机操作。
常见 tdata 相关问题
| 问题 | 原因 / 处理 |
|---|---|
| ZIP 中未找到 tdata 相关文件 | ZIP 里没有 tdata/ 路径也没有 key_datas；请按 使用方法 重新打包 |
| 未找到有效的 tdata 目录 | 解压后找不到名称或内容合法的 tdata 文件夹 |
| 无效的 tdata，无法加载账号 | 目录结构损坏、备份不完整，或 tdata 与当前 Desktop 版本不兼容 |
| Session 无效或已失效，无法转换为 tdata | StringSession 对应会话已在 Telegram 侧失效，需重新登录制作新 Session |
| 转换成功但 Desktop 无法登录 | 可能 Desktop 版本差异或导入路径错误；请备份后查阅 Desktop 文档 |
从 Session 制作工具来的用户
制作 ZIP 解压后若只需互转为 Session 文本，可直接上传整个制作 ZIP（内含 …/tdata/），或打开 session.txt 复制内容粘贴，两种方式均可。
自动识别（direction=auto）
默认模式：服务端检测上传内容：
| 内容 | 方向 |
|---|---|
| UTF-8 文本（非 ZIP） | Session → tdata |
ZIP（魔数 PK） | tdata → Session |
文件名不影响识别。
输出文件
| 方向 | 建议文件名 | 类型 |
|---|---|---|
| Session → tdata | converted_tdata.zip | ZIP |
| tdata → Session | converted_session.txt | 纯文本 |
额度与扣次
与 Session 制作 共用授权码额度：
- 转换成功并返回文件 → 扣 1 次
- 校验失败、转换失败、超时 → 不扣
详见 授权码与额度。
与 Session 制作的区别
- 制作：通过 Telegram 官方流程登录新会话并导出完整 ZIP
- 互转：对已有 Session 或 tdata 做格式变换，无需发码
常见错误
| 提示 | 含义 |
|---|---|
| 文件为空 | 未上传有效内容 |
| 不支持的文件类型 | 非文本也非有效 ZIP |
| Session 格式无效 | StringSession 文本结构不合法（非死号检测） |
| 无效的 tdata | tdata 文件结构无法加载（非死号检测） |
| 转换超时 | 超过服务端时间限制（默认 60 秒） |