名词解释
本文汇总 Session / TData 制作与格式互转涉及的术语。授权码与额度细则见 授权码与额度。
通用术语
授权码
购买服务后获得的凭证，用于全站登录并扣减「剩余可用次数」。与制作、互转共用同一额度池。登录方式、扣次规则与购买说明见 授权码与额度。
Session / StringSession
Telethon 使用的字符串格式登录会话。制作工具保存在 ZIP 的 session.txt 中；互转时可上传 .txt 或粘贴单行文本。属于敏感信息，请勿泄露。
TData / tdata
Telegram Desktop 使用的本地数据目录（目录名一般为 tdata/，不是单个 .tdata 扩展名文件）。内含加密密钥与账号映射，与 Session 等价，切勿泄露。
ZIP 压缩包（制作导出）
制作成功后的下载文件。文件名一般为区号+手机号（如 8613988881111.zip），内含 session.txt、account.json、tdata/。
account.json
账号元信息（JSON），含手机号、生成时间、设备信息、has_2fa、profile 等。不包含两步验证密码明文。
剩余可用次数 / 额度
授权码绑定的共用额度（制作 + 互转）。页面右上角显示「剩余可用次数 X / Y 次」。制作 ZIP 全部生成成功或互转成功各扣 1 次；失败流程不扣次。
两步验证 / Cloud Password
Telegram 云密码。登录时输入，不写入导出文件。
Telethon / Pyrogram / Telegram Desktop
常见使用场景：Python 库加载 StringSession；Desktop 导入 TData 目录。
Session 制作相关
任务 ID
单次导出任务的唯一标识，用于查询状态与下载。任务可能过期。
任务状态
| 状态 | 含义 |
|---|---|
| 等待处理 | 任务已创建 |
| 验证码已发送 | 已向手机号发码 |
| 等待扫码 | 等待扫描二维码 |
| 扫码监听已超时 | 需刷新二维码 |
| 等待两步验证密码 | 需输入 Cloud Password |
| 生成中 | 正在生成文件 |
| 已完成 | 可下载 |
| 失败 / 已过期 | 需重新开始 |
区号 / 验证码 / 二维码登录
- 区号：如
+86，与手机号分开填写 - 验证码：Telegram 官方 5/6 位登录码
- 二维码登录：手机 Telegram → 设置 → 设备 → 链接桌面设备
格式互转相关
格式互转
在 StringSession 与 tdata 目录结构之间转换，不经过 Telegram 登录；服务端也不连接 Telegram 服务器，仅在本地读写凭证文件。
不会判断死号：不与 Telegram 交互，无法得知会话是否已撤销、账号是否被封；只要文件结构合法即可转换成功，不代表输出仍可用于登录。
怎样算「有效的 tdata 目录」
服务端（opentele-ng）认定目录有效需满足：
- 是一个文件夹，且其中存在
key_datas，或 - 存在以
D877F783D5开头的文件名（Telegram Desktop 账号目录标识）
仅有空文件夹或普通配置文件、没有上述 marker 的目录不能用于 tdata → Session。
ZIP 上传时的 tdata 识别
上传 ZIP 后，服务端先读压缩包目录列表，检查是否包含路径片段 tdata/ 或任意路径下名为 key_datas 的文件，再解压并定位 tdata 文件夹。
Session → tdata 的输出结构
转换成功后 ZIP 内固定为：
tdata/
├── key_datas
└── D877F783D5… （及其他 Desktop 所需文件）不含 session.txt 或 account.json（那些属于制作导出包，不是互转输出）。
与 Telegram Desktop 的关系
- tdata → Session：从 Desktop 备份/复制的 tdata 还原为 StringSession
- Session → tdata：从 StringSession 生成 Desktop 可识别的 tdata 目录
本工具不会启动或修改 Telegram Desktop；导入需在本机操作。
自动识别（direction=auto）
| 内容 | 方向 |
|---|---|
| UTF-8 文本（非 ZIP） | Session → tdata |
ZIP（魔数 PK） | tdata → Session |
文件名不影响识别。
互转输出文件
| 方向 | 建议文件名 | 类型 |
|---|---|---|
| Session → tdata | converted_tdata.zip | ZIP |
| tdata → Session | converted_session.txt | 纯文本 |
与 Session 制作的区别
- 制作：通过 Telegram 官方流程登录新会话并导出完整 ZIP
- 互转：对已有 Session 或 tdata 做格式变换，无需发码
从制作工具来的用户
制作 ZIP 解压后若只需互转为 Session 文本，可直接上传整个制作 ZIP（内含 …/tdata/），或打开 session.txt 复制内容粘贴。
常见错误（互转）
| 提示 | 含义 |
|---|---|
| 文件为空 | 未上传有效内容 |
| 不支持的文件类型 | 非文本也非有效 ZIP |
| ZIP 中未找到 tdata 相关文件 | ZIP 里没有 tdata/ 也没有 key_datas |
| 未找到有效的 tdata 目录 | 解压后找不到合法的 tdata 文件夹 |
| Session 格式无效 | StringSession 文本结构不合法（非死号检测） |
| 无效的 tdata | tdata 文件结构无法加载（非死号检测） |
| 转换超时 | 超过服务端时间限制（默认 60 秒） |
| 转换成功但 Desktop 无法登录 | 可能版本差异或导入路径错误 |