名词解释
本文对 Session / TData 制作工具中出现的术语进行说明。
授权码
购买服务后获得的凭证，用于全站登录并扣减「剩余可用次数」。
| 提示信息 | 含义 |
|---|---|
| 授权码不存在 | 未在系统中找到 |
| 授权码已停用 | 已被管理员停用 |
| 授权码已过期 | 超过有效期 |
| 授权码无效 | 格式或内容无效 |
| 授权码可用次数已用完 | 所有次数已消耗 |
| 剩余次数不足 | 剩余为 0，无法发起新操作 |
Session / StringSession
Telethon 使用的字符串格式登录会话，保存在 ZIP 的 session.txt 中。属于敏感信息，请勿泄露。
TData
Telegram Desktop 使用的本地数据目录格式，保存在 ZIP 的 tdata/ 中。
ZIP 压缩包
导出下载文件。文件名一般为区号+手机号（如 8613988881111.zip），内含 session.txt、account.json、tdata/。
account.json
账号元信息（JSON），含手机号、生成时间、设备信息、has_2fa、profile 等。不包含两步验证密码明文。
剩余可用次数 / 额度
授权码绑定的共用额度（制作 + 互转）。
- Header 显示「剩余可用次数 X / Y 次」
- 制作：ZIP 全部生成成功 → 扣 1 次
- 互转：转换成功 → 扣 1 次（见 格式互转名词解释）
- 失败流程不扣次
任务 ID
单次导出任务的唯一标识，用于查询状态与下载。任务可能过期。
任务状态
| 状态 | 含义 |
|---|---|
| 等待处理 | 任务已创建 |
| 验证码已发送 | 已向手机号发码 |
| 等待扫码 | 等待扫描二维码 |
| 扫码监听已超时 | 需刷新二维码 |
| 等待两步验证密码 | 需输入 Cloud Password |
| 生成中 | 正在生成文件 |
| 已完成 | 可下载 |
| 失败 / 已过期 | 需重新开始 |
两步验证 / Cloud Password
Telegram 云密码。登录时输入，不写入导出文件。
Telethon / Pyrogram / Telegram Desktop
常见使用场景：Python 库加载 StringSession；Desktop 导入 TData。
区号 / 验证码 / 二维码登录
- 区号：如
+86，与手机号分开填写 - 验证码：Telegram 官方 5/6 位登录码
- 二维码登录：手机 Telegram → 设置 → 设备 → 链接桌面设备