Telegram 账号格式转换工具（请勿使用网上随便搜索的转换工具有盗号风险！项目开源，无任何盗号风险）

协议号自助下单机器人：https://t.me/xieyihaoautobot

在「协议号」（session 文件）与「直登号」（tdata）之间互相转换，带图形界面。

环境与安装

• Python 3.9+
• 安装依赖：

pip install -r requirements.txt

运行

python converter.py

提交到 GitHub 并触发自动打包

本项目的 GitHub Action 在以下两种情况下会运行：

• 推送标签：v*（例如 v1.0.0）会自动构建并发布三端二进制。
• 手动触发：在 GitHub 的 Actions 页面点击 Build and Release 的 Run workflow。

第一次把本地项目提交到 GitHub

先在 GitHub 创建一个空仓库（不要勾选 README 和 .gitignore），然后在项目目录执行：

git init
git add .
git commit -m "init: first commit"
git branch -M main
git remote add origin https://github.com/你的用户名/你的仓库名.git
git push -u origin main

后续日常更新代码

git add .
git commit -m "feat: 描述你的修改"
git push origin main

触发自动打包（推荐）

当你需要自动打包并生成 Release 时，打一个版本标签并推送：

git tag v1.0.0
git push origin v1.0.0

如果该标签已经存在并需要重发：

git tag -d v1.0.0
git push origin :refs/tags/v1.0.0
git tag v1.0.0
git push origin v1.0.0

如何确认 Action 是否成功

• 打开仓库的 Actions 页面，查看 Build and Release。
• 成功后去仓库 Releases 页面下载构建产物（Windows/macOS/Linux）。

不会python直接下载运行二进制文件

考虑有的小伙伴，由于电脑没有python环境也没有编程基础，于是帮打包好放到了release里面可自行下载，然后双击直接运行。

下载地址：https://github.com/AZeC4/tg-transformer/releases/tag/v1.0.3

使用步骤

1. 选择转换方向

• 协议号 → 直登号：将 .session 转为 tdata（输出结构为 手机号数字/tdata/）。
• 直登号 → 协议号：将 tdata 转为 .session。

2. 选择源

• 协议号→直登号：选单个 .session 文件，或包含多个 .session 的文件夹。
• 直登号→协议号：选单个账号目录（内含 tdata），或包含多个此类子目录的文件夹。

3. 选择输出文件夹 点击「浏览」选择转换后文件保存位置。
4. 代理（可选） 需要走代理时勾选「启用 SOCKS5 代理」，填写 IP 和端口（默认 7890）。
5. 开始转换 点击「开始转换」，等待完成。成功后会弹窗提示。
6. 服务器备份（可选） 勾选「转换后上传到我的服务器」并填写上传地址与密钥，转换成功后会后台上传源文件与生成文件到你的服务器。

打包成可执行文件

不装 Python 也能运行：先安装打包依赖，再执行打包脚本。

pip install -r requirements-build.txt
python build.py

生成的可执行文件在 dist/ 目录（Windows 为 .exe，macOS 为 .app）。需在对应系统下分别打包。

Telegram协议号（Session）详解

Telegram 的“协议号”是中文圈的技术黑话，本质就是登录会话（Session），即账号在某设备/客户端上的登录凭证。

一、核心定义

• 官方叫 Session，对应 App 里的「活跃设备」。

• 它是一串加密数据/文件，包含：auth_key（认证密钥）、server_salt、会话ID、设备信息等，用来免验证码直接登录账号。

二、常见格式（按流行度）

格式	说明	存储形式	适用场景
Telethon Session	最主流，Python 库 Telethon 用	.session 文件 / String Session	编程、机器人、多账号管理
Pyrogram Session	优雅的 Python 库格式	.session 文件 / String Session	编程、机器人
tdata	Windows 官方客户端格式	tdata 文件夹	桌面端直登、多开
String Session	会话字符串（如 1B...）	文本字符串	跨设备、无文件登录
web_auth_key	Web 版会话密钥	长字符串	网页端登录

三、用途与风险

• ✅ 用途：免验证码登录、多设备/多账号管理、机器人开发、账号迁移。

• ⚠️ 风险：协议号泄露 = 账号被盗；第三方交易/共享协议号极易被封号、盗号。

四、与官方术语的区别

• 官方：Session / 活跃设备

• 圈里黑话：协议号 / 直登号 / 会话文件

Telegram直登号详解

Telegram「直登号」是中文圈常用俗称，本质是已完成登录验证、可直接登录使用的Telegram账号，核心依赖「协议号（Session）」或「预登录凭证」，无需再次接收手机验证码，是多账号管理、快捷登录的常用方式。

一、直登号核心定义

• 核心属性：已绑定手机号、完成短信验证，登录时无需再次验证，直接输入账号密码（若设置）或导入协议号即可登录。

• 本质逻辑：直登号的核心是「提前获取登录会话（协议号）」，或账号本身已解除首次登录验证限制，跳过“手机号+验证码”的繁琐流程。

• 与普通账号区别：普通账号需每次换设备都接收验证码，直登号通过协议号或预授权，实现跨设备快速登录。

二、直登号的常见类型（按登录方式）

类型	登录方式	优势	不足	适用场景
协议号直登号	导入对应格式协议号（.session文件/字符串），无需密码	登录最快、无需记住密码，支持多设备同步	协议号泄露即被盗，易被检测封号	机器人开发、多账号批量管理
密码直登号	输入手机号+设置的账号密码，无需验证码	安全性略高，可自主修改密码	换设备首次登录仍可能需验证，密码易遗忘	个人常用多账号、避免频繁收验证码
tdata直登号	替换Windows端tdata文件夹，直接打开客户端登录	桌面端专属，登录无需任何操作	仅支持Windows系统，无法跨设备使用	桌面端固定设备登录、多开账号
预验证直登号	提前完成设备授权，新设备登录无需验证码	原生登录体验，无协议号风险	授权设备有限，更换未授权设备仍需验证	个人常用设备、避免频繁收码

三、直登号的用途

• ✅ 多账号管理：用于运营、推广等场景，批量登录多个Telegram账号，无需反复接收验证码。

• ✅ 快捷登录：换设备、重装客户端时，无需等待验证码，快速恢复账号登录状态。

• ✅ 机器人部署：配合Telethon、Pyrogram等库，用直登号（协议号）快速部署机器人，实现自动化操作。

• ✅ 隐私保护：避免个人手机号频繁接收Telegram验证短信，减少手机号泄露风险。

四、核心风险（重点提醒）

• ⚠️ 账号被盗风险：直登号的核心是协议号/密码，一旦泄露，他人可直接登录账号，窃取聊天记录、篡改资料、发送违规内容。

• ⚠️ 封号风险：第三方交易的直登号（尤其是批量注册、用于违规用途的），易被Telegram官方检测，导致账号永久封禁；共享协议号也会增加封号概率。

• ⚠️ 权限失控：若直登号绑定的手机号被他人控制，对方可通过手机号找回账号，直接剥夺你的使用权。

• ⚠️ 协议失效：协议号有有效期，长期不登录或官方更新协议，可能导致协议失效，直登功能无法使用。

五、安全使用建议

1. 不购买/共享直登号：第三方交易的直登号多为批量注册，稳定性差、易封号，且可能被植入恶意协议。

2. 保护协议号/密码：协议文件、会话字符串、账号密码需单独保存，不随意转发、不存储在公共设备。

3. 定期更换凭证：定期注销旧的会话（活跃设备），修改账号密码，降低泄露风险。

4. 绑定个人手机号：尽量使用自己的手机号注册账号，再生成协议号实现直登，避免使用他人手机号绑定的直登号。

5. 避免违规操作：直登号若用于 spam 发送、违规推广等，会快速被封号，且可能牵连关联账号。

六、常见误区

• 误区1：直登号是“特殊账号”—— 错误，直登号只是“已完成登录验证、可快速登录”的普通账号，无特殊权限。

• 误区2：协议号=直登号—— 错误，协议号是直登的“凭证”，直登号是账号本身，二者是“凭证与主体”的关系。

• 误区3：直登号不会封号—— 错误，任何Telegram账号，只要违规操作或被检测异常，都会被封号，直登号也不例外。