名詞解釋

本文對 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 與帳號資訊打包後的下載檔案。

• 檔名：區號 + 手機號（僅數字），例如 886912345678.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 驗證碼
等待掃碼	QR Code 已產生，等待手機掃描
掃碼監聽已逾時	QR Code 監聽逾時，需刷新重試
等待兩步驗證密碼	需要輸入 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/ 資料夾即為此格式

區號

手機號的國際區號前綴，如 +886（台灣）、+852（香港）。

• 在填寫手機號時需單獨選擇或輸入
• ZIP 檔名中的數字為區號與手機號的組合（不含 + 號）

驗證碼

Telegram 官方發送的數字登入碼，通常為 5 位或 6 位。

• 透過手機 Telegram 的官方訊息接收
• 不一定是簡訊驗證碼（部分情況下可能透過簡訊，但以 Telegram 應用內訊息為準）
• 有時效限制，過期需重新發送

QR Code 登入

透過手機 Telegram 掃描頁面 QR Code 完成桌面端登入的方式。

• 路徑：手機 Telegram → 設定 → 裝置 → 連結桌面裝置
• 頁面 QR Code 約 30 秒過期，會自動刷新
• 逾時後需手動點擊「刷新 QR Code」