名词解释

本文对 Session / TData 制作工具中出现的术语进行说明。所有定义均依据产品实际行为编写，如有疑问请联系客服。

授权码

购买本工具服务后获得的凭证，用于登录制作前台并扣减「可制作次数」。

• 每个授权码绑定固定的最大可用次数（如 10 次）
• 每成功完成一次 Session / TData 导出，扣减 1 次
• 授权码可能的状态与错误提示：

提示信息	含义
授权码不存在	输入的授权码未在系统中找到
授权码已停用	授权码已被管理员停用
授权码已过期	授权码已超过有效期
授权码无效	授权码格式或内容无效
授权码可用次数已用完	所有次数已消耗完毕
剩余制作次数不足	当前操作需要的次数超过剩余额度

Session / StringSession

Telethon 库使用的字符串格式登录会话。

• 导出后保存在 ZIP 内的 session.txt 文件中
• 内容为一段文本字符串，可在 Telethon、Pyrogram 等支持 StringSession 的库中加载
• 包含登录凭证，属于敏感信息，请勿泄露

TData

Telegram Desktop 客户端使用的本地数据目录格式。

• 本工具通过 opentele 将 StringSession 转换为 TData 目录
• 导出后保存在 ZIP 内的 tdata/ 文件夹中
• 可将该目录导入 Telegram Desktop 使用
• 同样属于敏感登录信息

ZIP 压缩包

Session、TData 与账号信息打包后的下载文件。

• 文件名：区号 + 手机号（仅数字），例如 8613988881111.zip
• 解压后根目录名：与文件名相同（不含 .zip）
• 包含 session.txt、account.json、tdata/ 三个部分

account.json

ZIP 内的账号元信息文件，JSON 格式，包含以下字段：

字段	说明
phone	完整手机号（含区号）
generated_at	文件生成时间
device_model	模拟设备型号
system_version	模拟系统版本
app_version	模拟应用版本
has_2fa	本次导出是否使用了两步验证密码（登录时输入了 Cloud Password 则为 true，否则为 false）
profile	Telegram 账号资料（用户名、昵称等）

重要

account.json 不包含两步验证密码（Cloud Password）明文，也不包含任何可还原密码的信息。

制作次数 / 额度

授权码绑定的可用导出次数。

• 登录后页面顶部显示「剩余可制作 X / Y 次」
• X 为剩余次数，Y 为授权码总次数
• 每成功完成一次导出扣减 1 次
• 仅在全部文件正常生成后才扣减次数；发码失败、验证码错误、两步验证失败或打包失败均不扣减
• 次数用完后需重新购买授权码

任务 ID

单次导出任务在系统中的唯一标识。

• 开始制作（手机号或扫码）后由系统分配
• 用于查询任务状态与下载文件
• 任务可能过期，过期后需重新开始制作

任务状态

制作过程中任务可能处于以下状态：

状态	含义
等待处理	任务已创建，等待后续操作
验证码已发送	已向手机号发送 Telegram 验证码
等待扫码	二维码已生成，等待手机扫描
扫码监听已超时	二维码监听超时，需刷新重试
等待两步验证密码	需要输入 Cloud Password
生成中	正在生成 Session 与 TData
已完成	生成成功，可下载
失败	生成过程出错
已过期	任务超时失效

两步验证 / Cloud Password

Telegram 账号安全功能，又称「云密码」。

• 在 Telegram 设置中开启后，登录新设备需额外输入此密码
• 本工具登录流程中会提示输入，与 Telegram 官方行为一致
• 密码仅在登录时传输验证，不会保存到导出文件中
• account.json 中的 has_2fa 表示本次导出是否使用了两步验证密码，不是密码本身

Telethon

Python 语言的 Telegram 客户端库。

• 支持通过 StringSession 加载登录会话
• 可将 session.txt 中的内容用于脚本或自动化场景

Pyrogram

另一款 Python 语言的 Telegram 客户端库。

• 同样支持 StringSession 格式
• 可使用 session.txt 中的会话字符串

Telegram Desktop

Telegram 官方桌面客户端。

• 支持导入 TData 目录作为本地登录数据
• 本工具导出的 tdata/ 文件夹即为此格式

区号

手机号的国际区号前缀，如 +86（中国）、+1（美国）。

• 在填写手机号时需单独选择或输入
• ZIP 文件名中的数字为区号与手机号的组合（不含 + 号）

验证码

Telegram 官方发送的数字登录码，通常为 5 位或 6 位。

• 通过手机 Telegram 的官方消息接收
• 不是短信验证码（部分情况下可能通过短信，但以 Telegram 应用内消息为准）
• 有时效限制，过期需重新发送

二维码登录

通过手机 Telegram 扫描页面二维码完成桌面端登录的方式。

• 路径：手机 Telegram → 设置 → 设备 → 链接桌面设备
• 页面二维码约 30 秒过期，会自动刷新
• 超时后需手动点击「刷新二维码」